75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
# {{任务编号}} 桌面端任务：{{任务标题}}
|
||
|
||
## 概述
|
||
|
||
{{一段描述：服务目标、纯本地服务说明}}
|
||
|
||
**前置依赖**: {{依赖任务列表}}
|
||
|
||
## tmux 执行协议
|
||
|
||
- **Session**: `arno-team`，始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane，禁止新建 tmux session / window / pane
|
||
- **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境（/exit 后重启，清除遗留上下文）
|
||
- **分发方式**: 由 `项目` pane 发送简短提示词，让目标 pane 自行读取任务文件
|
||
|
||
## 前置文档（必读）
|
||
|
||
> 执行本任务前必须加载以下文档，作为接口和存储规范。
|
||
|
||
### 接口与架构规范（所有桌面端任务通用）
|
||
- `docs/09-API契约.md` — 客户端本地接口定义（桌面端需遵守请求/响应格式）
|
||
- §1 通用规范 | §2 通用响应格式 | §4 错误码规范
|
||
- §9 客户端本地接口（HTTPS IPC）：§9.1~§9.20 全部端点
|
||
- `docs/07-系统架构.md` §2.1（客户端架构）| §4（CRDT 同步架构）| §5（数据流）
|
||
|
||
### 数据库规范（所有桌面端任务通用）
|
||
- `docs/08-数据库设计.md` §3（客户端本地数据库）
|
||
- §3.3 索引设计 | §3.5 SQLite DDL 参考
|
||
- §4 数据版本迁移策略（§4.2 迁移脚本规范）
|
||
|
||
### 工程规范（所有桌面端任务通用）
|
||
- `docs/11-工程规范.md` §1.5（术语使用规范）| §2（编码规范）
|
||
|
||
### 按任务选取
|
||
| 任务 | API 契约章节 | 数据库章节 | 其他参考 |
|
||
|------|-------------|-----------|---------|
|
||
| M3-001 | §9.12 证书状态、§9.13 导出、§9.14 导入 | §3.2.5 SyncMeta | — |
|
||
| M3-002 | §9.1 登录、§9.2 锁定、§9.15 修改密码、§9.16 密码恢复 | §3.2.7 LocalConfig | |
|
||
| M4-001 | 无直接 API（纯本地服务） | 无直接表操作 | — |
|
||
| M4-002 | §9.3~§9.7 接口、§9.8~§9.11 分类接口 | §3.2.1、§3.2.3、§3.2.4、§3.2.6 | |
|
||
| M5-001 | §6 同步接口（push/pull 格式参考） | §3.2.3 CRDTEntry、§3.2.5 SyncMeta | `docs/07-系统架构.md` §4（CRDT 同步架构） |
|
||
| M7-001 | §9.8~§9.11 分类接口 | §3.2.2 Category | |
|
||
| M7-002 | §9.16 POST /api/v1/local/password/recover | §3.2.7 LocalConfig | — |
|
||
|
||
## 功能需求（FR-NNN ~ FR-NNN）
|
||
|
||
- {{需求条目}}
|
||
|
||
## 需要创建的文件
|
||
|
||
### 1. `src/{{module_name}}/services/{{service}}.py` — {{服务名}}
|
||
|
||
{{类/方法骨架}}
|
||
|
||
### 2. 其他文件
|
||
|
||
{{附加文件}}
|
||
|
||
## 编码规范
|
||
|
||
- Python 3.12+，mypy strict，禁止 Any
|
||
- ruff format/check，Google 风格 docstring
|
||
|
||
## 验收标准
|
||
|
||
- {{逐条检查}}
|
||
- 模块测试覆盖率 >{{阈值}}%
|
||
|
||
## 验证命令
|
||
|
||
```bash
|
||
{{具体命令}}
|
||
```
|
||
|
||
完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。
|