From 4df023a45545fbfd740a00ea38cebab8b7480f42 Mon Sep 17 00:00:00 2001 From: chengma Date: Wed, 12 Aug 2026 11:02: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?#179?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/179-稳定进入收货地址编辑页.md | 51 +++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 docs/task/179-稳定进入收货地址编辑页.md diff --git a/docs/task/179-稳定进入收货地址编辑页.md b/docs/task/179-稳定进入收货地址编辑页.md new file mode 100644 index 0000000..9f25f3f --- /dev/null +++ b/docs/task/179-稳定进入收货地址编辑页.md @@ -0,0 +1,51 @@ +# 179 稳定进入收货地址编辑页并限制修改重试 + +- 类型：缺陷 +- 父级大工单：#1 +- 所属 MVP / 版本：#2 +- 状态：已完成，待用户验收 +- 日期：2026-08-12 +- Gitea 工单： + +## 背景与目标 + +正式采购已经进入“收货地址”面板并找到唯一“修改”按钮，但单次点击没有打开编辑页。旧流程只点击一次并等待，最终误报页面切换超时。本任务让修改入口具备稳定识别和一次受控重试，同时保持保存、下单及不可逆门禁不变。 + +## 最终方案 + +- 地址面板连续两次出现相同的唯一“修改”目标后才点击。 +- 首次点击无效时，只有最新控件树仍明确是同一地址面板、同一唯一目标再次稳定出现，才重试一次。 +- 最多点击两次；进入编辑页立即停止，进入未知页面、候选变化或候选不唯一时不再点击。 +- 编辑页可由“修改收货地址”标题或唯一详细地址编辑器识别。 +- 地址页面超时记录期望页面、最后识别页面、点击次数和候选数量，并保存脱敏控件树。 +- 保存按钮仍只点击一次，没有增加保存重试，也没有改动地址后缀、提交订单和不可逆门禁。 + +## 改了哪些 + +- `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)