VS Code + Cline で ”Devin 風”開発を行う方法⑨ - ローカル優先・クラウド補完の自律開発ループを完成させる

## T0009: CampGround エンティティと Repository interface 作成

Status: DONE

### Purpose (目的)

Campgrounds ドメインのエンティティとリポジトリインターフェースを作成してください。

既存の User エンティティ（T0001〜T0007）の実装を参考にし、
Clean Architecture のパターンに従って実装してください。

### TargetFiles (変更対象)

- app/src/domain/Entities/CampGround.php
- app/src/domain/Repositories/CampGroundRepositoryInterface.php
- app/src/domain/Entities/Review.php
- app/src/domain/Repositories/ReviewRepositoryInterface.php

### ReferenceFiles (参照ファイル)

- app/src/domain/Entities/User.php
- app/src/domain/Repositories/UserRepositoryInterface.php
- app/models/campground.php
- app/models/review.php
- app/models/images.php

### ImplementationDetails (実装内容)

- CampGround エンティティを作成する
  - id, title, price, description, location, author, geometry を持つ
  - isOwner(): bool メソッドを実装する
  - getGeoData(): array メソッドを実装する（JSON データ生成）
  - static create(): self ファクトリメソッドを実装する
- CampGroundRepositoryInterface を作成する
  - save(CampGround): CampGround
  - findById(int): ?CampGround
  - findAll(): array
  - update(CampGround): ?CampGround
  - delete(int): bool
- Review エンティティを作成する
  - id, body, rating, camp_id, author を持つ
  - isOwner(): bool メソッドを実装する
  - static create(): self ファクトリメソッドを実装する
- ReviewRepositoryInterface を作成する
  - save(Review): Review
  - findById(int): ?Review
  - findByCampId(int): array
  - delete(int): bool
  - deleteByCampId(int): bool
- ImageSchema は既存の app/models/images.php を参照するが、
  Clean Architecture 側では別の実装を検討する（必要に応じて）

### CompletionConditions (完了条件)

- CampGround エンティティが存在する
- CampGroundRepositoryInterface が存在する
- Review エンティティが存在する
- ReviewRepositoryInterface が存在する
- 各メソッドのシグネチャが正しい
- syntax error がない

### TestDetails (テスト観点)

- 今回はエンティティとインターフェースのみなので、コード実行テストは不要
- メソッドシグネチャと戻り値の型が正しいか確認する

## T0010: CampGround Repository 実装（PDO）

Status: FAILED

### Purpose (目的)

CampGround リポジトリの PDO 実装を作成してください。

既存の PdoUserRepository（T0001〜T0007）の実装を参考にし、
CampGroundQuery の処理をリポジトリパターンへ移行します。

### TargetFiles (変更対象)

- app/src/infrastructure/Db/CampGround/PdoCampGroundRepository.php

### ReferenceFiles (参照ファイル)

- app/src/infrastructure/Db/User/PdoUserRepository.php
- app/db/campgrounds.query.php
- app/models/campground.php

### ImplementationDetails (実装内容)

- PdoCampGroundRepository を作成する
  - CampGroundRepositoryInterface を実装する
  - DataSource を使用して DB アクセスする
  - findById, findAll, save, update, delete を実装する
  - CampGroundSchema::cast() を使って結果をエンティティに変換する
- 画像の保存・削除もリポジトリ内で処理する
  - ImageQuery を内部で呼び出す
- トランザクション処理を実装する
  - save と update ではトランザクションを使用する

### CompletionConditions (完了条件)

- PdoCampGroundRepository が存在する
- CampGroundRepositoryInterface を実装している
- findById, findAll, save, update, delete が実装されている
- トランザクション処理が正しい
- syntax error がない

### TestDetails (テスト観点)

- リポジトリの単体テストは行わない（軽量確認を優先）
- php-lint で構文チェックを行う

## T0011: Campground 登録機能の実装

Status: TODO

### Purpose (目的)

Campground 登録（Create）機能を Clean Architecture 側へ実装してください。

既存の app/controllers/campgrounds.php の createCampground() を
Clean Architecture パターンへ移行します。

### TargetFiles (変更対象)

