短剧与货盘术语

版本：v1.13
日期：2026-10-11
状态：执行基线
维护人：Cursor
上级：度裁知识库 README
迁自：drama/MCW-服装素材与平台货盘复用方案.md §2.1–§2.3 · drama/ID映射与权威落点.md §2/§4
全库前缀：MCW / SM / dct_ 等见 02-工程简写与术语.md

A. 业主心智 ↔ 项目术语

记忆口诀：SPU 是款，SKU 是款×尺码，SKC 是款×色（短剧挂车用色码）。

B. 货盘表职责（一张表干什么）

关系（自上而下）：

bff_mall_catalog_items.item_json     ← 商家可变商品包（含 skcs[] / skus[]；唯一货盘权威）
        ↑ B1 下发（dist 为上游）
app_merchant_products                ← 管理者货盘登记 / 上下架
bff_mall_store_authorizations        ← 下游「谁在卖」（只读管理者池）
        ↓
drama_garment_plot                   ← 短剧剧情（按 skc_code）

2026-10-11 并轨：原全局表 bff_catalog_items（平台款主档投影）、bff_catalog_skus（SKU 行表）、
bff_mall_catalog_skus（B1 SKU 版本表）三张已删表——读源与写点全部并入
bff_mall_catalog_items.item_json；分销 fashion_dist 为唯一商品主数据来源。
详见《商品主数据并轨升级方案》P5。

C. 货盘易混点

1. bff_mall_catalog_items ≠ 全局版型表
   主键是 (merchant_id, num_iid)：同一 num_iid 在不同商家各有一份 item_json（内容通常一致，但 MCW 改图/删花色写的是本商家这份）。

2. SKC ≠ SKU
   - SKC：花色级（skc_code + 试穿/模特/平铺图 + 剧情档案）
   - SKU：花色 × 尺码（下单、价、库存口径）
   服装管理页列表展的是 SKC；SKU 行存在 bff_mall_catalog_items.item_json.skus[]，无 B1 包时由 SKU 聚色 得到 SKC。

3. 「列表有哪些款」看谁
   - 管理者货盘：bff_mall_catalog_items（按 merchant_id + brand_id）叠 app_merchant_products 上下架/软删。
   - 下游谁在卖：只看 bff_mall_store_authorizations（catalog_merchant_id = 管理者）。零售禁止再 bind 同一 num_iid。
   展示字段一律取本商家 mall 活副本（bff_mall_catalog_items），禁止跨商家覆盖。

4. 「下架整款」≠「删一个花色」
   - 整款下架：app_merchant_products.status=offline（DELETE /drama/garments/{skc_code} 语义）
   - 删单个 SKC：MCW 管理页 DELETE …/garments/{product_id}/skcs/{skc_code}，改 catalog 包内 skcs[]，不是分销意义上的下架整款。

5. SKC 图三件套（flatlay / image_main / model_images）
   - flatlay：平铺 / 试穿 / 短剧锁款底图（has_flatlay · flatlay_url）
   - image_main：花色代表图 / 色块缩略图（列表与 C 端轮播首帧优先）
   - model_images[]：模特穿着效果图，仅展示；禁止当 flatlay 或试穿服装图
   - 就绪 flatlay_or_main：两字段至少其一 HTTP 可用；缺则黄灯不挡建档
   - 淘宝导入分字段落盘：商家自助登记 §4.4 · MCW §2.6

6. 导入须按花色建档（P0）
   import_garment_pack 为每个 SKC 写一条 drama_garment_plot（款级底稿 + 色名差分），禁止把同一段口播复制到所有色。剧情 LLM 导入后后台异步增强，手改过的花色不覆盖。详见 商家自助登记 §4.5。

7. 导入尺码：规格字 ≠ 适体区间（v0.6）
   26 / S / 2XL 都是客户习惯的 size_code，荐码认的是该档 body_interval_chart 适体区间。淘宝「尺寸表」齐套为尺码 + 身高 + 体重 + 腰围 + 臀围：身高/体重直接入 stature / body_mass_kg，腰臀成衣减松量。清洗剥掉「偏大一码」等营销句，不把 26 改写成 S。淘宝「裤长」是成衣附加列（garment_extras），不是人体 inside_leg_height。未命中库表时发 imp_{num_iid} 商家表，禁止拿 S–XL 演示表硬套数字码。
   ISV 终局：同一规则是入驻淘宝服务市场的核心服务（清洗 → 适体表 → 官方尺码组件），私域导入只是种子。
   标准文案（写方案 / 开发只引原文）：对外主卖点「不用改号型，26–33 也能荐准。」全文见 ISV 方案 §1.5 · 控制台句见 商家自助登记 §6.5。

