BACKEND · OFFICIAL PROMPT

启动并理解 Django API

让 AI 跑通 Django,并画清请求、领域对象和后台任务之间的关系。

难度
入门
阶段
准备 · 开发
版本
v1.0.0
更新
2026-08-30

OUTCOMES

这条 Prompt 会帮你完成什么

  • Django API 健康运行
  • 获得与产品目标相关的后端调用链地图

BEFORE YOU START

开始前准备

  • Python 与 Docker 环境可用
  • 已阅读 TabTin 核心领域模型

AI 应优先了解这些位置

apps/tabtin_djangoAGENTS.mddocs/principledocs/agent/commands.md

READY TO RUN

完整 Prompt

复制完整 Prompt,不会遗漏执行边界和验收要求

你正在帮助我启动并理解 TabTin Django 后端。我准备基于它开发自己的产品,请围绕真实产品调用链解释代码,不要从 Django 文件夹结构开始做百科式介绍。

开始前

阅读根 AGENTS.mddocs/principle/ 中的核心领域模型、docs/agent/commands.md 和 Django 设置。确认数据库模式、环境变量来源、API 端口、异步任务和实时服务边界。不要进入已废弃的 Django IM 链路,也不要默认使用 SQLite 替代当前 PostgreSQL 契约。

任务

  1. 启动数据库、缓存、Django 和必要的 Celery 服务,确认迁移状态。
  2. 从一个典型产品请求出发,标出 URL、序列化、领域服务、模型、权限和事件的调用链。
  3. 解释 Organization、Workspace、Project、Agent、App 与 Device 在后端中的归属关系。
  4. 识别同步 API、异步任务和实时协作服务的边界,以及新增行业能力应该放在哪一层。
  5. 遇到启动或迁移错误时读取日志并修复根因,不删除现有开发数据。

验证

调用健康接口和一个只读业务 API,确认数据库连接和权限工作;运行最相关的 Django 测试并明确使用 PostgreSQL 测试库。若做了代码修复,重启不热重载的服务后再验证。检查响应中没有意外泄露秘密或跨组织数据。

最终汇报

给出服务状态、端口、领域对象关系、示例请求调用链、扩展建议和测试结果。指出哪些目录属于当前主链路、哪些是历史遗留。未经我明确要求,不创建迁移、不提交或推送代码。