- API.md 新增第 4 节：升级/动作/列表/关系/通知与 6xxx 错误码 - ROADMAP 补 M2 全部条目与 DOD，验收用例加自验与回流两条 - DEVELOPMENT 记两条新坑：PowerShell 批量改写会毁中文、npm.ps1 被执行策略拦 - README 状态表把工单从待做改成已通，测试数 57
This commit is contained in:
dadao
@@ -1,4 +1,4 @@
|
||||
# M0–M1 实施清单
|
||||
# 实施清单（M0–M2）
|
||||
|
||||
> 来源：`2.Design/PRODUCT-PLAN.md` v1.0 第 12 节
|
||||
> 粒度：每项 0.3–1.5 人日，2 人并行 ≈ 2 周一个里程碑
|
||||
@@ -211,26 +211,78 @@
|
||||
|
||||
---
|
||||
|
||||
## 关键验收用例（M0–M1 必须通过）
|
||||
## M2 · 工单协同（第 5–6 周，10 人日）
|
||||
|
||||
### 2.1 数据（1d）
|
||||
- [x] `item.kind='ticket'` 落地；迁移 `0003_tickets.py` **重写 item 的状态约束**为任务∪工单并集
|
||||
（旧约束只允许任务六态，工单的 `open/accepted/...` 会被直接拦下）
|
||||
- [x] `ticket_ext`（`item_id` 既是主键又是外键，天然 1:1）：需求人/办理人/原任务指针/受理·提交·验收时间/退回次数/验收结论
|
||||
- [x] `item_link`（父子、相关，禁止自环）与 `notification`（只发给当事人）
|
||||
- [x] 三张表全部 `ENABLE ROW LEVEL SECURITY` + 同租户策略 + GRANT 给应用角色
|
||||
|
||||
### 2.2 领域（1.5d）
|
||||
- [x] 工单状态机 `open→accepted→in_progress→pending_verify→done`（可 `canceled`），默认拒绝
|
||||
- [x] 动作→角色规则：受理/开工/提交限办理人；**验收限需求人，办理人不能自验**（`6004`）；改派/取消限需求人或办理人
|
||||
- [x] 驳回回 `in_progress` 而不是 `open`，`reject_count` 累加
|
||||
- [x] 升级不搬数据：原任务变 `blocked`，验收通过后自动回流 `todo`
|
||||
|
||||
### 2.3 API（1.5d）
|
||||
- [x] `POST /items/{id}/promote`、`/ticket/{accept,start,submit,verify,reassign,cancel}`
|
||||
- [x] `GET /tickets?role=assigned|requested|all&status=`
|
||||
- [x] `GET|POST /items/{id}/links`、`DELETE /items/{id}/links/{link_id}`
|
||||
- [x] `GET /notifications`、`/unread-count`、`/read`、`/read-all`
|
||||
- [x] 抽出 `app/serializers.py`：任务与工单共用一份序列化，**根除"工单响应缺 tags 导致前端白屏"**
|
||||
|
||||
### 2.4 Web（3d）
|
||||
- [x] 工单页 `/w/:wsId/tickets`：派给我的 / 我发起的 / 全部，状态过滤，列表内联快操作
|
||||
- [x] 详情抽屉：按角色显示受理、开工、提交、验收、驳回、改派、取消；工单态顶部显示需求人/办理人/退回次数
|
||||
- [x] 任务详情底部"升级成工单"面板（从成员里选人，成功后提示"这条任务现在处于被阻塞"）
|
||||
- [x] 导航加未读角标（30 秒对齐一次，操作后立刻刷新）
|
||||
- [x] 登录支持 `?next=` 回跳，邀请链接不再"登录完掉回首页"
|
||||
|
||||
### 2.5 安卓（1.5d）
|
||||
- [ ] 工单列表与动作 —— 只做到任务列表；本机无 JDK/Gradle，仍是**未编译**状态
|
||||
|
||||
### 2.6 测试与验收（0.7d）
|
||||
- [x] `backend/tests/test_tickets.py` 11 个用例：升级建单+原任务阻塞+通知、全流程验收回流、驳回、
|
||||
自验 403、非法流转、重复升级、非成员指派、角色作用域、跨租户、关系挂载、通知已读、**响应必带 tags**
|
||||
- [x] 全量 `pytest -q` → **57 passed**；`ruff check` / `format --check` 全 0
|
||||
- [x] `web/e2e/tickets.mjs` 双浏览器上下文双用户 e2e，8 项断言全绿：
|
||||
升级 → B 受理/开工/提交 → A 验收通过 → 原任务回流"待办" → 两端控制台零报错
|
||||
- [x] `web/e2e/smoke.mjs` 回归复跑（抽屉多了"选人"下拉后修正选择器）7 项全绿
|
||||
|
||||
### 2.7 通知真实投递
|
||||
- [ ] 站内通知已有；微信/飞书推送推迟到 M6（M2 只要"在系统里能看到该我办了"）
|
||||
|
||||
### M2 完成定义（DOD）
|
||||
- [x] 两个人能跑完一次真实协助：升级 → 受理 → 办理 → 提交 → 验收 → 原任务自动解锁
|
||||
- [x] 办理人无法自验、跨租户看不到工单、通知只给当事人
|
||||
- [ ] 真实用一周：所有"需要别人帮忙"的事都走工单，不再私聊催（需要真实团队）
|
||||
|
||||
---
|
||||
|
||||
## 关键验收用例（M0–M2 必须通过）
|
||||
|
||||
| # | 用例 | 期望 | 现状 |
|
||||
|---|---|---|---|
|
||||
| 1 | 租户 A 用户请求租户 B 的 workspace id | 3003 未加入（不泄露存在性） | ✅ 已覆盖 |
|
||||
| 2 | 同一手机号登录两次 | 同一个 user_id，不重复建号 | ✅ 已覆盖 |
|
||||
| 3 | 被移出团队的成员拿旧 token 请求 | 3003；refresh 也失效 | [~] access 已拒，refresh 不可撤销（见 0.6） |
|
||||
| 4 | 并发两次提交同一任务的不同状态 | 一次成功，一次 409 并可重试 | [ ] M1 |
|
||||
| 4 | 并发两次提交同一任务的不同状态 | 一次成功，一次 409 并可重试 | ✅ 已覆盖（版本冲突用例） |
|
||||
| 5 | 网络中断后重新提交 | 幂等键保证不产生两条 | ✅ 已覆盖 |
|
||||
| 6 | 删除任务后全局搜索 | 搜不到，且回收站可恢复 | [ ] M3 |
|
||||
| 7 | 停掉 Redis | `/health` 变 503，业务接口给明确错误而非 500 | [ ] dev 用内存实现，未做 |
|
||||
| 8 | 部署后 `/version` | commit 与仓库 HEAD 一致 | [~] 机制已有，等部署验证 |
|
||||
| 9 | 办理人验收自己的工单 | 403 `6004`，不能自己给自己过 | ✅ 已覆盖 |
|
||||
| 10 | 工单验收通过后原任务 | 自动从"被阻塞"回到"待办"，事件流留痕 | ✅ 已覆盖（含 e2e） |
|
||||
|
||||
---
|
||||
|
||||
## 下一步排期建议
|
||||
|
||||
```
|
||||
已完成 0.1–0.9（骨架、认证、租户隔离、接口规范）+ 0.13 两端壳
|
||||
待补 PR 模板 / CI 在 Gitea 实跑 / 0.14 微信 spike / Web 构建验证
|
||||
第3周 0.11 部署 + 0.12 契约 + 1.1–1.3 任务域后端
|
||||
第4周 1.4 Web 四视图 + 自己开始 dogfooding
|
||||
已完成 0.1–0.9 骨架与认证 + 1.1–1.7 任务域 + 2.1–2.6 工单协同（含双人 e2e）
|
||||
待补 0.11 部署 / 0.12 契约 / 0.14 微信 spike / CI 在 Gitea 实跑 / 安卓编译链
|
||||
第7–8周 M3 知识：knowledge_doc + chunk、切片与索引、工单关闭生成草稿、带引用问答
|
||||
第9–10周 M4 AI：结构化录入、人物工作侧写、主动提醒、20 条黄金用例回归
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user