8. 「能管理就能更新」——写权限不看下游分配（2026-09-14 裁定）
   服装 SPU/SKC 的保存 / 下架 / 删除判定为三道任一成立（garment_catalog.merchant_can_manage_garment）：
   ① app_merchant_products 已登记；② 该款在本商家货盘（bff_mall_catalog_items）在册；③ 调用方是平台管理员（控制台 RBAC PLATFORM_SUPER_ADMIN 角色，或 * 通配权限）。
   刻意不要求 app_merchant_products 绑定行：它是认领 / 分配台账，不是「能否维护」的凭据。品牌管理者的列表（build_picker 品牌路）主源本就是本商家 mall pool——列表出得来就必须改得动，否则就是「按钮在、点了报『商家未绑定商品』」。
   未登记款下架 / 软删由 upsert_binding_status 直接补登记行，不必先认领；SKC 反查（resolve_num_iid_for_skc）在剧情档与绑定表之外，再兜一层本商家货盘。
   隔离仍在：既不在本商家货盘、又非平台管理员的商家，一律 403（PRODUCT_NOT_BOUND）/ 404（BINDING_NOT_FOUND）。

9. 经营关系 ≠ 商品授权 ≠ 门店上货清单（2026-10-15 整改）
   三件事挨着、都带「授权」字样，但决策人、权威库、要不要对面点头全不同：

「上哪些款」在 dist，「每款哪些色能卖」在平台——两页不合并，分工见
平台与分销门店及经营关系同步方案 §3.4。
建经营关系一律要对面点头：曾经「下游上货」页让人手打两个 id 就直接落库
（PUT /mall/brands/{id}/channel-grants，只验调用者是管理方、不验商家与门店归属），
该口子已删；GET 那条只读清单仍在（服装页「经营授权」弹窗与 dist pull 都在用）。

D. ID 权威落点（短剧 × 平台）

纪律：禁止双货盘；跨服务只引用 ID；分销 :8300 首期不作货盘权威。dist 是 FIT-1 catalog 的 B1 上游；drama/MCW 只读 FIT-1 货盘表 bff_mall_catalog_items（2026-10-11 并轨后为唯一权威，原 bff_catalog_items 已删），不直连 dist DB。

挂车 CTA（冻结）：

/pages/mall/detail?id=<product_id>&from=drama&episode_id=<ep_*>

E. 发号前缀

F. 短剧域术语（补充）

实现读库路径、API 写入对照见 MCW-服装素材与平台货盘复用方案.md §2.4 起。数据模型总索引见 drama-数据模型索引.md。

G. C 端 UGC 生态（索引 · 非契约正文）

状态（2026-08-30）：C0 契约已落 · C1 编码随 M3 后；IW 壳层（pages/creator/*）已上线；§11 拍板记录保留。契约见 C-ECO-* 专文，此处只收速查。

H. DSL→算法断链登记（GAP-* · 索引）

权威正文（59 项追踪 · ALG- · 验收命令）：DSL到算法参数落地对照与验收（清单 ID D-TRACE）。
纪律：新增/消项 GAP 先改 D-TRACE §8，再同步本表与 开发实施方案清单；SM 标 S7「算法落地完成」前须 GAP 已消或明确二期*（见 SM-Agent-工作流设计 §8）。

GAP = Gap in Algorithm Parameter pipeline：L2 DSL / 用户 Brief 设计有、但 L4 可灵请求体或 worker 未贯通时的登记 ID（非 Bug 单号）。

波次口径（SM Wave 0）：GAP-001/003/004 已关；GAP-002/005/006 基础贯通已接（Gate-3 可编 · TTS 链 · scene i2v），完整消项前 D-TRACE 相关项不得标 ✅。

关联简写：ALG-* = 智能选档/能力已贯通项（对照表 §7）；与 GAP 互补——ALG 记「已对齐」，GAP 记「断链待修」。

修订