docs: 归档任务 #262

docs/task/262-安全分流失败采购任务并继续只读核单.md

@@ -0,0 +1,65 @@
+# 262 安全分流失败采购任务并继续只读核单
+
+- 类型：需求
+- 父级大工单：#96
+- 所属 MVP / 版本：#97 真实采购首单闭环（不支付）
+- 状态：已完成
+- 日期：2026-08-18
+- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/262>
+
+## 背景与目标
+
+采购任务提交订单前失败时可以安全重新采购；订单已经提交并写入不可逆标记后，如果只读核单失败进入 `reconcile_manual_review`，原“重新采购”入口只显示安全阻止，无法再次读取已经存在的待付款订单。
+
+本任务保留同一个操作入口并增加安全分流：提交前失败仍重新采购；提交后失败只恢复原运行继续核单，绝不重新下单。
+
+## 最终方案
+
+- 批量预检分别返回可重新采购、只继续核单、类型过滤和安全阻止任务。
+- 只有任务和最新运行都处于 `reconcile_manual_review`、最新运行存在不可逆标记且没有未发送 Outbox 时，才允许继续核单。
+- Repository 在一个事务中把原任务和原运行恢复为 `reconcile_purchase`；不创建新运行，不修改原 `attempt_id`、确认快照或不可逆时间。
+- 工作线程把只读核单任务排在真正重新采购之前，直接调用 `PurchaseReconcileService`；核单结果不确定、状态变化或上报失败时停止剩余采购任务。
+- 核单成功后复用已保存 Outbox 的提交方法，并注入一个禁止创建采购 Adapter 的工厂，保证该分支没有重新下单路径。
+- 确认框分别显示“可重新采购”和“只继续核单”数量；只有只读任务时，确认按钮显示“继续核单”。
+
+最终实现与建单方案一致，没有修改数据库结构、Admin 接口或现有不可逆数据。
+
+## 改了哪些
+
+- `client/src/task_models.py`：批量预检和执行命令增加只读核单分类。
+- `client/src/task_repository.py`：增加继续核单预检及原子恢复事务。
+- `client/src/pdd_ui_event.py`：同一入口安全分流、只读优先执行、明确确认文案和失败停队。
+- `client/test/test_task_repository.py`：覆盖分类、原运行复用及提交前失败仍可重购。
+- `client/test/test_pdd_ui_event.py`：覆盖混合任务确认文案和只读任务优先顺序。
+- `client/test/test_purchase_recovery.py`：覆盖继续核单成功、禁止采购 Adapter 和核单失败停止后续采购。
+- `docs/client/05-ui-specification.md`、`docs/client/06-quality-security.md`：同步稳定交互与安全规则。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 提交订单前失败且无不可逆标记的任务仍可重新采购 | 通过 |
+| `reconcile_manual_review` 的最新不可逆运行可从同一入口继续核单 | 通过 |
+| 继续核单保留原运行编号、不可逆时间和确认数据，不创建新运行 | 通过 |
+| 继续核单不创建采购 Adapter，不重新提交订单或付款 | 通过 |
+| 确认框分别显示重新采购和只继续核单数量 | 通过 |
+| 只读核单优先，核单失败时停止后续重新采购 | 通过 |
+| 其他不可逆状态、未发送 Outbox 和类型不符任务保持安全阻止或过滤 | 通过 |
+
+## 测试
+
+- 执行的命令：
+  - `C:/Python310/python.exe -m py_compile src/task_models.py src/task_repository.py src/pdd_ui_event.py test/test_task_repository.py test/test_pdd_ui_event.py test/test_purchase_recovery.py`
+  - `C:/Python310/python.exe -m pytest -q --disable-warnings test/test_task_repository.py test/test_pdd_ui_event.py test/test_purchase_recovery.py`
+  - `C:/Python310/python.exe -m pytest -q test`
+  - 设置 `QT_QPA_PLATFORM=offscreen` 后创建 `MainWindow`。
+- 结果：语法检查通过；定向测试 96 项全部通过；完整 Client 测试 511 项通过、2 项与本工单无关的既有版本号断言失败；离屏界面冒烟输出 `OK`。
+- **没验证到的部分**：未连接真实 Android 设备继续核对现有订单；没有重新提交订单、触发支付或修改本机 `cg44` 的任务状态。
+
+## 遗留问题
+
+- 工作区 Client 版本为 `0.1.2`，两项更新模块测试仍固定期待 `0.1.0`，不属于本工单范围。
+
+## 相关提交
+
+- `5ea8aa3` 安全继续失败采购核单。