marumie

みらいまる見え政治資金

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

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

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

プロジェクト構成

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

ディレクトリ構造

…

各ディレクトリの役割

• 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 されます（どちらかが失敗した場合はタグは付きません）。

• タグ名の形式: 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 ファイルをご確認ください。