council(draft): FirstPrinciples - create plan.md for ShopXO frontend research (Q1-Q4)
Council
parent
dbd62f5658
commit
919c5cfd4e
136
plan.md
136
plan.md
|
|
@ -1,91 +1,109 @@
|
|||
# Plan — 调研「场馆删除后编辑商品出现规格重复错误」问题
|
||||
# Plan — ShopXO 酷炫前端模板调研
|
||||
|
||||
> 版本：v1.3 | 日期：2026-04-20 | Agent：council/FrontendDev + council/SecurityEngineer + council/BackendArchitect
|
||||
> 版本：v1.0 | 日期：2026-04-20 | Agent：council/FirstPrinciples + council/FrontendDev + council/BackendArchitect + council/ProductManager
|
||||
|
||||
---
|
||||
|
||||
## 任务概述
|
||||
|
||||
当票务商品关联的场馆模板被硬删除后，编辑商品时出现「规格不允许重复」错误。
|
||||
vr-shopxo-plugin 项目 Phase 0/1/2 后台开发已完成，现需调研票务商品详情页（`ticket_detail.html`）的酷炫前端模板实现方案。
|
||||
|
||||
**根因调查分工**：
|
||||
- FrontendDev：前端规格项构建与 fallback 行为
|
||||
- BackendArchitect：后端规格去重逻辑、`spec_base_id_map` 解析
|
||||
- SecurityEngineer：安全风险评估（P1 vs P2）
|
||||
**4个调研方向**：
|
||||
- Q1：ShopXO 自定义模板最佳实践
|
||||
- Q2：单订单多 SKU 支持（多座位选择前提）
|
||||
- Q3：第三方无代码构建服务提示词策略
|
||||
- Q4：uni-app 兼容性技术栈选型
|
||||
|
||||
**输出文件**：`docs/council-research-output.md`
|
||||
|
||||
---
|
||||
|
||||
## FrontendDev 任务清单
|
||||
## 依赖关系分析
|
||||
|
||||
- [x] [Done: council/FrontendDev] **Task 1**: 读取 `ticket_detail.html`，分析前端构建规格项的过程
|
||||
- [x] [Done: council/FrontendDev] **Task 2**: 当模板不存在时，前端如何处理 `template_snapshot` 和 `spec_base_id_map`？
|
||||
- [x] [Done: council/FrontendDev] **Task 3**: `loadSoldSeats()` 函数实际实现了吗？soldSeats 数据如何填充？
|
||||
- [x] [Done: council/FrontendDev] **Task 4**: 编辑模式下（已有 vr_goods_config），前端是否正确处理已删除场馆的旧规格？
|
||||
- [x] [Done: council/FrontendDev] **Task 5**: 给出前端根因分析（含具体文件路径和行号）
|
||||
- [x] [Done: council/FrontendDev] **Task 6**: 给出修复方案
|
||||
- [x] [Done: council/FrontendDev] **Task 7**: 将调研报告写入 `reviews/council-ghost-spec-FrontendDev.md`
|
||||
```
|
||||
Q2（多SKU） ──→ Q4（uni-app选型）的下单流程基础
|
||||
Q3（无代码） ──→ 依赖 Q1 的 ShopXO 模板约束
|
||||
Q1（最佳实践） ──→ 基础，供 Q3/Q4 引用
|
||||
```
|
||||
|
||||
**结论**：Q1 + Q2 可并行调研；Q3 依赖 Q1；Q4 依赖 Q2。
|
||||
|
||||
---
|
||||
|
||||
## SecurityEngineer 任务清单
|
||||
## Agent 任务分工
|
||||
|
||||
- [x] [Done: council/SecurityEngineer] **Task S1**: 读取 AdminGoodsSaveHandle.php — 安全审计：保存时是否拒绝脏数据
|
||||
- [x] [Done: council/SecurityEngineer] **Task S2**: 读取 SeatSkuService.php — 幽灵 spec 注入路径分析
|
||||
- [x] [Done: council/SecurityEngineer] **Task S3**: 读取 AdminGoodsSave.php — ShopXO 入口安全检查
|
||||
- [x] [Done: council/SecurityEngineer] **Task S4**: 输出安全审计报告 → `reviews/SecurityEngineer-GHOST_SPEC_SECURITY.md`
|
||||
- [x] [Done: council/SecurityEngineer] **Task S5**: 更新 `reviews/council-ghost-spec-summary.md`
|
||||
### 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**: 若不支持，给出最小改动方案
|
||||
|
||||
## BackendArchitect 任务清单
|
||||
### 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 的步骤清单）
|
||||
|
||||
- [x] [Done: council/BackendArchitect] **Task B1**: 读取 AdminGoodsSaveHandle.php，找出 `vr_goods_config` 的读取和解析逻辑
|
||||
- [x] [Done: council/BackendArchitect] **Task B2**: 找出 `spec_base_id_map` 如何被转换成规格项
|
||||
- [x] [Done: council/BackendArchitect] **Task B3**: 当 `template_id` 指向不存在的场馆时，SeatSkuService.php 的 GetGoodsViewData 如何 fallback？
|
||||
- [x] [Done: council/BackendArchitect] **Task B4**: 幽灵 spec 是在哪个环节产生的？是否在保存时过滤？
|
||||
- [x] [Done: council/BackendArchitect] **Task B5**: 商品保存时规格去重逻辑在哪里？`vr_goods_config` 中若有多个规格项的 `spec_base_id` 相同会怎样？
|
||||
- [x] [Done: council/BackendArchitect] **Task B6**: 给出根因分析（含具体行号）和修复方案
|
||||
- [x] [Done: council/BackendArchitect] **Task B7**: 将调研报告写入 `reviews/council-ghost-spec-BackendArchitect.md`
|
||||
### 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 已提交调研报告）|
|
||||
| **Finalize** | ✅ 完成（summary.md 写入，含 BackendArchitect 最终报告）|
|
||||
|
||||
---
|
||||
|
||||
## 关键文件（必须全部检查）
|
||||
|
||||
| 文件 | 关注点 |
|
||||
|------|--------|
|
||||
| `shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html` | 前端规格项构建、template_snapshot fallback |
|
||||
| `shopxo/app/plugins/vr_ticket/service/SeatSkuService.php` | GetGoodsViewData，模板不存在时的 fallback |
|
||||
| `shopxo/app/plugins/vr_ticket/hook/AdminGoodsSaveHandle.php` | 商品保存钩子，vr_goods_config 处理 |
|
||||
| `shopxo/app/plugins/vr_ticket/admin/Admin.php` | VenueDelete 硬删除逻辑 |
|
||||
| `shopxo/app/admin/hook/AdminGoodsSave.php` | ShopXO 商品保存钩子入口 |
|
||||
| 阶段 | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| **Draft** | 🔄 进行中 | 各 Agent 调研并提交各自方向报告 |
|
||||
| **Review** | ⬜ 待开始 | 各 Agent 交叉评审，FirstPrinciples 汇总 |
|
||||
| **Finalize** | ⬜ 待开始 | 输出 council-research-output.md |
|
||||
|
||||
---
|
||||
|
||||
## 输出文件
|
||||
|
||||
| 文件 | Agent | 状态 |
|
||||
|------|-------|------|
|
||||
| `reviews/council-ghost-spec-FrontendDev.md` | FrontendDev | ✅ |
|
||||
| `reviews/SecurityEngineer-GHOST_SPEC_SECURITY.md` | SecurityEngineer | ✅ |
|
||||
| `reviews/council-ghost-spec-BackendArchitect.md` | BackendArchitect | ✅ |
|
||||
| `reviews/council-ghost-spec-summary.md` | SecurityEngineer | ✅ (v2.1 — 含 BackendArchitect 报告) |
|
||||
| 文件 | 内容 | 负责人 |
|
||||
|------|------|--------|
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 根因结论（BackendArchitect 验证）
|
||||
## 技术风险识别（初判）
|
||||
|
||||
| 优先级 | 根因 | 文件:行号 |
|
||||
|--------|------|-----------|
|
||||
| **P1** | 无效 config 块未从数组移除，`continue` 后脏数据写回 DB | AdminGoodsSaveHandle.php:88-89 + 148-150 |
|
||||
| **P2** | GetGoodsViewData 单模板模式，多模板时覆盖有效块 | SeatSkuService.php:368 + 386-388 |
|
||||
| **P3** | BatchGenerate 对无效 template_id 返回 code=-2，阻断保存 | AdminGoodsSaveHandle.php:164-170 |
|
||||
| 风险 | 方向 | 影响 | 应对 |
|
||||
|------|------|------|------|
|
||||
| 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 拍板
|
||||
|
|
|
|||
Loading…
Reference in New Issue