みらいまる見え政治資金

政治資金の透明性向上を目指すオープンソースダッシュボード

政治家・政治団体が会計データを透明に公開し、市民が政治資金の流れを理解しやすくするためのWebアプリケーションです。クラウド会計ソフト（MFクラウド・freee等）から取得したデータを可視化し、政治資金報告書の作成も支援します。

チームみらい永田町エンジニアチームが開発しています。

プロジェクト構成

このプロジェクトは以下のディレクトリ構成で構築されています：

ディレクトリ構造

marumie/
├── webapp/           # フロントエンド（一般ユーザー向け）
│   ├── src/
│   │   ├── app/           # Next.js App Router
│   │   ├── client/        # クライアントサイドコンポーネント
│   │   ├── server/contexts/ # Bounded Context ベース構成
│   │   │   └── public-finance/  # 政治資金データの公開・可視化
│   │   └── types/         # 型定義
│   ├── tests/             # テストファイル
│   └── package.json
├── admin/            # 管理画面
│   ├── src/
│   │   ├── app/           # Next.js App Router
│   │   ├── client/        # クライアントサイドコンポーネント
│   │   ├── server/contexts/ # Bounded Context ベース構成
│   │   │   ├── auth/      # 認証関連処理
│   │   │   ├── data-import/  # 取引データ取り込み
│   │   │   ├── report/    # 政治資金報告書XMLエクスポート
│   │   │   └── shared/    # コンテキスト横断共有
│   │   ├── types/         # 型定義
│   │   └── middleware.ts
│   ├── tests/             # テストファイル
│   └── package.json
├── shared/           # 共通モデル・型定義・ユーティリティ
│   ├── models/       # 共通データモデル
│   └── utils/        # 共通ユーティリティ関数
├── data/             # サンプルデータ
├── supabase/         # Supabaseローカル開発環境設定
├── prisma/           # データベーススキーマ・マイグレーション
└── docs/             # ドキュメント（正本とスナップショットの分類は docs/README.md を参照）

各ディレクトリの役割

• webapp/: 一般ユーザー向けのフロントエンドアプリケーション（政治資金データの可視化）
• admin/: 管理者向けの管理画面（データ登録・管理機能）
• shared/: webapp と admin で共通して使用するモデル、型定義、ユーティリティ関数
• data/: サンプルデータファイル
• supabase/: Supabaseローカル開発環境の設定ファイルとテンプレート
• prisma/: データベーススキーマ定義、マイグレーションファイル、シードデータ
• docs/: プロジェクトのドキュメント。現行のルールを規定する「正本」と、実装当時の設計メモである「スナップショット」（docs/old/）に分かれています。読み方は docs/README.md を参照してください

技術スタック

• Frontend: Next.js 16, React 19, TypeScript
• Backend: Prisma ORM, Supabase
• Styling: Tailwind CSS v4
• Charts: Recharts, ApexCharts, Nivo
• Database: PostgreSQL (via Supabase)
• Development: pnpm, Biome
• Testing: Jest

画面イメージ

※ 表示されている値は実際の値ではありません。

ローカル開発手順

ローカル開発環境のセットアップ手順は 開発環境セットアップガイド を参照してください。

本番デプロイとリリースタグ

本番デプロイは GitHub Actions の Deploy Production ワークフローを main から手動実行して行います。 webapp / admin の両方のデプロイが成功すると、デプロイしたコミットに release tag が自動で作成・push されます（どちらかが失敗した場合はタグは付きません）。

デプロイは「ビルド → vercel promote で本番ドメインを付け替え → ドメインが今回のデプロイを指したか検証」の順に行います（scripts/vercel-deploy-production.sh）。 CLI からのデプロイは本番ドメインが自動では付け替わらないため、promote と検証まで通って初めてデプロイ成功とみなします。

• タグ名の形式: release-YYYYMMDD-HHMMSS（日本時間。例: release-20260911-153012）
• 名前順に並べるとデプロイ順になります

現在本番に出ているコミットは、最新の release tag で確認できます。

git fetch --tags
git log -1 "$(git tag -l 'release-*' --sort=-refname | head -n 1)"

ライセンス

このプロジェクトは GNU Affero General Public License v3.0 の下でライセンスされています。

コントリビューション

このプロジェクトへのコントリビューションを行う場合は、コントリビューターライセンス契約(CLA) への同意が必要です。

ライセンス表示

このソフトウェアを使用する場合は、適切なライセンス表示を行ってください。詳細は LICENSE ファイルをご確認ください。