docs: v3.0 最终规格 - template_snapshot 字段 + selected_sections 对象格式

核心变更： - 新增 template_snapshot 字段（发布时从 vr_seat_templates 读取并存储） - selected_sections 确认为对象格式 { room_id: ["A","B"] } - spec_base_id_map 使用 goods_spec_base.extends 动态构建 - 现有前端编辑体验完全不受影响 - Issue #13 已同步更新
2026-04-20 09:04:23 +08:00 · 2026-04-20 09:04:23 +08:00 · 741f25451c
parent 6daa332323
commit 741f25451c
2 changed files with 176 additions and 205 deletions
--- a/docs/PHASE2_PLAN.md
+++ b/docs/PHASE2_PLAN.md
@ -1,59 +1,35 @@
 # Phase 2 — 计划与当前状态

 > 版本：v3.0 | 日期：2026-04-20 | 状态：实现准备就绪
-> 关联提交：c894e7018（模板渲染）、1b0ac3276（精简 footer）
+> 关联 Issue：#13
 > 关联文档：`docs/VR_GOODS_CONFIG_SPEC.md`（v3.0 JSON 格式，已确认）

 ---

-## ⚠️ v3.0 重大变更摘要
+## ⚠️ v3.0 核心变更摘要

- `vr_goods_config` 包含完整 `rooms[]` 快照，不再查 `vr_seat_templates` 表
- `spec_base_id_map` 不入库，GetGoodsViewData 动态从 `goods_spec_base.extends->seat_key` 构建
- `selected_sections` 改为数组格式 `["A","B"]`（不是对象）
+- 新增 `template_snapshot` 字段（发布时从 `vr_seat_templates.seat_map` 读取并存储）
+- `selected_sections` 保持对象格式 `{ room_id: ["A","B"] }`
+- `spec_base_id_map` 不入库，GetGoodsViewData 从 `goods_spec_base.extends->seat_key` 动态构建
+- 现有前端编辑体验**完全不受影响**（前端只提交选择项）

 完整规格见 `docs/VR_GOODS_CONFIG_SPEC.md`。

 ---

-## 一、Phase 2 当前状态
-
-### ✅ 已完成
-
-| 任务 | 提交 | 说明 |
-|------|------|------|
-| 模板渲染 | c894e7018 | PHP ModuleInclude，渲染正常 |
-| 票务专用 footer | 1b0ac3276 | 精简 footer |
-
-### ⚠️ 实现准备就绪（待动手）
-
-| 任务 | 说明 | 依赖 |
-|------|------|------|
-| BatchGenerate 写入 extends | 存储 seat_key 到 goods_spec_base.extends | VR_GOODS_CONFIG_SPEC.md 已确认 |
-| GetGoodsViewData 重写 | 动态构建 spec_base_id_map + 适配 selected_sections | 同上 |
-| ticket_detail.html JS 更新 | seatKey 格式改为 roomId_rowLabel_colNum | 同上 |
-
-### ❌ 未开始
-
-| 任务 |
-|------|
-| 核销 API |
-| 后台 4 控制器联调 |
-| AdminGoodsSaveHandle selected_sections 透传确认 |
-
---
-
-## 二、vr_goods_config v3.0 结构（已确认）
+## 一、vr_goods_config v3.0 结构（已确认）

 ```json
 {
-  "version": 1.0,
+  "version": 3.0,
  "template_id": 4,
  "selected_rooms": ["room_id_xxx"],
-  "selected_sections": ["A", "B"],
+  "selected_sections": { "room_id_xxx": ["A", "B"] },
  "sessions": [{ "start": "15:00", "end": "16:59" }],
-  "venue": { "name": "...", "address": "...", "location": {}, "images": [] },
-  "rooms": [{ "id": "room_id_xxx", "name": "...", "map": [...], "sections": [...], "seats": {...} }]
+  "template_snapshot": {
+    "venue": { ... },
+    "rooms": [{ "id": "...", "name": "...", "map": [...], "sections": [...], "seats": {...} }]
+  }
 }
 ```

@ -61,73 +37,42 @@

 ---

-## 三、spec_base_id_map 解决方案（已确认）
+## 二、实现顺序（Issue #13）

-### 断路根因
+### Step 1：AdminGoodsSaveHandle — 保存时填充 template_snapshot

