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

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

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

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

marumie/
├── webapp/           # フロントエンド（一般ユーザー向け）
│   ├── src/
│   │   ├── app/      # Next.js App Router
│   │   ├── client/   # クライアントサイドコンポーネント
│   │   ├── server/   # サーバーサイドロジック
│   │   └── types/    # 型定義
│   ├── tests/        # テストファイル
│   └── package.json
├── admin/            # 管理画面
│   ├── src/
│   │   ├── app/      # Next.js App Router
│   │   ├── client/   # クライアントサイドコンポーネント
│   │   ├── server/   # サーバーサイドロジック
│   │   ├── types/    # 型定義
│   │   └── middleware.ts
│   ├── tests/        # テストファイル
│   └── package.json
├── shared/           # 共通モデル・型定義・ユーティリティ
│   ├── models/       # 共通データモデル
│   └── utils/        # 共通ユーティリティ関数
├── data/             # サンプルデータ
│   ├── sampledata.csv
│   └── test_current_liabilities.csv
├── supabase/         # Supabaseローカル開発環境設定
│   ├── config.toml
│   └── templates/
├── prisma/           # データベーススキーマ・マイグレーション
│   ├── schema.prisma
│   ├── migrations/
│   └── seed.cjs
├── logs/             # ログファイル
└── docs/             # 設計ドキュメント（その時点での設計メモなので必ずしも正確ではないです）
    └── images/       # ドキュメント用画像

• webapp/: 一般ユーザー向けのフロントエンドアプリケーション（政治資金データの可視化）
• admin/: 管理者向けの管理画面（データ登録・管理機能）
• shared/: webapp と admin で共通して使用するモデル、型定義、ユーティリティ関数
• data/: サンプルデータファイル
• supabase/: Supabaseローカル開発環境の設定ファイルとテンプレート
• prisma/: データベーススキーマ定義、マイグレーションファイル、シードデータ
• logs/: ログファイルやデバッグ用データ
• docs/: プロジェクトの設計ドキュメント

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

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

このプロジェクトはSupabaseローカル開発環境を使用してローカル開発を行います。

1. 初回セットアップ（推奨）

pnpm run dev:setup

このコマンドで依存関係のインストール、データベースのリセット・マイグレーション・シードデータの投入を一括実行します。

2. 開発サーバーの起動

pnpm run dev  # Webapp + 管理画面を同時起動（Supabase自動起動）

pnpm run dev           # Webapp + 管理画面を同時起動（推奨）
pnpm run dev:webapp    # Webappのみ起動
pnpm run dev:admin     # 管理画面のみ起動

pnpm run db:reset      # データベース完全リセット（データ削除 + マイグレーション + シード）
pnpm run db:migrate    # マイグレーション実行
pnpm run db:seed       # シードデータ投入
pnpm run db:studio     # Prisma Studio起動

pnpm run lint          # 全体のLint実行
pnpm run format        # コードフォーマット実行
pnpm run typecheck     # 型チェック実行
pnpm run test          # テスト実行

pnpm run supabase:start   # Supabaseローカル環境起動
pnpm run supabase:stop    # Supabaseローカル環境停止
pnpm run supabase:status  # Supabase状態確認

pnpm run clean         # 全てのnode_modulesとSupabaseを停止
pnpm run fresh         # クリーンインストール + セットアップ

• Vercelで行われるwebappのbuild過程で自動的にマイグレーションが実行されます

• 以下のコマンドでマイグレーションを実行してください：

pnpm run db:migrate

• メインアプリ: http://localhost:3000
• 管理画面: http://localhost:3001
• Supabase Studio: http://127.0.0.1:54323

webapp/.env.local に以下を追加してモックデータを有効化：

USE_MOCK_DATA=true

設定後、トランザクションページのバックエンドがモックデータを返すようになります。

data/sampledata.csv に政治資金の取引データのサンプルが含まれています。管理画面（ http://localhost:3001 ）の「CSVアップロード」機能からこのファイルをアップロードして確認できます。

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

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

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