OPC/goauto
2
0
Fork 0
Code Issues 192 Pull Requests Actions Packages Projects Releases Wiki Activity

区分 SYB 商品“去关联 PDD”与“去匹配”动作 #82

New Issue
Closed
opened 2026-08-25 10:16:59 +08:00 by ila · 2 comments
ila commented 2026-08-25 10:16:59 +08:00
Owner
Copy Link
Copy Source

需求来源

  • 提出时间：2026-08-25
  • 来源：#80/#81 页面验收。
  • 现象：SYB 商品处理阶段提示“请先关联拼多多商品”，按钮却显示“去匹配”；点击后进入蝦皮商品详情。
  • 用户确认：建立缺陷工单并修复。

原因与当前事实

  • 蝦皮商品与 PDD 商品的关联关系在蝦皮商品详情维护，因此进入蝦皮商品模块本身是正确方向。
  • 服务端目前把“未关联 PDD”“关联的 PDD 不存在”和“颜色匹配失效”都返回为 open_mapping。
  • Web 将 open_mapping 统一显示为“去匹配”，导致尚未关联商品时出现动作语义错误；未关联前也无法进行颜色匹配。
  • 当前跳转只打开通用蝦皮详情，没有直接进入 PDD 关联操作。

目标与方案

  1. 新增明确的管理端下一步动作 open_pdd_link。
  2. “未关联 PDD”或“关联 PDD 不存在”返回 open_pdd_link，按钮显示“去关联”。
  3. open_mapping 只保留给已经关联 PDD、但颜色规格映射缺失或失效的场景，按钮继续显示“去匹配”。
  4. “去关联”打开对应蝦皮商品详情，并通过路由动作参数直接打开既有“搜索并选择 PDD 商品”对话框。
  5. 统一相关普通用户提示为“PDD 商品”，不改程序字段名和数据模型。

非目标

  • 不改变蝦皮与 PDD 的一对多关联规则。
  • 不修改数据库、采购状态机、Android、Agent API 或规格匹配算法。
  • 不触发采集、采购、创建订单或支付。

设计证据

复用现有处理阶段列、蝦皮商品详情抽屉和 PDD 商品选择对话框，不新增页面或主要流程：

未关联 PDD
请先关联 PDD 商品
[去关联]
    ↓
蝦皮商品详情 + 自动打开“搜索并选择 PDD 商品”

颜色待匹配
颜色匹配无效，请重新选择
[去匹配]
    ↓
蝦皮商品详情 + 现有目标颜色定位

状态边界：

  • 正常：动作与阶段一致。
  • 加载：复用蝦皮详情及 PDD 选择器 loading。
  • 失败：复用统一请求错误提示。
  • 缺少蝦皮商品 ID：不跳转并给出明确提示。
  • 权限：沿用 SYB、蝦皮商品和 PDD 商品现有权限。

这是现有页面的小范围行为纠正，以上低保真流程作为设计证据，无需新增 QuantUX/HTML 原型。

依赖与影响

  • 依赖 #80 的处理阶段和 #81 的 PDD 跳转修复。
  • 影响 Server 管理端预检动作语义、Web 跳转及测试。
  • 无数据库迁移，无高风险业务动作。

验收标准

  • “未关联 PDD”显示“请先关联 PDD 商品”和“去关联”。
  • 点击“去关联”进入当前蝦皮商品，并直接打开 PDD 商品选择器。
  • “关联的 PDD 商品不存在”同样提供“去关联”，允许重新选择。
  • “颜色待匹配”仍显示“去匹配”，并进入规格匹配位置。
  • 服务端不再为未关联场景返回 open_mapping。
  • Server 单元测试、Web 定向测试/构建和 Harness 严格检查通过。

验证计划

  • Server 测试覆盖未关联、PDD 不存在和颜色待匹配的动作区分。
  • Playwright 覆盖“去关联”文案、路由参数和自动打开 PDD 选择器。
  • 运行 .\scripts\verify.ps1 -Component server、.\scripts\verify.ps1 -Component web 和 python dev_scripts/harness.py check --strict。
  • 不执行真机采集、采购、创建订单或支付。

