fix: 采购价格上限按数量计算总价 (#181)

2026-08-12 14:43:18 +08:00
parent 8c7be7bd07
commit 253be7cb61
24 changed files with 203 additions and 106 deletions
@@ -106,7 +106,7 @@ Idempotency-Key: <stable-key>
 }
 ```

-采集任务的 `payload` 不要求颜色、尺码、数量和价格字段。采购任务必须包含 `quantity` 以及 `max_price_cent` 或等价的明确价格保护规则。
+采集任务的 `payload` 不要求颜色、尺码、数量和价格字段。采购任务必须包含 `quantity` 以及 `max_price_cent` 或等价的明确价格保护规则。`max_price_cent` 是**人民币订单总价上限（整数分）**，不是商品单价；例如数量 2、单价上限 ¥11.80 时必须下发 `2360`。Client 只在最终订单确认页用页面订单总价与该上限比较，商品页或规格面板上含义不稳定的单价/小计不能直接用于总价超限判断。

 任务对象里**不含 Admin 侧状态**。Client 不关心 Admin 那边把它标成什么，只管做完提交。

@@ -221,7 +221,7 @@ Client 的 `HttpAdminGateway.claim_next` 已实现本接口，并原样序列化
 本页 §6 或 §7 提交，完整请求会先进入本地 Outbox。

 采购响应在写入本地前必须校验非空 `goods_url`、`goods_id`、动态 `options`、
-正整数 `quantity` 和正整数分 `max_price_cent`。字段不完整时停止新的领取并向
+正整数 `quantity` 和人民币订单总价上限（正整数分）`max_price_cent`。字段不完整时停止新的领取并向
 操作员显示协议错误；不得让不完整任务进入手机执行。

 `[必须]` **`204` 不是错误。** Client 要把它当"暂时没活干"处理，