- app/src/application/UseCases/Campground/CampgroundRegisterInput.php
- app/src/application/UseCases/Campground/CampgroundRegisterOutput.php
- app/src/application/UseCases/Campground/CampgroundRegisterUseCase.php
- app/src/application/UseCases/Campground/CampgroundRegisterUseCaseInterface.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/infrastructure/Bootstrap/container.php

### ReferenceFiles (参照ファイル)

- app/controllers/campgrounds.php
- app/models/campground.php
- app/src/application/UseCases/User/UserRegisterUseCase.php
- app/src/adapter/Controllers/UserController.php

### ImplementationDetails (実装内容)

- CampgroundRegisterInput を作成する
  - title, location, price, description, campgroundImages を持つ
  - バリデーションロジックを含む
- CampgroundRegisterOutput を作成する
  - id(): int を持つ
- CampgroundRegisterUseCaseInterface を作成する
- CampgroundRegisterUseCase を実装する
  - CampGroundRepository を DI する
  - 入力バリデーション
  - 地理座標変換（forwardGeocode）
  - CampGround::create() でエンティティ生成
  - リポジトリへ保存
  - 画像処理（ImageSchema の追加）
  - 例外をスローまたは Output を返す
- CampgroundController を作成する
  - CampgroundRegisterUseCaseInterface を DI する
  - public register(): void メソッドを実装する
  - POST リクエストから入力データを取得
  - UseCase を実行
  - 成功時は flash message + redirect
  - 失敗時は flash message + redirect
- container.php に route と DI 設定を追加する

### CompletionConditions (完了条件)

- CampgroundRegisterUseCase が存在する
- CampgroundController に register() が存在する
- POST /campgrounds が Clean Architecture 側へ流れる
- 登録成功時に flash message と redirect が行われる
- 登録失敗時にエラーメッセージが表示される
- syntax error がない

### TestDetails (テスト観点)

- Codeception で登録機能の HTTP テストを作成する
  - 正常系: 登録成功
  - 異常系: 必須項目欠落
  - 異常系: プライスが数値以外

## T0012: Campground 一覧・詳細表示機能の実装

Status: TODO

### Purpose (目的)

Campground 一覧（Index）と詳細（Show）表示機能を Clean Architecture 側へ実装してください。

既存の view/campgrounds/index.php と view/campgrounds/show.php の
データ取得処理を Clean Architecture 側へ移行します。

### TargetFiles (変更対象)

- app/src/application/UseCases/Campground/CampgroundListUseCase.php
- app/src/application/UseCases/Campground/CampgroundListUseCaseInterface.php
- app/src/application/UseCases/Campground/CampgroundListOutput.php
- app/src/application/UseCases/Campground/CampgroundDetailUseCase.php
- app/src/application/UseCases/Campground/CampgroundDetailUseCaseInterface.php
- app/src/application/UseCases/Campground/CampgroundDetailOutput.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/infrastructure/Bootstrap/container.php

### ReferenceFiles (参照ファイル)

- app/views/campgrounds/index.php
- app/views/campgrounds/show.php
- app/db/campgrounds.query.php
- app/db/reviews.query.php

### ImplementationDetails (実装内容)

- CampgroundListUseCase を作成する
  - findAll() を実行
  - 各 campground に画像情報を付与
  - Output モデルに詰めて返す
- CampgroundDetailUseCase を作成する
  - findById() を実行
  - 関連レビューを取得
  - Output モデルに詰めて返す
- CampgroundController に list() と detail() メソッドを追加する
  - GET /campgrounds -> list()
  - GET /campgrounds/{id} -> detail()
- container.php に route と DI 設定を追加する

### CompletionConditions (完了条件)

- CampgroundListUseCase が存在する
- CampgroundDetailUseCase が存在する
- GET /campgrounds が一覧を表示する
- GET /campgrounds/{id} が詳細を表示する
- レビュー情報が詳細ページに表示される
- syntax error がない

### TestDetails (テスト観点)

- Codeception で一覧・詳細の HTTP テストを作成する
  - 一覧表示が正常に動作する
  - 詳細表示が正常に動作する
  - レビューが表示される

## T0013: Campground 編集機能の実装

Status: TODO

### Purpose (目的)

Campground 編集（Update）機能を Clean Architecture 側へ実装してください。

既存の app/controllers/campgrounds.php の updateCampground() を
Clean Architecture パターンへ移行します。

### TargetFiles (変更対象)

