Table of Contents

31 PDD 商品档案与规格 JSON 管理

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

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

31 PDD 商品档案与规格 JSON 管理

类型：需求
所属 Epic：#1
所属 MVP / 版本：采集闭环后的商品档案阶段
状态：已完成
日期：2026-08-17
Gitea 工单：#31
Wiki 页面：Task-31-PDD-product-archive
Wiki revision：以页面当前 revision 为准

背景与目标

PDD 商品需要作为采购人员长期复用的独立档案，采集只是维护最新资料的一种方式。商品最简创建只输入包含 goods_id 的 PDD URL，并允许人工完整维护或由采集结果自动更新标题、店铺、销量、评价和规格。

最终方案

先完成并由用户确认 QuantUX 原型，再实施数据库、API 和 Admin 页面。
pdd_product 保存标题、店铺、数字销量/评价、pending/active/disabled 状态及最新 specs_json，不建立规格、SKU 或历史子表。
规格使用 color/size/other 通用多维结构；只有颜色值保存整数分价格，规格值保存是否可选择。
人工编辑全量覆盖；completed 采集全量覆盖；completed_partial 只合并明确采集到的数据；failed 不修改商品。
URL 创建继续按 goods_id 唯一，采集任务保存自己的 URL、goods_id 和规则快照。
PDD 商品列表多选和批量创建采集任务从本工单拆到独立 #45，避免商品档案与批量任务耦合。

修改文件

server/app/goauto/models/schema.go、server/app/goauto/migrations/：商品档案字段与 MySQL 8.4 增量迁移。
server/app/goauto/product/：商品创建、查询、完整覆盖编辑和规格 JSON 校验。
server/app/goauto/task/result_service.go：任务完成事务内更新商品最新档案。
web/src/views/goauto/pdd-products/、web/src/api/goauto/pdd-products.js：列表、添加、详情和编辑页面。
web/tests/e2e/pdd-product-module.spec.ts：页面和请求回归测试。
prototypes/quantux-pdd-product-6a81db5d191a826306a7edd6.html：已确认 QuantUX 离线原型。

验收结果

验收标准	结果
URL 最简创建并唯一校验 goods_id	通过
人工完整维护基础资料与通用规格 JSON	通过
完整、部分和失败采集按规则更新商品	通过
颜色价格使用整数分，尺码不单独定价	通过
不引入规格、SKU 或历史子表	通过
Admin 列表、添加、详情、编辑符合确认原型	通过
三星任务 35 部分结果写回商品档案	通过：3 个颜色价格和 1 个尺码已写入
用户验收	2026-08-17 明确通过

测试

scripts/verify.ps1 -Component server：通过。
scripts/verify.ps1 -Component web：通过，0 lint error；上游既有 warnings 不属于本工单。
pnpm exec playwright test tests/e2e/pdd-product-module.spec.ts：1 passed。
MySQL 8.4 增量迁移 1786700500000：通过。
三星任务 35：completed_partial；标题、店铺、销量、3 个颜色价格和 1 个尺码自动更新到 PDD 商品。评价数量未识别，用户决定暂不处理。
未验证部分：#45 的列表多选和批量采集任务尚未实施，不属于本工单代码范围。

遗留问题

PDD 商品列表多选和批量创建采集任务由 #45 实施。
三星评价数量兼容暂不处理，部分结果不会猜测或填写为 0。