用途:指导开发者用 Clean Architecture 原则构建 FastAPI 后端应用,适用于新建项目、重构既有 FastAPI 代码、实现领域驱动设计,以及集成 PostgreSQL、Redis、外部 API 等多数据源。
主要能力:提供三层架构模板(src/api、src/domain、src/infra),明确各层职责——API 层负责路由、Pydantic DTO、校验与中间件;领域层包含实体、值对象、抽象服务与仓储接口、业务规则和领域异常,且不依赖框架;基础设施层负责 SQLAlchemy 仓储、外部适配器、Redis 缓存与服务实现。依赖流向为 API → Domain ← Infrastructure,领域层绝不导入 API 或基础设施。
用法:通过领域实体、仓储接口、服务接口、具体仓储实现、具体服务实现、依赖注入容器、API 端点、Pydantic DTO 等模式示例,展示从抽象到落地的组织方式。依赖注入使用 dependency_injector 的 providers 与 Provide/inject 装配数据库会话、仓储和服务。测试策略覆盖领域层单元测试与基础设施层服务测试。
限制:资料未提供安装命令、收费信息、价格或平台支持范围。示例中的 CPF 校验为巴西税务标识,非通用场景需自行替换。使用前需具备 Python、FastAPI、SQLAlchemy、Pydantic 与依赖注入相关基础。