# Plan — ShopXO 酷炫前端模板实现方案调研

> 版本：v1.0 | 日期：2026-04-20 | Agent：council/FrontendDev（主导）+ council/BackendArchitect + council/ProductManager + council/FirstPrinciples

---

## 任务概述

vr-shopxo-plugin 项目推进自定义前端模板渲染，让票务商品详情页（ticket_detail.html）酷炫起来。4个研究问题并行调研，最终收敛到 `docs/council-research-output.md`。

---

## 任务清单

- [x] [Done: council/FrontendDev] **Task F1**: Q1 研究 — ShopXO 自定义模板最佳实践
  - ✅ 读取 ticket_detail.html（现有模板已验证可用）
  - ✅ 读取 docs/02_FRONTEND_CUSTOMIZATION.md、docs/12_UNIAPP_FRONTEND_RESEARCH.md
  - ✅ 结论：原生 HTML+CSS+JS 是 ShopXO PHP 模板最优解；Vue CDN 不可行（ThinkTemplate 冲突）
  - ✅ 酷炫化方向：CSS动画 > 3D舞台 > 触控缩放 > GSAP > 暗色主题

- [x] [Done: council/FrontendDev] **Task F2**: Q4 研究 — uni-app 兼容性技术栈选型
  - ✅ shopxo-uniapp fork 是微信小程序唯一可行路径（完全独立于 PHP 模板）
  - ✅ 两套前端体系（PHP H5 vs uni-app）完全独立，无桥接需求
  - ✅ 最小可行：增强现有 ticket_detail.html；理想方案：fork shopxo-uniapp
  - ✅ Q4 不等待 Q2，可先执行 fork shopxo-uniapp 基础工作

- [ ] [Claimed: council/BackendArchitect] **Task B1**: Q2 研究 — 单订单多SKU支持
  - 读取 ShopXO 标准订单模型（订单项表结构）
  - 分析现有 vr_ticket 订单插件实现
  - 判断是否支持单个订单包含多个 SKU 行项目
  - 如不支持，给出最小改动方案
  - **此结论直接影响多座位选择功能能否落地**

- [ ] [Claimed: council/ProductManager] **Task P1**: Q3 研究 — 第三方无代码构建服务提示词策略
  - Google App Build / Builder.io / Gamma 等无代码服务
  - 如何在 prompt 中表达 ShopXO 模板约束（HTML结构、CSS命名、API格式）
  - 生成代码的后处理步骤
  - H5 输出物的验收标准

- [ ] [Claimed: council/FrontendDev] **Task O1**: 汇总输出 — 写入 `docs/council-research-output.md`（等待 B1/P1 完成后执行）
  - 整合 Q1-Q4 所有结论
  - 明确优先级和依赖关系（Q2 → Q4 前置）
  - 识别最大技术风险点
  - 给出"最小可行方案" vs "理想方案"对比表

---

## 阶段划分

| 阶段 | 内容 | 负责人 |
|------|------|--------|
| **Draft** | Task F1 + F2 + B1 + P1（并行研究，限时20分钟） | All |
| **Review** | 交叉审阅：BackendArchitect 审 F1/F2，FrontendDev 审 B1/P1 | All |
| **Finalize** | Task O1：汇总到 council-research-output.md | FrontendDev |

---

## 依赖关系

```
Q2（多SKU支持）→ Q4（uni-app选型）：Q2 结论决定多座位功能能否实现
Q1（模板最佳实践）→ Q3（无代码服务）：Q1 的技术栈选型影响 Q3 的 prompt 约束
Q1 + Q4 → 输出文件：两份 FrontendDev 研究成果 + BackendArchitect + ProductManager 研究成果
```

---

## 风险识别

| 风险 | 级别 | 描述 |
|------|------|------|
| **R1**: Q2 多SKU不支持 | P0 | 多座位选择功能无法落地，需改订单模型 |
| **R2**: uni-app 与 ShopXO H5 模板冲突 | P1 | 两套前端体系如何共存需要澄清 |
| **R3**: 无代码服务生成的代码质量 | P2 | 生成的 HTML/CSS 可能不符合 ShopXO 规范 |
| **R4**: H5 预览与微信小程序兼容 | P2 | 部分 CSS/JS API 在双端表现不一致 |

---

## 输出文件

`docs/council-research-output.md` — 包含：
1. Q1-Q4 各自的具体可执行结论
2. 优先级和依赖关系矩阵
3. 最大技术风险点标注
4. 最小可行方案 vs 理想方案对比
5. 每项结论的置信度（高/中/低）

---

## 执行策略

- 20分钟限时：各 Agent 独立研究，记录置信度
- 3轮收敛：Round 1 规划 → Round 2 执行 → Round 3 收敛/投票
- 如有分歧：FirstPrinciples 做最终拍板