vr-shopxo-plugin/plan.md

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

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

---

## 任务概述

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 理想方案"对比

---

## 阶段划分

| 阶段 | 状态 | 说明 |
|------|------|------|
| **Draft** | 🔄 进行中 | 各 Agent 调研并提交各自方向报告 |
| **Review** | ⬜ 待开始 | 各 Agent 交叉评审，FirstPrinciples 汇总 |
| **Finalize** | ⬜ 待开始 | 输出 council-research-output.md |

---

## 输出文件

| 文件 | 内容 | 负责人 |
|------|------|--------|
| `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 拍板
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								# Plan — ShopXO 酷炫前端模板调研
-												council(draft): SecurityEngineer - create plan.md with Phase 2 security research directions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-15 05:53:39 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								> 版本：v1.0 | 日期：2026-04-20 | Agent：council/FirstPrinciples + council/FrontendDev + council/BackendArchitect + council/ProductManager
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
-												council(review): SecurityEngineer - Phase 2 security audit complete + P1 Verifier.php fix

Security audit findings (Task S1/S2/S3/S5 done):
- Task S1: Admin auth chain verified (Base extends Common OK)
- Task S2: SQL injection audit complete (no injection, P1 code bug found)
  - FIXED: Verifier.php:45 CONCAT column() syntax error → select()+PHP concat
- Task S3: XSS/CSRF audit complete (no risk in admin context)
- Task S5: IDOR audit complete (admin context acceptable)
- Task S4 (audit log design): still pending

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-15 06:11:43 +00:00
+								---
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
+								## 任务概述
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								vr-shopxo-plugin 项目 Phase 0/1/2 后台开发已完成，现需调研票务商品详情页（`ticket_detail.html`）的酷炫前端模板实现方案。
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								**4个调研方向**：
 								- Q1：ShopXO 自定义模板最佳实践
 								- Q2：单订单多 SKU 支持（多座位选择前提）
 								- Q3：第三方无代码构建服务提示词策略
 								- Q4：uni-app 兼容性技术栈选型
-												fix(P0): vr_ticket Base - inherit ShopXO Common for full auth chain

- Change plugin Base from standalone to extend Common
- Call IsLogin() + IsPower() + FormTableInit() explicitly (avoids
  full ViewInit which is unnecessary for API/admin controllers)
- Documents permission node format: plugins_vr_ticket-{controller}-{action}
- Fixes R1 P0: bypassed auth chain (only LoginInfo, missing IsPower)
- Also fixes all child controllers since they call parent::__construct()

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-15 06:00:20 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								**输出文件**：`docs/council-research-output.md`
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
 								---
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								## 依赖关系分析
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								```
 								Q2（多SKU） ──→ Q4（uni-app选型）的下单流程基础
 								Q3（无代码） ──→ 依赖 Q1 的 ShopXO 模板约束
 								Q1（最佳实践） ──→ 基础，供 Q3/Q4 引用
 								```
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								**结论**：Q1 + Q2 可并行调研；Q3 依赖 Q1；Q4 依赖 Q2。
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								---
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								## 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 理想方案"对比
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
 								---
 								## 阶段划分
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								| 阶段 | 状态 | 说明 |
 								|------|------|------|
 								| **Draft** | 🔄 进行中 | 各 Agent 调研并提交各自方向报告 |
 								| **Review** | ⬜ 待开始 | 各 Agent 交叉评审，FirstPrinciples 汇总 |
 								| **Finalize** | ⬜ 待开始 | 输出 council-research-output.md |
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
 								---
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								## 输出文件
-												council(draft): DebugAgent - plan.md: debug "Undefined array key id" error

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 01:46:20 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								| 文件 | 内容 | 负责人 |
 								|------|------|--------|
 								| `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 |
-												council(draft): BackendArchitect - add documentation review plan

- Add BackendArchitect Round 1 section to plan.md
- Claim 4 review tasks: 3 docs + 1 summary
- Dimensions: accuracy, completeness, actionability, consistency, misleading risk

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-19 21:25:48 +00:00
-												council(security): SecurityEngineer - add missing VenueList methods + security audit

Security findings:
- SQL injection: LOW (query builder + parameter binding)
- XSS: LOW (ThinkPHP auto-escape, no |raw detected)
- Path traversal: LOW (all view paths hardcoded)
- CSRF: MEDIUM (ShopXO framework-level gap, out of scope for plugin)

Critical fix: admin/Admin.php was missing VenueList(), VenueSave(),
VenueDelete() — sidebar URL "/plugins/vr_ticket/admin/venueList" would
return 500 error. Added all three methods with v3.0 seat_map support.

P1 garbled name: documented DB fix SQL for shx_plugins + vrt_power tables.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-16 00:53:41 +00:00
+								---
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								## 技术风险识别（初判）
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

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

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:14:37 +00:00
-												council(finalize): resolve plan.md merge conflict, integrate BackendArchitect report

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:21:45 +00:00
+								---
-												council(draft): BackendArchitect - mark all BackendArchitect tasks as done

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 11:14:37 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								## 共识收敛策略
-												docs(plan): 记录 P1+P2 修复已合并到 main

Commit: 804d465d0 → main: 49930844f

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-20 02:00:05 +00:00
-												council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)

											
										
										
											2026-04-20 15:10:51 +00:00
+								- **第 1 轮**（本轮）：各 Agent 创建 plan 并 claim 任务
 								- **第 2 轮**：各 Agent 完成调研，提交报告到 docs/
 								- **第 3 轮**：FirstPrinciples 汇总，如无法收敛则 FirstPrinciples 拍板