Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
- **写真アップロード**(UploadThing もしくは Vercel Blob、薄いラッパー経由で差し替え可能に)
- テイスティング記録(味の評価・レーダーチャート)
- AI「今夜の 1 杯」提案(自分のボトルデータに基づく。**主役にしない**)
- フィルタ・並べ替えの強化
- フィルタ・並べ替えの強化(複数軸ファセット)
Comment thread
coderabbitai[bot] marked this conversation as resolved.

### アイスボックス(将来枠・未定 / やるかも)

Expand All @@ -49,6 +49,8 @@
- 店で出会ったウイスキーの地図記録(Google map API)
- **バーコードスキャン**(スピリッツのバーコード DB が貧弱で、父が重視する限定版・樽違いをほぼ判別できない?)
- 価格の外部 API 取得
- あいまい検索(誤字許容。個人利用では過剰気味)
- 無限スクロール(難易度の割にコスパが低い。ページングは「もっと見る」で足りる)

### やらないこと(今のところ)

Expand All @@ -65,7 +67,7 @@

## 5. 非機能要件

- **対応環境**:モバイルブラウザ中心(PC でも崩れない程度)。最新の Chrome / Safari 想定。
- **対応環境**:モバイルファーストで作りつつ、PC でも見やすいレスポンシブ対応(ポートフォリオとして PC 閲覧される想定)。最新の Chrome / Safari 想定。
- **認証**:Google OAuth。パスワードは保持しない。
- **規模 / 性能**:個人利用(数十〜数百件)。過剰な最適化はしない。
- **保守性**:スタック内で完結(Next.js / Prisma / Postgres / Vercel)。
Expand Down
20 changes: 10 additions & 10 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@

## マイルストーン(週次)

| 期間 | マイルストーン | 主な作業 | 対応ストーリー |
| ---------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
| Sprint 0(設計) | 計画が固まる | 要件概要・ユーザーストーリー・データモデル・ロードマップ・ADR を Markdown で整備(=本ドキュメント群) | — |
| 準備(〜2 日) | 土台が立つ | `create-next-app`(TS)/ESLint・Prettier・tsconfig strict/`.env.example` 作成/GitHub Issues・Projects 起票/Vercel・Neon 接続/Prisma 初期化 | — |
| 第 1 週 | 認証と DB の土台 | Prisma スキーマ(User・Bottle)+マイグレーション/Better Auth で Google ログイン・ログアウト・保護ルート(セッション戦略・保護方式は現行の公式推奨を確認して決定)/空のボトル一覧ページ(プレースホルダ=ログイン後の着地点)/「自分のデータだけ」の基盤 | US-1 |
| 第 2 週 | ボトル CRUD(芯の本体) | 登録フォーム(zod・必須は銘柄名)/一覧(モバイルファースト・空状態)/詳細/編集/削除(確認・所有権)/Route Handlers(書き込み)+認可・読みは Server Component 直読み/**重要ロジック(zod・認可)の単体・結合テストを実装と併走**(→ `CONTRIBUTING.md` テスト方針) | US-2〜US-6 |
| 第 3 週 | 可視化 + デプロイ | ダッシュボード(国別の本数グラフ)/モバイル UI 調整/本番デプロイ(Vercel)・動作確認/README を実態に合わせて更新(デプロイ URL 反映) | US-7 |
| 第 4 週 | 品質 + 仕上げ + 父 FB | **E2E(Playwright・主要フロー 1 本)+ テストを細部まで拡充**+ GitHub Actions(CI)※導入時に CLAUDE.md の Commands と PR テンプレへ test を追記/バグ修正・UI 磨き/README 充実(スクショ・デモ GIF)・アーキ図/**父に実際に使ってもらいフィードバック収集**/予備日 | 共通 DoD |
| 期間 | マイルストーン | 主な作業 | 対応ストーリー |
| ---------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| Sprint 0(設計) | 計画が固まる | 要件概要・ユーザーストーリー・データモデル・ロードマップ・ADR を Markdown で整備(=本ドキュメント群) | — |
| 準備(〜2 日) | 土台が立つ | `create-next-app`(TS)/ESLint・Prettier・tsconfig strict/`.env.example` 作成/GitHub Issues・Projects 起票/Vercel・Neon 接続/Prisma 初期化 | — |
| 第 1 週 | 認証と DB の土台 | Prisma スキーマ(User・Bottle)+マイグレーション/Better Auth で Google ログイン・ログアウト・保護ルート(セッション戦略・保護方式は現行の公式推奨を確認して決定)/空のボトル一覧ページ(プレースホルダ=ログイン後の着地点)/「自分のデータだけ」の基盤 | US-1 |
| 第 2 週 | ボトル CRUD(芯の本体) | 登録フォーム(zod・必須は銘柄名)/一覧(モバイルファースト・空状態)/詳細/編集/削除(確認・所有権)/Route Handlers(書き込み)+認可・読みは Server Component 直読み/**重要ロジック(zod・認可)の単体・結合テストを実装と併走**(→ `CONTRIBUTING.md` テスト方針) | US-2〜US-6 |
| 第 3 週 | 可視化 + デプロイ | ワイヤーフレーム作成 ↔︎ ドキュメント整理/一覧の再設計(基本フィルタ〔単一軸〕・基本検索〔名前の部分一致〕・Load More ページネーション)/ダッシュボード(国別の本数グラフなど)/モバイル UI 調整・レスポンシブ(PC)対応/本番デプロイ(Vercel)・動作確認/README を実態に合わせて更新(デプロイ URL 反映) | US-3・US-7 |
| 第 4 週 | 品質 + 仕上げ + 父 FB | **E2E(Playwright・主要フロー 1 本)+ テストを細部まで拡充**+ GitHub Actions(CI)※導入時に CLAUDE.md の Commands と PR テンプレへ test を追記/バグ修正・UI 磨き/README 充実(スクショ・デモ GIF)・アーキ図/**父に実際に使ってもらいフィードバック収集**/予備日 | 共通 DoD |

