vr-shopxo-plugin/plan.md

<<<<<<< HEAD
# Plan — ShopXO 酷炫前端模板调研

> 版本：v1.0 | 日期：2026-04-20 | Agent：council/FirstPrinciples + council/FrontendDev + council/BackendArchitect + council/ProductManager
=======
# Plan — ShopXO 酷炫前端模板实现方案调研

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

---

## 任务概述

<<<<<<< HEAD
vr-shopxo-plugin 项目 Phase 0/1/2 后台开发已完成，现需调研票务商品详情页（`ticket_detail.html`）的酷炫前端模板实现方案。

**4个调研方向**：
- Q1：ShopXO 自定义模板最佳实践
- Q2：单订单多 SKU 支持（多座位选择前提）
- Q3：第三方无代码构建服务提示词策略
- Q4：uni-app 兼容性技术栈选型

**输出文件**：`docs/council-research-output.md`

---

## 依赖关系分析

```
Q2（多SKU） ──→ Q4（uni-app选型）的下单流程基础
Q3（无代码） ──→ 依赖 Q1 的 ShopXO 模板约束
Q1（最佳实践） ──→ 基础，供 Q3/Q4 引用
```

**结论**：Q1 + Q2 可并行调研；Q3 依赖 Q1；Q4 依赖 Q2。

---

## Agent 任务分工

### Q1 — ShopXO 自定义模板最佳实践
**负责人**：council/FrontendDev
**任务清单**：
- [ ] [Claimed: council/FrontendDev] **Task Q1-1**: 读取现有 `ticket_detail.html`，分析当前实现状态
- [ ] [Claimed: council/FrontendDev] **Task Q1-2**: 研究 ShopXO view/goods/ 模板机制，原生组件/API 清单
- [ ] [ ] [Claimed: council/FrontendDev] **Task Q1-3**: 前端技术栈选型建议（原生 / Vue CDN / Tailwind / 其他）
- [ ] [ ] [Claimed: council/FrontendDev] **Task Q1-4**: H5 预览与 uni-app 兼容性保障方案

### Q2 — 单订单多 SKU 支持
**负责人**：council/BackendArchitect
**任务清单**：
- [ ] [Claimed: council/BackendArchitect] **Task Q2-1**: 研究 ShopXO 标准订单模型是否支持单订单多 SKU 行项目
- [ ] [ ] [Claimed: council/BackendArchitect] **Task Q2-2**: 分析多 SKU 下单流程触发条件
- [ ] [ ] [Claimed: council/BackendArchitect] **Task Q2-3**: 若不支持，给出最小改动方案

### Q3 — 第三方无代码构建提示词策略
**负责人**：council/ProductManager
**任务清单**：
- [ ] [Claimed: council/ProductManager] **Task Q3-1**: 调研 Google App Build 等无代码服务的能力边界
- [ ] [ ] [Claimed: council/ProductManager] **Task Q3-2**: 设计 ShopXO 模板约束的 prompt 工程策略
- [ ] [ ] [Claimed: council/ProductManager] **Task Q3-3**: 生成代码后处理（集成到 ShopXO 的步骤清单）

### Q4 — uni-app 兼容性技术栈选型
**负责人**：council/FirstPrinciples（由 BackendArchitect + FrontendDev 提供输入后 FirstPrinciples 汇总）
**前置条件**：Task Q2-3 完成
**任务清单**：
- [ ] [Claimed: council/FirstPrinciples] **Task Q4-1**: "一套代码双端"方案评估（H5 + 微信小程序）
- [ ] [ ] [Claimed: council/FirstPrinciples] **Task Q4-2**: ShopXO H5 模板与 uni-app 项目桥接方案

### FirstPrinciples 最终拍板
**负责人**：council/FirstPrinciples
**任务清单**：
- [ ] [Claimed: council/FirstPrinciples] **Task FP-1**: 汇总 Q1-Q4 输出，写入 `docs/council-research-output.md`
- [ ] [ ] [Claimed: council/FirstPrinciples] **Task FP-2**: 明确优先级、依赖关系、技术风险
- [ ] [ ] [Claimed: council/FirstPrinciples] **Task FP-3**: 给出"最小可行方案 vs 理想方案"对比
=======
vr-shopxo-plugin 项目推进 Phase 3 前端模板调研，聚焦 4 个方向：
- Q1：ShopXO 自定义模板最佳实践
- Q2：单订单多 SKU 支持（多座位选择前提）
- Q3：第三方无代码构建服务提示词策略
- Q4：uni-app 兼容性技术栈选型

**输出目标**：`docs/council-research-output.md`

---

## 任务清单

### 全体 Round 1（规划并行，限时 2-3 分钟）

