@@ -0,0 +1,74 @@
|
||||
# {{任务编号}} 桌面端任务:{{任务标题}}
|
||||
|
||||
## 概述
|
||||
|
||||
{{一段描述:服务目标、纯本地服务说明}}
|
||||
|
||||
**前置依赖**: {{依赖任务列表}}
|
||||
|
||||
## 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`。
|
||||
Reference in New Issue
Block a user