vr-shopxo-plugin/plan.md

# Plan — ShopXO 酷炫前端模板实现方案调研

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

---

## 任务概述

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 多座位选择能否落地。

---

## 阶段划分

| 阶段 | 状态 | 说明 |
|------|------|------|
| **Draft** | 🔄 进行中 | Round 1 — 各 Agent 并行规划 |
| **Research** | ⬜ 待开始 | Round 2 — 执行调研 |
| **Finalize** | ⬜ 待开始 | Round 3 — 收敛共识 |

---

## 输出文件

| 文件 | 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` — 前端定制历史文档
-												council(draft): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								> 版本：v1.0 | 日期：2026-04-20 | Agent：council/ProductManager + council/FrontendDev + council/BackendArchitect + council/FirstPrinciples
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								vr-shopxo-plugin 项目推进 Phase 3 前端模板调研，聚焦 4 个方向：
 								- Q1：ShopXO 自定义模板最佳实践
 								- Q2：单订单多 SKU 支持（多座位选择前提）
 								- Q3：第三方无代码构建服务提示词策略
 								- Q4：uni-app 兼容性技术栈选型
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								**输出目标**：`docs/council-research-output.md`
-												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(plan): FrontendDev - Phase 2 bugfix plan: routing + encoding issues

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

											
										
										
											2026-04-16 00:11:57 +00:00
+								---
-												council(execute): FrontendDev - Round 4: export button fix + mark Phase 2 complete

- Fix P1 bug: ticket/list.html export button (GET→POST form) matching IS_AJAX_POST
- Mark all plan.md tasks complete (seat templates, tickets, verifiers, verifications views)
- BackendArchitect: AuditService.php (S4 design), Verifier.php CONCAT fix, Verification.php column() fix
- BackendArchitect: SeatTemplate.php countSeats fix, TicketService.php transaction fix
- BackendArchitect: EventListener.php audit_log table added
- SecurityEngineer: S1-S5 security audit complete
- [CONSENSUS: YES] all three agents vote YES

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

											
										
										
											2026-04-15 06:20:03 +00:00
-												council(draft): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								## 任务清单
-												refactor(vr_ticket): Admin.php root pattern → Hook-based goods save

- DELETE old Admin.php root controller (Vrticket.php)
- DELETE old Layui view files (seat_template/ticket/venue/verification/verifier)
- ADD hook/AdminGoodsSave.php: plugins_view_admin_goods_save hook (Vue3 form injection)
- ADD hook/AdminGoodsSaveHandle.php: handle save flow (save_handle + save_thing_end)
- UPDATE config.json: register 3 new hooks
- UPDATE SeatSkuService.php: refactored BatchGenerate
- ADD data.db: SQLite venue data
- UPDATE venue/save.html: venue editing form
- docs: add GOODS_ADD_HOOK_RESEARCH.md + update plan.md

											
										
										
											2026-04-18 21:46:37 +00:00
-												council(draft): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								### 全体 Round 1（规划并行，限时 2-3 分钟）
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								- [ ] [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 结论，识别最大技术风险
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								### 全体 Round 2（执行调研）
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								- [ ] [ ] **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 — 评审所有报告，给出最终拍板结论
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								### 全体 Round 3（收敛）
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								- [ ] [ ] **Task P3**: ProductManager — 整合所有输出到 `council-research-output.md`，merge main
 								- [ ] [ ] 所有 Agent 投票 `[CONSENSUS: YES/NO]`
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								## 依赖关系
 								```
 								Q2结论 ──→ Q4是否能做多座位选择
 								Q1结论 ──→ Q3/Q4技术栈基础
 								Q3/Q4 ──→ 最小可行方案 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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								**关键风险**：Q2（多SKU）结论将直接影响 Q4 多座位选择能否落地。
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								| 阶段 | 状态 | 说明 |
 								|------|------|------|
 								| **Draft** | 🔄 进行中 | Round 1 — 各 Agent 并行规划 |
 								| **Research** | ⬜ 待开始 | Round 2 — 执行调研 |
 								| **Finalize** | ⬜ 待开始 | Round 3 — 收敛共识 |
-												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(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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								| 文件 | 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 |
-												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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +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): ProductManager - create plan.md for frontend template research round

											
										
										
											2026-04-20 15:10:35 +00:00
+								- `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` — 前端定制历史文档