Marine Wallet
マリーンズを応援する毎日を、記録し、つなぎ、未来へ積み立てる。
千葉ロッテマリーンズの観戦体験を軸に、ロッテ貯金と割り勘を1つのアプリへ統合した個人利用アプリです。
仕様は docs/marine-wallet-spec-v0.1.md、統合方針は
docs/integration-plan.md を参照してください。
- 完全個人利用 / 非商用
- Marine Wallet 自身は資金を保有・移動しません（外部アプリへの誘導のみ）
| |
|---|
| リポジトリ | minatani-01/marine-wallet（旧 baseball-savings を改称） |
| 公開URL | https://marine-wallet.vercel.app |
| Vercelプロジェクト名 | marine-wallet |
| Supabase | Marine Wallet（ref xliszlnpypvqghrwplxa） |
統合元
| 旧アプリ | 旧スタック | 統合後 |
|---|
| ロッテ貯金（baseball-savings） | Vite + React + Supabase | 貯金タブ |
| 割り勘アプリ（warikan-app） | Next.js + Supabase | 割り勘タブ |
旧アプリのリポジトリ・Vercelプロジェクト・Supabaseプロジェクトはいずれも削除または
PAUSED 済みです。データは移行済みで、旧ロッテ貯金の試合116件（合計 54,600円）と
旧割り勘の92件はすべて本アプリのDBにあります。
技術スタック
- Next.js 16（App Router / Turbopack /
proxy.ts）
- React 19
- Tailwind CSS v4
- Supabase（Auth / PostgreSQL / RLS）
- Vercel
チャートは外部ライブラリを使わず SVG で自前描画しています（components/charts/CumulativeChart.tsx）。
セットアップ
npm install
cp .env.example .env.local # Supabase の URL とキーを設定する
npm run dev
.env.local:
NEXT_PUBLIC_SUPABASE_URL=https://<project-ref>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<publishable key>
DBマイグレーション
Supabase の SQL Editor で番号順に実行します（何度実行しても安全な冪等スクリプトです）。
本番プロジェクトへは適用済みで、新しく環境を作るときだけ必要になります。
| ファイル | 内容 |
|---|
0001_marine_wallet_core.sql | 共通スキーマ（profiles / saving_rules / games / saving_entries / monthly_savings）とRLS。saving_rules は 0017 で saving_rule_settings に置き換え |
0002_import_legacy_games.sql | 旧ロッテ貯金アプリからのデータ移行（実施済みの記録。再実行用のクエリを含む） |
0003_confirmed_ui.sql | 確定UIに合わせたボーナス項目とカスタム貯金の追加 |
0004_home_away_nullable.sql | 旧アプリが未記録だったホーム/ビジターを null 許容にする |
0005_marine_link.sql | Marine Link（marine_links / link_permissions / 判定関数 / RPC / 共有用ポリシー） |
0006_shared_goals.sql | 共同貯金（shared_goals / shared_goal_members / 進捗RPC） |
0007_split_member_marine_id.sql | メンバーの Marine ID と、参加者単位の割り勘共有 |
0008_member_participation.sql | メンバーの参加機能（割り勘 / 貯金）と、貯金の参加者別集計RPC |
0009_drop_deposit_pending.sql | 月末フローから「入金手続き中」を外す |
0010_member_avatar.sql | メンバーの写真アイコン（member-avatars バケットと、自分のフォルダだけ読み書きできるRLS） |
0011_profile_avatar.sql | 自分のプロフィールアイコン（profiles.avatar_path） |
0012_annual_goal.sql | 目標金額を月間から年間へ（monthly_goal_amount → annual_goal_amount）。0020 で廃止 |
0013_master_auto_accept.sql | マスター権限（profiles.is_master）。マスターからの接続リクエストは承認なしで接続する |
0014_confirm_month_for_circle.sql | 月末の確定を、貯金に参加している接続済みメンバーにも反映する |
0015_totals_by_deposited.sql | 累計貯金額の基準を「確定した月」から「入金した月」へ |
0016_circle_by_link.sql | 総累計貯金額を、メンバー登録ではなく Marine Link の接続で決める |
0017_shared_saving_rules.sql | 貯金ルールを全アカウント共通の1行にし、共有設定の「貯金ルール」を変更権限に変える |
0018_auto_saving_entries.sql | つみたての自動生成（試合の登録時と接続の成立時）。確定の対象も接続で決める |
デプロイ
master への push で Vercel が Production を自動デプロイします。環境変数は
NEXT_PUBLIC_SUPABASE_URL と NEXT_PUBLIC_SUPABASE_ANON_KEY の2つだけです。
NEXT_PUBLIC_* はビルド時にバンドルへ埋め込まれるため、環境変数を変更したときは
ビルドキャッシュを使わずに再デプロイしてください。変更していないときはキャッシュを
使って構いません。
ビルド設定は vercel.json（framework: nextjs）でリポジトリ側に固定しています。
旧 Vite 構成のプロジェクト設定が残っていてもこちらが優先されます。
画面構成
ホーム 更新ボタン / 累計貯金・前月比 / 今月のつみたて額・継続日数
/ 未精算の立替・今季の勝率 / 貯金推移（月別・年別）
貯金 試合登録・カスタム貯金 / 月間集計 / 月末確定・ワンバンク入金
/ 未登録の試合 / 記録 / 貯金ルール
割り勘 精算額と支払い状況 / メンバーごとの支払額（受取はマイナス）/ 精算（PayPay誘導）/ 未精算・すべて・完了
履歴 取引履歴（貯金と割り勘をまとめた時系列）
マイページ Marine ID / アイコン・表示名・ログアウト / お知らせ / メンバー（マスターのみ）
└ メンバー 一緒に使う人を1画面で管理
あなたの Marine ID / 届いているリクエスト / メンバー一覧
（写真アイコン・Marine ID・接続・共有設定・割り勘と貯金の指定）
/ メンバー未登録の接続 / 共同貯金 / 月間比較
実装状況
仕様書 40章のフェーズ区分に対応します。
| フェーズ | 状態 |
|---|
| Phase 1 統合基盤 | 実装済み |
| Phase 2 ロッテ貯金自動化 | 手動登録のみ実装。NPBからの自動取得は未着手 |
| Phase 3 外部アプリ連携 | 金額コピーと起動URLは実装済み。入金ステータスは月末フローに内包 |
| Phase 4 Marine Link | 実装済み（Marine ID / リクエスト / 権限管理 / データ共有 / 月間比較 / 共同貯金） |
| Phase 5 Marine Day | 未着手 |
| Phase 6 Insight | 履歴・推移は実装済み。Season Report / Fan Score / 通知は未着手 |
ブランドアセット
確定アイコンの置き場所は public/brand/README.md を参照。
public/brand/mark.png が無い場合はワードマークのみを表示するため、画面は崩れない。
設計上のポイント
- 貯金ルールは全アカウント共通。
saving_rule_settings に1行だけ置きます。
変更できるのはマスターと、マスターが接続の共有設定で「貯金ルール」をONにした相手だけです
（can_edit_saving_rules()）。権限が無い人には読み取り専用で見せます。
共有設定の「貯金ルール」は、見せるかどうかではなく変更権限を渡すかどうかです。
- 試合データは共有（仕様書 15章）。
games は全ユーザー共通で、
saving_entries がユーザーごとの積立額を持ちます。
- つみたては強制。試合が登録されると、マスターと接続しているアカウント全員ぶんの
積立が自動で作られます（
sync_saving_entries_for_game）。あとから接続した人には、
接続が成立した時点で過去ぶんをまとめて作ります（sync_saving_entries_for_user）。
金額は共通ルールで計算するので全員同じです。すでにある記録は触りません
（手で直した額を黙って書き換えないため）。貯金タブの「未登録の試合」は
取りこぼしを拾うための手動の受け皿として残してあります。
つみたてと確定は自動、入金済みだけが各自の操作です。確定の連動はマスターが押した
時点でしか動かないため、あとから接続した人にはマスターが確定済みの月を
接続時にまとめて反映します（sync_monthly_status_for_user）。作るのは確定（ready）までで、
入金済みは実際に送金した本人しか分からないので触りません。
- 過去の金額は再計算しない。貯金ルールを変更しても、記録済みの試合の金額は保持されます。
- ワンバンク入金は月末に1回。
monthly_savings が
calculating → ready → deposited の状態を管理します。
入金はワンバンク側で一度に終わるため、間に「手続き中」は挟みません。
- ホームでは試合数ではなく戦績を出す。試合の登録は試合のあとになるので、
「今月何試合ぶん記録したか」は読む意味が薄い。勝率（引き分けを除く 勝 ÷ 勝＋負）と
勝敗分、そして最後に記録した試合の日付を出し、どこまでの結果かが分かるようにしています。
戦績は貯金の記録に紐づく試合から数えます。全試合を貯金の対象にするため
記録＝その年の試合そのもので（本番DBで2026年の試合116件と試合貯金116行が
1対1であることを確認済み）、
games を別に引かずに済みます。
- 割り勘の金額は「誰がいくら払うか」で見せる。メンバーごとに
「負担額 − 立替額」を出し、立替の方が多い人はマイナス（＝受け取る側）で表示します。
合計は必ず 0 になります。なお同じ「未精算」でも、ホームは立替の総額、
割り勘タブは実際に動かす必要がある額（精算額）で、意味が違うので名前を分けています。
- メンバー管理はマイページの下に置く。下部ナビは URL の前方一致で点灯するため、
/split/members に置くと操作中ずっと「割り勘」が点いたままになる。マイページからの
導線なので /me/members に移し、古いURLは転送だけ残してある。
- 「メンバー」と「Marine Link」は1画面にまとめてある。どちらも同じ相手を Marine ID で
指すため、分けていると同じ人を2か所に登録することになっていた。いまは1人1行で、
その行の中で 接続・共有設定・割り勘と貯金の指定まで完結する。接続はあるがメンバーに
載っていない相手は「メンバー未登録の接続」として出し、1タップで取り込める。
/me/link は /me/members へ転送する。
- アイコンの写真は非公開に置く。
member-avatars バケットは public=false で、
<ユーザーID>/… の先頭フォルダが自分と一致するオブジェクトだけ読み書きできる
（本番DBで、別アカウントからも未ログインからも見えないことを確認済み）。
表示のたびにサーバー側で署名付きURLを発行する。アップロード時は端末側で中央を
正方形に切り出して 256px の JPEG に変換してから上げるため、元の写真の大きさは問わない。
署名が切れたり読めなかったときは名前の頭文字表示に戻す。
- UIに絵文字は使わない（仕様書 4.1）。アイコンはすべて
components/icons.tsx の SVG ラインアイコンです。
- 累計貯金額は入金した月だけを数える。確定は金額を締めただけで手元からは動いていないので、
累計は
monthly_savings.status = 'deposited' の月の合計です。まだ入金していない分は
「未入金」として別に出します（確定済みの月は確定額で、確定前の月は積立予定額で数えます）。
定義は lib/insights.ts の depositedTotal と、DB側の deposited_total_for() に
1つずつだけ置いてあります。1人分の累計と、貯金に参加している接続済みメンバーを
合算した総累計を分けて出します。
スクリプト
npm run dev # 開発サーバー
npm run build # 本番ビルド
npm run start # 本番サーバー
npm run typecheck # 型チェック