-BatchGenerate 生成 GoodsSpecBase.id 后，从未写入 spec_base_id_map。前端用 `roomId_row_col` 格式查，存储端从未按此格式写入。
+在 `save_thing_end` 时机，BatchGenerate 之前：
+1. 用 `template_id` 读取 `vr_seat_templates.seat_map`（最新数据）
+2. 按 `selected_rooms` 过滤（只存用户选中的房间）
+3. 填充 `config.template_snapshot`

-### 解决方案：使用 goods_spec_base.extends
+### Step 2：BatchGenerate — 写入 extends

-```
-BatchGenerate 写入时：
-  extends.seat_key = "room_id_rowLabel_colNum"  (无 MD5)
+insertGetId 中加入 `extends.seat_key = roomId_rowLabel_colNum`

-GetGoodsViewData 读取时：
-  遍历 goods_spec_base（inventory > 0）
-  → 解析 extends.seat_key
-  → 构建 spec_base_id_map[key] = id
+### Step 3：GetGoodsViewData — 重写

-前端 submit() 时：
-  seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum
-  specBaseId = spec_base_id_map[seatKey]
-```
+- 读 `vr_goods_config[0]`，透传 `template_snapshot`
+- 从 `goods_spec_base.extends` 动态构建 `spec_base_id_map`
+- `selected_sections` 适配对象格式
+- `goods_spec_data` 按场次聚合

-详见 `docs/VR_GOODS_CONFIG_SPEC.md` 第三章。
-
---
-
-## 四、下一步工作（实现顺序）
-
-### Step 1：BatchGenerate 写入 extends
-
-```php
-// SeatSkuService::BatchGenerate() 中，insertGetId 前：
-$extends = json_encode([
-    'seat_key' => $roomId . '_' . $rowLabel . '_' . $col
-], JSON_UNESCAPED_UNICODE);
-
-// insertGetId 中加入：
-'extends' => $extends,
-```
-
-### Step 2：GetGoodsViewData 重写
-
-```php
-// 1. 读取 vr_goods_config[0]
-// 2. 直接透传 rooms[] / sessions[] / selected_sections / venue
-// 3. 动态构建 spec_base_id_map（从 goods_spec_base.extends）
-// 4. 生成 goods_spec_data（场次+最低价聚合）
-// 5. 返回 { vr_seat_template, goods_spec_data, goods_config }
-```
-
-### Step 3：ticket_detail.html JS
+### Step 4：ticket_detail.html JS — seatKey 格式

 ```javascript
-// seatKey 格式改为带 roomId：
+// 改为带 roomId：
 var seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum;
-// 例："room_id_1776341371905_A_3"
 var specBaseId = self.specBaseIdMap[seatKey] || 0;
 ```

 ---

-## 五、模板渲染当前状态
+## 三、Phase 2 当前状态

-| 项目 | 状态 |
+| 任务 | 状态 |
 |------|------|
 | 模板渲染 | ✅ 正常 |
 | 票务 footer | ✅ 已精简 |
-| 场次显示 | ❌ 待 GetGoodsViewData 重写 |
-| 座位图渲染 | ❌ 待 GetGoodsViewData + JS 更新 |
-| 已售座位标记 | ❌ 待 loadSoldSeats() 实现 |
+| Issue #13 实现（v3.0 落地） | ⚠️ 待动手 |
+| 核销 API | ❌ 未开始 |
+| 后台 4 控制器联调 | ❌ 未开始 |
--- a/docs/VR_GOODS_CONFIG_SPEC.md
+++ b/docs/VR_GOODS_CONFIG_SPEC.md
@ -1,17 +1,15 @@
 # vr_goods_config JSON 规格说明

 > 版本：v3.0 | 日期：2026-04-20 | 状态：**已确认，待实现**
-> 关联提交：待实现
+> 关联 Issue：#13

 ---

-## ⚠️ 重要：v3.0 vs 旧版本的区别
+## ⚠️ v3.0 vs 旧版本的区别

-**v2.0（旧）**：rooms/sections/seats 存放在 `vr_seat_templates.seat_map` JSON 里，前端需要跨表查询。
+**旧版**：rooms/sections/seats 存放在 `vr_seat_templates.seat_map` JSON 里，前端需要跨表查询。

-**v3.0（新）**：完整快照直接嵌入 `goods.vr_goods_config`，前端完全不跨表。
-
-**破坏性变更**：`selected_sections` 从**对象格式** `{"room_id": ["A","B"]}` 改为**数组格式** `["A","B"]`（每个房间一个选中分区列表）。
+**v3.0（最终）**：发布时将 `vr_seat_templates.seat_map` 快照存入 `template_snapshot`，和用户选择一起存储，前端完全不跨表。

 ---

