[MVP] Admin：蝦皮与 PDD 商品级颜色映射 #291

New Issue

2026-08-24T11:29:25+08:00

ila commented

2026-08-24 11:29:25 +08:00

基本信息

类型：需求
父级大工单：#14
所属 MVP / 版本：本工单
阶段：商品级颜色映射闭环

背景与目标

当前 Admin 已经维护蝦皮商品与 PDD 商品关联，也能把某条 SYB 完整规格映射为一个完整 PDD 可购买组合；但缺少“蝦皮侧颜色 → 当前 PDD 商品颜色”的商品级可视化维护能力，采购员仍需在不同 SYB 订单中重复判断颜色名称差异。

本 MVP 建立一次维护、后续复用的商品级颜色映射，并把它安全接入现有完整规格映射流程。颜色映射只确定颜色维度，不代表完整规格已经可采购；只有剩余尺码、款式等维度唯一确定并形成有效 spec_mappings 后，才允许创建采购任务。

做什么 / 不做什么

做：在蝦皮数据模块下增加独立的颜色匹配页面和入口，不增加新的顶部模块。
做：按蝦皮商品与当前 PDD 商品隔离颜色映射，允许多个蝦皮颜色对应同一个 PDD 颜色。
做：保留两端原始颜色，记录当前映射、来源、上下文版本和修改审计。
做：PDD 颜色选择来自最新可购买规格；更换 PDD 商品或目标颜色消失时按明确规则隔离或失效。
做：颜色映射命中后，只在其余维度唯一确定时生成现有完整规格映射；否则继续走现有人工候选或 AI 流程。
不做：不增加尺码映射维护页面，不覆盖蝦皮或 PDD 原始规格。
不做：不把颜色映射直接当成可采购的完整规格，不绕过价格、库存、上下文和完整 PDD 组合校验。
不做：不修改 Client 接口，不让 Client 或 Android Agent 本地猜测颜色、尺码或其他维度。
不做：不增加新 AI 配置或自动创建采购任务。

已确认总体方案

先制作符合 cmautobuy 当前界面规范的本地 HTML 交互原型，用户确认后再实施生产代码。
增加商品级颜色映射当前表和只追加决策审计表；当前映射唯一键包含 shopee_goods_id、蝦皮颜色身份键和 pdd_goods_id。
页面使用蝦皮正式 SKU 颜色与能够可靠解析的 SYB 历史观测颜色组成“蝦皮侧颜色集合”，逐项标明来源；无法可靠解析的原文不猜测。
PDD 颜色维度从采集结果 dimensions 识别并保存实际维度键，不写死 JSON 键为 color；可选值只来自最新可购买组合。
PDD 下拉按“当前选择 / 未使用的颜色 / 已经匹配（仍可选择）”分组；支持多对一，部分保存和明确清除。
保存携带由当前蝦皮颜色集合、PDD 关联、PDD 规格快照和规则版本计算的上下文版本；数据变化时拒绝陈旧提交。
SYB 处理时先解析蝦皮侧颜色并读取商品级颜色映射，再匹配剩余维度；仅有一个完整可购买组合时，按 rule 来源写入现有 spec_mappings 和既有决策审计。
页面沿用 Admin 服务端渲染、原生 JavaScript、CSRF、当前用户权限和 1366×768 三段式布局。

阶段与子工单

Stage A：交互原型及用户确认。
Stage B1：数据模型、仓储服务、失效与审计规则。
Stage B2：蝦皮颜色匹配可视化页面。
Stage B3：接入 SYB 完整规格解析和采购门禁。
MVP 集成回归与用户验收。

#292 Admin：设计蝦皮与 PDD 商品颜色匹配交互原型
#293 Admin：建立商品级颜色映射数据模型与失效审计规则（依赖 #292 原型确认及数据库实施授权）
#294 Admin：实现蝦皮与 PDD 商品颜色匹配可视化页面（依赖 #292、#293）
#295 Admin：商品颜色映射接入 SYB 完整规格解析与采购门禁（依赖 #293、#294）
#296 Admin：部署商品级颜色映射版本到生产（依赖 #293、#294、#295）
#297 Admin：蝦皮数据支持按 PDD 商品 ID 反查（列表检索补充）

MVP 验收标准

