go-clean — HTTP から永続化まで

go-clean — HTTP から永続化まで Archify で生成されたアーキテクチャ図です。 API クライアント · HTTP / JSON · アーキテクチャコンポーネント API クライアント HTTP / JSON HTTP 境界 · Gin · UserHandler · DTO · アーキテクチャコンポーネント · POST /users · GET /users/:id HTTP 境界 Gin · UserHandler · DTO POST /users · GET /users/:id UserUsecase · Create / Get · 入出力の変換 · アーキテクチャコンポーネント · HTTP・SQL を import しない UserUsecase Create / Get · 入出力の変換 HTTP・SQL を import しない 永続化アダプター · UserRepository · conn(ctx, db) · アーキテクチャコンポーネント · INSERT · SELECT · SELECT EXISTS 永続化アダプター UserRepository · conn(ctx, db) INSERT · SELECT · SELECT EXISTS PostgreSQL 16 · users · UUID / email UNIQUE · アーキテクチャコンポーネント · postgres:16-alpine · :5432 PostgreSQL 16 users · UUID / email UNIQUE postgres:16-alpine · :5432 起動・手書き DI · cmd/api/main.go · アーキテクチャコンポーネント · http.Server · SIGINT / SIGTERM 起動・手書き DI cmd/api/main.go http.Server · SIGINT / SIGTERM 技術基盤 · config / database / logger · アーキテクチャコンポーネント · *sql.DB を main が注入 技術基盤 config / database / logger *sql.DB を main が注入 User 集約 · User / Email / ID / errors · アーキテクチャコンポーネント · 標準ライブラリのみ · JSON タグなし User 集約 User / Email / ID / errors 標準ライブラリのみ · JSON タグなし TxManager · Do(ctx, fn) · context に *sql.Tx · アーキテクチャコンポーネント · 入れ子は既存 Tx に合流 TxManager Do(ctx, fn) · context に *sql.Tx 入れ子は既存 Tx に合流 HTTP Create / Get port 呼出 SQL / pgx DI・起動 設定・接続・ログ初期化 生成・検証 Do(ctx, fn) 凡例 バックエンド データベース 外部システム

呼び出しと依存方向

  • • 実線=実行時の呼び出し。破線=起動時の初期化・配線。
  • • import は handler → usecase → domain。repository → usecase / domain。
  • • usecase が port を定義し、main がその実装と同じ *sql.DB を注入する。

作成・取得と整合性

  • • 作成:Email / User を検証 → Tx 内で EXISTS・INSERT → Commit → 201。
  • • 取得:ParseID → SELECT → Reconstruct → UserOutput → DTO → 200。
  • • 競合作成は email UNIQUE が防ぎ、SQLSTATE 23505 をドメインエラーへ変換。

HTTP と実行基盤

  • • JSON は最大 1 MiB、未知フィールドを拒否。400 / 404 / 409、未知エラーは 500。
  • • /healthz は router 内で 200 を返す。DB への Ping は起動時に実施。
  • • 接続プール 25 / 25・寿命 5 分。HTTP 5 / 10 / 10 / 60 秒、停止猶予 10 秒。