# municipality-series / 市町村系列 family

This family serves municipality-centric longitudinal lookup.  
この family は、市町村起点の時系列参照に使います。

## Target demand / 想定需要

- choose one municipality or one `jis_code`  
  1 つの市町村、または 1 つの `jis_code` を選んで参照する
- retrieve a stable CSV showing election-by-election changes  
  選挙ごとの変化を stable な CSV として取得する
- power charts without rebuilding joins on every request  
  毎回 join を組み直さずに chart や分析へ渡す

## Selector rule / selector 規則

- primary selector is `jis_code`  
  主 selector は `jis_code` です
- municipality name is display metadata only  
  municipality name は表示用 metadata であり、主キーではありません
- no silent continuity inference across JIS changes  
  JIS 変更をまたぐ continuity を暗黙推論してはいけません

## Datasets / dataset 一覧

- `stats`
- `party-votes`
- `proportional-party-comparison-2025-2026`

## Contract boundary / 契約境界

- this family is `derived extraction data`, not canonical facts  
  これは `derived extraction data` であり、canonical facts ではありません
- primary selector is the user-facing municipality selector `jis_code`  
  主 selector は user-facing な municipality selector としての `jis_code` です
- municipality names are display metadata, not keys  
  municipality name は表示 metadata であり、キーではありません
- designated-city ward rows may be rolled up to the parent city selector when no exact parent selector row exists  
  指定都市の区 row は、exact な親 selector row がない場合に限って親市 selector へ持ち上げることがあります
- continuity across JIS changes must not be inferred from names alone  
  JIS 変更をまたぐ continuity を名前だけで推論してはいけません

## Standalone dataset docs / dataset 個別説明

- `stats/README.md`
- `party-votes/README.md`
- `proportional-party-comparison-2025-2026/README.md`