infra(compose): E2E 動作確認手順 + ログ証跡(Phase 1 Setup 1 完了判定)

[win2cot]

Phase 1 Setup 1-7: E2E 動作確認手順 + ログ証跡

概要

Setup 1-1〜1-6 の成果が結合して動作することを E2E で確認し、結果をログ / スクリーンショット / コメントで証跡として記録する。Phase 1 Setup 1 の完了判定 + Phase 1 Sprint 0 着手の前提確認も兼ねる。

詳細仕様: docs/architecture/infrastructure-plan.md v5 §5.2 受入条件。

背景

Setup 1-1〜1-6 が個別 PR で merge されても、それらが組み合わさって「ログイン → JWT 取得 → API call が成功する」状態を確認していない。本 Issue で結合動作を保証する。

成果は docs/dev/local-setup.md の §8(E2E)と整合させ、再現可能性を担保する。

実装内容

A. E2E シナリオ実行

下記を順に実行し、各 step の結果を記録(スクショ / ログ output):

1. docker compose -f docker-compose.local.yml up -d で MySQL + Keycloak 起動
2. source .env.local && ./gradlew :webapi:bootRun で tasks-webapi 起動
   • Flyway migration ログ確認(flyway_schema_history、users、tasks テーブル作成)
3. ブラウザで http://localhost:8080(Keycloak admin console)→ admin login OK
4. tasks realm 確認 → Test User 4 名存在
5. web/index.html を軽量 HTTP サーバで配信、ブラウザでアクセス
6. 未ログイン状態 → Keycloak login redirect
7. tenant1-member1@example.com でログイン → callback 戻り
8. ブラウザの localStorage / sessionStorage に JWT 保存確認
9. GET /api/auth/me(または当該 endpoint)を Authorization: Bearer <jwt> で呼び出し → 200 応答(api/auth/me 未実装の場合は actuator /actuator/health で代替確認)
10. JWT デコードで realm_access.roles に MEMBER が含まれること確認

B. 証跡記録

下記のいずれかの方法で記録:

• 本 Issue のコメントにステップごとの結果(✓ / ✗ + 短いログ抜粋)
• docs/reviews/2026-MM-DD-phase1-setup1-e2e.md(専用 review ノート、ADR ライクに)

C. 失敗時のリカバリー手順

E2E が失敗したら:

• 失敗 step を特定し、関連する Setup 1-X Issue を reopen(または follow-up Issue 起票)
• トラブルシュート手順を docs/dev/local-setup.md §9 に追記

受入条件

• 上記 E2E 10 step が全て成功
• 結果が本 Issue コメント or docs/reviews/... に証跡として残っている
• 失敗ステップがあれば原因究明 + follow-up Issue 起票完了
• docs/dev/local-setup.md の §8 E2E 手順が本 Issue の結果と整合
• Phase 1 Setup 1 Milestone(#4)の closed 候補状態(全サブ Issue closed)

想定影響範囲

• Phase 1 Sprint 0([Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121)着手の前提確認(本 E2E が green であること)
• Phase 1 Sprint 1 Infra で AWS dev 環境を構築する際の比較ベースライン

関連

• 親 tracker Issue: [Phase 1 Infra] Setup 0-2 + Sprint 0-5 Infra ストリーム横断 tracker #206
• Milestone: Phase 1 Setup 1(due 2026-06-13)
• 依存: Setup 1-1〜1-6 すべて完了後
• 隣接: Setup 1-6(setup guide)、Phase 1 Sprint 0([Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121)
• 詳細仕様: docs/architecture/infrastructure-plan.md v5 §5.2 受入条件

備考

• task-type: task-type:design(動作確認 + 証跡記録)
• 優先度: priority/p2(Setup 1-1〜1-6 完了後)
• area: area/infra + area/docs

[claude-automation-impl]

着手宣言 + 実装方針

実施内容

本 Issue は task-type:design のため、以下の方針で進めます。

可能な検証(CI 環境内)

1. Gradle ビルド確認(:webapi:check)
2. 設定ファイルの静的検証(docker-compose.local.yml / application.yml / tasks-realm.json / web/index.html)
3. Flyway マイグレーション SQL の存在確認

ドキュメント成果物

• docs/reviews/2026-05-24-phase1-setup1-e2e.md を作成し、E2E 手順・静的検証結果・ローカル実行時の期待値を記録
• docs/dev/local-setup.md §8 が本 Issue の手順と整合しているか確認・更新

CI 環境の制約

Docker / ブラウザが不要な範囲(ビルド・静的解析)は本 PR 内で完結させます。
Docker Compose 起動 → Keycloak ブラウザ操作 → JWT 取得フローは、ローカル実行者向けの手順と期待値を docs/reviews/ に文書化することで代替します。