ストーリー

アーキテクチャ標準の3つのレベル

原則（Principles）

組織が採用すべきアーキテクチャ原則

原則の依存関係:

APIファースト ──→ 疎結合 ──→ データ所有権
      │                         │
      └──→ 環境非依存            └──→ フェイルファスト
                                       │
オブザーバビリティ ←─────────────────────┘
                                       │
                 冪等性 ←──────────────┘

パターン（Patterns）

サービスアーキテクチャパターン

サービス内部のアーキテクチャパターン

推奨するプロジェクト構造（Go + ヘキサゴナル）

service-name/
├── cmd/
│   └── server/
│       └── main.go              # エントリポイント
├── internal/
│   ├── domain/                  # ドメイン層
│   │   ├── entity/             # エンティティ
│   │   ├── valueobject/        # 値オブジェクト
│   │   └── port/               # ポート（インターフェース）
│   │       ├── in/             # 入力ポート（ユースケース）
│   │       └── out/            # 出力ポート（リポジトリ等）
│   ├── application/            # アプリケーション層
│   │   └── usecase/            # ユースケース実装
│   └── adapter/                # アダプター層
│       ├── in/                 # 入力アダプター（HTTP/gRPC）
│       └── out/                # 出力アダプター（DB/外部API）
├── pkg/                        # 公開パッケージ
├── api/                        # API定義（OpenAPI/Proto）
├── deployments/                # デプロイ設定
└── docs/                       # ドキュメント

規約（Conventions）

API設計規約

エラーコード体系

エラーコード体系:

形式: {サービスコード}-{カテゴリ}-{連番}

サービスコード:
├── USR: User Service
├── PRD: Product Service
├── ORD: Order Service
└── NTF: Notification Service

カテゴリ:
├── VAL: Validation Error（400系）
├── AUT: Authentication Error（401）
├── FRB: Forbidden Error（403）
├── NTF: Not Found Error（404）
├── CNF: Conflict Error（409）
└── INT: Internal Error（500系）

例: USR-VAL-001 = User ServiceのValidation Error #001

ログ標準

アーキテクチャ標準の適用ガイド

新規サービス vs 既存サービス

「アーキテクチャ標準は”設計図”ではなく”地図”だ。目的地への行き方は複数あるが、どの道を通っても迷わないようにするのが標準の役割だ」 — 田中VPoE

まとめ

チェックリスト

• アーキテクチャ標準の3レベル（原則・パターン・規約）を理解した
• 組織が採用すべきアーキテクチャ原則を理解した
• 推奨パターンの使い分けを理解した
• API設計規約・エラーコード・ログ標準の設計方法を理解した

次のステップへ

次は「品質標準とコーディング規約」を学びます。コードの品質を組織全体で底上げするための品質基準とコーディング規約の設計方法を身につけましょう。

推定読了時間: 30分