docs(t215): freeze admin order authorization contract

This commit is contained in:
QiuSW
2026-07-28 12:25:26 +08:00
parent 56e7a2be33
commit 16c2ea410a
10 changed files with 272 additions and 16 deletions
+21
View File
@@ -568,6 +568,27 @@ evidence asset ID;后端逐一核对其实际 SHA-256 后才接受候选。Adm
key、四个指纹和受控截图;后续选品授权必须引用 key 并绑定任务内容 hash 和 review
版本,不能只信 URL 或列表 ordinal。
### Admin 下单授权(T-215)
非空候选保存后,任务从 `RUNNING` 进入 `WAITING_CONFIRMATION`。Admin 选择不会调用
Android 或拼多多,而是在后端追加一版 human review 和一条
`order_authorizations`:
```text
Admin task detail
-> candidate key + 全候选结构化理由
-> 校验 task/execution/content hash/version
-> candidate key 映射原 observation
-> 追加 admin human review
-> 生成 PENDING_DELIVERY authorization 快照
-> T-216 device command pull
```
授权快照固定原始任务 SKU/数量、候选规格/价格、review 版本和 T-214 四个身份指纹;
请求不能覆盖这些字段。一次 execution 最多一条 active 授权;设备领取前改选只能
追加新版本并把旧记录标记为 `SUPERSEDED`,设备领取后必须走显式停止/撤销协议。
浏览器不持有设备 claim token,授权表也不保存拼多多登录、支付或收货凭证。
人工理由使用版本化 allowlist。接受或拒绝至少有一个理由且指定主要理由;
`OTHER` 才要求 4-200 字备注。拒绝推荐后改选必须同时产生一条原推荐项负标签和一条
替代项正标签;全部无匹配时每个曝光候选都有负标签。人工修正追加新 review 并引用