5

Task-83-PDD-商品单商品定位模式

QiuSW edited this page 2026-09-21 16:13:32 +08:00

Table of Contents

• Task #83：PDD 商品页增加单商品定位模式
• 需求与确认方案
• 实现结果
• 验证
• 风险边界

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Task #83：PDD 商品页增加单商品定位模式

• 工单：#83
• 状态：待用户验收
• 实施提交：0991fd2
• 交付单元：Web Admin
• 长期文档影响：无。仅调整既有页面从携带 productId 的链接进入时的展示与退出交互，不改变 API、数据库、业务状态、权限或部署方式。

需求与确认方案

从 SYB 商品的“查看 PDD 商品”进入 PDD 商品页时，页面进入单商品定位模式：

• 只显示 URL 中 productId 对应的 PDD 商品，并自动打开既有详情抽屉；
• 页面提示当前定位的内部商品编号和 goods_id；
• 不新增“查看全部 PDD 商品”按钮；
• 关闭详情抽屉仍保留单商品列表；
• 点击“查询”时清除 URL 的 productId，按当前筛选条件加载正常列表；
• 点击“重置”时清除 productId 和全部筛选条件，加载全部列表；
• 编号无效或商品不存在时显示明确空状态，不回退为全部商品，以免误认。

实现结果

• 单商品定位只调用既有详情接口，不先加载完整列表；
• 定位模式下隐藏批量选择列，并明确标识“当前定位商品”；
• 查询和重置均通过替换当前路由退出定位模式；
• 补充端到端测试，覆盖定位、自动打开详情、查询退出、重置退出及无效编号边界。

验证

• 专项 Playwright：2/2 通过；
• git diff --check：通过；
• python dev_scripts/harness.py check --strict：通过；
• .\scripts\verify.ps1 -Component web：通过（lint 0 error，保留既有 warnings；Vite 构建成功）；
• 未执行人工浏览器验收，等待用户审核。

风险边界

未修改服务端、数据库、Android Agent、权限、安全或创建订单行为。