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

SYB AI 匹配有结果即放行创建采购 #200

New Issue
Open
opened 2026-09-03 09:23:45 +08:00 by ila · 2 comments
ila commented 2026-09-03 09:23:45 +08:00
Owner
Copy Link
Copy Source

需求摘要

来源：用户于 2026-09-03 确认：在 Admin SYB 商品页，AI 匹配请求成功且返回规格结果后，不再因自动确认置信度阈值要求人工确认，应可继续创建采购。

范围与非目标

  • 范围：server/ 采购批量 AI 规格匹配的自动确认规则及其测试；必要时更新长期业务规则/API 文档与 Admin 提示。
  • 非目标：不改变 PDD 可售 SKU 组合校验；AI 调用失败、无规格结果或结果不属于当前可售 SKU 组合时仍阻止创建采购；不创建订单、不支付、不变更 Android 执行。

前置依赖与并行

  • 无外部依赖；不可与同一采购匹配流程的改动并行合并。

方案

  • 移除批量 AI 匹配对 AutoConfirmMinConfidence 的放行条件。
  • AI 返回的映射仍须具备匹配结果理由，并通过当前已采集 PDD SKU 组合校验；满足后保存为已确认映射，使采购准备状态进入 purchase_ready。
  • 保留现有确定性匹配、人工映射和失败/无结果/无效 SKU 的处理。

设计证据

后端流程与状态门禁变更，不涉及新页面或重大交互；用户已于 2026-09-03 确认上述流程规则。

验收

  1. 低于原自动确认阈值但返回有效可售 SKU 的 AI 结果自动保存为 confirmed，并可创建采购。
  2. AI 无结果、服务失败或无效 SKU 组合仍不保存且不可创建采购。
  3. 现有确定性匹配和人工映射行为不回归。
  4. 不产生自动下单或支付行为。

风险

采购前映射的人工阈值门禁被取消，依赖 AI 返回和 SKU 组合校验；不触及创建订单、地址修改或支付。文档影响待实现后按长期规则决定。

Gitea 交互

由于当前会话未提供 Gitea MCP，使用已配置环境中的 Gitea API 创建本工单。

需求变更（2026-09-03）

用户确认：PDD 档案可能由人工录入或其他导入来源建立，缺少 collection_task / 完整可售 SKU 组合记录是正常状态。对这类档案，已确认的 AI 或唯一确定性规格映射应允许创建采购，不得因缺少采集任务记录阻断。

修订方案与验收

  • 无可售 SKU 组合证据时，仍校验映射值属于当前 PDD 可选候选；不再把缺少采集记录本身作为批量匹配确认或采购创建的阻断条件。
  • 存在可售 SKU 组合证据时，继续校验映射命中同一可售颜色+尺码组合；AI 无结果、Provider 失败或候选之外的值仍不保存。
  • 验收补充：订单 2609032F7FY4N9 所在的“已有 confirmed 映射、PDD active、但没有完成采集任务”的状态应进入 purchase_ready。

风险更新

取消“必须有采集任务 SKU 证据”的采购前置条件，改为在证据存在时校验、缺失时不阻断；价格与候选规格校验、设备、并发、订单与禁止支付边界不变。用户已于 2026-09-03 确认。

