Django 后端开发全流程指导：在创建模型/视图/DRF…

适用于 Django 后端开发中的模型、视图、DRF API、查询优化、认证、测试和生产部署等任务。

适用场景

解决思路

1. 识别任务类型：模型设计（数据库 schema、关系、迁移）、视图/API 开发（FBV、CBV、DRF viewsets、serializers）、查询优化（N+1 问题、数据库性能）、认证/权限（用户模型、访问控制）、测试（单元测试、集成测试、fixtures）、安全审查（CSRF、XSS、SQL 注入、权限）、生产部署（设置、HTTPS、数据库、缓存、监控）、模板渲染（Django templates、context processors）。
2. 如果 django-ai-boost MCP server 可用，使用它理解项目结构和现有模式。
3. 阅读相关现有代码以理解约定。
4. 检查 Django 版本以考虑兼容性。
5. 模型/ORM 任务：加载 references/models-and-orm.md，参考模型字段类型和最佳实践、模型设计模式和字段选择、关系配置（ForeignKey, OneToOne, ManyToMany）、自定义管理器和 QuerySet 方法、迁移模式和常见陷阱、数据库级约束和索引、迁移策略。
6. 视图/API 任务：加载 references/views-and-urls.md 和 references/drf-guidelines.md。views-and-urls.md 参考 FBV vs CBV 决策标准、函数式 vs 类视图权衡、CBV mixins 和继承模式、URL 路由和反向解析、URL 配置模式、中间件实现、请求/响应生命周期。drf-guidelines.md 参考 DRF serializers（ModelSerializer, nested serializers）、viewsets、routers、分页、过滤和搜索、认证和权限类、API 版本化策略、API 性能优化、RESTful 端点约定。
7. 性能问题：加载 references/performance-optimization.md，参考查询优化技术（select_related, prefetch_related, only, defer）、数据库索引策略、缓存层（Redis, Memcached, database cache）、数据库连接池、分析和监控工具、异步视图和后台任务。
8. 生产部署：加载 references/production-deployment.md，参考关键设置（DEBUG, SECRET_KEY, ALLOWED_HOSTS）、数据库配置和连接池、HTTPS/SSL 配置和安全头、静态和媒体文件服务、使用 Redis/Memcached 缓存、生产环境邮件配置、使用 Sentry 错误监控、日志和健康检查、零停机部署策略、部署过程和健康检查。
9. 安全问题：加载 references/security-checklist.md，参考 CSRF 保护实现、XSS 预防技术、SQL 注入防御、认证最佳实践、权限和授权模式、安全设置配置、输入验证和清理。
10. 测试任务：加载 references/testing-strategies.md，参考测试组织和结构、Factory 模式 vs fixtures、测试视图、模型和序列化器、Mock 外部服务、测试数据库优化、覆盖率和 CI/CD 集成。
11. 参考 references/examples.md 获取模型设计（自定义管理器）、N+1 查询优化、DRF API 端点实现、编写 Django 测试的实践示例。
12. 遵循代码质量标准：遵循 PEP 8 和 Django 编码风格；尽可能使用 Django 内置功能而非第三方包；保持视图轻量，使用 services/managers 处理业务逻辑；写描述性变量名并为复杂逻辑添加 docstrings；用适当异常优雅处理错误。
13. 遵循 Django 特定模式：对 FK/OneToOne 使用 select_related()，对反向 FK/M2M 使用 prefetch_related()；利用类视图和 mixins 实现代码复用；使用 Django forms/serializers 进行验证；遵循 Django 迁移工作流（永不编辑已应用的迁移）；使用 Django 内置安全功能（CSRF tokens, auth decorators）。
14. API 开发 (DRF)：标准 CRUD 使用 ModelSerializer；实现适当的分页和过滤；使用适当的权限类；遵循 RESTful 端点约定；进行破坏性变更时对 API 版本化。
15. 代码审查：检查 N+1 查询问题（在脑中用 Django Debug Toolbar）；验证适当的错误处理和边缘情况；确保遵循安全最佳实践；确认迁移干净且可逆。
16. 测试考虑：建议或编写适当测试；验证关键路径的测试覆盖率；检查 fixtures/factories 可维护。
17. 性能检查：审查数据库查询效率；考虑缓存机会；验证正确使用数据库索引。
18. 版本兼容：考虑 LTS 版本（4.2, 5.2）用于生产；升级时检查弃用警告；使用 django-upgrade 工具自动化迁移。
19. 常见陷阱：避免循环导入（使用惰性引用）；在关系上添加 related_name；在频繁查询字段上添加数据库索引；使用 get() 时处理异常；避免模板和序列化器中的 N+1 查询。

适用边界 · 注意事项

• 不适用于非 Django 的 Python Web 框架（如 Flask、FastAPI）或其他语言后端。
• 不适用于需要特定云厂商（AWS/GCP/Azure）专有部署配置的场景。
• 如果项目使用非 Django ORM 的数据库访问层，部分 ORM 最佳实践不适用。