設計概念

詳細は メモ — 開発手法。AI 協働フロー本体とは別レイヤ。

レイヤ構成 (Interface / Application / Domain / Infrastructure)

DDD でよく使う 4 層。Domain は他レイヤに依存しない。

• Interface: REST / GraphQL / CLI 等
• Application: ユースケース 運用
• Domain: 業務ロジック・エンティティ・値オブジェクト
• Infrastructure: DB・外部 API 等

依存逆転 / 依存性逆転原則 (DIP)

抽象 (Protocol / Interface) に依存させ、Domain が Infrastructure に依存しないようにする。

実装の語彙

Pure function

副作用なし。同じ入力 → 同じ出力。テスト・並列実行しやすい。

値オブジェクト (Value Object)

アイデンティティを持たない不変オブジェクト。Python では @dataclass(frozen=True) が多い。

業務例外 / 技術例外

業務ルール違反（WARNING）とインフラ起因（ERROR）を分離する方針。

Protocol / Interface

抽象化の呼び名違い。Python は typing.Protocol、Java/TS は implements。

---