API エンドポイント作成パターン

このプロジェクトのAPI実装パターンを定義します。

アーキテクチャ

4層構成。Handler は Usecase を保持し、Service を直接持たない。Service は Handler から直接呼ばず、Usecase 経由で呼ぶ。

Handler (API層) → Usecase (アプリケーションロジック) → Service (ビジネスロジック) → Repository (データアクセス)

使用フレームワーク

• Echo: HTTPルーター
• Huma v2: OpenAPI対応のAPIフレームワーク
• humaecho: EchoとHumaのアダプター

ディレクトリ構成