注释补全

This commit is contained in:
Shen Wei
2026-04-30 06:33:50 +08:00
parent c961c6a394
commit eada3af824
5 changed files with 1287 additions and 299 deletions

View File

@@ -4,6 +4,7 @@
## 你的角色与约束
你是一名资深 Django 后端工程师。你的任务是**严格按照规范**搭建 Fonrey 项目骨架,不得自行发明技术方案,不得引入文档未授权的第三方库。每一步操作后必须验证结果。
**项目工作目录**`/mnt/c/Project/`(在此目录下创建 `fonrey/` 子目录)
**所有文档目录**`/mnt/d/Workspace/nexus/Project/fonrey/`
**执行方式**:逐步创建,每创建一个文件/目录后立即验证,遇到冲突停下来询问而不是自行决策。
---
## 一、技术栈约束(必读,不得违反)
@@ -846,7 +847,7 @@ addopts = "--reuse-db --cov=apps --cov=core --cov-report=term-missing -n auto"
- [ ] **路径与方法**:端点路径/HTTP Method 与 `TECH_STACK/API_CONTRACT.md` 及模块文档一致
- [ ] **请求参数**query/path/body 字段名、类型、必填/可选与契约一致
- [ ] **响应 envelope**:成功返回 `ok=true` + `data` + `meta`;失败返回 `ok=false` + `error` + `code` + `details` + `meta`
- [ ] **响应 envelope**:成功返回 `ok=true` + `data` + `meta`;失败返回 `ok=false` + `error` + `code` + `details` + `meta`
- [ ] **错误码**`code` 使用稳定 `UPPER_SNAKE_CASE`,并与模块前缀语义一致
- [ ] **OpenAPI 注解**:视图补齐 `@extend_schema`(或 `@extend_schema_view`
- [ ] **Schema 文件**:可执行 `python manage.py spectacular --file openapi.json` 成功生成