> **MVP 完了の定義**:第 3 週末に「Google ログイン → ボトルを登録・一覧・編集・削除 → 傾向グラフ」が本番 URL で一通り動く。

Expand All @@ -34,15 +34,15 @@
1. 写真アップロード(UploadThing もしくは Vercel Blob)
2. テイスティング記録(味の評価・レーダーチャート)
3. AI「今夜の 1 杯」提案(自分のボトルデータに基づく)
4. フィルタ・並べ替えの強化
4. フィルタ・並べ替えの強化(複数軸ファセット)

> **開発インフラ(任意)**:ローカル DB を `docker-compose` でコンテナ化(本番=Neon、ローカル=コンテナ)。MVP には不要で、Docker 学習・環境分離の signal として芯の後に検討。デプロイの Docker 化はしない(Vercel 運用のため不要)。

## アイスボックス(やるかも・未定)

> 日付なし。やるとは限らない置き場。詳細は要件概要を参照。

ラベル写真から AI 自動入力 / 蒸留所の地図表示 / 歴史表示 / 実績バッジ / ウィッシュリスト / 読み取り専用の公開ページ / 店で出会ったウイスキーの地図記録
ラベル写真から AI 自動入力 / 蒸留所の地図表示 / 歴史表示 / 実績バッジ / ウィッシュリスト / 読み取り専用の公開ページ / 店で出会ったウイスキーの地図記録 / あいまい検索 / 無限スクロール

## 参考:ガント(仮・開始日に合わせて調整)

Expand Down
3 changes: 3 additions & 0 deletions docs/user-stories.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,9 @@
- [ ] 自分のボトルが一覧で表示される(銘柄名・国・地域・年数・本数・限定版バッジ)
- [ ] スマホ画面で崩れず見やすい(モバイルファースト)
- [ ] 0 件のとき「まだ登録がありません」などの空状態が表示される
- [ ] 国で絞り込みできる
- [ ] 名前で検索できる
- [ ] 「もっと見る」で追加読み込みできる
Comment thread
coderabbitai[bot] marked this conversation as resolved.

## US-4 ボトルの詳細を見る

Expand Down
Loading