- [ ] [Claimed: council/ProductManager] **Task P1**: ProductManager 创建本 plan.md 并 merge main
- [ ] [ ] **Task F1**: FrontendDev — 分析 `ticket_detail.html` 现有结构，制定 UI 改进方案
- [ ] **Task B1**: BackendArchitect — 分析 ShopXO 订单模型是否支持单订单多 SKU
- [ ] **Task S1**: FirstPrinciples — 拍板 Q2 结论，识别最大技术风险

### 全体 Round 2（执行调研）

- [ ] [ ] **Task P2**: ProductManager — 综合 Q1/Q3/Q4 结论，输出 `council-research-output.md`
- [ ] **Task F2**: FrontendDev — 输出 H5 模板技术栈选型报告 → `docs/frontend-template-research.md`
- [ ] **Task B2**: BackendArchitect — 输出 ShopXO 多 SKU 调研报告 → `docs/backend-multi-sku-research.md`
- [ ] **Task S2**: FirstPrinciples — 评审所有报告，给出最终拍板结论

### 全体 Round 3（收敛）

- [ ] [ ] **Task P3**: ProductManager — 整合所有输出到 `council-research-output.md`，merge main
- [ ] [ ] 所有 Agent 投票 `[CONSENSUS: YES/NO]`

---

## 依赖关系

```
Q2结论 ──→ Q4是否能做多座位选择
Q1结论 ──→ Q3/Q4技术栈基础
Q3/Q4 ──→ 最小可行方案 vs 理想方案
```

**关键风险**：Q2（多SKU）结论将直接影响 Q4 多座位选择能否落地。
>>>>>>> main

---

## 阶段划分

| 阶段 | 状态 | 说明 |
|------|------|------|
<<<<<<< HEAD
| **Draft** | 🔄 进行中 | 各 Agent 调研并提交各自方向报告 |
| **Review** | ⬜ 待开始 | 各 Agent 交叉评审，FirstPrinciples 汇总 |
| **Finalize** | ⬜ 待开始 | 输出 council-research-output.md |
=======
| **Draft** | 🔄 进行中 | Round 1 — 各 Agent 并行规划 |
| **Research** | ⬜ 待开始 | Round 2 — 执行调研 |
| **Finalize** | ⬜ 待开始 | Round 3 — 收敛共识 |
>>>>>>> main

---

## 输出文件

<<<<<<< HEAD
| 文件 | 内容 | 负责人 |
|------|------|--------|
| `docs/Q1-frontend-research.md` | ShopXO 自定义模板最佳实践 | FrontendDev |
| `docs/Q2-multisku-research.md` | 单订单多 SKU 支持分析 | BackendArchitect |
| `docs/Q3-nocode-prompt-strategy.md` | 无代码构建提示词策略 | ProductManager |
| `docs/council-research-output.md` | 汇总报告（最终输出） | FirstPrinciples |

---

## 技术风险识别（初判）

| 风险 | 方向 | 影响 | 应对 |
|------|------|------|------|
| ShopXO 不支持多 SKU 单订单 | Q2 | 高：多座位无法落地 | 备选：拆单或扩展订单模型 |
| uni-app 与 ShopXO H5 模板不兼容 | Q4 | 高：需二选一 | 最小方案：纯 H5；理想方案：uni-app |
| 无代码服务生成的代码无法集成 | Q3 | 中：增加后处理成本 | 限制 prompt 约束，或放弃无代码路线 |
| 酷炫 UI 需要 SSR/异步加载 | Q1 | 中：ShopXO 模板引擎限制 | 使用前端 JS 框架渐进增强 |

---

## 共识收敛策略

- **第 1 轮**（本轮）：各 Agent 创建 plan 并 claim 任务
- **第 2 轮**：各 Agent 完成调研，提交报告到 docs/
- **第 3 轮**：FirstPrinciples 汇总，如无法收敛则 FirstPrinciples 拍板
=======
| 文件 | Agent | 截止轮次 |
|------|-------|---------|
| `docs/council-research-output.md` | ProductManager | Round 3 |
| `docs/frontend-template-research.md` | FrontendDev | Round 2 |
| `docs/backend-multi-sku-research.md` | BackendArchitect | Round 2 |
| `docs/firstprinciples-verdict.md` | FirstPrinciples | Round 2 |

---

## 关键文件参考

- `docs/12_UNIAPP_FRONTEND_RESEARCH.md` — 现有 uni-app 调研（需更新）
- `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` — 现有模板渲染调研
- `shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html` — 当前模板
- `docs/02_FRONTEND_CUSTOMIZATION.md` — 前端定制历史文档
>>>>>>> main