議員レコード (giinrecord)

言ったことではなく、やったことを。 https://giinrecord.jp

国会議員が本会議でどう投票し、どの法案を出し、何を発言したか —— 衆参両院と国立国会図書館の公式記録だけを、出典リンク付きでそのまま並べるサイトです。評価・採点・推薦はしません。

原則

• 事実のみ。 すべての行に一次資料へのリンクと取得日時。
• 事実と推定を区別。 参議院の個人別投票は事実。衆議院は個人別記録が公開されていないため「会派の態度」として別に扱う。
• 評価しない。 スコア・ランク・一致率・色による善悪表現を作らない。
• 検証可能。 コード（MIT）とデータ（CC BY 4.0）を公開。

構成

apps/web         React + TypeScript + Vite + React Router。ビルド時にプリレンダリングした静的サイト。サーバー実行コードは含まない
packages/etl     TypeScript のバッチ。GitHub Actions で日次実行し、衆参・会議録から data/ を生成
packages/shared  型定義
data/            正規化済み JSON（CC BY 4.0）
deploy/          VPS の配信設定（nginx コンテナ + docker compose。共用ホストの nginx は TLS と proxy のみ）

開発

pnpm install
pnpm test && pnpm typecheck && pnpm lint
pnpm dev            # apps/web
pnpm etl 221        # 第221回国会の参院投票結果を data/ に取得

進め方

スクラム。PBI は GitHub Issues、ボードは GitHub Projects。TDD。

デプロイ（staging → production）

環境	URL	いつ	ワークフロー
staging	https://staging.giinrecord.jp（noindex）	main への push で自動	deploy-staging.yml
production	https://giinrecord.jp	手動リリース：gh workflow run release.yml --ref main -f ref=$(git rev-parse origin/main)（GUI なら Actions → Release → Run workflow）。承認待ちは無い（#659）	release.yml
両方（データのみ）	—	日次 ETL の data PR がマージされたら自動	deploy-data.yml（etl.yml / districts.yml が起動）

staging の初回構築で人間がやることは 2 つだけ：DNS の A レコード staging.giinrecord.jp → VPS のアドレス（giinrecord.jp と同じ。IP はリポジトリに書かない、#133） と、手元で 1 回 bash deploy/run-remote.sh deploy/staging-setup.sh（VPS_SSH_HOST は ssh エイリアス、既定 sakura-vps）。 GitHub 側は Environment staging / production / production-data に同じ DEPLOY_* secrets。required reviewers は 3 つとも置いていない（#659。理由は docs/ops/deploy.md）。詳細は deploy/README.md と docs/ops/deploy.md。

ライセンス

コード: MIT / データ: CC BY 4.0（出典: 参議院・衆議院・国立国会図書館）