政府予算ビュー（旧称: 政府予算見える化、行政事業レビュー可視化）
行政事業レビューシステム（rssystem.go.jp）の予算・支出データを中心に、国の予算の流れ・事業の評価・委託構造・基金・事業者・概算要求・税制・家計負担・財政余力をブラウザで見られるようにする Next.js アプリケーション。本番は https://rs-vis.team-mir.ai で公開しています。
対象の中心は行政事業レビュー（RS）の対象事業です（国の全予算の約 27%）。範囲と対象外は docs/rs-data-scope.md を参照してください。RS のシート年度 N には N−1 年度の執行・支出先が載ります（2025 年版 = 2024 年度実績）。
ページ一覧
トップ / は各ビューへの入口です。ヘッダーの「AI」からどのページでも AI ナビ（自然言語での絞り込み・データの問い合わせ・ページ移動）を使えます。
主なビュー
| ページ | 説明 |
|---|
/budget-sankey | サンキー図。歳入→会計→所管→項→目→事業→支出先の流れを 1 本で追う。所管・名前・金額・再委託・政策評価スコア（6 項目）・継続年数で絞り込み。「RSのみ」プリセットが旧 /sankey-svg（旧 URL はここへリダイレクト） |
/project-bubble | バブルチャート。5,000 超の事業を内容の近さで配置し、予算規模や AI 評価を切り替えて比較 |
/quality | 評価一覧。公開資料に基づく独自基準の AI 評価（試行）と執行透明性スコアを事業ごとに一覧。詳細ダイアログに予算・執行推移、支出先、みんなの意見 |
/subcontracts | 委託構造。事業ごとの支出先・再委託先の構造を図と表で確認（契約方式・再委託率・クイックフィルタ） |
/vendors | 事業者別。事業者（法人番号）ごとの受注額・1 者応札率・随意契約 |
/funds | 基金。基金シートから残高・支出・国庫返納・終了予定・点検結果 |
補助ビュー（試作）
| ページ | 説明 |
|---|
/budget-requests | 2027 年度の概算要求・要望を原資料とともに探す |
/tax-expenditures | 法人税の租税特別措置の適用実態と関連 RS 事業、AI による試行評価 |
/tax-burden | 年収・家族構成別の税と保険料の負担率、国の税目別歳入（2025 年度制度のモデル計算） |
/fiscal-space | 財政余力シミュレータ。政策・物価・労働・エネルギー・国債借換を仮定モデルで条件比較 |
財務省予算書（URL 直打ち）
/mof-budget-overview（予算全体）、/mof-jikou（事項）、/mof-kou-moku（科目別内訳）、/mof-kou（項一覧）、/mof-hierarchy（階層フロー）、/mof-sankey（項×RS 事業）。
その他
/lp（紹介ページ）、/terms（利用規約）、/privacy（プライバシーポリシー）。
技術スタック
- フレームワーク: Next.js 15 (App Router, Turbopack), React 18, TypeScript
- スタイリング: Tailwind CSS、lucide-react
- 可視化: 自作 SVG レイアウト、d3 系、Canvas（バブルチャート）、Web Worker（財政余力の計算）
- データ: 生成済み JSON を
.gz で Git 管理し、ビルド時に展開。意見投稿と AI ナビの対話ログは Supabase
- AI: OpenRouter 経由の LLM。訪問者の API キー（BYOK・ブラウザ直）を優先し、環境変数があればサイト提供 AI
- データ処理: Python 3、TypeScript (tsx)
- テスト: Node.js test runner（単体）、Playwright（E2E）
セットアップ
前提条件
- Node.js 22 以上（CI と同じ）
- Python 3.x（データ再生成時のみ）
起動
npm install
npm run dev
ブラウザで http://localhost:3000 を開いてください。prebuild フックで public/data/*.gz が .json に展開され、データ生成なしで動きます。
任意の環境変数
| 変数 | 用途 |
|---|
NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY | 事業への意見投稿（AI インタビュー）と AI ナビの対話ログ保存。無ければ API は 404、UI は非表示 |
SANKEY_AI_CHAT_ENABLED=1 と OpenRouter のキー | サイト提供 AI（キー未登録の訪問者も AI ナビを使える）。モデルは SANKEY_AI_CHAT_MODEL / SANKEY_AI_INTERVIEW_MODEL で差し替え |
NEXT_PUBLIC_GA_MEASUREMENT_ID | Google Analytics 4 の測定 ID（本番環境のみ読み込む。未設定時は既定値） |
データ再生成（任意）
CSV・API から JSON を作り直す手順はページごとに違います。docs/data-pipeline-guide.md と /pipeline スキル（.claude/skills/）を参照してください。元データは data/（Git 管理外）に置きます。代表的なコマンド:
npm run download-rs-csv-2025 # RS の CSV を取得・展開
npm run generate-unified-budget-graph # サンキー図（予算書×RS）
npm run generate-subcontracts-2025 # 委託構造
npm run score-quality-ai-2025 # AI 評価
npm run generate-project-map # バブルチャート（埋め込み）
npm run generate-funds # 基金
npm run generate-vendors # 事業者
npm run compress-data # gzip 圧縮（Git 管理用）
npm スクリプト（開発・検証）
| コマンド | 説明 |
|---|
npm run dev | 開発サーバー（Turbopack、ポート 3000） |
npm run build / npm start | 本番ビルド（prebuild で .gz を展開）/ 本番サーバー |
npm run lint | ESLint |
npm run typecheck | TypeScript の型チェック（データ展開不要） |
npm test | 単体テスト（ドメイン・API・AI ツール） |
npm run test:e2e | Playwright E2E（初回は npx playwright install chromium。data-testid は Playwright 実行時だけ出力） |
npm run test:e2e:ui / :headed / :report | Playwright の UI モード / ブラウザ表示 / HTML レポート |
CI（.github/workflows/checks.yml）は PR に対して typecheck・lint・単体テスト・E2E（本番ビルド）・依存の監査を実行します。
AI ナビ・MCP・スキル
デプロイ（Vercel）
開発は dev ブランチで行い、dev → main の PR をマージすると Vercel が自動ビルドします（東京リージョン hnd1）。main への直接 push はしません。
- Vercel プロジェクトと環境変数は
infra/terraform/ の Terraform で管理（手順は infra/terraform/README.md）
- Supabase のスキーマは
supabase/schema.sql、追加変更は supabase/migrations/
- データ更新時は
compress-data で .gz を作ってコミットする
プロジェクト構成
.
├── app/ # Next.js App Router（ページ・API・ドメインロジック）
│ ├── api/ # API エンドポイント群（/api/mcp、/api/ai、/api/sankey など）
│ └── lib/ # Pure なドメインロジック（HTTP・React を含まない）
├── client/ # クライアント側（components / hooks / lib）
├── components/ # 共通 UI（ナビゲーション・フィルタ部品・法務文書）
├── types/ # 全レイヤー共通の型定義
├── scripts/ # データ生成（Python / TypeScript）
├── public/data/ # 生成データ（.gz のみ Git 管理）
├── data/ # ローカルの元データ（Git 管理外）
├── supabase/ # スキーマ・マイグレーション
├── infra/terraform/ # Vercel・環境変数の IaC
├── skills/ # 外部の AI 向けスキル
├── tests/ # 単体テスト・E2E（tests/e2e）
└── docs/ # 設計・仕様・監査のドキュメント（docs/tasks は作業記録）
レイヤーの規約（scripts/ は CSV 処理のみ、app/lib/ は Pure、client/ は app/lib/api/*-loader を import しない等）は CLAUDE.md にあります。
ドキュメント
データソース
出典と利用条件の一覧は app/lib/data-sources.ts（利用規約第 6 条・紹介ページと共用）にあります。
ライセンス
GNU Affero General Public License v3.0
