go-clean のアーキテクチャ

go-clean のアーキテクチャ Archify で生成されたアーキテクチャ図です。 APIクライアント · HTTP / JSON · アーキテクチャコンポーネント APIクライアント HTTP / JSON HTTP Handler · adapter/handler · アーキテクチャコンポーネント HTTP Handler adapter/handler ユースケース · UserUsecase · アーキテクチャコンポーネント ユースケース UserUsecase Repository · UserRepository / TxManager · アーキテクチャコンポーネント Repository UserRepository / TxManager PostgreSQL 16 · users テーブル · アーキテクチャコンポーネント PostgreSQL 16 users テーブル ドメイン · User / Email / ID · アーキテクチャコンポーネント ドメイン User / Email / ID 起動・DI · cmd/api/main.go · アーキテクチャコンポーネント 起動・DI cmd/api/main.go 技術基盤 · config / database / logger · アーキテクチャコンポーネント 技術基盤 config / database / logger HTTP Create / Get port 経由で呼出 SQL / pgx 生成・検証 DI・サーバ起動 設定・接続・ログ初期化 *sql.DB を供給 凡例 バックエンド データベース 外部システム

矢印の読み方

  • • 実線は実行時の呼出、破線は起動時の組み立て。
  • • import は handler → usecase → domain。repository → usecase / domain。

依存性逆転とトランザクション

  • • usecase/port.go が UserRepository と TxManager を定義。
  • • UserUsecase.Create は重複確認と INSERT を TxManager.Do で囲む。

HTTP と永続化の境界

  • • POST /users、GET /users/:id。GET /healthz は router 内で完結。
  • • handler が DTO・HTTPエラー変換、repository が SQL・復元を担当。