docs(t218): freeze single-submit reconciliation contract

This commit is contained in:
QiuSW
2026-07-28 16:56:17 +08:00
parent 1e87b6273a
commit 682cc7327c
8 changed files with 223 additions and 10 deletions
+10 -4
View File
@@ -5,7 +5,7 @@
## 当前快照
- 日期:2026-07-28
- 阶段:T-217 已授权商品重新定位与订单 dry-run 已完成;下一项 T-218
- 阶段:T-218 单次订单提交与订单回读已领取,合约冻结中
- Git:当前分支为 `main`;T-001 至 T-004、T-101 至 T-104、T-201 至 T-217
均按文档提交、实现提交的顺序纳入历史
- 生产代码:`android-buyer/` 已接入 Roubao Android 源码
@@ -76,6 +76,9 @@
唯一颜色/尺码、数量和预算重新核验 Admin 选择;确认页 WebView 折叠时使用端上
中文 OCR 做只读 fail-closed 证据提取。后端保存 v10 READY、截图、SKU、数量、
单价/总额和事件;无障碍动作集中不含订单提交或支付。
- T-218 目标:后端先创建一次性 submission fence,App 点击前持久化
`CLICK_ASSUMED`,最多点击一次精确“提交订单”;进程/网络不确定后只回读待付款
订单或转人工,绝不重复提交或点击支付。
- Workflow:纯 Kotlin runner 已支持步骤 timeout、最多 3 次 retry、安全阻塞、
用户停止和单 runner 并发拒绝;T-102 已接入搜索加有界候选采集五步
- TaskSource:严格 CLI 已生成并验证真实私有 ProbeTask;默认 APK 不含私有 fixture
@@ -104,8 +107,10 @@
已用 CLI 真实导入并逐字段/图片哈希验证,生成物位于被忽略的 `.local/`
- 标准启动路径:`$env:RUN_START_COMMAND="1"; .\init.ps1`
- 标准验证路径:`.\init.ps1`
- 当前 blocker:T-217 无阻塞。真实 VLM 服务地址、模型、设备级测试凭证、成本上限
和数据留存尚未确认;当前只支持单 SKU/JPEG;候选探针截图要求 Android 11/API 30+
- 当前 blocker:T-218 实现无代码阻塞;当前真机确认页缺少已配置收货地址,因此
真实提交 smoke 必须按合约阻塞,不能为测试自动添加地址。真实 VLM 服务地址、模型、
设备级测试凭证、成本上限和数据留存尚未确认;当前只支持单 SKU/JPEG;候选探针
截图要求 Android 11/API 30+
## 当前目录
@@ -149,7 +154,8 @@
## 任务摘要
- 已完成:T-001 至 T-004、T-101 至 T-104、T-201 至 T-217。
- 下一步:T-218 单次订单提交与订单回读,然后实现 T-219 付款提醒。
- 进行中:T-218 单次订单提交与订单回读。
- 下一步:T-219 Admin 待付款提醒与端到端验收。
## 当前可运行内容