# 71 实现采购任务演练执行与结果回传

- 类型：需求
- 父级大工单：#1
- 所属 MVP / 版本：#2 Client 可运行任务闭环（MVP）
- 状态：已完成，待用户验收
- 日期：2026-08-09
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/71

## 背景与目标

Client 已认识采购任务数据，但没有独立采购执行器。直接开放领取会让任务卡在
已领取状态，也可能把尚未验证的页面操作带入真实订单流程。本任务先建立只处理
本地任务的 `dry_run` 演练服务，在最终提交订单前停止并可靠回传结果。

## 最终方案

- 新增独立 `PurchaseTaskService`，不复用采集执行器，也不领取 Admin 任务。
- 新增可注入的 `PddPurchaseAdapter` 窄接口。接口没有提交订单或付款方法。
- 动态规格使用完整 `options` 对象精确选择和比较，不写死颜色、尺码维度。
- 进入打开商品、选择规格、设置数量和确认页等关键动作前先持久化步骤；动作前后
  重新读取商品、规格、数量和人民币分价格。
- 多候选、无匹配、价格超限、验证码、登录失效、未知页面、风控页和支付页均停止。
- 演练结果明确记录 `mode=dry_run`、确认规格、数量、价格、未提交订单和未付款。
- 结果或失败与执行记录、Outbox 在 SQLite 事务内一起保存。提交失败只补交 Outbox，
  不重新执行手机流程。
- HTTP Gateway 保持只声明 `collect`，采购领取留给依赖工单 #72。

## 改了哪些文件

- `client/src/pdd_purchase_adapter.py`：采购演练适配层接口和最新页面状态对象。
- `client/src/purchase_task_service.py`：本地采购演练、校验、失败分类和结果提交。
- `client/src/task_repository.py`：采购运行、步骤、结果、失败及 Outbox 原子持久化。
- `client/src/task_models.py`：执行记录说明同时适用于采集和采购。
- `client/test/test_purchase_task_service.py`：正常演练和安全停止场景测试。
- `docs/client/02-architecture.md`：记录采购服务和无下单入口的适配边界。
- `docs/client/03-data-model.md`：采购结果改用动态 `options` 对象。

## 验收结果

| 验收标准 | 结果 |
|---|---|
| 本地采购任务创建独立执行记录并进入演练 | 通过 |
| 动态 options 精确选择，不写死颜色尺码 | 通过 |
| 关键动作前后使用最新页面状态复核 | 通过 |
| 价格超过人民币分上限时停止 | 通过 |
| 多候选、无匹配、验证码、登录和未知页面安全停止 | 通过 |
| 到达最终提交前停止，不提交订单或付款 | 通过 |
| 结果先写 SQLite 与 Outbox，提交失败不重跑手机流程 | 通过 |
| HTTP Client 仍只声明 collect | 通过 |

## 测试

- 执行的命令：
  - `C:/Python310/python.exe -m unittest discover -s test -p "test_purchase*.py" -v`
  - `C:/Python310/python.exe -m unittest discover -s test -p "test_*.py" -q`
  - `C:/Python310/python.exe -m py_compile src/task_models.py src/task_repository.py src/pdd_purchase_adapter.py src/purchase_task_service.py`
  - 设置 `QT_QPA_PLATFORM=offscreen` 后创建并关闭 `MainWindow`
- 结果：采购专项 6 项通过；Client 全量 193 项通过；语法检查通过；离屏冒烟输出
  `MAIN_WINDOW_OK`。
- **未验证到的部分**：未连接真实 Android 设备；本工单使用可注入 Mock Adapter
  验证应用层和安全边界，没有点击真实提交订单或付款。

## 相关提交

- `311d55f` 实现采购任务安全演练