- app/src/application/UseCases/Campground/CampgroundUpdateInput.php
- app/src/application/UseCases/Campground/CampgroundUpdateOutput.php
- app/src/application/UseCases/Campground/CampgroundUpdateUseCase.php
- app/src/application/UseCases/Campground/CampgroundUpdateUseCaseInterface.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/infrastructure/Bootstrap/container.php

### ReferenceFiles (参照ファイル)

- app/controllers/campgrounds.php
- app/models/campground.php
- app/db/images.query.php

### ImplementationDetails (実装内容)

- CampgroundUpdateUseCase を作成する
  - findById() で既存データを取得
  - 存在しない場合は例外をスロー
  - 入力データをマージ
  - 画像の追加・削除処理
  - リポジトリへ保存
- CampgroundController に update() メソッドを追加する
  - PUT /campgrounds/{id} を処理
  - 所有者確認（認可）
  - UseCase を実行
  - 成功/失敗時の flash message + redirect
- container.php に route と DI 設定を追加する

### CompletionConditions (完了条件)

- CampgroundUpdateUseCase が存在する
- CampgroundController に update() が存在する
- PUT /campgrounds/{id} が Clean Architecture 側へ流れる
- 編集成功時に flash message と redirect が行われる
- 非所有者の場合は権限エラーが表示される
- syntax error がない

### TestDetails (テスト観点)

- Codeception で編集機能の HTTP テストを作成する
  - 正常系: 編集成功
  - 異常系: 非所有者
  - 異常系: 存在しない campground

## T0014: Campground 削除機能の実装

Status: TODO

### Purpose (目的)

Campground 削除（Delete）機能を Clean Architecture 側へ実装してください。

既存の app/controllers/campgrounds.php の deleteCampground() を
Clean Architecture パターンへ移行します。

### TargetFiles (変更対象)

- app/src/application/UseCases/Campground/CampgroundDeleteUseCase.php
- app/src/application/UseCases/Campground/CampgroundDeleteUseCaseInterface.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/infrastructure/Bootstrap/container.php

### ReferenceFiles (参照ファイル)

- app/controllers/campgrounds.php
- app/db/campgrounds.query.php

### ImplementationDetails (実装内容)

- CampgroundDeleteUseCase を作成する
  - findById() で既存データを取得
  - 存在しない場合は例外をスロー
  - 所有者確認（認可）
  - リポジトリへ削除依頼
  - 関連画像・レビューも削除されることを確認
- CampgroundController に delete() メソッドを追加する
  - DELETE /campgrounds/{id} を処理
  - 所有者確認（認可）
  - UseCase を実行
  - 成功時は flash message + redirect
  - 失敗時は flash message + redirect
- container.php に route と DI 設定を追加する

### CompletionConditions (完了条件)

- CampgroundDeleteUseCase が存在する
- CampgroundController に delete() が存在する
- DELETE /campgrounds/{id} が Clean Architecture 側へ流れる
- 削除成功時に flash message と redirect が行われる
- 非所有者の場合は権限エラーが表示される
- syntax error がない

### TestDetails (テスト観点)

- Codeception で削除機能の HTTP テストを作成する
  - 正常系: 削除成功
  - 異常系: 非所有者
  - 異常系: 存在しない campground

## T0015: Review 登録・削除機能の実装

Status: TODO

### Purpose (目的)

Review 登録（Create）と削除（Delete）機能を Clean Architecture 側へ実装してください。

既存の app/controllers/reviews.php の createReview() と deleteReview() を
Clean Architecture パターンへ移行します。

### TargetFiles (変更対象)

- app/src/application/UseCases/Campground/ReviewRegisterUseCase.php
- app/src/application/UseCases/Campground/ReviewRegisterUseCaseInterface.php
- app/src/application/UseCases/Campground/ReviewDeleteUseCase.php
- app/src/application/UseCases/Campground/ReviewDeleteUseCaseInterface.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/infrastructure/Bootstrap/container.php

### ReferenceFiles (参照ファイル)

- app/controllers/reviews.php
- app/models/review.php
- app/db/reviews.query.php

### ImplementationDetails (実装内容)

- ReviewRegisterUseCase を作成する
  - CampGroundRepository を DI（存在確認用）
  - ReviewRepository を DI
  - 入力バリデーション
  - Review::create() でエンティティ生成
  - リポジトリへ保存