@ -20,39 +18,40 @@
 ```json
 [
  {
-    "version": 1.0,
+    "version": 3.0,
    "template_id": 4,
    "selected_rooms": ["room_id_1776341371905", "room_id_1776341444657"],
-    "selected_sections": ["A", "B"],
+    "selected_sections": {
+      "room_id_1776341371905": ["A", "B"],
+      "room_id_1776341444657": ["A"]
+    },
    "sessions": [
      { "start": "15:00", "end": "16:59" },
      { "start": "18:00", "end": "21:59" }
    ],
-    "venue": {
-      "name": "测试 2",
-      "address": "测试地址",
-      "location": { "lng": "", "lat": "" },
-      "images": []
-    },
-    "rooms": [
-      {
-        "id": "room_id_1776341371905",
-        "name": "1号放映室VV",
-        "map": [
-          "AAAAB__BBB_BAAAA",
-          "AAAAB__BBB_BAAAA",
-          "AAAAB__BBB_BAAAA"
-        ],
-        "sections": [
-          { "char": "A", "name": "VIP区",  "price": 100, "color": "#f06292" },
-          { "char": "B", "name": "看台区", "price": 50,  "color": "#4fc3f7" }
-        ],
-        "seats": {
-          "A": { "char": "A", "name": "VIP区",  "price": 100, "color": "#f06292" },
-          "B": { "char": "B", "name": "看台区", "price": 50,  "color": "#4fc3f7" }
+    "template_snapshot": {
+      "venue": {
+        "name": "测试 2",
+        "address": "测试地址",
+        "location": { "lng": "", "lat": "" },
+        "images": []
+      },
+      "rooms": [
+        {
+          "id": "room_id_1776341371905",
+          "name": "1号放映室VV",
+          "map": ["AAAAB__BBB_BAAAA", "AAAAB__BBB_BAAAA"],
+          "sections": [
+            { "char": "A", "name": "VIP区",  "price": 100, "color": "#f06292" },
+            { "char": "B", "name": "看台区", "price": 50,  "color": "#4fc3f7" }
+          ],
+          "seats": {
+            "A": { "char": "A", "name": "VIP区",  "price": 100, "color": "#f06292" },
+            "B": { "char": "B", "name": "看台区", "price": 50,  "color": "#4fc3f7" }
+          }
        }
-      }
-    ]
+      ]
+    }
  }
 ]
 ```
@ -61,36 +60,51 @@

 | 字段 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| `version` | float | ✅ | 协议版本，当前 1.0，用于前向兼容判断 |
-| `template_id` | int | ✅ | 来源场馆模板 ID（溯源用，不用于查询） |
-| `selected_rooms` | string[] | ✅ | 本商品启用的房间 ID 列表（决定渲染哪些房间） |
-| `selected_sections` | string[] | ✅ | 本商品选中的分区字符列表（当前房间的分区，`["A","B"]`） |
-| `sessions` | object[] | ✅ | 本商品场次列表 |
-| `venue` | object | ✅ | 场馆基本信息快照 |
-| `rooms` | object[] | ✅ | 房间完整数据快照（直接复制自 vr_seat_templates.rooms） |
+| `version` | float | ✅ | 协议版本（当前 3.0），用于前向兼容判断 |
+| `template_id` | int | ✅ | 发布/编辑时读取最新 vr_seat_templates 的依据 |
+| `selected_rooms` | string[] | ✅ | 用户选择：启用了哪些演播（房间 ID 列表） |
+| `selected_sections` | object | ✅ | 用户选择：key=房间ID，value=该房间选中的分区字符列表 |
+| `sessions` | object[] | ✅ | 用户管理：场次列表 |
+| `template_snapshot` | object | ✅ | 发布时从 vr_seat_templates.seat_map 读取的快照（含 venue + rooms） |
+
+### selected_sections 格式说明
+
+```json
+"selected_sections": {
+  "room_id_1776341371905": ["A", "B"],
+  "room_id_1776341444657": ["A"]
+}
+```
+
+key = 房间 ID，value = 该房间选中的分区字符数组。为什么用对象格式？因为同一个 section char（如 "A"）可能在不同房间里代表不同的区（VIP区 vs 普通区），所以必须按 room_id 区分。

 ---

