vr-shopxo-plugin/plan.md

95 lines
3.9 KiB
Markdown
Raw Normal View History

# Plan — ShopXO 酷炫前端模板实现方案调研
> 版本v1.0 | 日期2026-04-20 | Agentcouncil/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/F2FrontendDev 审 B1/P1 | All |
| **Finalize** | Task O1汇总到 council-research-output.md | FrontendDev |
---
## 依赖关系
```
Q2多SKU支持→ Q4uni-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 做最终拍板