- ReviewDeleteUseCase を作成する
  - findById() で既存データを取得
  - 存在しない場合は例外をスロー
  - 所有者確認（認可）
  - リポジトリへ削除依頼
- CampgroundController に registerReview() と deleteReview() メソッドを追加する
  - POST /campgrounds/{id}/reviews -> registerReview()
  - DELETE /campgrounds/{id}/reviews/{review_id} -> deleteReview()
- container.php に route と DI 設定を追加する

### CompletionConditions (完了条件)

- ReviewRegisterUseCase が存在する
- ReviewDeleteUseCase が存在する
- POST /campgrounds/{id}/reviews が Clean Architecture 側へ流れる
- DELETE /campgrounds/{id}/reviews/{review_id} が Clean Architecture 側へ流れる
- レビュー登録成功時に flash message と redirect が行われる
- レビュー削除成功時に flash message と redirect が行われる
- 非所有者の場合は権限エラーが表示される
- syntax error がない

### TestDetails (テスト観点)

- Codeception でレビュー機能の HTTP テストを作成する
  - 正常系: レビュー登録成功
  - 正常系: レビュー削除成功
  - 異常系: 非所有者
  - 異常系: 必須項目欠落

## T0016: Campgrounds Router 追加と既存 routes の置き換え

Status: TODO

### Purpose (目的)

Clean Architecture 側の Router に Campgrounds ルートを追加し、
既存 MVC の routes/campgrounds.php からバイパスするように変更してください。

### TargetFiles (変更対象)

- app/src/infrastructure/Bootstrap/container.php
- app/routes/campgrounds.php

### ReferenceFiles (参照ファイル)

- app/src/infrastructure/Http/Router.php
- app/routes/campgrounds.php
- app/controllers/campgrounds.php

### ImplementationDetails (実装内容)

- container.php に CampgroundController の DI 設定を追加する
- Router の routes 配列に Campgrounds ルートを追加する
  - GET /campgrounds
  - POST /campgrounds
  - GET /campgrounds/new
  - GET /campgrounds/{id}
  - PUT /campgrounds/{id}
  - DELETE /campgrounds/{id}
  - GET /campgrounds/{id}/edit
  - POST /campgrounds/{id}/reviews
  - DELETE /campgrounds/{id}/reviews/{review_id}
- routes/campgrounds.php を変更し、
  対応するルートは $router->dispatch() へバイパスする
- GET /campgrounds/new と GET /campgrounds/{id}/edit は
  既存の view 表示を維持する（または Clean Architecture 側で実装）

### CompletionConditions (完了条件)

- CampgroundController が Router 経由で dispatch される
- 全てのルートが正しく動作する
- 既存の campgrounds GET ルートが維持されている
- syntax error がない

### TestDetails (テスト観点)

- Codeception で各ルートの HTTP テストを作成する
  - 全てのルートが正しく dispatch される

## T0017: Campgrounds Feature Test 作成

Status: TODO

### Purpose (目的)

Campgrounds 機能の Clean Architecture 移行後の HTTP レベルの動作を
Codeception Feature Test で確認してください。

### TargetFiles (変更対象)

- app/tests/Codeception

### ReferenceFiles (参照ファイル)

- app/routes/campgrounds.php
- app/src/adapter/Controllers/Campground/CampgroundController.php
- app/src/application/UseCases/Campground/*.php

### ImplementationDetails (実装内容)

- Codeception を使用する
- 実際の HTTP リクエスト経由で campgrounds をテストする
- localhost:8080 で起動しているテスト用アプリケーションを使用する
- 以下のテストを作成する:
  - campground list success
  - campground detail success
  - campground create success
  - campground create validation error
  - campground update success
  - campground update unauthorized
  - campground delete success
  - campground delete unauthorized
  - review register success
  - review register validation error
  - review delete success
  - review delete unauthorized
- Laravel/Pest の HTTP helper は使用しない
- Controller / UseCase の Unit Test への置き換えは禁止

### CompletionConditions (完了条件)

- 全ての Feature Test が存在する
- Codeception コマンドで実行可能
- 全テストが成功する

### TestDetails (テスト観点)

- redirect
- flash message
- 認証・認可
- 画像アップロード
- レビュー表示