吃音村 2.0

吃音を持つ人たちが暮らす、小さなオンラインの村。競争・ランキングを持たず、 弱さや苦労を分かち合うことを中心に置いた MVP です。

既存の「吃音村」DB とは完全に独立した、新しい Supabase プロジェクトを前提としています。

必要環境

• Node.js 20 以上
• npm
• Supabase アカウント（新規プロジェクトを1つ作成してください。既存の吃音村プロジェクトとは共有しないこと）

セットアップ

1. 依存関係のインストール

npm install

2. Supabase プロジェクトの作成

1. https://supabase.com でプロジェクトを新規作成。作成時の詳細設定は以下を選択:
   • Enable Data API: ON（supabase-js から叩くのに必須）
   • Enable automatic RLS: ON（新規テーブルへの安全装置。うちは全テーブルで手動RLSも行うので実質重複するが害はない）
   • Automatically expose new tables: OFF（Supabase推奨のセキュリティ設定。この場合でも動くよう、各 migration に明示的な grant select/insert/... を入れてあるので、ONでもOFFでもどちらでも問題ない）
2. Project Settings → API から以下を控える
   • Project URL
   • anon public キー
   • （必要になった時点で）service_role キー — 絶対にブラウザに公開しないこと

3. 環境変数の設定

.env.local.example を .env.local にコピーし、値を埋めてください。

cp .env.local.example .env.local

NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...   # 今回のMVPでは未使用。将来のサーバー専用処理向け

4. マイグレーションの適用

supabase/migrations/ 以下の SQL を、Supabase 管理画面の SQL Editor に ファイル名の順番通り貼り付けて実行してください（supabase CLI がある場合は supabase db push でも可）。

ファイル	内容
20250101000001_extensions.sql	拡張機能・共通トリガー関数
20250101000002_profiles.sql	住民票（profiles）
20250101000003_bonfire.sql	焚き火（bonfire_posts）
20250101000004_garden.sql	農園（種・水やり・収穫・作物配布・water_seed RPC）
20250101000005_shrine.sql	祠（村の生命力・お供え・make_offering / get_village_status RPC）
20250101000006_desert.sql	砂漠（desert_stories）
20250101000012_crop_gifts.sql	焚き火での作物ギフト（crop_gifts・gift_crop RPC）
20250101000014_own_field.sql	自分の家の畑（garden_seeds.kind・water_own_field_seed RPC）
20250101000017_desert_bloom.sql	砂漠の開拓の水やり・開花（desert_waterings・flower_catalog・desert_blooms・user_flowers・water_desert_story RPC）
20250101000018_library.sql	図書館（book_catalog・library_reviews・flower_gifts・gift_flower RPC）
20250101000019_soft_delete_rls_fix.sql	焚き火・砂漠・図書館の論理削除RLS修正
20250101000020_library_book_swap.sql	図書館の本の入れ替え
20250101000021_cinema.sql	映画館（movie_catalog・cinema_reviews・cinema_flower_gifts・gift_flower_to_cinema_review RPC）

5. Auth のメール確認設定（推奨）

Supabase 管理画面 → Authentication → Email Templates → Confirm signup の リンクを以下の形式に変更してください（@supabase/ssr を使った Next.js の 標準的な確認フローです）。

{{ .SiteURL }}/auth/confirm?token_hash={{ .TokenHash }}&type=email&next=/onboarding

開発中にメール確認をスキップしたい場合は、Authentication → Providers → Email の "Confirm email" をオフにしても構いません。

6. 開発サーバーの起動

npm run dev

http://localhost:3000 を開いてください。

DB 構造概要

• profiles — 住民票。user_id は auth.users に 1:1。ログイン済みユーザーのみ閲覧可、編集は本人のみ。
• bonfire_posts — 日常の気持ちの投稿。論理削除（deleted_at）。
• garden_seeds — 種。kindがcommunityなら苦労を植えた農園の種（status: seed → growing → harvested）、own_fieldなら自分の家の畑で自分の「できたこと」を植えた種（harvest_count・last_watered_dateで1日1回・最大10収穫を管理）。
• waterings — 農園（community）の水やり記録。unique(seed_id, user_id) で二重水やりを禁止。直接 INSERT する RLS ポリシーは存在せず、water_seed() RPC 経由でのみ作成される（own_field は自分専用のためwateringsは使わず、garden_seeds.last_watered_dateで日次制限する）。
• crop_catalog — 収穫される作物のマスタ。is_active を切り替えることで後から増減可能。
• harvests — 収穫そのもの。community の種は生涯1回だけ（water_seed()内のアプリケーションロジックで保証）、own_field の種は水やりのたびに複数回発生し得るためseed_idはuniqueにしていない。
• user_crops — 収穫物の個人在庫。unique(user_id, harvest_id) で二重配布を禁止。offered_at が 埋まっていればお供え済み。
• game_settings — 水やり必要回数・お供え回復量・生命力の自然減少量・状態しきい値などの バランス数値。1行だけのシングルトンテーブルで、コードを書き換えずに調整可能。
• village_state — 村の生命力の基準値と最終計算日。日々の Cron は不要で、 経過日数 × daily_vitality_decay を都度計算する方式。
• offerings — お供え履歴。unique(user_crop_id) で同じ作物の二重奉納を禁止。
• crop_gifts — 焚き火での作物ギフト履歴。誰が・誰に・どの投稿を通じて渡したかを記録する。
• desert_stories — 苦難の記録（何に苦しんだか / 何をしたか / その結果）。論理削除。status（story → blooming → bloomed）で水やりの進捗を管理する。投稿内容（本文3項目）は本人がいつでも編集可能だが、status/bloomed_at は列レベルの権限制限により water_desert_story() 経由でしか変更できない。
• desert_waterings — 砂漠の記録への水やり記録。unique(story_id, user_id) で二重水やりを禁止。waterings と同型で、water_desert_story() RPC 経由でのみ作成される。
• flower_catalog — 咲く花のマスタ。crop_catalog と同型。is_active で後から増減可能。
• desert_blooms — 開花の記録そのもの。harvests と同型で、story_id は一生に1回だけ開花する（water_desert_story() 内のアプリケーションロジックで保証）。
• — 咲いた花の個人在庫。/ とは完全に独立しており、祠のお供えには使わない収集専用の在庫（ 相当のカラムはない）。

