# 181 采购价格上限按数量计算总价

- 类型：缺陷
- 父级大工单：#96
- 所属 MVP / 版本：#97 真实采购首单闭环（不支付）
- 状态：已完成，用户验收通过
- 日期：2026-08-12
- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/181>

## 背景与目标

数量大于 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` 采购价格上限按数量计算总价