-## 二、selected_sections 格式说明
+## 二、设计意图

-**格式**：`string[]` — 选中分区的字符列表，应用于 `selected_rooms` 中的**当前选中房间**。
+### 流程说明

-**为什么不是对象**：`{"room_id": ["A","B"]}`（v2.0 旧格式）改为 `["A","B"]`。
-
-**简化理由**：用户在后端编辑商品时，一次只能编辑一个房间的分区选择。所以 `selected_sections` 是"当前房间的选中分区"，不需要跨房间存储。
-
-```php
-// AdminGoodsSaveHandle 中的转换（旧格式 → 新格式）
-// 旧格式（已废弃）：
-//   $config['selected_sections'] = { "room_id_xxx": ["A","B"] }
-
-// 新格式（v3.0）：
-//   前端传入 selected_sections: ["A","B"]
-//   直接存储，不做任何转换
-$selectedSections = $config['selected_sections'] ?? [];
-
-// BatchGenerate 适配（详见第五章）
 ```
+商品发布/编辑时：
+  前端提交 → selected_rooms / selected_sections / sessions
+  后端 AdminGoodsSaveHandle →
+    1. 用 template_id 读取 vr_seat_templates.seat_map（最新数据）
+    2. 按 selected_rooms 过滤，填充 template_snapshot
+    3. 和 selected_* 一起写入 goods.vr_goods_config
+    4. BatchGenerate 生成 SKU
+```
+
+### 现有前端兼容性
+
+- 前端只提交 `selected_rooms` / `selected_sections` / `sessions`，**不提交 `template_snapshot`**
+- `template_snapshot` 由后端在保存时自动填充
+- 现有商品编辑体验**完全不受影响**
+
+### template_snapshot 的作用
+
+- 前端渲染所需的所有座位图/sections/seats 数据都来自 `template_snapshot`
+- `selected_rooms` / `selected_sections` 用于高亮、过滤等交互逻辑
+- 若 `template_snapshot` 为空（兼容旧商品），降级读 `vr_seat_templates` 表

 ---

@ -101,20 +115,17 @@ $selectedSections = $config['selected_sections'] ?? [];
 ```
 BatchGenerate() → 生成 GoodsSpecBase.id
               → 从未写入 spec_base_id_map  ← 断路
