77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
# {{任务编号}} 后端任务：{{任务标题}}
|
||
|
||
## 概述
|
||
|
||
{{一段描述：API 目标}}
|
||
|
||
**前置依赖**: {{依赖任务列表}}
|
||
|
||
## tmux 执行协议
|
||
|
||
- **Session**: `arno-team`，始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane，禁止新建 tmux session / window / pane
|
||
- **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境（/exit 后重启，清除遗留上下文）
|
||
- **分发方式**: 由 `项目` pane 发送简短提示词，让目标 pane 自行读取任务文件
|
||
|
||
## 前置文档（必读）
|
||
|
||
> 执行本任务前必须加载以下文档，作为接口和存储规范。
|
||
|
||
### 接口与架构规范（所有后端任务通用）
|
||
- `docs/09-API契约.md` — 完整 REST API 定义（所有后端任务必须严格遵守）
|
||
- §1 通用规范（认证方式）| §2 通用响应格式 | §3 HTTP 状态码 | §4 错误码规范
|
||
- `docs/07-系统架构.md` §2.2（服务端架构）| §7（模块划分）
|
||
|
||
### 数据库规范（所有后端任务通用）
|
||
- `docs/08-数据库设计.md` §2（服务端数据库）
|
||
- §2.3 索引设计 | §2.5 SQLite DDL 参考
|
||
- §4 数据版本迁移策略（§4.2 迁移脚本规范、§4.3 迁移执行流程）
|
||
|
||
### 工程规范（所有后端任务通用）
|
||
- `docs/11-工程规范.md` §1.5（术语使用规范）| §2（编码规范）| §5（API 设计规范）
|
||
|
||
### 按任务选取
|
||
| 任务 | API 契约章节 | 数据库章节 |
|
||
|------|-------------|-----------|
|
||
| M2-001 | §5（设备注册接口）§7（管理接口 §7.1~§7.5） | §2.2.1 |
|
||
| M5-002 | §6（同步接口 §6.1~§6.3） | §2.2.2 |
|
||
| M8-001 | §7.8 GET /api/v1/admin/logs | §2.2.3 |
|
||
| M8-002 | §7.6 POST /api/v1/admin/backups、§7.7 恢复备份 | §2.2.4 |
|
||
|
||
## 功能需求（FR-NNN ~ FR-NNN）
|
||
|
||
- {{需求条目列表}}
|
||
|
||
## 需要创建的文件
|
||
|
||
### 1. `src/{{module_name}}/services/{{service}}.py` — {{服务名}}
|
||
|
||
{{类/方法骨架 + 参数说明 + 约束}}
|
||
|
||
### 2. `src/{{module_name}}/api/routes/{{route}}.py` — API 路由
|
||
|
||
{{端点定义}}
|
||
|
||
### 3. `src/{{module_name}}/db/migrations/{{NNNN}}_{{name}}.sql` — 数据库迁移
|
||
|
||
{{DDL}}
|
||
|
||
## 编码规范
|
||
|
||
- Python 3.12+，完整类型注解（mypy strict）
|
||
- ruff format/check，Google 风格 docstring
|
||
- 严格遵守 `docs/09-API契约.md`
|
||
|
||
## 验收标准
|
||
|
||
- {{逐条检查}}
|
||
- mypy --strict 零错误
|
||
- ruff check 零告警
|
||
|
||
## 验证命令
|
||
|
||
```bash
|
||
{{具体命令}}
|
||
```
|
||
|
||
完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。
|