文档影响

无长期业务规则变化：本缺陷只纠正既有“未关联 PDD”和“颜色待匹配”的下一步表达与定位，关联关系、权限和业务流程不变。

## 需求来源 - 提出时间：2026-08-25 - 来源：#80/#81 页面验收。 - 现象：SYB 商品处理阶段提示“请先关联拼多多商品”，按钮却显示“去匹配”；点击后进入蝦皮商品详情。 - 用户确认：建立缺陷工单并修复。 ## 原因与当前事实 - 蝦皮商品与 PDD 商品的关联关系在蝦皮商品详情维护，因此进入蝦皮商品模块本身是正确方向。 - 服务端目前把“未关联 PDD”“关联的 PDD 不存在”和“颜色匹配失效”都返回为 `open_mapping`。 - Web 将 `open_mapping` 统一显示为“去匹配”，导致尚未关联商品时出现动作语义错误；未关联前也无法进行颜色匹配。 - 当前跳转只打开通用蝦皮详情，没有直接进入 PDD 关联操作。 ## 目标与方案 1. 新增明确的管理端下一步动作 `open_pdd_link`。 2. “未关联 PDD”或“关联 PDD 不存在”返回 `open_pdd_link`，按钮显示“去关联”。 3. `open_mapping` 只保留给已经关联 PDD、但颜色规格映射缺失或失效的场景，按钮继续显示“去匹配”。 4. “去关联”打开对应蝦皮商品详情，并通过路由动作参数直接打开既有“搜索并选择 PDD 商品”对话框。 5. 统一相关普通用户提示为“PDD 商品”，不改程序字段名和数据模型。 ## 非目标 - 不改变蝦皮与 PDD 的一对多关联规则。 - 不修改数据库、采购状态机、Android、Agent API 或规格匹配算法。 - 不触发采集、采购、创建订单或支付。 ## 设计证据 复用现有处理阶段列、蝦皮商品详情抽屉和 PDD 商品选择对话框，不新增页面或主要流程： ```text 未关联 PDD 请先关联 PDD 商品 [去关联] ↓ 蝦皮商品详情 + 自动打开“搜索并选择 PDD 商品” ``` ```text 颜色待匹配 颜色匹配无效，请重新选择 [去匹配] ↓ 蝦皮商品详情 + 现有目标颜色定位 ``` 状态边界： - 正常：动作与阶段一致。 - 加载：复用蝦皮详情及 PDD 选择器 loading。 - 失败：复用统一请求错误提示。 - 缺少蝦皮商品 ID：不跳转并给出明确提示。 - 权限：沿用 SYB、蝦皮商品和 PDD 商品现有权限。 这是现有页面的小范围行为纠正，以上低保真流程作为设计证据，无需新增 QuantUX/HTML 原型。 ## 依赖与影响 - 依赖 #80 的处理阶段和 #81 的 PDD 跳转修复。 - 影响 Server 管理端预检动作语义、Web 跳转及测试。 - 无数据库迁移，无高风险业务动作。 ## 验收标准 - [ ] “未关联 PDD”显示“请先关联 PDD 商品”和“去关联”。 - [ ] 点击“去关联”进入当前蝦皮商品，并直接打开 PDD 商品选择器。 - [ ] “关联的 PDD 商品不存在”同样提供“去关联”，允许重新选择。 - [ ] “颜色待匹配”仍显示“去匹配”，并进入规格匹配位置。 - [ ] 服务端不再为未关联场景返回 `open_mapping`。 - [ ] Server 单元测试、Web 定向测试/构建和 Harness 严格检查通过。 ## 验证计划 - Server 测试覆盖未关联、PDD 不存在和颜色待匹配的动作区分。 - Playwright 覆盖“去关联”文案、路由参数和自动打开 PDD 选择器。 - 运行 `.\scripts\verify.ps1 -Component server`、`.\scripts\verify.ps1 -Component web` 和 `python dev_scripts/harness.py check --strict`。 - 不执行真机采集、采购、创建订单或支付。 ## 文档影响 无长期业务规则变化：本缺陷只纠正既有“未关联 PDD”和“颜色待匹配”的下一步表达与定位，关联关系、权限和业务流程不变。
ila commented 2026-08-25 10:23:23 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，待用户验收

