# Plan — vr-shopxo-plugin 前端评估 + 票务功能推进

> 版本：v2.0 | 日期：2026-05-26 | Agent：council/FrontendDeveloper
> 任务来源：Round 1 Council 评估轮

---

## 背景

当前项目有两个前端入口：
- **H5**：ShopXO 票务详情页（ticket_detail.html，819行）
- **UniApp**：vr-shopxo-uniapp 小程序前端

存在 3 个 P0 API Gap 阻塞 UniApp 开发，H5 可独立推进。

---

## 阶段划分

| 阶段 | 内容 | 状态 |
|------|------|------|
| **Draft** | 评估报告 + plan.md 创建 | ✅ 本轮完成 |
| **Review** | 各成员交叉 review | 待执行 |
| **Finalize** | 汇总协调者输出综合报告 | 待执行 |

---

## FrontendDeveloper 任务清单

### API Gap 前置确认（依赖 BackendArchitect）

- [ ] **Task 1** [Claimed: pending BackendArchitect] Gap 1：确认 seatSpecMap 注入商品详情 API 的具体实现方案和时间
- [ ] **Task 2** [Claimed: pending BackendArchitect] Gap 2：确认 CartSave extension_data 写入 order_detail 的路径

### H5 票务详情页（无阻塞，可立即执行）

- [ ] **Task 3** [Claimed: FrontendDeveloper] 实现 `loadSoldSeats()` — 调用 `/seatmap` API 获取已售座位，填充 soldSeats 数组
- [ ] **Task 4** [Claimed: FrontendDeveloper] ticket_detail.html 观演人表单 UX 优化
- [ ] **Task 5** [Claimed: FrontendDeveloper] 核销码展示（QR + 短码）组件化

### UniApp 票务组件（等待 Gap 1/2 确认后启动）

- [ ] **Task 6** [Claimed: pending Gap 1+2] UniApp goods-vr-ticket 组件基础框架
- [ ] **Task 7** [Claimed: pending Gap 1+2] UniApp 商品详情页集成 seatSpecMap 渲染
- [ ] **Task 8** [Claimed: pending Gap 1+2] UniApp 选座页 + 座位地图渲染
- [ ] **Task 9** [Claimed: pending Gap 1+2] UniApp 购票确认 + 支付流程（单座位优先）
- [ ] **Task 10** [Claimed: pending Gap 1+2] UniApp 票夹页（TicketWallet API 集成）
- [ ] **Task 11** [Claimed: pending Gap 1+2] UniApp 核销页（QR 展示 + 扫码核销）

### 文档 & 交接

- [ ] **Task 12** [Done] 评估报告 → `docs/council-eval-frontenddeveloper.md`
- [ ] **Task 13** [Claimed: FrontendDeveloper] UniApp 组件目录结构设计文档

---

## 依赖关系

```
BackendArchitect Gap 1 确认 ──→ Task 6-11（UniApp 选座/购票/票夹/核销）可启动
BackendArchitect Gap 2 确认 ──→ Task 9（UniApp 购票确认）可完成
Task 3（H5 loadSoldSeats）    ──→ 可独立执行，无前置依赖
Task 4（H5 表单优化）          ──→ 可独立执行，无前置依赖
Task 5（H5 核销码展示）        ──→ 可独立执行，无前置依赖
```

---

## 当前投票立场

**投票：C — 双线并行**

- H5（Task 3-5）无阻塞，立即启动
- UniApp（Task 6-11）等待 Gap 1+2 确认后启动
- BackendArchitect 并行完成 Gap 1+2 注入任务

---

## 关键文件

| 文件 | 关注点 |
|------|--------|
| `shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html` | H5 票务详情，loadSoldSeats TODO |
| `~/WorkSpace/vr-shopxo-uniapp/components/` | UniApp 组件目录（当前无 goods-vr-ticket） |
| `docs/council-eval-frontenddeveloper.md` | 本轮评估报告 |
| `docs/14_TREE_API_DESIGN.md` | Phase 4 Tree API 设计文档 |