SuperAPI AI 工具集

django-clean-drf

编程与开发

查看项目

更新于 10-15 19:52

技能介绍

用途:在 Django REST Framework 中按 Clean Architecture 与 SOLID 原则搭建生产质量 API,把 HTTP、应用、领域与基础设施层分离,便于测试与维护。

主要能力:分层依赖只向内流动;用例模式配合 dataclass 的输入/输出 DTO;服务层承载领域逻辑(静态方法做查询、实例方法做变更);视图保持轻薄;读写序列化器分离;业务逻辑用显式返回值而非异常;支持 Python 3.12+ 与 Django 5+ 特性;全量类型注解。

使用方式:按需求先建立上下文,再加载对应参考文档,如 references/project-structure.md、references/use-cases-pattern.md、references/services-pattern.md、references/views-serializers.md、references/testing-clean-arch.md,以及 query-optimization、api-patterns、authentication、production-api、django-admin、coding-standards 等。实现时遵循 View → Use Case → Service → Model 的依赖方向,避免反向导入。用例示例:用 @dataclass(frozen=True, slots=True) 定义输入输出,用 @transaction.atomic 包裹状态变更,校验返回 tuple[bool, str]。

适用场景:新建 Django API 或 DRF 项目、实现用例与业务逻辑、设计服务层、CRUD 与 API 端点、架构与分层问题、可测试性改造,以及查询优化、分页过滤搜索、JWT 鉴权、生产部署、Django Admin 等。

限制:要求 Python 3.10+ 才能使用 X | None 语法,推荐 3.12+;Django 最低 4.2 LTS,推荐 5.0+。该技能强制严格的层依赖规则与代码规范,需配合 Ruff、工厂测试等实践。资料未提供具体安装命令、收费或价格信息;URL 与官方说明暂未提供。