OpenGreenTrack - GHG排出量算定・管理ツール
公式サイト: https://g-track.org/ — 製品概要・導入事例・お問い合わせはこちら。
OpenGreenTrack は企業向けの温室効果ガス（GHG）排出量算定・可視化・管理プラットフォームです。Scope 1 / 2 / 3 を横断し、拠点別・カテゴリ別の排出量を集計して、経営層から現場まで意思決定に活かせるダッシュボードを提供します。
主要機能
- ダッシュボード
- データ入力
- Scope 1・2 と Scope 3 積上げを1つのフォームで入力
- 入力履歴の検索・編集・削除
- Scope 分析
- 排出係数管理
- 公的係数マスタとの連携
- 拠点別 / 事業部別のカスタム係数設定
- 拠点管理
- レポート出力
対象ユーザー
- 環境推進部門
- サステナビリティ担当者
- 拠点のエネルギー管理責任者
- 経営層、ESG/BCP 戦略担当者
技術スタック
| 技術 | 役割 |
|---|
| Next.js（App Router） | フロントエンドフレームワーク。ファイルベースルーティング・Server Components |
| React | UIコンポーネント |
| TypeScript | 静的型付け |
| Supabase | バックエンド基盤（PostgreSQL / Auth / RLS） |
| Tailwind CSS + CSS Variables | 緑基調のデザイン（src/styles/globals.css） |
| recharts | グラフ・チャート描画 |
| lucide-react | アイコン |
| clsx | クラス名結合ユーティリティ |
依存ライブラリは最新安定版を使用します（プレリリース版は不可）。バージョン方針・開発規約の正本は AGENTS.md を参照してください。
アーキテクチャの全体像は docs/architecture.md、ディレクトリ構成は docs/directory-structure.md を参照してください。
開発環境セットアップ
詳しい手順は docs/setup-guide.md を参照してください。
セットアップ方法は、目的に応じて 2 つあります。
| 経路 | 用途 | 主な流れ |
|---|
| ローカルで動かす（推奨） | まず無料で試す、開発する | Docker + Supabase CLI → npx supabase start → npm run db:reset:demo → npm run dev |
| クラウドで運用する | チーム利用、本番利用 | Supabase プロジェクト作成 → npx supabase link --project-ref xxx → npx supabase db push --include-seed → .env.local にクラウドの値を設定 |
Docker をインストールできない会社 PC では、クラウドで運用する経路を選んでください。macOS / Windows でのターミナル操作や Docker 未導入時の対応も docs/setup-guide.md に記載しています。
前提ツール
| ツール | 必要なバージョン | 確認コマンド | 備考 |
|---|
| Node.js | 24 以上（package.json の engines で指定） | node -v | 満たさない場合 npm install 時に EBADENGINE 警告が出ます |
| npm | Node.js 24 同梱のもの | npm -v | |
| Git | 任意の最新版 | git --version | |
| Docker Desktop | ローカルで動かす場合のみ必要 | docker --version | クラウドで運用する経路では不要 |
最短手順
上から順に実行してください（ローカルで動かす場合）。
| 順番 | 作業 | コマンド |
|---|
| 1 | リポジトリ取得と依存インストール | git clone → npm install |
| 2 | 環境変数ファイルのひな形を作る | cp .env.example .env.local |
| 3 | Supabase 起動 → DB 作成 → .env.local に値を記入 | npx supabase start → npm run db:reset:demo |
| 4 | 開発サーバー起動 | npm run dev |
手順 1: リポジトリを取得して、依存パッケージをインストールします。
git clone <リポジトリURL>
cd OpenGreenTrack
npm install
npm install 時に lefthook が Git フック（pre-commit）を自動セットアップします。
以降、コミット時にステージした .ts / .tsx に自動で eslint --fix がかかり、CI が赤くなる前にローカルで整えられます。
どうしてもスキップしたい場合は git commit --no-verify を使えますが、同じ lint は CI 側でも実行されます。
環境変数
手順 2: .env.example をコピーして .env.local を作ります。
cp .env.example .env.local
実際の値は次章「Supabase セットアップ」を実行すると得られます。 取得した値を、次の対応表のとおり .env.local に書き込んでください。
| 取得元の名前 | .env.local の変数名 |
|---|
API_URL（ローカル） / Project URL（クラウド） | NEXT_PUBLIC_SUPABASE_URL |
ANON_KEY（ローカル） / anon public（クラウド） | NEXT_PUBLIC_SUPABASE_ANON_KEY |
SERVICE_ROLE_KEY（ローカル） / service_role（クラウド） | SUPABASE_SERVICE_ROLE_KEY |
- ローカルで動かす場合は
npx supabase status -o env で上記 3 つの名前（API_URL / ANON_KEY / SERVICE_ROLE_KEY）の値が表示されます。npx supabase start の画面表示は Project URL / Publishable / Secret というラベルで、.env.local の変数名とは異なるため、値の確認には -o env を使うのが確実です。
- クラウドで運用する場合は Supabase Dashboard の Project Settings → API から URL / キーを取得します。
.env.example はコミットして共有する（サンプル値のみ）.env.local は機密情報を含むため、決してコミットしない（.gitignore 済み）SUPABASE_SERVICE_ROLE_KEY は管理者権限キーのため、サーバ側でのみ使用する（クライアントコードでの参照禁止）
Tip: ローカルで動かす場合は、次のコマンドで .env.local に貼り付けられる 3 行をそのまま出力できます。
npx supabase status -o env \
--override-name api.url=NEXT_PUBLIC_SUPABASE_URL \
--override-name auth.anon_key=NEXT_PUBLIC_SUPABASE_ANON_KEY \
--override-name auth.service_role_key=SUPABASE_SERVICE_ROLE_KEY
Supabase セットアップ
手順 3: Supabase を起動して DB を作り、.env.local の値を埋めます。
ローカルで試す場合:
npx supabase start
npm run db:reset:demo # DB を作り直し、公式排出係数マスタ + デモデータを投入
npx supabase start が完了したら、環境変数 の対応表に従って .env.local の 3 つの値を埋めてください（値は npx supabase status -o env で再表示できます）。
クラウドで運用する場合:
npx supabase link --project-ref <Project Ref>
npx supabase db push --include-seed # マイグレーション + 公式排出係数マスタを反映
supabase db reset はローカル DB を作り直すコマンド、supabase db push はクラウド DB へマイグレーションを反映するコマンドです。
Supabase CLI は npx supabase … で実行します（npm run db:* も内部で npx supabase を呼びます）。Homebrew 等で入れた supabase を併用する場合は、同じメジャーバージョンに揃えてください。
supabase/migrations/ はテーブル定義など DDL 専用（データは置かない）で、データは supabase/seeds/ にあります。supabase/seeds/production/（公式排出係数マスタ）は supabase db reset / supabase db push --include-seed で自動的に投入されます。supabase/seeds/demo/（デモ組織・デモユーザー [email protected] / password123 を含むデモデータ）は npm run db:reset:demo または npm run db:seed:demo で明示的に入れたときだけ投入されます。本番には入れないでください。
手順の詳細とつまずきやすい点は docs/setup-guide.md、シードとコマンドの一覧は supabase/README.md を参照してください。
開発サーバー起動
手順 4: .env.local を埋め終えたら起動します。
npm run dev
ブラウザで http://localhost:3000 にアクセスします（ポートは 3000 に固定）。
デモデータを投入した場合は [email protected] / password123 でログインできます。
コマンド一覧
| コマンド | 説明 |
|---|
npm run dev | 開発サーバー起動（http://localhost:3000） |
npm run build | 本番ビルド |
npm run start | 本番ビルドの起動 |
npm run lint | ESLint 実行 |
npm run test | テスト実行（vitest） |
npm run test:watch | テストをウォッチモードで実行 |
npm run test:e2e | E2Eスモークテスト実行（Playwright / ローカルSupabase必須） |
npm run test:e2e:ui | E2Eスモークテストを UI モードで実行 |
npm run test:e2e:install | E2E用のブラウザ（Chromium）をダウンロード（初回のみ） |
npm run db:reset | ローカル DB を作り直す（マイグレーション + 公式排出係数マスタ） |
npm run db:reset:demo | ローカル DB を作り直し、デモデータまで投入する |
npm run db:seed:demo | 起動中のローカル DB にデモデータ（supabase/seeds/demo/demo.sql）を投入する |
npm run db:seed:production | 起動中のローカル DB に公式排出係数マスタを（再）投入する |
npm run check:migrations | supabase/migrations/ にデータ操作（DML）が混入していないか検査する |
ドキュメント
ドキュメントはすべて日本語です（ファイル名は英語 kebab-case に統一）。
All documentation is written in Japanese.
セキュリティと運用上の注意
- ブラウザに公開してよい環境変数は
NEXT_PUBLIC_ プレフィックス付きのもののみ
SUPABASE_SERVICE_ROLE_KEY は RLS をバイパスする管理者キー。必ずサーバー側でのみ利用する.env.local を誤ってコミットした場合は、速やかに該当キーをローテーション（Supabase で再発行）する- CI/CD 用のシークレットは GitHub Actions / Vercel 等の Secrets 管理機能を使用する
- IDEAデータベース取込は、数十MBの Excel をブラウザから Supabase Storage（
upload-quarantine バケット）へ直接アップロードし、サーバはパスだけを受け取ってストリーミングで読み取る。リクエストボディ制限のあるホスティング（Vercel 等）でも動作し、Node のメモリは数百MBで足りる（詳細は docs/setup-guide.md の 2-F）
- 脆弱性を発見した場合は公開 Issue ではなく
SECURITY.md の手順で報告してください
コントリビューション
バグ報告・機能提案・コード貢献を歓迎します 🌱
ライセンス
本プロジェクトは Apache License 2.0 の下で公開されています。