用户确认 cmautobuy 专用颜色匹配原型。
两端原始颜色和完整规格数据均不被映射操作覆盖。
多个蝦皮侧颜色可以映射到同一 PDD 颜色，未使用颜色优先展示。
更换 PDD 商��不会误用旧颜色映射；PDD 重新采集后目标消失会明确标记失效。
陈旧页面提交被拒绝，颜色映射修改和清除有可追踪审计。
颜色映射不能独立进入采购；仅剩余维度唯一且完整组合仍可购买时，才生成有效完整规格映射。
不能唯一确定时继续人工或 AI 流程，不猜测、不静默跳过。
不修改 Client 接口，不自动创建采购任务，不自动付款。
固定 Go 1.23.0 的全量 test、build、vet，以及 MySQL 8.4 首建、升级、重放和浏览器关键流程验证通过。

依赖、风险和回退

依赖现有蝦皮商品与 PDD 关联、shopee_skus、pdd_products.skus_json、spec_mappings 和 SYB 规格解析。
风险：错误的颜色维度识别或陈旧 PDD 快照可能导致完整规格生成错误；必须保存实际维度键、执行上下文版本校验，并在生成完整映射前重新验证当前可购买组合。
风险：蝦皮正式 SKU 颜色和 SYB 观测颜色来源不同；页面必须标明来源，只有可靠解析结果可参与映射。
数据库迁移按下一个未占用 MySQL schema 版本追加，不能修改已发布迁移；开始生产实现前仍需用户明确授权。
回退时关闭颜色映射入口和派生规则即可恢复现有逐条完整规格匹配；新表和审计数据保留，已经生成且仍有效的完整 spec_mappings 不做破坏性删除。

AI 辅助颜色建议范围补充（2026-08-24）

经用户确认，颜色匹配页面增加一次性 AI 建议：模型只在当前可购买 PDD 颜色白名单中，为待匹配或已失效的蝦皮颜色生成未保存草稿；有效人工映射和本页人工修改不被覆盖，采购员核对后仍通过现有“保存修改”、事务审计和完整规格门禁生效。不新增数据库结构、AI 配置或 Client 接口，不让 AI 点击直接写映射。

#298 Admin：商品颜色匹配增加 AI 建议与人工确认
#299 Admin：部署 PDD 反查与 AI 颜色建议版本到生产（依赖 #297、#298）

