# jp-election-db public docs / analytical-articles

`docs/analytical-articles/` は、運用レポートとは別系統の分析論考、方法論、政策分析、法学分析を公開する棚である。

## 境界

- Source of truth: `catalog/current.yaml` と `catalog/public-manifest.json` が指す current release、公開 `data/`、`specs/`、`verification/` artifact。分析や文章ではなく、再利用者が参照すべき機械可読・検証可能な正本。
- Operational report: 実行報告、検証報告、release / deploy / evidence に紐づく記録。`docs/reports/` に置く。
- Analytical Article: 分析論考、方法論、政策分析、法学分析、一般化された説明。個別の実行ログではなく、後から読める知見や説明を主対象にする。`docs/analytical-articles/` に置く。

## 配置方針

- 既存の `docs/reports/` は移動しない。
- article ごとに安定した英語 slug を使う。
- 日本語 title を主にし、必要なら英語 title も metadata に併記する。
- public server へ配布する article 本体は `article.pdf` のみとする。
- 元 Word、抽出テキスト、思考メモ、summary、画像 assets は repo 管理領域には置けるが public server へ配布しない。
- `index.json` は analytical article listing の機械可読入口として扱い、公開可能な最小 metadata のみを含める。

## 推奨構成

```text
docs/analytical-articles/
├── index.html
├── index.json
├── README.md
└── <article-slug>/
    ├── article.pdf
```