# party-series / 政党系列 family

This family serves party-centric longitudinal lookup.  
この family は、政党起点の時系列参照に使います。

## Target demand / 想定需要

- choose one party  
  1 つの政党を選んで参照する
- retrieve a stable CSV showing election-by-election national vote changes  
  全国での選挙ごとの得票変化を stable な CSV として取得する
- power national trend charts without rebuilding joins on every request  
  毎回 join を組み直さずに全国 trend chart や分析へ渡す

## Selector rule / selector 規則

- primary selector is `party_id`  
  主 selector は `party_id` です
- geography stays national in first-wave datasets  
  first-wave dataset では geography は national に固定されます

## Datasets / dataset 一覧

- `national-votes`
- `proportional-votes`

## Contract boundary / 契約境界

- this family is `derived extraction data`, not canonical facts  
  これは `derived extraction data` であり、canonical facts ではありません
- primary selector is `party_id`  
  主 selector は `party_id` です
- geography stays national in first-wave datasets  
  first-wave dataset では geography は national のままです
- `vote_system` remains row-level authority and must not be dropped  
  `vote_system` は row-level authority なので落としてはいけません
- row-authority dataset と explicit semantic aggregate dataset を同居させてよい  
  row-authority dataset と explicit semantic aggregate dataset は同じ family に同居してよいです
- `national-votes` は mixed `vote_system` row dataset であり、`proportional-votes` は明示的な比例 dataset です  
  `national-votes` は mixed `vote_system` row dataset であり、`proportional-votes` は explicit proportional dataset です

## Standalone dataset docs / dataset 個別説明

- `national-votes/README.md`
- `proportional-votes/README.md`