From aa6d812ac6da13924d5638f508d8f636d5d7a1f2 Mon Sep 17 00:00:00 2001 From: chengma Date: Wed, 12 Aug 2026 14:43:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#181?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/181-采购价格上限按数量计算总价.md | 66 +++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 docs/task/181-采购价格上限按数量计算总价.md diff --git a/docs/task/181-采购价格上限按数量计算总价.md b/docs/task/181-采购价格上限按数量计算总价.md new file mode 100644 index 0000000..ef23bca --- /dev/null +++ b/docs/task/181-采购价格上限按数量计算总价.md @@ -0,0 +1,66 @@ +# 181 采购价格上限按数量计算总价 + +- 类型：缺陷 +- 父级大工单：#96 +- 所属 MVP / 版本：#97 真实采购首单闭环（不支付） +- 状态：已完成 +- 日期：2026-08-12 +- Gitea 工单： + +## 背景与目标 + +数量大于 1 的采购任务曾把 PDD SKU 单价直接保存到 `max_price_cent`，而 Client 设置数量后读取并比较的是页面订单总价，导致总价与单价错误比较。生产任务 `cg6` 的数量为 2、采集单价为 ¥11.80，却只下发了 1180 分上限。 + +本任务把 Admin、Client 和接口契约统一为“`max_price_cent` 是人民币订单总价上限”，并让 Admin 按采购数量自动计算，继续保留严格价格保护。 + +## 最终方案 + +- Admin 采购确认弹窗输入选定规格的人民币单价上限，同时显示数量和只读订单总价上限；修改单价时即时更新总价。 +- JavaScript 只提供交互反馈。Admin 后端把单价精确解析为整数分，在事务内读取顺运宝最新数量，执行 `单价上限 × 数量` 并检查整数溢出后写入 `tasks.max_price_cent`。 +- Client 明确把 `max_price_cent` 解释为订单总价上限。商品页或规格面板的金额可能是单价或小计，因此只在最终订单确认页执行总价超限判断。 +- 不修改数据库结构，不回写历史任务，不重试 `cg6`，不增加涨价容差。 +- 实现与建单方案一致。 + +## 改了哪些 + +- `admin/templates/syb/list.html`、`admin/static/js/app.js`：增加单价标签、数量、即时总价输出和辅助说明。 +- `admin/handler/web/others.go`、`admin/service/purchase_workflow.go`：接收单价并在事务内安全计算订单总价上限。 +- `admin/service/syb.go`、`admin/service/task.go`、任务详情模板：生成默认单价/总价并明确总价展示语义。 +- `client/src/purchase_task_service.py`、采购适配和网关边界：只在最终确认页比较订单总价，统一错误信息和字段说明。 +- Admin/Client 测试：覆盖数量乘法、溢出、模板反馈以及确认页总价超限。 +- Admin/Client 基线文档：统一 `max_price_cent` 契约。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 数量 2、单价 ¥11.80 显示订单总价上限 ¥23.60 | 通过 | +| 单价输入具有可见标签、辅助说明和可访问的即时总价输出 | 通过 | +| 后端按最新数量计算并保存总价，数量 1 保持原值 | 通过 | +| 后端拒绝零值、负值和整数乘法溢出 | 通过 | +| Client 只在最终确认页按订单总价执行价格保护 | 通过 | +| Admin 与 Client 契约文档定义一致 | 通过 | +| Go 1.23 静态检查、构建、全量测试通过 | 通过 | +| Client 全量测试和语法检查通过 | 通过 | + +## 测试 + +- 执行的命令： + - `GOTOOLCHAIN=go1.23.0 go test ./service -run 'Test(CreatePurchaseTasks_安全字段和重复保护|CalculateOrderPriceLimitCent_按数量计算且拒绝溢出)' -count=1`（临时 MySQL 8 `_test` 基础库） + - `GOTOOLCHAIN=go1.23.0 go vet ./...` + - `GOTOOLCHAIN=go1.23.0 go build ./...` + - `GOTOOLCHAIN=go1.23.0 go test ./... -count=1` + - `C:/Python310/python.exe -m py_compile src/purchase_task_service.py src/pdd_purchase_adapter.py src/pdd_u2_purchase_adapter.py src/task_dispatcher.py src/http_admin_gateway.py` + - `C:/Python310/python.exe -m unittest discover -s test -p "test_*.py"` + - `git diff --check` +- 结果：MySQL 8 实库目标测试通过；Admin 全量检查通过；Client 共 456 个测试通过。临时数据库和授权已清理。 +- **没验证到的部分**：未在生产创建新采购任务，也未操作 Android 真机或执行真实下单；生产只执行部署和服务健康检查。 + +## 遗留问题 + +- 历史任务保持创建时的原始金额语义，`cg6` 不自动修改或重试。部署后新建任务使用订单总价上限。 +- 本任务不加入自动涨价容差；实际订单总价超过计算上限时仍会停止采购。 + +## 相关提交 + +- `253be7c` 采购价格上限按数量计算总价