# derived extraction data / 派生抽出データ

`derived extraction data` are deterministic CSV extracted and rearranged from canonical release facts to satisfy repeated access patterns.  
`derived extraction data` は、canonical release facts から決定的に抽出・再配置した CSV 群であり、繰り返し発生する利用需要に応えるための派生データです。

## Naming rules / 命名規則

- use lowercase kebab-case for family and dataset directories  
  family / dataset ディレクトリ名には lowercase kebab-case を使います
- use noun-based names that describe lookup/use pattern  
  名称は表示先ではなく lookup / use pattern を表す名詞ベースにします
- do not use `continuous` in path names; use `series`  
  path 名に `continuous` は使わず、`series` を使います
- keep file names fixed and carry meaning in directory structure  
  ファイル名は固定し、意味はディレクトリ構造で表現します

## Standard layout / 標準レイアウト

```text
<family>/<dataset>/
  current.yaml
  latest/
    nationwide.csv
    <selector_dir>/<selector_value>.csv
  releases/<source_release_version>/...
```

## First-wave families / 初期 family

- `municipality-series`
- `prefecture-series`
- `party-series`

## Layer role / レイヤ責務

- `derived/extraction` is the tidy distillation layer for stable reuse
  `derived/extraction` は stable reuse のための tidy distillation 層です
- UI-facing contracts belong to `derived/shape` and its current compatibility mirror under `presentation/`
  UI 向け contract は `derived/shape` と、その互換ミラーである `presentation/` に属します
- do not encode graph/page-specific view contracts here
  graph/page 固有の view contract はここに持ち込みません

## Machine-readable map / 機械読取用マップ

- `CATALOG.md`
- `catalog-map.csv`

## Human-readable local docs / 人間向けローカル説明

- each family directory has its own `README.md`  
  各 family ディレクトリには独立した `README.md` があります
- each dataset directory has its own `README.md`  
  各 dataset ディレクトリにも独立した `README.md` があります
- dataset-local README files define the dataset purpose, selector, row grain, `current.yaml` keys, and CSV columns  
  dataset ごとの README には、そのデータの用途、selector、row grain、`current.yaml` のキー、CSV 列定義を書きます