feat(edit): 商品编辑页优化

docs/product/ozon-dynamic-attributes-and-sku-form-plan.md

@@ -4,7 +4,7 @@
 
 ## 1. 目标与原则
 
-Ozon 商品的必填属性由 `description_category_id` 与 `type_id` 对应的类目 schema 决定；同一 Ozon 平台的所有门店共用该 schema。编辑器不得为儿童玩具、服装、食品等类目分别硬编码字段，而应使用 Ozon 返回的 `is_required`、`is_aspect`、`dictionary_id`、`is_collection`、`max_value_count`、`type` 与复杂属性信息驱动展示、填报和发布校验。当前编辑器和首次发布预检均读取平台级类目、属性和字典缓存；真正创建发布 job 并调用 Ozon 的闭环仍待后续实现。
+Ozon 商品的必填属性由 `description_category_id` 与 `type_id` 对应的类目 schema 决定；同一 Ozon 平台的所有门店共用该 schema。编辑器不得为儿童玩具、服装、食品等类目分别硬编码字段，而应使用 Ozon 返回的 `is_required`、`is_aspect`、`dictionary_id`、`is_collection`、`max_value_count`、`type` 与复杂属性信息驱动展示、填报和发布校验。唯一的编辑器业务例外是名为“商品颜色”的 SKU 字典属性：即使 schema 标记为单值或选填，也按多选控件、最多 100 个值和上架必填处理。当前编辑器和首次发布预检均读取平台级类目、属性和字典缓存；真正创建发布 job 并调用 Ozon 的闭环仍待后续实现。
 
 页面继续以 Atlas 商品和 SKU 为编辑主体：主要信息保留稳定的商品级字段，Ozon 类目属性按通用属性和 SKU 变体属性拆分。保存草稿允许信息不完整；首次上架必须由服务端按当时有效的类目 schema 重新校验。
 
@@ -21,7 +21,9 @@ Ozon 商品的必填属性由 `description_category_id` 与 `type_id` 对应的
 - 品牌；
 - 默认包装重量与默认包装尺寸。
 
-默认包装规格是父商品级默认值。每个 SKU 默认继承该值；当某个 SKU 的包装不同，可在 SKU 卡片中设置包装重量和包装尺寸覆盖值。SKU 未填写覆盖值不表示缺失，而是继续继承主要信息中的默认包装规格。
+默认包装规格是父商品级默认值。每个 SKU 默认继承该值；当某个 SKU 的包装不同，可在 SKU 卡片中设置包装重量和包装尺寸覆盖值。SKU 未填写覆盖值不表示缺失，而是继续继承主要信息中的默认包装规格。包装重量和包装尺寸属于 Ozon 导入接口的固定物流字段，而不是由类目 schema 决定归属的动态属性：编辑器可以在重量、尺寸后分别提供“按 SKU 填写”的入口，但这只开启对应字段的 SKU 覆盖编辑，不应删除 SPU 默认值或把继承值冗余持久化到所有 SKU。
+
+创建 Ozon 发布请求时，服务端必须为每个待发布 SKU 计算有效包装规格：SKU 覆盖值优先，否则取 SPU 默认值。每个 `/v3/product/import` 的 `items[]` 都要写入 `depth`（由 `length_mm` 映射）、`width`、`height`、`dimension_unit=mm`、`weight`（由 `shipping_weight_g` 映射）和 `weight_unit=g`；四个数值均必须存在且大于 0。该“逐 SKU 展开”发生在发布快照/payload 适配层，不要求草稿存储复制同一组 SPU 值。
 
 品牌和型号既是主要信息，也是可供采集、AI 与多平台复用的 Atlas 标准字段。如果 Ozon 当前类目同时返回对应平台属性，发布适配器应建立显式映射并确保只有一个最终事实来源；字典型品牌必须由用户确认 Ozon 字典值，不能把自由文本直接冒充字典 ID。
 
@@ -37,6 +39,8 @@ Ozon 商品的必填属性由 `description_category_id` 与 `type_id` 对应的
 - 整数、十进制、布尔、文本和字典分别使用适合的输入控件。
 - 复杂属性按 Ozon 的复杂属性结构分组展示，发布时进入 `complex_attributes`，不得扁平化为普通属性。
 
+“商品净重”和“商品尺寸”不等同于 Ozon 的包装物流规格，也不能因为 SKU 存在而默认显示。它们只有在当前类目 schema 返回相应属性时才展示：`is_aspect=true` 放入 SKU，`is_aspect=false` 放入 SPU；是否为上架必填由 `is_required` 决定。Atlas 可继续保存实物规格供尺寸图等内部能力使用，但不能把它当作 Ozon 固定物流字段，也不得替代有效包装规格。
+
 例如，儿童玩具类目把「最小儿童年龄」和「最大儿童年龄」标为必填时，两个字段应直接显示在产品属性区，并在各自 Label 前显示红色 `*`。如果它们是字典属性，必须选择 Ozon 返回的年龄值，而不是任意输入文本。
 
 ### 2.3 SKU 设置
@@ -49,7 +53,7 @@ Ozon schema 中 `is_aspect=true` 的属性放入每个 SKU 卡片的「Ozon 变
 - Ozon 变体属性，例如颜色、尺码；
 - 采购价、售价和划线价；
 - SKU 图片；
-- SKU 实物规格；
+- 当前 schema 要求或允许的 SKU 级商品净重/尺寸属性；
 - 对父商品默认包装规格的可选覆盖。
 
 SKU 中的 Ozon 必填变体属性同样只在 Label 前显示红色 `*`。父商品默认包装规格与 SKU 覆盖值应明确显示继承关系，例如「继承默认值：320 g」和「为此 SKU 单独设置」。
@@ -157,7 +161,7 @@ GET /api/product-platform-profiles/{profile_id}/validation
 - 所有通用必填属性有合法值；
 - 每个待上架 SKU 的必填变体属性有合法值；
 - 字典值、单/多值数量、数值类型与复杂属性结构有效；
-- SKU 的 `offer_id`、条形码、价格、图片和有效包装规格符合发布要求；
+- SKU 的 `offer_id`、条形码、价格、图片和有效包装规格符合发布要求；有效包装规格按“SKU 覆盖值 → SPU 默认值”解析，且在创建发布快照前必须可展开为该 SKU 的完整 Ozon 物流字段；
 - 已上架 SKU 返回 `not_publishable_again`，不作为普通字段缺失处理。
 
 `POST /publish-jobs` 必须调用同一套校验，不能信任浏览器校验结果。保存草稿和创建发布任务应继续保持各自的事务与幂等边界。