feat: 安全领取并分派采购任务 (#72)

2026-08-10 00:05:40 +08:00
parent 460619392f
commit f201bcc4bf
12 changed files with 789 additions and 76 deletions
@@ -199,10 +199,16 @@ POST /api/v1/client/tasks/claim

 无可领取任务时返回 `204 No Content`。

-Client 的 `HttpAdminGateway.claim_next` 已实现本接口。当前只声明
-`supported_types: ["collect"]`，一次调用最多领取一个采集任务；采集结束后通过
+Client 的 `HttpAdminGateway.claim_next` 已实现本接口，并原样序列化应用层已经
+安全确认的 `ClaimCapabilities`。没有采购演练 Adapter 或设备未准备好时只声明
+`supported_types: ["collect"]`；条件满足时声明 `collect,purchase`，但
+`purchase_mode` 固定为 `dry_run`。一次调用最多领取一个任务，结果或失败通过
 本页 §6 或 §7 提交，完整请求会先进入本地 Outbox。

+采购响应在写入本地前必须校验非空 `goods_url`、`goods_id`、动态 `options`、
+正整数 `quantity` 和正整数分 `max_price_cent`。字段不完整时停止新的领取并向
+操作员显示协议错误；不得让不完整任务进入手机执行。
+
 `[必须]` **`204` 不是错误。** Client 要把它当"暂时没活干"处理，
 不要报错，也不要因此触发重试风暴。首次 claim 通常返回 204；如果该编号已经预先分配任务，也可以直接返回 200。