vr-shopxo-plugin/docs/PHASE2_PLAN.md

# Phase 2 — 计划与当前状态

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

---

## ⚠️ v3.0 重大变更摘要

- `vr_goods_config` 包含完整 `rooms[]` 快照，不再查 `vr_seat_templates` 表
- `spec_base_id_map` 不入库，GetGoodsViewData 动态从 `goods_spec_base.extends->seat_key` 构建
- `selected_sections` 改为数组格式 `["A","B"]`（不是对象）

完整规格见 `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 结构（已确认）

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

详细字段说明见 `docs/VR_GOODS_CONFIG_SPEC.md` 第一章。

---

## 三、spec_base_id_map 解决方案（已确认）

### 断路根因

BatchGenerate 生成 GoodsSpecBase.id 后，从未写入 spec_base_id_map。前端用 `roomId_row_col` 格式查，存储端从未按此格式写入。

### 解决方案：使用 goods_spec_base.extends

```
BatchGenerate 写入时：
  extends.seat_key = "room_id_rowLabel_colNum"  (无 MD5)

GetGoodsViewData 读取时：
  遍历 goods_spec_base（inventory > 0）
  → 解析 extends.seat_key
  → 构建 spec_base_id_map[key] = id

前端 submit() 时：
  seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum
  specBaseId = spec_base_id_map[seatKey]
```

详见 `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

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

---

## 五、模板渲染当前状态

| 项目 | 状态 |
|------|------|
| 模板渲染 | ✅ 正常 |
| 票务 footer | ✅ 已精简 |
| 场次显示 | ❌ 待 GetGoodsViewData 重写 |
| 座位图渲染 | ❌ 待 GetGoodsViewData + JS 更新 |
| 已售座位标记 | ❌ 待 loadSoldSeats() 实现 |