chengma/cmautobuy
2
0
Fork 0
Code Issues 89 Pull Requests Actions Packages Projects Releases Wiki Activity

Admin：商品颜色映射接入 SYB 完整规格解析与采购门禁 #295

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

基本信息

  • 类型：需求
  • 父级大工单：#14
  • 所属 MVP / 版本：#291 / 蝦皮与 PDD 商品级颜色映射
  • 阶段：Stage B3 SYB 与采购链路接入
  • 依赖：#293、#294

要解决什么

商品颜色映射若只停留在可视化页面，SYB 处理状态和采购任务仍然读不到它。需要把颜色映射作为现有完整规格解析的一个确定性输入，但不能把只有颜色的结果错误当成完整可购买组合。

做什么 / 不做什么

  • 做：SYB 规格可靠解析出蝦皮侧颜色后，按当前蝦皮商品和当前 PDD 商品读取有效商品颜色映射。
  • 做：用目标 PDD 颜色约束当前可购买组合，再对尺码、款式及其他维度执行现有确定性匹配。
  • 做：仅剩一个完整可购买组合时写入现有 spec_mappings 和决策审计，并让现有处理阶段和采购创建自然复用。
  • 做：在颜色映射保存、SYB 新数据入库和 PDD 采集结果更新三个写入事件调用同一幂等解析服务。
  • 不做：颜色映射命中但完整组合不唯一时不写 spec_mappings，不自动创建采购任务。
  • 不做：不覆盖人工完整映射，不降低库存、价格、数量、上下文或真实采购安全门禁。
  • 不做：不修改 Client 接口和 pdd_data 契约，不让 Client 猜测规格。

怎么做

  • 增加一个不依赖 Gin 的幂等 service：读取 SYB 当前上下文、解析蝦皮侧颜色、读取当前 PDD 商品颜色映射、筛选最新 available=true 的完整 PDD 组合，再复用现有维度排序和确定性匹配。
  • 颜色解析失败、颜色映射缺失/失效、PDD 关联变化、第三维度未提供、剩余维度没有唯一结果时返回明确“不生成”的业务结论，不视为系统错误。
  • 只有完整组合唯一且再次通过 OptionKey、可购买性及上下文版本校验时，使用 UpsertAutomaticSpecMapping 写入 source=rule，记录规则版本、颜色映射依据和上下文版本；人工 source=manual 永不被覆盖。
  • 同一个共享服务由三处事务调用：颜色映射保存后处理该商品既有待匹配 SYB 明细；SYB 同步新增/更新明细后处理当前行；PDD 采集结果成功入库后处理关联商品待匹配明细。预期的“不唯一/无映射”不阻塞主业务，数据库错误按所属事务回滚并记录脱敏错误。
  • 处理阶段仍以现有有效 spec_mappings 为准，不增加“只有颜色已匹配即可采购”的旁路。
  • AI 和人工完整规格匹配保持现有优先级；颜色映射只缩小候选，不给 AI 或 Client 传入不存在的候选。

验收标准

  • 有效颜色映射加上唯一剩余维度时，生成当前 PDD 商品下的完整有效 spec_mappings。
  • 颜色命中但尺码或第三维度不唯一时不生成完整映射，SYB 保持待匹配并可继续人工/AI处理。
  • 蝦皮颜色解析失败、颜色映射缺失/失效或目标颜色无可购买组合时不猜测、不写入。
  • 更换 PDD 商品、PDD 重采目标消失和上下文并发变化均阻止旧结果写入。
  • 已有人工完整映射不被规则结果覆盖；规则结果写入来源、版本、原因和既有决策审计。
  • 三个写入事件都能幂等调用共享服务，重复处理不会产生不同结果或重复副作用。
  • SYB 处理阶段和采购创建继续只读取完整有效 spec_mappings。
  • Client 四接口及任务载荷保持兼容，不自动创建采购任务、不下单、不付款。

怎么验证

固定 Go 1.23.0 执行颜色映射到完整规格的 service/repository/handler 定向测试、Client 契约测试和全量 test/build/vet；MySQL 8.4 _test 验证并发上下文和事务回滚。浏览器验证颜色保存后 SYB 行阶段更新；使用脱敏数据覆盖唯一、缺失、失效、多候选、第三维度、人工覆盖和重复事件。

风险和回���

  • 风险：这是影响真实采购候选的关键链路，任何非唯一结果都必须保守阻断；不得因提高自动化率放宽唯一性。
  • 风险：在多个写入事件中调用同一服务可能产生锁竞争；查询按商品和待匹配明细限定范围，保持幂等并避免全表扫描。
  • 回退：关闭三个事件中的颜色辅助派生调用，即恢复现有逐条人工/AI完整规格流程；已经生成且仍有效的规则映射按现有来源规则保留，可由人工覆盖。
