vr-shopxo-plugin/plan.md

185 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<<<<<<< HEAD
# Plan — ShopXO 酷炫前端模板调研
> 版本v1.0 | 日期2026-04-20 | Agentcouncil/FirstPrinciples + council/FrontendDev + council/BackendArchitect + council/ProductManager
=======
# Plan — ShopXO 酷炫前端模板实现方案调研
> 版本v1.0 | 日期2026-04-20 | Agentcouncil/ProductManager + council/FrontendDev + council/BackendArchitect + council/FirstPrinciples
>>>>>>> main
---
## 任务概述
<<<<<<< HEAD
vr-shopxo-plugin 项目 Phase 0/1/2 后台开发已完成,现需调研票务商品详情页(`ticket_detail.html`)的酷炫前端模板实现方案。
**4个调研方向**
- Q1ShopXO 自定义模板最佳实践
- Q2:单订单多 SKU 支持(多座位选择前提)
- Q3:第三方无代码构建服务提示词策略
- Q4uni-app 兼容性技术栈选型
**输出文件**`docs/council-research-output.md`
---
## 依赖关系分析
```
Q2多SKU ──→ Q4uni-app选型的下单流程基础
Q3无代码 ──→ 依赖 Q1 的 ShopXO 模板约束
Q1最佳实践 ──→ 基础,供 Q3/Q4 引用
```
**结论**Q1 + Q2 可并行调研;Q3 依赖 Q1Q4 依赖 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 个方向:
- Q1ShopXO 自定义模板最佳实践
- Q2:单订单多 SKU 支持(多座位选择前提)
- Q3:第三方无代码构建服务提示词策略
- Q4uni-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