From 57aac2b85f0bc5af0a14da1ced5d738cee4ed102 Mon Sep 17 00:00:00 2001 From: chengma Date: Mon, 10 Aug 2026 16:35:54 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#106?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../106-admin顺运宝下一步单条创建采购任务.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/task/106-admin顺运宝下一步单条创建采购任务.md diff --git a/docs/task/106-admin顺运宝下一步单条创建采购任务.md b/docs/task/106-admin顺运宝下一步单条创建采购任务.md new file mode 100644 index 0000000..54bb0df --- /dev/null +++ b/docs/task/106-admin顺运宝下一步单条创建采购任务.md @@ -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)