## 基本信息 - 类型：需求 - 父级大工单：#14 - 所属 MVP / 版本：#291 / 蝦皮与 PDD 商品级颜色映射 - 阶段：Stage B3 SYB 与采购链路接入 - 依赖：#293、#294 ## 要解决什么 商品颜色映射若只停留在可视化页面，SYB 处理状态和采购任务仍然读不到它。需要把颜色映射作为现有完整规格解析的一个确定性输入，但不能把只有颜色的结果错误当成完整可购买组合。 ## 做什么 / 不做什么 - 做：SYB 规格可靠解析出蝦皮侧颜色后，按当前蝦皮商品和当前 PDD 商品读取有效商品颜色映射。 - 做：用目标 PDD 颜色约束当前可购买组合，再对尺码、款式及其他维度执行现有确定性匹配。 - 做：仅剩一个完整可购买组合时写入现有 `spec_mappings` 和决策审计，并让现有处理阶段和采购创建自然复用。 - 做：在颜色映射保存、SYB 新数据入库和 PDD 采集结果更新三个写入事件调用同一幂等解析服务。 - 不做：颜色映射命中但完整组合不唯一时不写 `spec_mappings`，不自动创建采购任务。 - 不做：不覆盖人工完整映射，不降低库存、价格、数量、上下文或真实采购安全门禁。 - 不做：不修改 Client 接口和 `pdd_data` 契约，不让 Client 猜测规格。 ## 怎么做 - 增加一个不依赖 Gin 的幂等 service：读取 SYB 当前上下文、解析蝦皮侧颜色、读取当前 PDD 商品颜色映射、筛选最新 `available=true` 的完整 PDD 组合，再复用现有维度排序和确定性匹配。 - 颜色解析失败、颜色映射缺失/失效、PDD 关联变化、第三维度未提供、剩余维度没有唯一结果时返回明确“不生成”的业务结论，不视为系统错误。 - 只有完整组合唯一且再次通过 `OptionKey`、可购买性及上下文版本校验时，使用 `UpsertAutomaticSpecMapping` 写入 `source=rule`，记录规则版本、颜色映射依据和上下文版本；人工 `source=manual` 永不被覆盖。 - 同一个共享服务由三处事务调用：颜色映射保存后处理该商品既有待匹配 SYB 明细；SYB 同步新增/更新明细后处理当前行；PDD 采集结果成功入库后处理关联商品待匹配明细。预期的“不唯一/无映射”不阻塞主业务，数据库错误按所属事务回滚并记录脱敏错误。 - 处理阶段仍以现有有效 `spec_mappings` 为准，不增加“只有颜色已匹配即可采购”的旁路。 - AI 和人工完整规格匹配保持现有优先级；颜色映射只缩小候选，不给 AI 或 Client 传入不存在的候选。 ## 验收标准 - [ ] 有效颜色映射加上唯一剩余维度时，生成当前 PDD 商品下的完整有效 `spec_mappings`。 - [ ] 颜色命中但尺码或第三维度不唯一时不生成完整映射，SYB 保持待匹配并可继续人工/AI处理。 - [ ] 蝦皮颜色解析失败、颜色映射缺失/失效或目标颜色无可购买组合时不猜测、不写入。 - [ ] 更换 PDD 商品、PDD 重采目标消失和上下文并发变化均阻止旧结果写入。 - [ ] 已有人工完整映射不被规则结果覆盖；规则结果写入来源、版本、原因和既有决策审计。 - [ ] 三个写入事件都能幂等调用共享服务，重复处理不会产生不同结果或重复副作用。 - [ ] SYB 处理阶段和采购创建继续只读取完整有效 `spec_mappings`。 - [ ] Client 四接口及任务载荷保持兼容，不自动创建采购任务、不下单、不付款。 ## 怎么验证 固定 Go 1.23.0 执行颜色映射到完整规格的 service/repository/handler 定向测试、Client 契约测试和全量 test/build/vet；MySQL 8.4 `_test` 验证并发上下文和事务回滚。浏览器验证颜色保存后 SYB 行阶段更新；使用脱敏数据覆盖唯一、缺失、失效、多候选、第三维度、人工覆盖和重复事件。 ## 风险和回��� - 风险：这是影响真实采购候选的关键链路，任何非唯一结果都必须保守阻断；不得因提高自动化率放宽唯一性。 - 风险：在多个写入事件中调用同一服务可能产生锁竞争；查询按商品和待匹配明细限定范围，保持幂等并避免全表扫描。 - 回退：关闭三个事件中的颜色辅助派生调用，即恢复现有逐条人工/AI完整规格流程；已经生成且仍有效的规则映射按现有来源规则保留，可由人工覆盖。
ila commented 2026-08-24 00:05:02 +08:00
Author
Owner
Copy Link
Copy Source

????????????????????????????????:???????,????????????????????? rule ?? spec_mappings;????????,???/??????????

????????????????????????????????:???????,????????????????????? rule ?? spec_mappings;????????,???/??????????
ila commented 2026-08-24 00:17:33 +08:00
Author
Owner
Copy Link
Copy Source

????,???????

  • ????:486a374
  • ????:79237fc
  • ??:docs/task/295-????????????????.md
  • ????:?????SYB ?????PDD ??????
  • ??:????????????? rule;?????????????;????????? Client ??
  • ??:?? Go 1.23.0 build/test/vet ???
  • ???:?? MySQL 8.4 _test ???/??????? v30??? SYB/Client ???
????,??????? - ????:486a374 - ????:79237fc - ??:docs/task/295-????????????????.md - ????:?????SYB ?????PDD ?????? - ??:????????????? rule;?????????????;????????? Client ?? - ??:?? Go 1.23.0 build/test/vet ??? - ???:?? MySQL 8.4 _test ???/??????? v30??? SYB/Client ???
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: chengma/cmautobuy#295