docs(#42): record user acceptance

2026-08-20 23:14:16 +08:00
parent 888cc8b617
commit dae9cb6aed
5 changed files with 20 additions and 18 deletions
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Project-Profile
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Project-Profile.-
-wiki_revision: e80a0564cf94d2feb3c068d0bf24419d36e21e67
-synchronized_at: 2026-08-20T08:47:11Z
+wiki_revision: 63251261d5cf18c9d3a14fb74d268e1c7c10842d
+synchronized_at: 2026-08-20T15:12:02Z
 <!-- gitea-wiki-mirror:end -->

 # 项目档案
@@ -17,8 +17,8 @@ synchronized_at: 2026-08-20T08:47:11Z
 | 主要使用者 | 管理员、采购人员、开发维护者 |
 | Gitea 仓库 | `OPC/goauto` |
 | 默认分支 | `main` |
-| 当前已实施范围 | PDD 商品与采集闭环、虾皮/SYB 商品档案、SYB 接口导入、店铺准入、后台同步记录、采购任务数据与共享契约 |
-| 后续设计范围 | 采购任务服务、Android 演练、创建待付款订单和物流回填 |
+| 当前已实施范围 | PDD 商品与采集闭环、虾皮/SYB 商品档案与导入、采购任务服务、Android 采购演练与持久结果上报 |
+| 后续设计范围 | Admin 采购管理、创建待付款订单、人工复核与物流回填 |
 | 预计规模 | 20 台 Android；每天约 100 个采集任务、200 个采购任务 |

 ## 建设基线
@@ -70,4 +70,4 @@ synchronized_at: 2026-08-20T08:47:11Z

 #40、#41、#49～#52 已于 2026-08-20 通过用户验收，虾皮/SYB 商品档案、店铺过滤、异步同步记录、列表布局和 MySQL 同步缺陷修复均已完成。

-#33、#34 已于 2026-08-20 通过用户验收，采购数据契约和服务端状态机已经完成。按原定 MVP 依赖顺序，下一步是 #42 Android 采购演练规则与持久执行基线；该工单只演练商品、规格、数量和价格，不改地址、不创建订单。#35 Admin 页面和 #36 正式创建待付款订单仍属于后续工单。
+#33、#34、#42 已于 2026-08-20 通过用户验收，采购数据契约、服务端状态机和 Android 安全演练基线已经完成。#42 只演练商品、规格、数量和价格，使用本地任务/attempt/Outbox 保证结果重传不重复操作 PDD，不改地址、不创建订单。下一步是 #35 Admin 采购管理；#36 正式创建待付款订单仍属于后续高风险工单。
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Architecture-and-Code-Map
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Architecture-and-Code-Map.-
-wiki_revision: 5da7f2250f851caab6d0d1713f869b619ed55eb2
-synchronized_at: 2026-08-20T08:47:11Z
+wiki_revision: 5702b75cf0a7e045f09f58eb14d5362fc3734c09
+synchronized_at: 2026-08-20T15:12:12Z
 <!-- gitea-wiki-mirror:end -->

 # 架构与代码地图
@@ -126,6 +126,8 @@ Android Portal/Agent
 | SYB 异步导入入口与同步记录页面 | `web/src/views/goauto/syb-products/`、`web/src/views/goauto/syb-sync-runs/`、`web/src/api/goauto/syb-products.js`；确认原型快照 `prototypes/50/v2/index.html` |
 | Android Agent 基线 | `android/app/src/main/java/cn/ilapage/goauto/agent/` |
 | Android 无障碍规则执行 | `android/app/src/main/java/cn/ilapage/goauto/agent/automation/` |
+| Android 采购演练规则解释器 | `android/app/src/main/java/cn/ilapage/goauto/agent/automation/PurchaseRuleContract.kt`、`PurchaseRehearsalExecutor.kt` |
+| Android 采购任务、attempt 与 Outbox 持久化 | `android/app/src/main/java/cn/ilapage/goauto/agent/persistence/`；调度入口 `service/AgentForegroundService.kt` |
 | 三端统一验证 | `scripts/verify.ps1` |

 以上入口均已落地；新增 API、表或执行动作时必须同步更新本代码地图与共享契约。
@@ -2,15 +2,15 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Business-Rules-and-Glossary
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary.-
-wiki_revision: 39297e8886ddcd441c9cb874f399b3962055a3a1
-synchronized_at: 2026-08-20T14:49:50Z
+wiki_revision: 7c81f6f6c5ad12b8ace76cc71fb1475b5fdb2274
+synchronized_at: 2026-08-20T15:12:16Z
 <!-- gitea-wiki-mirror:end -->

 # 业务规则与术语

 ## 当前范围

-当前已实施范围包含 PDD 商品最新档案与采集闭环、虾皮商品档案、SYB 商品与后台导入，以及采购任务数据和规则契约。采购任务服务、Admin 页面、Android 演练、真实创建待付款订单和物流回填仍由独立工单推进。
+当前已实施范围包含 PDD 商品最新档案与采集闭环、虾皮商品档案、SYB 商品与后台导入、采购任务服务，以及 Android 采购演练与持久结果上报。Admin 采购页面、真实创建待付款订单和物流回填仍由独立工单推进。

 ## PDD 商品

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Android-Agent-API-Contract
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Android-Agent-API-Contract.-
-wiki_revision: 60e8cebb504e23f1a42076977d8d99b486909594
-synchronized_at: 2026-08-20T14:51:34Z
+wiki_revision: cac56434a387fcac4314ab62248c6ae5a9c69309
+synchronized_at: 2026-08-20T15:12:36Z
 <!-- gitea-wiki-mirror:end -->

 # MVP 共享 API 契约
@@ -369,9 +369,9 @@ POST /api/agent/v1/tasks/{taskId}/fail
 | `DEVICE_BUSY` | 设备已有活动任务 | 否 |
 | `DEVICE_CAPABILITY_MISMATCH` | 设备缺少任务规则要求的版本化能力 | 否 |

-## 采购任务共享契约（#33、#34、#53）
+## 采购任务共享契约（#33、#34、#42、#53）

-本节固定采购域的数据和接口边界；`purchase_task`、`purchase_task_attempt`、规则校验及服务端 HTTP 状态机已落地，Admin 页面和 Android 执行动作分别由后续工单实现。任何实现都不得扩展为自动支付。
+本节固定采购域的数据和接口边界；`purchase_task`、`purchase_task_attempt`、规则校验、服务端 HTTP 状态机及 Android 演练执行已经落地。Admin 页面和正式地址/订单动作仍由后续工单实现。任何实现都不得扩展为自动支付。

 ### 任务与快照

@@ -484,7 +484,7 @@ POST /api/agent/v1/tasks/{taskId}/fail

 结果提交至少关联 `taskId`、`taskAttemptId`、`deviceId`、规则快照哈希和结构化结果。相同 attempt 的相同结果重复提交返回同一事实；不同内容拒绝覆盖。慢路径第一趟提交规格后释放设备与已知账号租约，任务进入 `spec_probe_pending`；服务端固化同一 attempt 的 AI/人工决策后，第二趟使用新的 attempt 重新派发。无匹配结果则明确失败。`order_result_unknown` 只允许管理员或采购员人工解除，永不自动重派。

-Agent Room 只保存恢复执行所需的任务、attempt 和 Outbox；服务端数据库是最终事实来源。双方均不保存原始控件树、截图、PDD 凭据或完整收货地址。
+Android #42 使用本地 SQLite 保存恢复与重传所需的任务、attempt 和 Outbox；最终结果和 Outbox 在同一事务写入。断网或重启后只重发已保存的同一 requestId 和结果，不重新执行 PDD 操作。演练执行器只解释服务端规则快照中的受限类型化动作和参数，精确选择规格、设置数量、校验实际单价并停在安全点；不支持的能力在打开 PDD 前失败，地址修改、创建订单和支付动作均被拒绝。服务端数据库仍是最终事实来源；双方均不保存原始控件树、截图、PDD 凭据或完整收货地址。

 | 错误码 | 普通提示 |
 |---|---|
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Delivery-Issues
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Delivery-Issues.-
-wiki_revision: 7c3027260213a9b4dc969349f41cdd25d8337e13
-synchronized_at: 2026-08-20T14:51:37Z
+wiki_revision: b12c7f5391f9ce80f78ff0dd57ef09c162dc1890
+synchronized_at: 2026-08-20T15:12:40Z
 <!-- gitea-wiki-mirror:end -->

 # 当前 MVP 交付工单索引
@@ -62,7 +62,7 @@ synchronized_at: 2026-08-20T14:51:37Z
 | T37 | [#39](https://git.ilapage.cn/OPC/goauto/issues/39) | 采购闭环真机端到端验收 | #33～#38、#42 |
 | T38 | [#40](https://git.ilapage.cn/OPC/goauto/issues/40) | 虾皮商品档案、PDD 关联与规格映射（2026-08-20 已验收） | 已完成 |
 | T39 | [#41](https://git.ilapage.cn/OPC/goauto/issues/41) | SYB 货运单商品导入与虾皮信息提取（2026-08-20 已验收） | 已完成 |
-| T40 | [#42](https://git.ilapage.cn/OPC/goauto/issues/42) | Android 采购演练规则与持久执行基线 | #33、#34、#53、#54；只演练，不改地址、不创建订单 |
+| T40 | [#42](https://git.ilapage.cn/OPC/goauto/issues/42) | Android 采购演练规则与持久执行基线（2026-08-20 已验收） | 已完成；只演练，不改地址、不创建订单 |
 | T43 | [#45](https://git.ilapage.cn/OPC/goauto/issues/45) | Admin PDD 商品列表多选与批量采集任务创建（2026-08-18 已验收） | 已完成 |
 | T46 | [#48](https://git.ilapage.cn/OPC/goauto/issues/48) | SYB ERP 客户端移植与真实导入 | #41；已实施，等待验收 |
 | T47 | [#49](https://git.ilapage.cn/OPC/goauto/issues/49) | 店铺管理与 SYB 同步店铺过滤（2026-08-20 已验收） | 已完成 |