すべてのテーブルで RLS を有効化しています。特にゲームの根幹となる処理 （水やり3回での収穫判定・作物のランダム決定・複数人への配布・お供えによる 生命力更新）はフロントエンドに任せず、SECURITY DEFINER の Postgres 関数内で 行 (row) ロックを使い、トランザクションとして原子的に処理しています。

主要 RPC 一覧

関数	説明
water_seed(p_seed_id uuid)	指定した種に水をやる。自分の種には不可、二重水やりも DB 制約で禁止。水やりが harvest_water_count 回に達すると、その場でランダムな作物を収穫し、種を植えた人＋水をやった全員に配布する。
get_current_vitality()	村の現在の生命力（0〜100）を計算して返す。書き込みはしない。
get_village_status()	生命力を4段階の状態（tier 1〜4）とメッセージに変換して返す。数値自体はクライアントに公開しない。
make_offering(p_user_crop_id uuid)	自分の未奉納の作物を祠にお供えする。現在の生命力を再計算し、offering_recovery を加算して max_vitality でクランプ、その値を新しい基準値として保存する。
get_offering_history()	祠の裏で表示する、全村人のお供え履歴（誰が・何を・いつ）を返す。user_crops は本人しか SELECT できないため、この関数を介さず直接テーブルを結合すると他人の記録が見えなくなる。
water_own_field_seed(p_seed_id uuid)	自分の家の畑で、自分の種に水をやる。植えた当日から1日1回まで。水をやるたびに即座にランダムな作物を1個収穫し、自分だけに配布する。harvest_countが10に達すると、その種は収穫終了になる。
gift_crop(p_user_crop_id uuid, p_recipient_id uuid, p_bonfire_post_id uuid)	自分の未奉納の作物を、焚き火の投稿を通じて他の村人に渡す。user_crops.user_id を書き換えて所有者を移し、crop_gifts に記録を残す。
water_desert_story(p_story_id uuid)	砂漠の記録に水をやる。自分の記録には不可、二重水やりも DB 制約で禁止。harvest_water_count（農園と共通）回に達すると、その場でランダムな花を咲かせ、記録した人＋水をやった全員に配布する。
gift_flower(p_user_flower_id uuid, p_recipient_id uuid, p_library_review_id uuid)	自分の花を、図書館の感想を通じて他の村人に渡す。user_flowers.user_id を書き換えて所有者を移し、flower_gifts に記録を残す。
gift_flower_to_cinema_review(p_user_flower_id uuid, p_recipient_id uuid, p_cinema_review_id uuid)	自分の花を、映画館の感想を通じて他の村人に渡す。gift_flower と同じ処理を cinema_flower_gifts に記録する。

画面構成

/                 ログイン前トップ
/login            ログイン
/signup           新規登録
/onboarding       初回村人登録
/village          村マップ
/town-hall        村役場（自分の住民票・編集リンク・村人一覧リンク）
/town-hall/edit   住民票の編集
/residents        村人一覧
/residents/[id]   住民票（他の村人）
/bonfire          焚き火
/garden           農園
/shrine           祠
/shrine/back      祠の裏（お供え履歴）
/desert           砂漠
/library          図書館（本の一覧）
/library/[id]     本の詳細・感想投稿・花のギフト
/library/[id]/reviews/[id]/edit  感想の編集
/cinema           映画館（映画の一覧）
/cinema/[id]      映画の詳細・感想投稿・花のギフト
/cinema/[id]/reviews/[id]/edit  感想の編集

MVP でやらないこと

研究所・掲示板・フォロー・DM・ランキング・いいね・複雑な通知・課金・ Google ログイン・Realtime・高度なアニメーション・管理者画面・AI 機能は 今回のスコープ外です（後から追加できる設計にはしています）。