Files
2026-09-02 17:52:05 +08:00
..
2026-09-02 17:52:05 +08:00
2026-09-02 17:52:05 +08:00
2026-09-02 17:52:05 +08:00
2026-09-02 17:52:05 +08:00

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 直传、库存、审核轮询和前台变体归并均属于后续发布阶段;但字段与接口必须避免妨碍它们。