fastapi-ddd-guidelines

DDDアーキテクチャでFastAPIのバックエンドを新规実装または既存コードベースをrifァクタringuする际のガイド。reイヤー构成(域/应用程序/基础设施/控制oller)、依存方向、责务边界、pydantic/sqlalchemy(sqlmodel)/alembic/pytestの前提、セッション管理(取决于で1rikエsuto1セsション、必要时UoW)を含む。

📖 中文导读:DDDアーキテクチャでFastAPIのバックエンドを新规実装または既存コードベースをrifァクタringuする际のガイド。reイヤー构成(域/应用程序/基础设施/控制oller)、依存方向、责务边界、pydantic/sqlalchemy(sqlmodel)/alembic/pytestの前提、セッション管理(取决于で1rikエsuto1セsション、必要时UoW)を含む。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: fastapi-ddd-guidelines description: DDDアーキテクチャでFastAPIのバックエンドを新規実装または既存コードベースをリファクタリングする際のガイド。レイヤー構成(domain/application/infrastructure/controller)、依存方向、責務境界、pydantic/sqlalchemy(sqlmodel)/alembic/pytestの前提、セッション管理(Dependsで1リクエスト1セッション、必要時UoW)を含む。

FastAPI DDD Guidelines

目的

  • FastAPIでDDD構成のバックエンドを設計/実装/リファクタリングする手順と判断基準を提供する
  • レイヤー責務と依存方向を明確化する
  • セッション管理とトランザクション境界を標準化する

使い方

  1. 依頼内容が「新規実装」か「リファクタリング」かを明確化する
  2. 必要に応じて references/ を読む(下記参照)
  3. レイヤー構成・依存方向・責務の合意を作成する
  4. 具体的なディレクトリ構成・実装方針・コード例を示す

参照ファイル

  • レイヤー責務と依存方向のルール: references/layers.md
  • セッション管理/UoW/トランザクション: references/session-uow.md
  • 実装テンプレ/ディレクトリ構成例: references/templates.md

実行ガイド

  • まず references/layers.md を読み、責務/依存方向/配置ルールを回答の土台にする
  • セッションやトランザクション境界を求められる場合は references/session-uow.md を読む
  • 新規実装やリファクタリングで具体的な構成が必要なら references/templates.md を読む
  • 出力は日本語、簡潔かつ具体的に