## 基本信息 - 类型：需求 - 父级大工单：#14 - 所属 MVP / 版本：本工单 - 阶段：商品级颜色映射闭环 ## 背景与目标当前 Admin 已经维护蝦皮商品与 PDD 商品关联，也能把某条 SYB 完整规格映射为一个完整 PDD 可购买组合；但缺少“蝦皮侧颜色 → 当前 PDD 商品颜色”的商品级可视化维护能力，采购员仍需在不同 SYB 订单中重复判断颜色名称差异。本 MVP 建立一次维护、后续复用的商品级颜色映射，并把它安全接入现有完整规格映射流程。颜色映射只确定颜色维度，不代表完整规格已经可采购；只有剩余尺码、款式等维度唯一确定并形成有效 `spec_mappings` 后，才允许创建采购任务。 ## 做什么 / 不做什么 - 做：在蝦皮数据模块下增加独立的颜色匹配页面和入口，不增加新的顶部模块。 - 做：按蝦皮商品与当前 PDD 商品隔离颜色映射，允许多个蝦皮颜色对应同一个 PDD 颜色。 - 做：保留两端原始颜色，记录当前映射、来源、上下文版本和修改审计。 - 做：PDD 颜色选择来自最新可购买规格；更换 PDD 商品或目标颜色消失时按明确规则隔离或失效。 - 做：颜色映射命中后，只在其余维度唯一确定时生成现有完整规格映射；否则继续走现有人工候选或 AI 流程。 - 不做：不增加尺码映射维护页面，不覆盖蝦皮或 PDD 原始规格。 - 不做：不把颜色映射直接当成可采购的完整规格，不绕过价格、库存、上下文和完整 PDD 组合校验。 - 不做：不修改 Client 接口，不让 Client 或 Android Agent 本地猜测颜色、尺码或其他维度。 - 不做：不增加新 AI 配置或自动创建采购任务。 ## 已确认总体方案 1. 先制作符合 cmautobuy 当前界面规范的本地 HTML 交互原型，用户确认后再实施生产代码。 2. 增加商品级颜色映射当前表和只追加决策审计表；当前映射唯一键包含 `shopee_goods_id`、蝦皮颜色身份键和 `pdd_goods_id`。 3. 页面使用蝦皮正式 SKU 颜色与能够可靠解析的 SYB 历史观测颜色组成“蝦皮侧颜色集合”，逐项标明来源；无法可靠解析的原文不猜测。 4. PDD 颜色维度从采集结果 `dimensions` 识别并保存实际维度键，不写死 JSON 键为 `color`；可选值只来自最新可购买组合。 5. PDD 下拉按“当前选择 / 未使用的颜色 / 已经匹配（仍可选择）”分组；支持多对一，部分保存和明确清除。 6. 保存携带由当前蝦皮颜色集合、PDD 关联、PDD 规格快照和规则版本计算的上下文版本；数据变化时拒绝陈旧提交。 7. SYB 处理时先解析蝦皮侧颜色并读取商品级颜色映射，再匹配剩余维度；仅有一个完整可购买组合时，按 `rule` 来源写入现有 `spec_mappings` 和既有决策审计。 8. 页面沿用 Admin 服务端渲染、原生 JavaScript、CSRF、当前用户权限和 1366×768 三段式布局。 ## 阶段与子工单 1. Stage A：交互原型及用户确认。 2. Stage B1：数据模型、仓储服务、失效与审计规则。 3. Stage B2：蝦皮颜色匹配可视化页面。 4. Stage B3：接入 SYB 完整规格解析和采购门禁。 5. MVP 集成回归与用户验收。 - [x] #292 Admin：设计蝦皮与 PDD 商品颜色匹配交互原型 - [ ] #293 Admin：建立商品级颜色映射数据模型与失效审计规则（依赖 #292 原型确认及数据库实施授权） - [ ] #294 Admin：实现蝦皮与 PDD 商品颜色匹配可视化页面（依赖 #292、#293） - [ ] #295 Admin：商品颜色映射接入 SYB 完整规格解析与采购门禁（依赖 #293、#294） - [ ] #296 Admin：部署商品级颜色映射版本到生产（依赖 #293、#294、#295） - [ ] #297 Admin：蝦皮数据支持按 PDD 商品 ID 反查（列表检索补充） ## MVP 验收标准 - [ ] 用户确认 cmautobuy 专用颜色匹配原型。 - [ ] 两端原始颜色和完整规格数据均不被映射操作覆盖。 - [ ] 多个蝦皮侧颜色可以映射到同一 PDD 颜色，未使用颜色优先展示。 - [ ] 更换 PDD 商��不会误用旧颜色映射；PDD 重新采集后目标消失会明确标记失效。 - [ ] 陈旧页面提交被拒绝，颜色映射修改和清除有可追踪审计。 - [ ] 颜色映射不能独立进入采购；仅剩余维度唯一且完整组合仍可购买时，才生成有效完整规格映射。 - [ ] 不能唯一确定时继续人工或 AI 流程，不猜测、不静默跳过。 - [ ] 不修改 Client 接口，不自动创建采购任务，不自动付款。 - [ ] 固定 Go 1.23.0 的全量 test、build、vet，以及 MySQL 8.4 首建、升级、重放和浏览器关键流程验证通过。 ## 依赖、风险和回退 - 依赖现有蝦皮商品与 PDD 关联、`shopee_skus`、`pdd_products.skus_json`、`spec_mappings` 和 SYB 规格解析。 - 风险：错误的颜色维度识别或陈旧 PDD 快照可能导致完整规格生成错误；必须保存实际维度键、执行上下文版本校验，并在生成完整映射前重新验证当前可购买组合。 - 风险：蝦皮正式 SKU 颜色和 SYB 观测颜色来源不同；页面必须标明来源，只有可靠解析结果可参与映射。 - 数据库迁移按下一个未占用 MySQL schema 版本追加，不能修改已发布迁移；开始生产实现前仍需用户明确授权。 - 回退时关闭颜色映射入口和派生规则即可恢复现有逐条完整规格匹配；新表和审计数据保留，已经生成且仍有效的完整 `spec_mappings` 不做破坏性删除。 ## AI 辅助颜色建议范围补充（2026-08-24）经用户确认，颜色匹配页面增加一次性 AI 建议：模型只在当前可购买 PDD 颜色白名单中，为待匹配或已失效的蝦皮颜色生成未保存草稿；有效人工映射和本页人工修改不被覆盖，采购员核对后仍通过现有“保存修改”、事务审计和完整规格门禁生效。不新增数据库结构、AI 配置或 Client 接口，不让 AI 点击直接写映射。 - [ ] #298 Admin：商品颜色匹配增加 AI 建议与人工确认 - [ ] #299 Admin：部署 PDD 反查与 AI 颜色建议版本到生产（依赖 #297、#298）

ila commented

2026-08-24 11:43:38 +08:00

MVP ????:#292 ???????????;#293?#294?#295 ???????????????,??????????????? MySQL v30 ????,??????

ila referenced this issue

2026-08-24 15:18:43 +08:00

[Epic] Admin 采集采购管理端 #14

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: OPC/cmautobuy#291