V2.2 商品 AI 编辑页
状态:需求与架构设计,尚未开发。本文及同目录文档优先于
docs/v2.1/中关于商品编辑页、试算页和多 SKU 的旧设计。
1. 目标
V2.2 用一张「商品(SPU)」和多个「可售 SKU」表达一个采集商品,重做当前商品编辑页为 商品 AI 编辑页。不在旧 /trial/:id 上继续叠加多 SKU 功能;旧试算页在 V2.2 开发完成前保持可用但冻结。
编辑页需要支持:
- 维护可扩展的通用属性和 SKU 独立属性;
- 为每个 SKU 管理图片、视频与视频封面;
- 从包装物流规格发起定价,确认后回填 SKU 售价和划线价;
- AI 生成标题、标签、简介等通用内容,以及按 SKU 生成尺寸图和套图;
- 为后续「上架至 Ozon」保留一 SKU 一 offer 的稳定发布模型。
2. 已确认决策
| 主题 | 决策 |
|---|---|
| Ozon 可售单元 | 一个本地 SKU 对应一个独立 Ozon offer_id 和一个 /v3/product/import.items[] 项。 |
| Ozon 变体 | 类目接口的 is_aspect=true 属性(如颜色/尺码)作为 SKU 属性提交;不假定 Ozon 会自动把多个 item 合并为一个前台变体组,发布阶段另行真机验证。 |
| 型号和货号 | 型号是父商品的通用属性;同一商品所有 SKU 共用。货号是 SKU 属性,后续可由 AI 生成、用户可编辑。 |
| 尺寸图 | 必须逐 SKU 生成,只读取该 SKU 已确认的实物规格快照。 |
| 计价 | 不在页面常驻展示试算卡;每个 SKU 的「定价」弹窗使用其有效包装物流规格计算,确认后回填售价与划线价。 |
| 图片采集 | 1688、淘宝、天猫当前不能可靠地按 SKU 采集图片。采集主图、详情图作为商品候选素材;已能稳定归属的 SKU 图才绑定 SKU。 |
| 单规格商品 | 单规格商品也必须有一条默认 SKU。SKU 不是“有多规格时才存在”的可选结构;它是定价、媒体选择、货号和未来 Ozon offer 的统一可售单元。 |
| 字段继承 | “SKU 字段为空”只表示该 SKU 的某一可继承字段未覆盖父商品默认值,绝不表示 SKU 记录、SKU 名称或货号为空,更不表示单规格商品。 |
| 动态类目属性 | 先选 Ozon description_category_id + type_id,再读取该类目的属性 schema。is_aspect=true 默认归入 SKU 变体属性;其他属性默认归入通用属性,但允许业务显式改为 SKU 属性。 |
| 编辑页 | 用新的商品 AI 编辑页替代旧商品编辑页;不修改旧试算页来承载多 SKU。 |
3. Ozon 文档依据
仓内 docs/ozon-seller-api/04-product-import.md 表明,/v3/product/import 的每个 items[] 都必须提供自己的 offer_id、price、包装 depth/width/height/weight 和图片;尺寸与重量不得为零。一次请求可提交最多 100 个 item。03-category-attributes.md 定义 is_aspect=true 为区分 SKU 变体的类目属性。
因此,独立 offer 不是仅为本地方便的选择,而是与 Ozon 导入契约相符的最小稳定粒度。现有本地文档没有描述可通过一个变体组 ID 将多个 import item 强制合并,故发布设计应以独立 offer 为事实来源;前台变体合并只能作为后续经验证的增强。
4. 文档索引
| 文档 | 内容 |
|---|---|
| product-ai-editor.md | 页面信息架构、交互和保存行为 |
| data-model.md | SPU/SKU、属性、素材、定价和迁移数据模型 |
| api.md | 编辑页、SKU、素材、定价与 AI 的服务端契约 |
5. 范围与非目标
本期先完成编辑、校验、草稿保存和可审阅的数据模型。按钮「上架至 Ozon」可以先呈现为不可用或提示“后续开发”,不得在本期调用 Ozon。AI 套图抽屉沿用现有方案能力作为设计基线,具体交互与任务契约另行讨论后开发。
CSV、Ozon API 直传、库存、审核轮询和前台变体归并均属于后续发布阶段;但字段与接口必须避免妨碍它们。