docs: 补充任务 #257 联合验收修复

2026-08-17 18:15:12 +08:00
parent 1009e54531
commit 24f91bb7d7
1 changed files with 4 additions and 0 deletions
@@ -18,6 +18,7 @@
 - `PurchaseTaskService` 捕获 #256 的结构化候选观察，单次调用 Admin。`uncertain`、`rejected`、`failed`、网络错误和非法响应均安全结束，不循环请求，也不自动重新采购。
 - Admin 返回 `matched` 后，U2 Adapter 重新读取商品页、已选颜色和全部尺码候选，复算快照哈希，只按返回候选的页面原文精确点击并确认选中。
 - 数量、订单总价上限、地址、不可逆标记、单次下单和只读核单继续走原有门禁。原任务规格不被覆盖；成功结果和失败诊断记录解析编号与实际采用规格。
+- #258 联合验收发现 Mock 的请求校验比真实 Admin 宽松；补充修正后，Mock 同样校验请求体 64 KiB、字段长度和控制字符、带时区观测时间、领取任务中的颜色/尺码，以及任务不存在和从未领取的稳定错误代码。
 - 实现与建单方案一致。真实 Admin 与真机端到端验证按 #258 单独执行。

 ## 改了哪些
@@ -28,6 +29,7 @@
 - `client/src/pdd_purchase_adapter.py`、`pdd_u2_purchase_adapter.py`：增加解析结果应用边界，重新读取并核对真机候选后精确选择。
 - `client/src/pdd_purchase_reconcile_adapter.py`、`purchase_reconcile_service.py`：核单结果保留原请求规格、实际规格和解析审计信息。
 - `client/test/` 相邻测试：覆盖 Gateway 契约、HTTP 响应、Mock 幂等、SQLite 迁移、Repository、采购服务、页面变化和核单结果。
+- `client/test/test_admin_gateway_contract.py`：补充 Admin/Mock 请求边界和任务身份错误码一致性回归。
 - `docs/client/03-data-model.md`、`docs/client/06-quality-security.md`：补充本地表结构、持久化边界和采购安全规则。

 ## 验收结果
@@ -53,6 +55,7 @@
  - `C:/Python310/python.exe -m py_compile src/admin_gateway.py src/db_schema.py src/http_admin_gateway.py src/mock_admin_gateway.py src/pdd_purchase_adapter.py src/pdd_purchase_reconcile_adapter.py src/pdd_u2_purchase_adapter.py src/purchase_reconcile_service.py src/purchase_task_service.py src/task_models.py src/task_repository.py`
  - 设置 `QT_QPA_PLATFORM=offscreen` 后创建并关闭 `MainWindow`。
 - 结果：定向测试 162 项全部通过；编译和离屏 UI 冒烟通过。Client 全量测试 492 项通过、2 项失败，失败均为工作区现有 `0.1.2` 版本号与旧测试固定期望 `0.1.0` 不一致，与 #257 无关。直接从 `client/` 执行无路径限制的 `pytest -q` 还会因 `test/` 和 `tools/` 中同名测试脚本产生既有收集冲突，因此全量单元测试明确使用 `pytest test -q`。
+- #258 补充验证：`C:/Python310/python.exe -m pytest -q test/test_admin_gateway_contract.py test/test_http_admin_gateway.py test/test_purchase_task_service.py test/test_pdd_u2_purchase_adapter.py test/test_task_repository.py test/test_purchase_recovery.py`，148 项通过；`py_compile` 和 `git diff --check` 通过。
 - **没验证到的部分**：未连接真实 Admin 和 Android 真机执行完整解析后下单链路；该验证属于 #258。没有进行自动付款。

 ## 遗留问题
@@ -63,3 +66,4 @@
 ## 相关提交

 - `afc1cdf` 安全应用采购规格解析结果并继续采购。
+- `1009e54` 对齐规格解析 Mock 请求校验和稳定错误代码。