メインコンテンツまでスキップ

アーキテクチャ設計

Bazbiiシステムの設計思想と全体構造を説明します。 このセクションは、新しい機能の設計や技術判断を行う際の基盤となる情報を提供します。

セクション一覧​

設計概要​

要件・意思決定​

設計原則​

1. クリーンアーキテクチャ​

  • server-core: ビジネスロジックとドメインモデル。外部依存なし
  • server-platform: インフラストラクチャの実装（DB、ログ、認証など）
  • server-apps: アプリケーションのエントリーポイント。依存注入のコンポジションルート

2. 依存方向の制御​

  • 依存は一方向のみ
  • server-coreはserver-platformやserver-appsに依存しない
  • インターフェースを通じて結合度を下げる

3. プロトコル設計​

  • 外部API: Connect RPC (HTTP/JSON)
  • 内部通信: gRPC
  • コントラクト: Protocol Buffersで定義

主要な設計判断​

システムの設計に関する重要な判断は、アーキテクチャ意思決定記録 (ADR)に詳細に記録されています。

主な決定事項​

関連ドキュメント​