sileya-ai
/
vr-shopxo-plugin
1
0
Fork 0
Code Issues 3 Pull Requests Packages Projects Releases Wiki Activity
vr-shopxo-plugin/plan.md

5.6 KiB
Raw Permalink Blame History

Plan — 调研「场馆删除后编辑商品出现规格重复错误」问题

版本：v1.3 | 日期：2026-04-20 | Agent：council/FrontendDev + council/SecurityEngineer + council/BackendArchitect

BackendArchitect（Task B1-B6）

当票务商品关联的场馆模板被硬删除后，编辑商品时出现「规格不允许重复」错误。

根因调查分工：

  • FrontendDev：前端规格项构建与 fallback 行为
  • BackendArchitect：后端规格去重逻辑、spec_base_id_map 解析
  • SecurityEngineer：安全风险评估（P1 vs P2）

FrontendDev 任务清单

  • [Done: council/FrontendDev] Task 1: 读取 ticket_detail.html，分析前端构建规格项的过程
  • [Done: council/FrontendDev] Task 2: 当模板不存在时，前端如何处理 template_snapshot 和 spec_base_id_map？
  • [Done: council/FrontendDev] Task 3: loadSoldSeats() 函数实际实现了吗？soldSeats 数据如何填充？
  • [Done: council/FrontendDev] Task 4: 编辑模式下（已有 vr_goods_config），前端是否正确处理已删除场馆的旧规格？
  • [Done: council/FrontendDev] Task 5: 给出前端根因分析（含具体文件路径和行号）
  • [Done: council/FrontendDev] Task 6: 给出修复方案
  • [Done: council/FrontendDev] Task 7: 将调研报告写入 reviews/council-ghost-spec-FrontendDev.md

SecurityEngineer 任务清单

  • [Done: council/SecurityEngineer] Task S1: 读取 AdminGoodsSaveHandle.php — 安全审计：保存时是否拒绝脏数据
  • [Done: council/SecurityEngineer] Task S2: 读取 SeatSkuService.php — 幽灵 spec 注入路径分析
  • [Done: council/SecurityEngineer] Task S3: 读取 AdminGoodsSave.php — ShopXO 入口安全检查
  • [Done: council/SecurityEngineer] Task S4: 输出安全审计报告 → reviews/SecurityEngineer-GHOST_SPEC_SECURITY.md
  • [Done: council/SecurityEngineer] Task S5: 更新 reviews/council-ghost-spec-summary.md

优先级定义

级别 含义
P1 安全漏洞：脏数据注入、XSS、权限绕过、数据覆盖
P2 功能缺陷：用户体验问题、错误提示不友好
P3 改进建议：代码健壮性优化

BackendArchitect 任务清单

  • [Done: council/BackendArchitect] Task B1: AdminGoodsSaveHandle.php 全链路追踪 — vr_goods_config 读取/解析/snapshot 重建
  • [Done: council/BackendArchitect] Task B2: spec_base_id_map 如何被转换成规格项（已验证：存储在模板表，与幽灵 spec 无关）
  • [Done: council/BackendArchitect] Task B3: SeatSkuService GetGoodsViewData 模板不存在时的 fallback（单模板处理，多模板有缺陷）
  • [Done: council/BackendArchitect] Task B4: 幽灵 spec 产生环节 + 清理时机（保存时未清理，写回 DB）
  • [Done: council/BackendArchitect] Task B5: 商品保存规格去重逻辑（GoodsService.php:1859）
  • [Done: council/BackendArchitect] Task B6: 根因分析报告（含行号）→ reviews/council-ghost-spec-BackendArchitect.md
  • [Done: council/BackendArchitect] Task B7: 将调研报告写入 reviews/council-ghost-spec-BackendArchitect.md

阶段划分 ✅

阶段 内容 状态
Draft Task 1-7（FrontendDev）+ Task S1-S3 + Task B1-B6（并行） ✅ 完成
Review Task 7 + Task S4 + Task B7（输出各自报告） ✅ 完成
Finalize Task S5：汇总到 reviews/council-ghost-spec-summary.md ✅ 完成

根因结论

优先级 根因 文件:行号
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
P4 前端过滤后 configs 为空时用户无声失去配置 AdminGoodsSave.php:196-229
P5 loadSoldSeats 未实现（TODO 注释） ticket_detail.html:375-383
安全评估 无 P1 安全漏洞，属于 P2 功能缺陷 SecurityEngineer-GHOST_SPEC_SECURITY.md

关键文件

文件 关注点
shopxo/app/plugins/vr_ticket/hook/AdminGoodsSaveHandle.php P1 根因：continue 不删除脏 config
shopxo/app/plugins/vr_ticket/service/SeatSkuService.php GetGoodsViewData：P2 根因，多模板处理缺陷
shopxo/app/plugins/vr_ticket/hook/AdminGoodsSave.php 前端过滤逻辑：P4 体验问题
shopxo/app/plugins/vr_ticket/admin/Admin.php VenueDelete：硬删除逻辑（第 888 行）
shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html loadSoldSeats 未实现（P5）
shopxo/app/service/GoodsService.php 规格列值去重检测（第 1859 行）

修复方案

P1 Fix（立即实施）

  1. AdminGoodsSaveHandle.php:88 — continue 改为 unset($configs[$i])
  2. AdminGoodsSaveHandle.php:145 后 — 添加 $configs = array_values($configs);
  3. AdminGoodsSaveHandle.php:148 — 写回前加 if (!empty($configs))
  4. AdminGoodsSaveHandle.php:158-173 — BatchGenerate 前增加模板存在性显式校验

P2 Fix（高优先级）

  1. SeatSkuService.php GetGoodsViewData — 遍历所有有效配置块，不只处理 $vrGoodsConfig[0]
  2. 修改 DB 写回逻辑为写回 validConfigs 而非 [$config]

P3 Fix（中优先级）

  1. AdminGoodsSave.php — configs 为空时提示用户重新选择场馆