实现

  • 新增管理端下一步动作 open_pdd_link。
  • “未关联 PDD”和“关联的 PDD 商品不存在”现在返回该动作，页面显示“去关联”。
  • open_mapping 只保留给颜色规格匹配缺失或失效，页面继续显示“去匹配”。
  • 点击“去关联”会打开当前蝦皮商品详情，并直接打开既有“搜索并选择 PDD 商品”对话框。
  • 相关提示统一为普通用户可理解的“PDD 商品”。
  • 未修改数据库、关联规则、采购状态机、Android 或 Agent API。

验证

  • go test ./app/goauto/purchase：通过。
  • 定向 Playwright：1/1 通过，覆盖“去关联”“去匹配”区分、正确蝦皮商品和 PDD 选择器自动打开。
  • .\scripts\verify.ps1 -Component server：全量测试与构建通过。
  • .\scripts\verify.ps1 -Component web：通过；lint 0 error、30 条存量 warning，生产构建成功。
  • python dev_scripts/harness.py check --strict：通过。
  • python dev_scripts/harness.py sync --check：核心 Wiki 镜像一致。
  • 未执行真机采集、采购、创建订单或支付。

提交与归档

请在 SYB 商品页检查：

  1. “未关联 PDD”显示“去关联”，点击后直接出现 PDD 商品选择器。
  2. “颜色待匹配”仍显示“去匹配”。
## 实施完成，待用户验收 ### 实现 - 新增管理端下一步动作 `open_pdd_link`。 - “未关联 PDD”和“关联的 PDD 商品不存在”现在返回该动作，页面显示“去关联”。 - `open_mapping` 只保留给颜色规格匹配缺失或失效，页面继续显示“去匹配”。 - 点击“去关联”会打开当前蝦皮商品详情，并直接打开既有“搜索并选择 PDD 商品”对话框。 - 相关提示统一为普通用户可理解的“PDD 商品”。 - 未修改数据库、关联规则、采购状态机、Android 或 Agent API。 ### 验证 - `go test ./app/goauto/purchase`：通过。 - 定向 Playwright：1/1 通过，覆盖“去关联”“去匹配”区分、正确蝦皮商品和 PDD 选择器自动打开。 - `.\scripts\verify.ps1 -Component server`：全量测试与构建通过。 - `.\scripts\verify.ps1 -Component web`：通过；lint 0 error、30 条存量 warning，生产构建成功。 - `python dev_scripts/harness.py check --strict`：通过。 - `python dev_scripts/harness.py sync --check`：核心 Wiki 镜像一致。 - 未执行真机采集、采购、创建订单或支付。 ### 提交与归档 - 提交：`7b488e2 fix(#82): separate PDD linking from mapping` - 已推送到 `origin/main`。 - Wiki：[Task 82 区分去关联 PDD 与去匹配动作](https://git.ilapage.cn/OPC/goauto/wiki/Task-82-%E5%8C%BA%E5%88%86%E5%8E%BB%E5%85%B3%E8%81%94-PDD-%E4%B8%8E%E5%8E%BB%E5%8C%B9%E9%85%8D%E5%8A%A8%E4%BD%9C.-) - Wiki revision：`249c51bc6e10b091c0b9a58aa0b110e8dbe8401f` 请在 SYB 商品页检查： 1. “未关联 PDD”显示“去关联”，点击后直接出现 PDD 商品选择器。 2. “颜色待匹配”仍显示“去匹配”。
ila commented 2026-08-28 15:07:22 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。
ila closed this issue 2026-08-28 15:07:25 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#82