docs: 归档任务 #106

2026-08-10 16:35:54 +08:00
parent 3e0f3241a4
commit 57aac2b85f
1 changed files with 53 additions and 0 deletions
@@ -0,0 +1,53 @@
+# 106 Admin：顺运宝下一步支持单条创建采购任务
+
+- 类型：需求
+- 父级大工单：#14
+- 所属 MVP / 版本：#15 Admin 四模块可用闭环
+- 状态：已完成，待用户验收
+- 日期：2026-08-10
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/106
+
+## 背景与目标
+
+规格映射完成后，顺运宝行虽然进入“可创建采购任务”阶段，但下一步仍显示“核对规格”，
+采购员还要勾选行并返回顶部进入采购确认。目标是让每行下一步准确表达当前动作，并让可采购行直接进入单条采购确认。
+
+## 最终方案
+
+- 完整化阶段动作文字：创建采集任务、查看采集状态、重新采集、匹配规格、创建采购任务和查看采购任务。
+- 可采购行的“创建采购任务”只打开现有确认弹窗，并只启用当前行对应的隐藏字段，不改变列表复选框状态。
+- 顶部批量入口继续读取已勾选行，不受单条入口影响。
+- 每次打开确认弹窗都重置为采购演练，并清空真实下单确认，避免遗留上次未提交的 live 选择。
+- 已有未结束采购任务的行进入按订单号筛选的采集采购页，不再打开创建入口。
+- 创建请求继续经过现有服务端权限、映射、数量、人民币价格上限、执行模式和幂等校验。
+
+## 改了哪些
+
+- `admin/service/syb.go`：修正各处理阶段的下一步文字。
+- `admin/templates/syb/list.html`：按阶段渲染详情、单条采购确认或采购任务查看入口。
+- `admin/static/js/app.js`：同一采购弹窗兼容单条与批量来源，并重置安全模式。
+- `admin/service/syb_workflow_test.go`：逐阶段断言下一步文字。
+- `admin/syb_interaction_template_test.go`：验证三类行内动作的模板输出。
+- `docs/admin/05-ui-specification.md`：记录阶段动作、单条确认和服务端复核规则。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 各处理阶段显示准确下一步文字 | 通过 |
+| 可采购行只带当前明细进入采购确认 | 通过（模板与事件绑定检查） |
+| 默认演练且真实下单安全确认不被绕过 | 通过 |
+| 顶部批量创建行为保持可用且单条入口不改复选框 | 通过 |
+| 已有任务进入采集采购页而不重复创建 | 通过 |
+| 服务端过期、权限、价格和重复校验保持有效 | 通过（现有采购工作流回归） |
+| 不改数据库、Client 接口和不可逆阶段红线 | 通过 |
+
+## 测试
+
+- 执行的命令：`GOTOOLCHAIN=go1.23.0 go vet ./...`、`go build ./...`、`go test ./... -count=1`、`node --check static/js/app.js`、`git diff --check`。
+- 结果：全部通过；采购任务创建、重复保护和客户端权限测试通过。
+- **没验证到的部分**：未在生产库创建采购任务，未执行真实下单；需要用户在浏览器分别验收单条与批量确认弹窗。
+
+## 相关提交
+
+- `7106f6b` feat: 顺运宝下一步支持单条建采购任务 (#106)