docs: 归档任务 #179

2026-08-12 11:02:14 +08:00
parent 7c569813e1
commit 4df023a455
1 changed files with 51 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 179 稳定进入收货地址编辑页并限制修改重试
+
+- 类型：缺陷
+- 父级大工单：#1
+- 所属 MVP / 版本：#2
+- 状态：已完成，待用户验收
+- 日期：2026-08-12
+- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/179>
+
+## 背景与目标
+
+正式采购已经进入“收货地址”面板并找到唯一“修改”按钮，但单次点击没有打开编辑页。旧流程只点击一次并等待，最终误报页面切换超时。本任务让修改入口具备稳定识别和一次受控重试，同时保持保存、下单及不可逆门禁不变。
+
+## 最终方案
+
+- 地址面板连续两次出现相同的唯一“修改”目标后才点击。
+- 首次点击无效时，只有最新控件树仍明确是同一地址面板、同一唯一目标再次稳定出现，才重试一次。
+- 最多点击两次；进入编辑页立即停止，进入未知页面、候选变化或候选不唯一时不再点击。
+- 编辑页可由“修改收货地址”标题或唯一详细地址编辑器识别。
+- 地址页面超时记录期望页面、最后识别页面、点击次数和候选数量，并保存脱敏控件树。
+- 保存按钮仍只点击一次，没有增加保存重试，也没有改动地址后缀、提交订单和不可逆门禁。
+
+## 改了哪些
+
+- `client/src/pdd_u2_purchase_adapter.py`：增加地址页面识别、稳定修改入口和最多一次受控重试，并补充脱敏超时诊断。
+- `client/test/test_pdd_u2_purchase_adapter.py`：覆盖首次点击丢失、持续丢失、未知页面、候选歧义和原有完整地址流程。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 地址面板稳定后才点击“修改” | 通过 |
+| 首次点击无效且仍在原面板时允许第二次进入编辑页 | 通过 |
+| “修改”最多点击两次，持续失败后停止 | 通过 |
+| 页面未知、候选不唯一或候选变化时不重复点击 | 通过 |
+| 保存按钮保持单次点击 | 通过 |
+| 超时包含页面、点击次数、候选数量和脱敏控件树 | 通过 |
+| 不可逆下单门禁未修改 | 通过 |
+| Client 全量测试通过 | 通过 |
+
+## 测试
+
+- 执行的命令：在 `client` 目录执行 `C:/Python310/python.exe -m unittest discover -s test -p 'test_pdd_u2_purchase_adapter.py'`
+- 结果：33 个采购 Adapter 测试全部通过。
+- 执行的命令：在 `client` 目录执行 `$env:QT_QPA_PLATFORM='offscreen'; C:/Python310/python.exe -m unittest discover -s test -p 'test_*.py'`
+- 结果：451 个 Client 测试全部通过；仅有测试环境 Qt 字体目录警告。
+- **没验证到的部分**：未在真机重新执行采购；未点击真实地址页面、保存、提交订单或进入任何不可逆操作。
+
+## 相关提交
+
+- `7c56981` fix: 稳定进入收货地址编辑页 (#179)