docs: 归档任务 #221

2026-08-14 10:27:14 +08:00
parent 84ec0ed1f0
commit 0201dab98c
1 changed files with 52 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 221 Client：地址流程关键操作后增加1秒稳定等待
+
+- 类型：缺陷
+- 父级大工单：#1
+- 所属 MVP / 版本：#2
+- 状态：已完成，待用户验收
+- 日期：2026-08-14
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/221
+
+## 背景与目标
+
+正式采购修改收货地址时，关键操作完成后可能立即读取到上一状态的控件树，造成页面切换、保存或返回确认超时。本任务在关键状态改变操作后增加固定稳定时间，再继续执行原有页面状态确认。
+
+## 最终方案
+
+- 使用单一常量把地址操作稳定等待固定为 1 秒。
+- 点击地址入口、点击“修改”、写入新地址、单次点击“保存”、关闭已知 ColorOS 密码本浮层和点击地址页返回后，分别执行一次稳定等待。
+- 固定等待后仍使用原有控件树轮询、唯一目标、默认地址、表单连续稳定、单次保存和超时诊断。
+- “修改”和 ColorOS 浮层处理发生在已有超时循环内部，固定等待会同步补回超时预算，避免减少原页面确认时间。
+- 不改变地址后缀、Admin 接口、SQLite、任务状态、不可逆下单门禁和禁止付款规则。
+
+## 改了哪些
+
+- `client/src/pdd_u2_purchase_adapter.py`：增加统一地址操作稳定等待，并接入六类关键状态改变操作。
+- `client/test/test_pdd_u2_purchase_adapter.py`：记录 Fake Clock 的等待时间，验证普通地址闭环执行 5 次、ColorOS 浮层闭环执行 6 次 1 秒等待。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 地址入口后等待 1 秒再确认地址面板 | 通过 |
+| 点击“修改”后等待 1 秒且保留安全重试 | 通过 |
+| 写入地址后等待 1 秒再验证表单 | 通过 |
+| 保存只点击一次，并等待 1 秒再确认结果 | 通过 |
+| 关闭已知 ColorOS 浮层后等待 1 秒 | 通过 |
+| 地址页返回后等待 1 秒再确认规格页 | 通过 |
+| 原安全门禁、错误分类和超时语义保持 | 通过 |
+| 地址专项及 Client 回归 | 专项通过；全量存在 2 项无关既有失败 |
+
+## 测试
+
+- 执行的命令：
+  - `C:/Python310/python.exe -m py_compile src/pdd_u2_purchase_adapter.py`
+  - `C:/Python310/python.exe -m pytest test/test_pdd_u2_purchase_adapter.py -q --disable-warnings`
+  - `C:/Python310/python.exe -m pytest test -q --disable-warnings`
+  - `git diff --check -- client/src/pdd_u2_purchase_adapter.py client/test/test_pdd_u2_purchase_adapter.py`
+- 结果：语法检查和差异检查通过；地址专项 48 项全部通过；Client 全量 470 项中 468 项通过。
+- **没验证到的部分**：没有连接真机执行地址修改、保存、返回或真实采购。全量测试另有 2 项既有失败，原因是工作区版本为 `0.1.2`，旧更新测试仍固定期待 `0.1.0`，与 #221 无关。
+
+## 相关提交
+
+- `84ec0ed` fix: 稳定采购地址页面切换 (#221)