AI が恋愛の意思決定を肩代わりし、親友キャラクター「タイマン」がユーザーの背中を押すスマホ向け Web アプリ（PWA）。
ハッカソン猪俣チーム（team-dlc-4）の AI-DLC（AI-Driven Development Lifecycle）プロジェクト。
このアプリは「人をダメにする」目的で存在します。
世の中に存在する悩みの中でもとりわけ多い「恋愛」——その中での意思決定を徹底的に省くことで、超お手軽な恋愛をユーザーにお届けします。
その結果、ユーザーは悩んだり努力したりすることなく恋愛を楽しんでしまう、**「ダメダメ恋愛人間」**になります。
「誰と付き合うべきか」「いつ告白すべきか」「何をメッセージすべきか」——本来は自分で悩み、向き合うべき問いを、AI が断定的に肩代わりする。親友キャラクター「タイマン」が友達口調で背中を押すことで、ユーザーから "考える工程" そのものを奪う。それがこのアプリの提供する究極の体験です。
具体的な機能要件・非機能要件は aidlc-docs/inception/requirements/requirements.md を参照。
team-dlc-4/
├── README.md # 本ファイル（プロジェクト全体の入口）
├── CLAUDE.md # AI-DLC ワークフロー定義（AI への指示）
├── VERSION # プロジェクトバージョン
│
├── .aidlc-rule-details/ # AI-DLC ルール詳細（フェーズ別実行手順）
│
├── aidlc-docs/ # 📄 AI-DLC ドキュメント（CONSTRUCTION 前の唯一の真実）
│ ├── aidlc-state.md # ステージ進捗・補完履歴・Extension 設定
│ ├── audit.md # 全ユーザー入力・AI 応答のタイムスタンプ付き監査ログ
│ ├── inception/ # 🔵 INCEPTION フェーズ成果物（要件・設計）
│ │ ├── requirements/ # 要件定義（FR / NFR）
│ │ ├── user-stories/ # ペルソナとユーザーストーリー
│ │ ├── application-design/ # コンポーネント・データモデル・ユニット定義
│ │ └── plans/ # 実行計画・各ステージのプラン
│ ├── construction/ # 🟢 CONSTRUCTION フェーズ成果物（未着手）
│ └── operations/ # 🟡 OPERATIONS フェーズ（プレースホルダー）
│
├── mock/ # フロントエンドモック（HTML / CSS / JS）
│ ├── index.html # トップページ
│ ├── matched.html # マッチング画面
│ ├── message.html # メッセージ画面
│ ├── dateplan.html # デートプラン画面
│ ├── confession.html # 告白判定画面
│ ├── profile.html # プロファイル画面
│ ├── style.css # 共通スタイル
│ ├── mockData.js # ダミーデータ
│ ├── pcnav.js # PC ナビゲーション
│ ├── taiman.js # タイマンキャラクター制御
│ └── taiman.png # タイマンキャラクター画像
│
├── Tie-Man.png # タイマンキャラクター素材
└── WhiteBoard.png # 設計時のホワイトボード画像（コンセプト元）
INCEPTION フェーズ（要件定義・設計）の全成果物を格納する。CONSTRUCTION フェーズ着手前は、本ディレクトリが唯一の真実となる。
| ファイル ／ ディレクトリ | 役割 |
|---|---|
aidlc-state.md |
全ステージの進捗・Extension 設定（Security/PBT）・INCEPTION 補完履歴を記録 |
audit.md |
ユーザー入力と AI 応答のタイムスタンプ付き完全ログ（追記専用） |
inception/ |
INCEPTION フェーズの全成果物 |
construction/ |
CONSTRUCTION フェーズの成果物（未着手） |
operations/ |
OPERATIONS フェーズ（プレースホルダー） |
要件定義・ユーザーストーリー・アプリケーション設計など、**「何を作るか／なぜ作るか」**を定義するドキュメント群。
| サブディレクトリ | 役割 | 主要ファイル |
|---|---|---|
requirements/ |
機能要件・非機能要件 | requirements.md |
user-stories/ |
ペルソナとユーザーストーリー（10 本） | stories.md ／ personas.md |
application-design/ |
アーキテクチャ・コンポーネント・データモデル・ユニット定義 | application-design.md（統合 index） |
plans/ |
実行計画・各ステージのプラン | execution-plan.md |
ハッカソン用のフロントエンドモック（静的 HTML/CSS/JS）。Next.js 実装前のデザイン検証用。
AI-DLC ワークフローの各フェーズ・各ステージの詳細実行手順が格納されたディレクトリ。CLAUDE.md からこれらを参照して AI が動作する。
| フェーズ | 状態 | 備考 |
|---|---|---|
| 🔵 INCEPTION | ✅ 完了（4 回の補完済み） | 要件・ストーリー・設計すべて確定 |
| 🟢 CONSTRUCTION | ⏳ 未着手 | 次のステージ |
| 🟡 OPERATIONS | — | プレースホルダー |
詳細は aidlc-docs/aidlc-state.md を参照。
| レイヤー | 採用技術 |
|---|---|
| フロントエンド | Next.js PWA（TypeScript） ／ Zustand ／ AWS Amplify Hosting |
| バックエンド | Python FastAPI（AWS Lambda Web Adapter） ／ API Gateway (REST) |
| AI | Anthropic Claude API（Prompt Caching 活用） |
| データベース | Amazon DynamoDB（KMS Customer Managed Key 暗号化） |
| Secrets 管理 | AWS Secrets Manager |
| 認証 | Amazon Cognito User Pool（本番） ／ 匿名セッション（デモ） |
| IaC | AWS CDK (TypeScript) |
| ロギング | Amazon CloudWatch Logs（マスキング適用） |
| バッチ | AWS Lambda + Amazon EventBridge（リテンション・本番） |
requirements/requirements.md— 機能要件 FR-01〜FR-07・非機能要件 NFR-01〜NFR-06user-stories/stories.md— ユーザーストーリー US-01〜US-10
application-design/application-design.md— システム全体構成図・統合 indexapplication-design/data-model.md— ドメインモデル・DynamoDB スキーマ・データライフサイクルapplication-design/component-dependency.md— 依存関係マトリクス・データフロー図 6 種・AWS インフラ依存
application-design/unit-of-work.md— Unit 1〜3 の責務・コンポーネント・コード配置application-design/unit-of-work-dependency.md— ユニット間依存・Day 1 合意事項・クリティカルパスapplication-design/unit-of-work-story-map.md— ストーリー × ユニットマッピング・優先順位
バックエンド担当 1 名:
└ Unit 3 インフラ立ち上げ（CDK で DynamoDB / KMS / Secrets / Lambda 雛形デプロイ）
全員同時並行:
├ OpenAPI 仕様レビュー
└ data-model.md の型を信頼してコーディング開始
その後（並行開発）:
フロント 2 名 → Unit 1（API モックで先行）
バックエンド 2 名 → Unit 2（Routers / Services / Collectors / Repositories / Filters）
＋ インフラメンテ
詳細は unit-of-work-dependency.md §クリティカルパス を参照。
本プロジェクトは AI-DLC（AI-Driven Development Lifecycle）に従って進めている。AI が要件定義から設計まで段階的にユーザーと対話しながら成果物を生成・補完する。
ワークフロー定義は CLAUDE.md にあり、フェーズ別の詳細手順は .aidlc-rule-details/ に格納されている。
| Extension | デモ | 本番 | 用途 |
|---|---|---|---|
| Security Baseline | ❌ 無効 | ✅ 有効 | OWASP Top 10 対応・データ暗号化等 |
| Property-Based Testing | ✅ 有効 | ✅ 有効 | AI 判定ロジックへの PBT 適用（NFR-04） |
ただし、Security Baseline 無効でも NFR-03-A の最低限セキュリティ要件 S1〜S10 は必須実装（API キー保護・KMS 暗号化等）。詳細は requirements.md NFR-03-A を参照。
要配慮個人情報（生体データ・位置情報）を扱うため、改正個人情報保護法に準拠した取扱いを設計に組み込んでいる。
- NFR-03-A: ハッカソンデモでも守る最低限セキュリティ S1〜S10
- NFR-05: プライバシー UI 表示制御（生数値・位置履歴の UI 露出禁止）
- NFR-05-B: 要配慮個人情報の取扱い B1〜B6（同意取得・利用目的限定・保持期間・削除権・Claude API 送信制限）
詳細は requirements.md を参照。
本プロジェクトはハッカソン用途で開発されている。第三者ライブラリのライセンスは各依存先に従う。