遊栄 SNS素材・投稿管理
B-club / KINGYO / C-girl / 焼肉En の 店舗 → キャスト → 素材 → 投稿 を記録・集計する社内業務用サイトです（日本語・スマホ優先）。
SNSへの自動投稿やAPI連携は行いません（記録専用）。
- スタック: Next.js 16 / TypeScript / Tailwind CSS 4 / PostgreSQL（本番）・PGlite（ローカル組み込みDB）
- 認証: メール＋パスワード（自己登録なし。管理者が発行）。店舗ごとに 管理者／編集スタッフ／閲覧のみ
- 日付: 表示・カレンダーの日境界は Asia/Tokyo。日時は timestamptz、撮影日・回答日は date（架空の時刻は付けません）
セットアップ（ローカル）
npm install
cp .env.example .env # ローカルだけなら DATABASE_URL は消す/空でOK（./.data/pglite を自動作成）
ADMIN_PASSWORD='10文字以上のパスワード' npm run create-admin -- [email protected] "管理者"
npm run build && COOKIE_SECURE=false npm start # → http://localhost:3000
# 開発: COOKIE_SECURE=false npm run dev
- 初回アクセス時に自動でマイグレーションと初期マスター（3店舗・20セット60問、
seed/APP_SEED.json）が投入されます。何度実行しても重複せず、実績データは消えません（npm run db:seed でも可）。
- キャストは空で始まります。デモ用の架空データが必要な時だけ
npm run seed:demo（DATABASE_URL 設定時は拒否）。
- ログイン後、
/admin/users（システム管理者のみ）でスタッフを招待し、店舗ごとの権限を付与します。
共有DB（Supabase など）に接続する
PC・スマホで同じ記録を見るには、共有のPostgreSQLが必要です。
- Supabase でプロジェクトを作成し、接続文字列（Database → Connection string, Session pooler 推奨）を取得
.env に DATABASE_URL=... と COOKIE_SECURE=true（https運用時）を設定npm run db:migrate（マイグレーション＋初期マスター）→ npm run create-admin -- ...- 全テーブルは RLS有効・ポリシーなし（Supabaseの公開API経由の直接アクセスは全拒否）。アプリはサーバー側のDB接続だけで読み書きし、店舗権限はサーバー処理で検証します。
DATABASE_URL は絶対にフロントエンドやGitへ出さないでください。
デプロイ（例: Vercel）
GitHubリポジトリを接続し、環境変数 DATABASE_URL / COOKIE_SECURE=true を設定してデプロイ。初回は上記 3 のコマンドをローカルから実行（同じ DATABASE_URL を使う）。
テスト
npm run typecheck
npm test # 集計・検算例・権限・回答進捗などのドメインテスト（32件、メモリDB）
npm run build && npm run test:e2e # 実ブラウザ(Edge)のUIテスト 23件（別DB .data/e2e を使用）
バックアップ・復元
- Supabase: ダッシュボードの Backups、または
pg_dump "$DATABASE_URL" -Fc -f backup.dump / pg_restore -d "$DATABASE_URL" --clean backup.dump
- ローカル(PGlite): アプリ停止後に
.data/pglite フォルダごとコピー／戻す
- 台帳として
ダッシュボード → CSV出力（キャスト一覧・素材一覧・投稿履歴。数式インジェクション対策済み）も使えます
設計メモ
- 素材グループ＋個別素材N件を1トランザクションで作成。素材番号は
BCL-PR-0001-01 形式で、店舗×種別のカウンタ（INSERT … ON CONFLICT DO UPDATE）で採番するため同時登録でも重複せず、取消しても振り直しません。
- 使用済み素材 = 有効な「投稿済み」投稿に紐付く個別素材の重複なし件数。投稿済み件数 = 有効な「投稿済み」レコード数（SNSごとに1件）。手動の「投稿済み」フラグは持ちません。
- 店舗をまたぐ関連付けは複合外部キー
(id, store_id) でDBでも禁止。保存の連打は画面側のロック＋request_key の一意制約で二重登録を防ぎます。
- 誤登録の取消は論理削除（集計から除外）。投稿に紐付いた個別素材は取消不可。SNS側で後から消えた投稿は「公開状態メモ」に残します。
未実装・制限
- 写真・動画ファイルのアップロード（Storage）は未実装。保存場所URLと枚数・本数の記録のみ（仕様上アップロードは任意）。
- 管理者向け全店集計画面（任意項目）は未実装。
- ログイン試行の制限はプロセス内のみ（複数インスタンスでは前段のWAF等も併用してください）。
ファイルのアップロード（Supabase Storage）
- 非公開バケット
materials に、ブラウザから直接アップロードします（署名付きURL・サーバーを経由しないので大きな動画もOK）。閲覧は認証後の期限付きURL(1時間)です。
- 有効にするには環境変数
SUPABASE_URL と SUPABASE_SERVICE_ROLE_KEY（Project Settings → API の service_role）を設定します。キーはサーバー専用で、Gitやブラウザに出さないでください。
- 1ファイルの上限はバケット設定(既定2GB。Supabase Proで、Storage設定のグローバル上限も要確認)と
MAX_UPLOAD_MB の小さい方です。対応形式: JPEG/PNG/WebP/GIF/HEIC、MP4/MOV/WebM。
- 素材詳細で、個別素材ごとの「＋ ファイルを追加」と、名前順に空き素材へ割り当てる「まとめてアップロード」が使えます。
AIでキャプションを作る（Gemini）
- 投稿登録の「✨ AIでキャプションを作る・整える」で、ざっくりした文章から3案を作り、確認して「採用」するとキャプション欄に入ります（仕上がりプレビュー・文字数つき）。採用するまで内容は変わりません。
- 有効にするには環境変数
GEMINI_API_KEY（Google AI Studio で取得。サーバー専用）を設定します。モデルは GEMINI_MODEL（既定 gemini-3.8-flash）で変更できます。
- 送信するのは、入力した文章・店舗名・投稿先・タイトル・出演者の表示名のみ。写真・動画は送りません。1ユーザー1分10回まで。
- 自動投稿（Instagram Graph API / TikTok Content Posting API）は未実装です。パスワードを預けての自動操作は規約違反・乗っ取りの危険があるため作りません。
過去素材置き場とGoogleドライブ連携
- 「素材」→「過去素材置き場」は、ドライブ等に保管している過去素材へのリンク台帳です（素材の在庫・使用数には含みません）。1件ずつの登録と、ドライブのフォルダからの一括取り込み（ファイル名・サムネイル・キャスト推定つき）ができます。
- 一括取り込みの設定手順は docs/GOOGLE_DRIVE_SETUP.md。サービスアカウント方式で、読み取り専用です。
