66 lines
3.0 KiB
Markdown
66 lines
3.0 KiB
Markdown
# #265 Client：售罄临时页仅下拉刷新一次并重新识别商品
|
||
|
||
- 工单号：#265
|
||
- 类型：缺陷修复
|
||
- 父级大工单：#1
|
||
- 所属 MVP：#2
|
||
- 状态：待验收
|
||
- 日期：2026-08-18
|
||
- Gitea：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/265>
|
||
|
||
## 背景与目标
|
||
|
||
Android 浏览器通过深链打开 PDD 商品时，PDD 偶尔先显示页面级“商品已售罄”，人工下拉刷新一次后才能恢复完整商品详情。本任务让采集和采购在确认是页面级售罄时，仅执行一次受限的下拉刷新并重新识别页面，避免立即把临时页面判为永久失效。
|
||
|
||
## 最终方案
|
||
|
||
- 页面分类器增加页面级售罄状态，并由商品打开状态机记录是否已经刷新。
|
||
- 采集和采购共用安全下拉手势：根据最新控件树计算屏幕范围，在内容区从上向下滑动一次，不点击任何控件。
|
||
- 刷新后恢复商品页则继续原流程；仍显示售罄则返回不可重试的 `PDD_GOODS_UNAVAILABLE`。
|
||
- 普通 SKU、颜色或尺码选项中的“售罄”不触发整页刷新。
|
||
- 采购刷新发生在规格选择和不可逆标记之前，不改变下单门禁。
|
||
|
||
## 改了哪些文件
|
||
|
||
- `client/src/pdd_page_classifier.py`
|
||
- `client/src/pdd_goods_refresh.py`
|
||
- `client/src/pdd_collect_service.py`
|
||
- `client/src/pdd_u2_purchase_adapter.py`
|
||
- `client/test/test_pdd_page_classifier.py`
|
||
- `client/test/test_pdd_collect_service.py`
|
||
- `client/test/test_pdd_u2_purchase_adapter.py`
|
||
- `docs/client/06-quality-security.md`
|
||
|
||
实现提交：`e7ac5a4`
|
||
|
||
## 验收结果
|
||
|
||
- [x] 明确页面级售罄时只下拉刷新一次。
|
||
- [x] 刷新后恢复正常商品页时继续采集或采购流程。
|
||
- [x] 刷新后仍售罄时返回 `PDD_GOODS_UNAVAILABLE`，并记录一次刷新诊断信息。
|
||
- [x] SKU 选项中的普通“售罄”不会触发整页刷新。
|
||
- [x] 采集和采购均不点击推荐商品或其他页面控件。
|
||
- [x] 未修改不可逆阶段后的重新下单规则。
|
||
|
||
## 测试
|
||
|
||
在 `client/` 目录执行：
|
||
|
||
```powershell
|
||
C:/Python310/python.exe -m py_compile src/pdd_page_classifier.py src/pdd_goods_refresh.py src/pdd_collect_service.py src/pdd_u2_purchase_adapter.py
|
||
C:/Python310/python.exe -m pytest -q test/test_pdd_page_classifier.py test/test_pdd_collect_service.py test/test_pdd_u2_purchase_adapter.py
|
||
$env:QT_QPA_PLATFORM="offscreen"
|
||
C:/Python310/python.exe -c "from src.ui_main import MainWindow; from PyQt5.QtWidgets import QApplication; app=QApplication([]); w=MainWindow(); print('OK'); app.quit()"
|
||
Remove-Item Env:QT_QPA_PLATFORM
|
||
C:/Python310/python.exe -m pytest -q test
|
||
```
|
||
|
||
结果：
|
||
|
||
- 语法检查通过。
|
||
- 定向测试 146 项全部通过。
|
||
- 界面离屏冒烟测试打印 `OK`。
|
||
- 完整测试 526 项通过、2 项失败；失败是工作区现有 `src/version.py` 为 `0.1.2`，两项旧测试仍期待 `0.1.0`，与本任务无关。
|
||
|
||
未验证到的部分：未使用真实 Android 设备复现临时售罄页和实际下拉刷新；未执行真实规格选择或下单。
|