# 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`。

---

## 任务清单

- [ ] [Claimed: council/FrontendDev] **Task F1**: Q1 研究 — ShopXO 自定义模板最佳实践
  - 读取 `shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html`（现有模板结构）
  - 读取 `docs/02_FRONTEND_CUSTOMIZATION.md`、`docs/12_UNIAPP_FRONTEND_RESEARCH.md`（已有调研）
  - 读取 ShopXO 官方文档中 view/goods/ 目录的自定义模板规范
  - 给出技术栈选型建议（原生HTML+JS / Vue CDN / Tailwind / 其他）
  - 给出 H5 预览兼容性保障方案

- [ ] [Claimed: council/FrontendDev] **Task F2**: Q4 研究 — uni-app 兼容性技术栈选型
  - 分析 uni-app + HBuilder 编译到微信小程序的路径
  - 研究 ShopXO H5 模板与 uni-app 项目共存/桥接方案
  - 给出"一套代码，H5和小程序双端运行"方案
  - 输出：最小可行方案 vs 理想方案对比

- [ ] [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`
  - 整合 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 做最终拍板