-
-Admin.php Save → 从 form 存旧格式 spec_base_id_map（空或无效）
-GetGoodsViewData → 读 vr_seat_templates.spec_base_id_map（旧路径）
-前端 JS → 用 "A_3" 格式查 → key 不匹配 → 永远查不到
+前端 JS → 用 "roomId_row_col" 格式查 → 永远查不到
 ```

-### 3.2 解决方案：使用 goods_spec_base.extends 字段
+### 3.2 解决方案：使用 goods_spec_base.extends

-ShopXO 原生 `goods_spec_base` 表有 `extends` 字段（JSON 扩展数据），我们的 BatchGenerate 每次都重建全量 spec（delete + insert），所以写入 `extends` 不会被覆盖。
+ShopXO 原生 `goods_spec_base` 表有 `extends` 字段（JSON 扩展数据）。BatchGenerate 每次都删除+重建全量 spec，放心写入 `extends`。

 **存储时**（BatchGenerate 写入 GoodsSpecBase）：
 ```php
 $extends = json_encode([
-    'seat_key' => $roomId . '_' . $rowLabel . '_' . $col  // 例："room_id_xxx_A_3"
+    'seat_key' => $roomId . '_' . $rowLabel . '_' . $col
 ], JSON_UNESCAPED_UNICODE);

 Db::name('GoodsSpecBase')->insertGetId([
@ -122,11 +133,11 @@ Db::name('GoodsSpecBase')->insertGetId([
    'price'          => $seatPrice,
    'inventory'      => 1,
    // ... 其他字段
-    'extends'        => $extends,  // ← 新增
+    'extends'        => $extends,
 ]);
 ```

-**读取时**（GetGoodsViewData 动态构建 spec_base_id_map）：
+**读取时**（GetGoodsViewData 动态构建）：
 ```php
 $specs = Db::name('GoodsSpecBase')
    ->where('goods_id', $goodsId)
@ -146,53 +157,80 @@ foreach ($specs as $spec) {
 ```json
 {
  "room_id_1776341371905_A_3": 2001,
-  "room_id_1776341371905_B_5": 2002,
-  "room_id_1776341444657_A_1": 2050
+  "room_id_1776341371905_B_5": 2002
 }
 ```

-### 3.3 字段不冲突说明
+---

-`extends` 字段是 ShopXO 的标准扩展字段，ShopXO 自己的 GoodsSave 更新 spec 时只修改核心字段（price/inventory 等），不碰 `extends`。而我们的 BatchGenerate 在商品保存时全量重建 spec，`extends` 由我们写入，不存在被覆盖的风险。
+## 四、AdminGoodsSaveHandle 改动方案
+
+### 保存时填充 template_snapshot
+
+在 `save_thing_end` 时机，BatchGenerate 之前：
+
+```php
+// foreach ($configs as $config) 循环内：
+$templateId = intval($config['template_id'] ?? 0);
+$selectedRooms = $config['selected_rooms'] ?? [];
+
+// 1. 读取最新 vr_seat_templates.seat_map
+$template = Db::name(self::table('seat_templates'))->find($templateId);
+$seatMap = json_decode($template['seat_map'] ?? '{}', true);
+$allRooms = $seatMap['rooms'] ?? [];
+
+// 2. 按 selected_rooms 过滤（只存用户选中的房间）
+$filteredRooms = [];
+foreach ($allRooms as $room) {
+    if (in_array($room['id'], $selectedRooms)) {
+        $filteredRooms[] = $room;
+    }
+}
+
+// 3. 填充 template_snapshot
+$config['template_snapshot'] = [
+    'venue' => $seatMap['venue'] ?? [],
+    'rooms' => $filteredRooms,
+];
+
+// 4. 用更新后的 config 覆盖（$configs[$i] = $config）
+// 5. 后续 BatchGenerate 继续使用更新后的 $config
+```

 ---

-## 四、前端数据结构（GetGoodsViewData 输出）
+## 五、前端数据结构（GetGoodsViewData 输出）

 ```php
 [
  'vr_seat_template' => [
-    'venue'             => $config['venue'],      // 场馆信息
-    'rooms'            => $config['rooms'],       // 房间快照
-    'sessions'         => $config['sessions'],    // 场次列表
-    'selected_rooms'    => $config['selected_rooms'],
-    'selected_sections'=> $config['selected_sections'],
-    'spec_base_id_map' => $specBaseIdMap,          // 动态构建（见3.2）
+    'venue'             => $config['template_snapshot']['venue'] ?? [],
+    'rooms'            => $config['template_snapshot']['rooms'] ?? [],  // 直接透传快照
+    'sessions'         => $config['sessions'] ?? [],
+    'selected_rooms'    => $config['selected_rooms'] ?? [],
+    'selected_sections'=> $config['selected_sections'] ?? {},           // {room_id: [chars]}
+    'spec_base_id_map' => $specBaseIdMap,                               // 动态构建
  ],
-  'goods_spec_data'   => [...],   // 场次+价格（用于前端场次卡片）
-  'goods_config'      => $config   // 原始 vr_goods_config[0]
+  'goods_spec_data'   => $goodsSpecData,
+  'goods_config'      => $config
 ]
 ```

 ### goods_spec_data 生成逻辑

-从 `goods_spec_base` 按场次维度聚合（每个座位 = 一条 GoodsSpecBase）：
-
 ```php
-// 取每个场次的最低价格作为卡片显示价
-$specs = Db::name('GoodsSpecBase')
-    ->where('goods_id', $goodsId)
-    ->where('inventory', '>', 0)
-    ->select();
+// 从 goods_spec_base 按场次维度聚合（每个座位 = 一条 GoodsSpecBase）
+$specs = Db::name('GoodsSpecBase')->where('goods_id', $goodsId)
+    ->where('inventory', '>', 0)->select();

-$sessionPrices = [];  // sessionStr => minPrice
-$sessionSpecs  = [];  // sessionStr => first spec_base_id
+$sessionPrices = [];
+$sessionSpecs  = [];

 foreach ($specs as $spec) {
-    // 从 goods_spec_value 找到场次维度值
+    // 从 goods_spec_value 找到场次维度值（格式："HH:mm-HH:mm"）
    $sessionValue = Db::name('GoodsSpecValue')
        ->where('goods_spec_base_id', $spec['id'])
-        ->where('value', 'like', '%-%:%')
+        ->where('value', 'REGEXP', '^[0-9]{2}:[0-9]{2}-[0-9]{2}:[0-9]{2}$')
        ->find();

    if ($sessionValue) {
@ -206,7 +244,6 @@ foreach ($specs as $spec) {
    }
 }

-// 构建 goods_spec_data
 $goodsSpecData = [];
 foreach ($sessions as $s) {
    $start = $s['start'] ?? '';
@ -234,7 +271,7 @@ var specBaseId = specBaseIdMap[seatKey] || 0;
 // goods_params 格式（每座一行）
 {
  goods_id: goodsId,
-  spec_base_id: specBaseId,   // ← 用 seatKey 查到
+  spec_base_id: specBaseId,
  stock: 1,
  extension_data: JSON.stringify({ attendee, seat: {...} })
 }
@ -242,44 +279,33 @@ var specBaseId = specBaseIdMap[seatKey] || 0;

 ---

-## 五、需要修改的文件
+## 六、需要修改的文件

 | 文件 | 改动 |
 |------|------|
-| `SeatSkuService::BatchGenerate()` | 写入 `extends` JSON（含 `seat_key`） |
-| `SeatSkuService::GetGoodsViewData()` | 动态从 `extends` 构建 `spec_base_id_map`；适配 `selected_sections` 数组格式 |
+| `AdminGoodsSaveHandle` | save_thing_end 中 BatchGenerate 之前：从 vr_seat_templates 读取并填充 `config.template_snapshot` |
+| `SeatSkuService::BatchGenerate()` | insertGetId 中写入 `extends.seat_key` |
+| `SeatSkuService::GetGoodsViewData()` | 重写：读 `template_snapshot`；从 `extends` 动态构建 `spec_base_id_map`；适配 `selected_sections` 对象格式 |
 | `ticket_detail.html` JS | `seatKey` 格式改为 `roomId + '_' + rowLabel + '_' + colNum` |
-| `AdminGoodsSaveHandle` | selected_sections 透传（已经是数组格式，无需改动） |

 ---

-## 六、数据库迁移（如需要）
-
-如后续需要在 `goods_spec_base` 加专用列（非必须，`extends` 已够用）：
-
-```sql
-ALTER TABLE `{{prefix}}goods_spec_base` ADD COLUMN `seat_key` VARCHAR(100) DEFAULT NULL COMMENT '座位键：roomId_row_col';
-```
-
---
-
-## 七、版本判断（降级兼容）
+## 七、降级兼容

 ```php
 $config = json_decode($goods['vr_goods_config'] ?? '', true);
 if (empty($config)) {
-    return ['vr_seat_template' => null, 'goods_spec_data' => [], 'goods_config' => null];
+    return /* 错误 */;
 }

-$config = $config[0];
+$config = $config[0] ?? $config;

-if (empty($config['rooms'])) {
-    // v1/v2 旧格式：降级读 vr_seat_templates 表
+if (version_compare($config['version'] ?? 0, 3.0, '<')) {
+    // 旧版格式（无 template_snapshot）：降级读 vr_seat_templates 表
    return self::GetGoodsViewDataLegacy($goodsId, $config);
 }

 // v3.0 新格式
-$version = $config['version'] ?? 1.0;
 // ...
 ```

@ -289,9 +315,9 @@ $version = $config['version'] ?? 1.0;

 | 决策 | 结论 |
 |------|------|
-| `selected_sections` 格式 | 数组 `["A","B"]`，不是对象 |
-| `spec_base_id_map` 存储 | 不入库，GetGoodsViewData 动态构建 |
-| seat_key 存储位置 | `goods_spec_base.extends->seat_key`（JSON） |
-| seat_key 格式 | `{roomId}_{rowLabel}_{colNum}`（无 MD5） |
-| goods_spec_data.price | 取该场次所有座位中的最低价（用于卡片显示） |
-| 降级兼容 | `version` 字段判断，v1/v2 走旧 vr_seat_templates 表路径 |
+| `selected_sections` 格式 | 对象 `{ room_id: ["A","B"] }`（每个房间独立选择） |
+| `template_snapshot` | 发布时从 vr_seat_templates.seat_map 读取并存储，不实时查表 |
+| `spec_base_id_map` | 不入库，GetGoodsViewData 动态从 `extends.seat_key` 构建 |
+| `seat_key` 格式 | `{roomId}_{rowLabel}_{colNum}`（无 MD5） |
+| `goods_spec_data.price` | 取该场次所有座位中的最低价（用于卡片显示） |
+| 现有前端兼容性 | ✅ 前端只提交选择项，template_snapshot 由后端保存时填充 |