## 需求摘要 来源：用户于 2026-09-03 确认：在 Admin SYB 商品页，AI 匹配请求成功且返回规格结果后，不再因自动确认置信度阈值要求人工确认，应可继续创建采购。 ## 范围与非目标 - 范围：`server/` 采购批量 AI 规格匹配的自动确认规则及其测试；必要时更新长期业务规则/API 文档与 Admin 提示。 - 非目标：不改变 PDD 可售 SKU 组合校验；AI 调用失败、无规格结果或结果不属于当前可售 SKU 组合时仍阻止创建采购；不创建订单、不支付、不变更 Android 执行。 ## 前置依赖与并行 - 无外部依赖；不可与同一采购匹配流程的改动并行合并。 ## 方案 - 移除批量 AI 匹配对 `AutoConfirmMinConfidence` 的放行条件。 - AI 返回的映射仍须具备匹配结果理由，并通过当前已采集 PDD SKU 组合校验；满足后保存为已确认映射，使采购准备状态进入 `purchase_ready`。 - 保留现有确定性匹配、人工映射和失败/无结果/无效 SKU 的处理。 ## 设计证据 后端流程与状态门禁变更，不涉及新页面或重大交互；用户已于 2026-09-03 确认上述流程规则。 ## 验收 1. 低于原自动确认阈值但返回有效可售 SKU 的 AI 结果自动保存为 confirmed，并可创建采购。 2. AI 无结果、服务失败或无效 SKU 组合仍不保存且不可创建采购。 3. 现有确定性匹配和人工映射行为不回归。 4. 不产生自动下单或支付行为。 ## 风险 采购前映射的人工阈值门禁被取消，依赖 AI 返回和 SKU 组合校验；不触及创建订单、地址修改或支付。文档影响待实现后按长期规则决定。 ## Gitea 交互 由于当前会话未提供 Gitea MCP，使用已配置环境中的 Gitea API 创建本工单。 ## 需求变更（2026-09-03） 用户确认：PDD 档案可能由人工录入或其他导入来源建立，缺少 `collection_task` / 完整可售 SKU 组合记录是正常状态。对这类档案，已确认的 AI 或唯一确定性规格映射应允许创建采购，不得因缺少采集任务记录阻断。 ### 修订方案与验收 - 无可售 SKU 组合证据时，仍校验映射值属于当前 PDD 可选候选；不再把缺少采集记录本身作为批量匹配确认或采购创建的阻断条件。 - 存在可售 SKU 组合证据时，继续校验映射命中同一可售颜色+尺码组合；AI 无结果、Provider 失败或候选之外的值仍不保存。 - 验收补充：订单 `2609032F7FY4N9` 所在的“已有 confirmed 映射、PDD active、但没有完成采集任务”的状态应进入 `purchase_ready`。 ### 风险更新 取消“必须有采集任务 SKU 证据”的采购前置条件，改为在证据存在时校验、缺失时不阻断；价格与候选规格校验、设备、并发、订单与禁止支付边界不变。用户已于 2026-09-03 确认。
ila commented 2026-09-03 09:36:53 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，待验收

  • 实现：SYB 商品页批量 AI 匹配不再按 AutoConfirmMinConfidence 拦截。Provider 成功返回有理由的规格结果，且结果属于当前候选并命中同一可售颜色+尺码 SKU 组合时，自动保存为 confirmed，采购预检进入 purchase_ready。
  • 保留：AI 无结果/调用失败、候选无效或非可售 SKU 组合仍不改写映射且不可创建采购；不涉及订单创建、地址修改或支付。
  • 文档：已更新 Business-Rules-and-Glossary，线上回读 revision c326132fdfa8407abc7cc7643073291be359802b；在干净工作区完成 harness.py sync --check。
  • 验证：go test ./app/goauto/purchase ./app/goauto/shopeeproduct 通过；python dev_scripts/harness.py check --strict 通过。未执行真实 Provider 或真机采购操作。
  • 提交与分支：e85f237 feat(purchase): 放行有结果的 AI 规格匹配 (#200)，已推送 feat/200-ai-match-result-purchase-ready。

主工作区原有的 docs/12-syb-erp-interface.md、server/config/settings.yml 等改动未包含在本提交。

## 实施完成，待验收 - 实现：SYB 商品页批量 AI 匹配不再按 `AutoConfirmMinConfidence` 拦截。Provider 成功返回有理由的规格结果，且结果属于当前候选并命中同一可售颜色+尺码 SKU 组合时，自动保存为 `confirmed`，采购预检进入 `purchase_ready`。 - 保留：AI 无结果/调用失败、候选无效或非可售 SKU 组合仍不改写映射且不可创建采购；不涉及订单创建、地址修改或支付。 - 文档：已更新 `Business-Rules-and-Glossary`，线上回读 revision `c326132fdfa8407abc7cc7643073291be359802b`；在干净工作区完成 `harness.py sync --check`。 - 验证：`go test ./app/goauto/purchase ./app/goauto/shopeeproduct` 通过；`python dev_scripts/harness.py check --strict` 通过。未执行真实 Provider 或真机采购操作。 - 提交与分支：`e85f237 feat(purchase): 放行有结果的 AI 规格匹配 (#200)`，已推送 `feat/200-ai-match-result-purchase-ready`。 主工作区原有的 `docs/12-syb-erp-interface.md`、`server/config/settings.yml` 等改动未包含在本提交。
ila commented 2026-09-03 09:57:39 +08:00
Author
Owner
Copy Link
Copy Source

需求变更已实现，待验收

  • 根因核验：订单 2609032F7FY4N9 的颜色与尺码映射均已是 confirmed，但关联 PDD 商品没有完成采集任务与 SKU 组合记录；旧采购预检将“缺少证据”硬拦截，页面误显示为“去匹配”。
  • 修复：无 SKU 组合证据时，只校验确认映射仍属于当前 PDD 候选，不再阻断批量 AI 匹配确认或采购创建；存在组合证据时仍要求映射命中同一可售组合。
  • 验证：go test ./app/goauto/purchase ./app/goauto/shopeeproduct、python dev_scripts/harness.py check --strict 通过；线上 Wiki 已回读 revision 9b195f3c578f980b808e6eb28f36e7bf5294e75b，干净工作区 sync --check 通过。
  • 提交：fc28632 fix(purchase): 允许无 SKU 采集证据创建采购 (#200)，已推送。已将本地 8010 API 重启到当前分支（跳过数据库迁移）；未创建采购任务、订单或支付。
## 需求变更已实现，待验收 - 根因核验：订单 `2609032F7FY4N9` 的颜色与尺码映射均已是 `confirmed`，但关联 PDD 商品没有完成采集任务与 SKU 组合记录；旧采购预检将“缺少证据”硬拦截，页面误显示为“去匹配”。 - 修复：无 SKU 组合证据时，只校验确认映射仍属于当前 PDD 候选，不再阻断批量 AI 匹配确认或采购创建；存在组合证据时仍要求映射命中同一可售组合。 - 验证：`go test ./app/goauto/purchase ./app/goauto/shopeeproduct`、`python dev_scripts/harness.py check --strict` 通过；线上 Wiki 已回读 revision `9b195f3c578f980b808e6eb28f36e7bf5294e75b`，干净工作区 `sync --check` 通过。 - 提交：`fc28632 fix(purchase): 允许无 SKU 采集证据创建采购 (#200)`，已推送。已将本地 `8010` API 重启到当前分支（跳过数据库迁移）；未创建采购任务、订单或支付。
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#200