From 0201dab98c590fe835d9f926c67d9fa23e3579d2 Mon Sep 17 00:00:00 2001 From: chengma Date: Fri, 14 Aug 2026 10:27:14 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#221?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../221-地址流程关键操作后增加稳定等待.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/task/221-地址流程关键操作后增加稳定等待.md diff --git a/docs/task/221-地址流程关键操作后增加稳定等待.md b/docs/task/221-地址流程关键操作后增加稳定等待.md new file mode 100644 index 0000000..fabff07 --- /dev/null +++ b/docs/task/221-地址流程关键操作后增加稳定等待.md @@ -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)