diff --git a/docs/00-project-profile.md b/docs/00-project-profile.md index 67f2bc1..7e2fe9c 100644 --- a/docs/00-project-profile.md +++ b/docs/00-project-profile.md @@ -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 # 项目档案 @@ -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 正式创建待付款订单仍属于后续高风险工单。 diff --git a/docs/02-architecture-and-code-map.md b/docs/02-architecture-and-code-map.md index 3733123..38c8721 100644 --- a/docs/02-architecture-and-code-map.md +++ b/docs/02-architecture-and-code-map.md @@ -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 # 架构与代码地图 @@ -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、表或执行动作时必须同步更新本代码地图与共享契约。 diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index 8cb595b..4ddf804 100644 --- a/docs/03-business-rules-and-glossary.md +++ b/docs/03-business-rules-and-glossary.md @@ -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 # 业务规则与术语 ## 当前范围 -当前已实施范围包含 PDD 商品最新档案与采集闭环、虾皮商品档案、SYB 商品与后台导入，以及采购任务数据和规则契约。采购任务服务、Admin 页面、Android 演练、真实创建待付款订单和物流回填仍由独立工单推进。 +当前已实施范围包含 PDD 商品最新档案与采集闭环、虾皮商品档案、SYB 商品与后台导入、采购任务服务，以及 Android 采购演练与持久结果上报。Admin 采购页面、真实创建待付款订单和物流回填仍由独立工单推进。 ## PDD 商品 diff --git a/docs/08-agent-api-contract.md b/docs/08-agent-api-contract.md index b280e9a..6b3fc10 100644 --- a/docs/08-agent-api-contract.md +++ b/docs/08-agent-api-contract.md @@ -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 # 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 凭据或完整收货地址。 | 错误码 | 普通提示 | |---|---| diff --git a/docs/09-delivery-issues.md b/docs/09-delivery-issues.md index bd5af9f..a8676ca 100644 --- a/docs/09-delivery-issues.md +++ b/docs/09-delivery-issues.md @@ -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 # 当前 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 已验收） | 已完成 |