OPC/goauto

Table of Contents

69 蝦皮与 PDD 规格匹配

背景与目标
最终方案
修改文件
验收结果
测试
遗留问题
相关提交

69 蝦皮与 PDD 规格匹配

类型：需求
所属 Epic：采购闭环
所属 MVP / 版本：采购 MVP
状态：待验收
日期：2026-08-23
Gitea 工单：#69
Wiki 页面：Task-69-蝦皮与-PDD-规格匹配
Wiki revision：以线上页面 revision 为准
设计证据：prototypes/69/v2/index.html，用户于 2026-08-23 确认

背景与目标

蝦皮与 PDD 的颜色名称可能不同，需要采购人员可视化建立明确对应关系；尺码应优先批量完成唯一确定性匹配，剩余项目再人工选择。映射操作不得修改两端原始规格，Android Agent 只接收服务端最终确定的 PDD 原始标签。

最终方案

继续使用 shopee_product.specs_json 保存每个蝦皮商品独立的规格映射，不新增数据库表或迁移。
颜色使用关联 PDD 商品当前可选颜色的可搜索下拉框；未使用颜色优先，已被其他蝦皮颜色使用的选项仍可选择并显示占用者，支持多对一。
新增只读计算接口批量预览尺码：只接受繁简、空白、大小写、全半角等统一后的唯一确定结果；没有唯一结果则保留待人工选择。
单一“保存修改”提交全部变更；自动尺码建议经采购人员显式保存后确认生效，离开未保存页面会提示。
PDD 目标规格消失后页面显示“已失效”；服务端拒绝保存不存在的目标，采购预检和任务创建也拒绝使用失效映射。
SYB “去匹配”快捷入口携带目标颜色，蝦皮详情打开后突出对应行。
Android Agent 无改动，不增加本地猜测能力。

修改文件

server/app/goauto/shopeeproduct/：确定性尺码预览、映射目标校验、Admin 路由及测试。
server/app/goauto/purchase/：采购预检和创建的失效映射门禁及测试。
web/src/views/goauto/shopee-products/index.vue：按 v2 原型实现颜色/尺码映射交互。
web/src/views/goauto/syb-products/index.vue：快捷入口传递当前目标颜色。
web/src/api/goauto/shopee-products.js：尺码预览接口封装。
核心 Wiki 与 docs/ 镜像：架构、业务规则、共享 API 和工单索引。

验收结果

验收标准	结果
两端原始规格保持不变，映射独立保存与覆盖	通过（自动化与代码检查）
尺码批量匹配只接受唯一确定结果	通过（Go 单元测试）
PDD 规格变化能识别并拦截失效项	通过（服务端单元测试与 Web 状态逻辑）
采购优先使用已确认映射，Agent 不猜测规格	通过（采购服务测试；Agent 未修改）
Web 颜色分组、多对一和单一保存入口	待用户页面验收

测试

.\scripts\verify.ps1 -Component all：Go 全量测试与构建、Web lint/生产构建、Android 单元测试和 debug APK 构建均通过；Web 仅有仓库既有 warning。
python dev_scripts/harness.py check --strict：通过。
python dev_scripts/harness.py sync --verify：在本次命令中临时使用当前 Gitea URL 后通过，四个核心镜像已更新。
git diff --check：通过。
未验证部分：当前浏览器运行时没有可用浏览器会话，未执行登录态页面点击走查；未进行真机采购或创建订单，本工单也不包含该高风险动作。

遗留问题

等待用户在本地管理端验收规格匹配页面。
本机全局 Gitea 环境变量仍指向旧入口，直接运行 harness 会失败；本次使用命令级当前地址覆盖完成同步。未在 #69 中修改本机凭据或环境配置。

相关提交

67d8f32 feat(#69): add Shopee PDD specification mapping