# Plan — VR 演唱会票务小程序 Round 3 执行

> 版本：v3.0 | 日期：2026-05-26 | Agent：council/BackendArchitect
> 任务：Round 3 评估更新 — 现场代码核查，修正 P0 优先级，投票 A

---

## 评估范围

- Phase 4 Tree API 设计文档完整性 + 可行性
- SeatMapService + `/seatmap` API 完整性
- seatSpecMap 注入商品详情 API 的实现方案（Round 3 修正）
- CartSave extension_data 多座位存储链路（Round 3 修正）
- 后端下一步优先级建议

---

## 现状快照（Round 3 现场核查）

### Phase 4 Tree API
- 设计文档：✅ `docs/PHASE_4_API.md` + `PLAN_TREE_API_IMPLEMENTATION.md`（父仓库 commit `40a9b0ad1`）
- `SeatSkuService.php`（实际名）：✅ 存在，含 `GetGoodsViewData()` + `buildSeatSpecMap()`
- `SeatMapService.php`（设计名）：❌ 不存在（命名混淆）
- `api/` 目录（Worktree）：❌ 未纳入 Git 追踪（父仓库有 `Goods.php`）
- 状态：**设计完整，代码仅部分复用逻辑，命名混淆 + api 目录未追踪**

### SeatMapService + seatmap API（Round 3 修正）
- `index/Index.php::soldSeats` — ✅ 存在，路由正常
- `SeatSkuService::getSoldSeats()` — ❌ **方法完全缺失（致命）**
- **关键修正**：`Index.php:43` 调用不存在的方法，**所有直接调用 soldSeats API 的客户端都会触发 PHP Fatal Error**
- H5 绕过正确（不走 API），但 UniApp/第三方 调用会崩溃
- `api/Goods.php::seatmap()`（父仓库）：⚠️ 引用不存在的 `SeatMapService::GetSeatMap()`
- 命名混淆：设计文档说 `SeatMapService`，实际类名是 `SeatSkuService`

### seatSpecMap 注入商品详情（Round 3 一致）
- Goods.php 硬编码调用 — ✅ **H5 已工作**（直接调用 `GetGoodsViewData()`）
- Hook `plugins_service_goods_data` — ❌ **未在 Hook.php 中注册**
- UniApp 调用 `api/goods/detail` API — ❌ **Gap 1 仍成立**
- 结论：Gap 1 **致命且成立**

### CartSave extension_data（Round 3 修正）
- H5 链路 `ticket_detail.html:762` — ✅ 已实现（`extension_data` 嵌套在 `order_base`）
- `TicketService::onOrderPaid()` — ✅ 逐行生成票（多座位已支持）
- 结论：**Gap 2 已消除**，UniApp 只需复刻 H5 的 JSON 格式，后端无需额外改动

---

## BackendArchitect 评估任务

| Task | 内容 | 状态 |
|------|------|------|
| B1 | Phase 4 Tree API 设计文档评估 | [Done: council/BackendArchitect] |
| B2 | SeatMapService + seatmap API 完整性检查 | [Done: council/BackendArchitect] — P0 崩溃发现 |
| B3 | seatSpecMap 注入方案设计 | [Done: council/BackendArchitect] — Hook 注册即可 |
| B4 | CartSave extension_data 多座位链路分析 | [Done: council/BackendArchitect] — Gap 2 已消除 |
| B5 | 输出 Round 3 评估报告 + 投票 | [Done: council/BackendArchitect] |

---

## 待执行任务（Round 3 更新 — P0 → P1 → P2 排序）

### P0 — 立即修复（2h 内完成）

| Task | 内容 | 依赖 | 状态 |
|------|------|------|------|
| P0-1 | 实现 `SeatSkuService::getSoldSeats()` | 无 | [To Claim: council/BackendArchitect] |
| P0-2 | 注册 `plugins_service_goods_data` Hook + `InjectGoodsDetailData()` | 无 | [To Claim: council/BackendArchitect] |

### P1 — 短期完善

| Task | 内容 | 依赖 | 状态 |
|------|------|------|------|
| P1-1 | `api/` 目录纳入 Git 追踪 + 修复 `SeatMapService` 命名混淆 | P0-2 | [To Claim] |
| P1-2 | 统一 `SeatMapService` / `SeatSkuService` 命名 | P1-1 | [To Claim] |
| P1-3 | 完善 Phase 4 Tree API 文档（API 契约） | 无 | [To Claim] |

### P2 — 可延后

| Task | 内容 | 依赖 | 状态 |
|------|------|------|------|
| P2-1 | Phase 4 Tree API 实现（`buildTree()`） | P1-1 | [To Claim] |
| P2-2 | 实时座位锁定机制（SKIP LOCKED） | P0-1 | [To Claim] |

---

## 投票结果

**投票：A — 后端优先**

理由：
1. `getSoldSeats()` 实现（30 行）修复运行时崩溃，解锁 UniApp soldSeats API
2. Hook 注册（10 行）解锁 UniApp 商品详情 API（Gap 1）
3. Gap 2（CartSave）已消除，后端无额外改动需求
4. Phase 4 不应前置，应在 P0/P1 稳定后作为独立任务启动

---

## 输出

- 评估报告（更新版）：`docs/council-eval-backendarchitect.md`
- 投票：`docs/council-eval-backendarchitect.md#五投票`