# party-series / proportional-votes / 政党系列 比例得票

This dataset stores national proportional party-vote rows as selector-oriented derived extraction CSV.  
この dataset は、全国の比例政党得票 row を selector-oriented な derived extraction CSV として保存します。

## Boundary / 境界

- this is not canonical fact storage  
  これは canonical fact storage ではありません
- source of truth remains Layer 2 release facts and release manifests  
  正本は Layer 2 release facts と release manifests に残ります
- this dataset is a deterministic rearrangement for party-centric proportional lookup  
  この dataset は party-centric proportional lookup のための deterministic rearrangement です
- this dataset is an explicit semantic dataset for `proportional` only  
  この dataset は `proportional` 専用の explicit semantic dataset です

## Selector and row grain / selector と row grain

- family: `party-series`
- dataset: `proportional-votes`
- primary selector field: `party_id`
- selector shard directory: `by-party`
- row grain: `party_id x election_set_key`

## Important semantics rules / 重要な semantic 規則

- rows are restricted to `hr:block` and `hc:pr` only  
  row は `hr:block` と `hc:pr` のみに限定されます
- `smd` and `multi` must not appear in this dataset  
  `smd` と `multi` はこの dataset に入ってはいけません
- `vote_system` is retained as source provenance even though the semantic family is fixed to `proportional`  
  semantic family は `proportional` に固定ですが、`vote_system` は source provenance として保持します
- `component_family` is always `proportional`  
  `component_family` は常に `proportional` です
- party lineage, merger, or split semantics are not implied here  
  政党系譜や合流・分裂の意味づけはこの dataset では扱いません

## Files in this directory / このディレクトリのファイル

- `current.yaml`: contract and latest metadata for this dataset  
  この dataset の contract と latest metadata
- `latest/nationwide.csv`: stable convenience table for the whole dataset  
  dataset 全体の stable convenience table
- `latest/by-party/<party_id>.csv`: one selector shard  
  1 selector 分の shard CSV
- `releases/<source_release_version>/...`: release-scoped materialization snapshot  
  release 単位の materialization snapshot

## `current.yaml` keys / `current.yaml` の主要キー

| key | meaning / 意味 |
|---|---|
| `dataset_id` | fixed dataset contract id / 固定の dataset 契約 ID |
| `family` | extraction family name / extraction family 名 |
| `dataset` | dataset name within the family / family 内 dataset 名 |
| `source_release_version` | Layer 2 release version used to build this snapshot / この snapshot の build 元になった Layer 2 release version |
| `source_layer` | upstream layer authority / 上流 authority layer |
| `primary_selector_field` | shard key field / shard の主キー列 |
| `primary_selector_index_dir` | directory name used for shard files / shard ファイルに使う directory 名 |
| `row_grain` | one-row meaning / 1 row の意味 |
| `built_at` | UTC build timestamp / UTC build 時刻 |
| `notes` | dataset-specific contract note / dataset 固有の契約メモ |
| `source_election_set_keys` | election sets included in the build / build に含めた election set 一覧 |
| `files` | latest/release nationwide artifact metadata / latest/release artifact metadata |
| `summary` | selector count and shard summary / selector 件数と shard 要約 |

## CSV columns / CSV 列定義

| column | meaning / 意味 |
|---|---|
| `election_set_key` | election-set id such as `20260208_hr` / `20260208_hr` のような election-set id |
| `election_date` | election date in `YYYY-MM-DD` / `YYYY-MM-DD` の election date |
| `election_type` | election type such as `hr`, `hc` / `hr`, `hc` などの election type |
| `vote_system` | exact source vote system: `block` or `pr` / 厳密な source vote system。`block` または `pr` |
| `component_family` | fixed semantic family `proportional` / 固定 semantic family `proportional` |
| `party_id` | normalized party id / 正規化済み party id |
| `votes` | national proportional votes for that party in that election set / その election set における全国比例得票 |
| `valid_votes` | national valid votes for the same proportional component, when available / 同一比例 component における全国 valid votes |
| `vote_share_pct_national` | national proportional vote share for the party in that row, when available / 当該 row における全国比例得票率 |

## Notes / 注意

- blank numeric fields mean the upstream Layer 2 fact did not expose a stable value for this row  
  空の数値列は upstream Layer 2 fact に stable な値がなかったことを意味します
- this dataset is explicit enough to draw proportional trend lines without mixing `smd` or `multi`  
  この dataset は `smd` や `multi` を混ぜずに比例 trend line を引ける程度には explicit です
- if you need exact mixed-component authority rows, use `party-series/national-votes` instead  
  mixed-component の exact authority rows が必要なら `party-series/national-votes` を使います