私のマニュアル「そなえ」さん（MVP）
予定を入れるだけで準備リストを自動生成し、編集を学習して「自分専用マニュアル」に育てるアプリ。
検証用プロトタイプ。詳細仕様は docs/CLAUDE.md。デプロイ手順は docs/デプロイ手順.md。
本番に影響しないテスト環境（別 URL・別 DB）の作り方は docs/テスト環境構築手順.md、
テスト環境自体の仕様は docs/機能仕様_テスト環境_エンジニア向け.md、
本番との今の差分は docs/機能仕様_本番との差分_エンジニア向け.md。
技術スタック
- Next.js 16 (App Router) + TypeScript / Tailwind CSS v4
- Prisma + PostgreSQL（本番 = Neon 無料枠。ローカルも Neon 接続文字列を使用）
- Google Calendar API + OAuth 2.0（
googleapis、スコープ calendar.readonly）
- 準備リスト生成: OpenAI API（
gpt-4o-mini、未設定時はカテゴリ別テンプレート）
- 通知: Web Push（PWA / Service Worker +
web-push + VAPID）
- 新規予定の検知: GitHub Actions（
.github/workflows/poll.yml）が数分おきに /api/cron/poll を叩く
- ホスティング: Vercel（無料 Hobby）。
vercel.json で関数リージョンを syd1（Neon と同じシドニー）に固定し DB 往復を短縮
パフォーマンス上の設計
- Vercel 関数と Neon を同一リージョン（Sydney）に配置（
vercel.json の regions）。
併せて Vercel の Project → Settings → Functions → Region も Sydney (syd1) にしておくと確実。
- レイアウトはログイン判定に DB を使わない（Cookie 署名のみ）。
getCurrentUser は React cache で1リクエスト1回。
- ダッシュボードの警告集計は N+1 を廃し、まとめクエリ。一覧は必要カラムだけ
select。
- 各ページに
loading.tsx（スケルトン）を置き、遷移を即時に感じられるように。
- OpenAI 呼び出しはタイムアウト付き。準備リスト初回生成と cron は
maxDuration = 60。
ローカル開発
npm install
cp .env.example .env # DATABASE_URL / DIRECT_URL に Neon の接続文字列を入れる
npm run db:deploy # Neon にテーブル作成（初回・スキーマ変更時）
npm run dev # http://localhost:3000
Google 連携なしで試すには、トップページの「開発用ログイン」（本番では自動的に無効）。
環境変数（.env / .env.example 参照）
| 変数 | 用途 |
|---|
DATABASE_URL | Neon の Pooled 接続文字列（アプリ実行用） |
DIRECT_URL | Neon の Direct 接続文字列（マイグレーション用） |
SESSION_SECRET | セッション Cookie 署名鍵（長いランダム文字列） |
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET | Google Cloud Console の OAuth クライアント |
GOOGLE_REDIRECT_URI | <APP_BASE_URL>/api/auth/google/callback。Console にも同値を登録 |
OPENAI_API_KEY / OPENAI_MODEL | 準備リスト生成。未設定でもテンプレートで動作 |
APP_BASE_URL | 公開 URL（OAuth・通知リンク・cron が使用） |
VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY / VAPID_SUBJECT | Web Push。npx web-push generate-vapid-keys |
CRON_SECRET | /api/cron/poll を叩くときの共有シークレット |
ENABLE_DEV_LOGIN | 本番で開発用ログインを使いたいときだけ true |
モバイル / PWA
- レスポンシブ。モバイルは下部タブバー、デスクトップは上部ナビ。
public/manifest.webmanifest + public/icons/* で「ホーム画面に追加」に対応（display: standalone）。- iOS は Safari で「ホーム画面に追加」して開いた場合のみ Web Push を受信可（iOS 16.4+）。Android は通常のブラウザで可。
通知の仕組み
- ユーザーが設定画面で「通知をオンにする」→ ブラウザが購読を作成 →
PushSubscription に保存。
- GitHub Actions が
/api/cron/poll（x-cron-secret 必須）を数分おきに叩く → 全ユーザーのカレンダーを syncUserCalendar で取り込み。
- 新規予定が見つかったユーザーの全端末へ Web Push（初回同期時は送らない）。
- 手動の「カレンダーから取り込む」ボタンでも新規分だけ通知。
デプロイ
docs/デプロイ手順.md に、Neon → Google Console → Vercel → GitHub Actions →
スマホ設定まで、コピペ値つきの詳細手順があります。
スクリプト
| コマンド | 内容 |
|---|
npm run dev | 開発サーバー |
npm run build | prisma generate + next build |
npm start | 本番サーバー |
npm run db:migrate | prisma migrate dev（スキーマ変更時） |
npm run db:deploy | prisma migrate deploy |
