vr-shopxo-plugin/plan.md

3.3 KiB
Raw Blame History

Plan — VR 演唱会票务小程序 Phase 2 技术评估

版本v1.0 | 日期2026-04-21 | Agentcouncil/FrontendDev + council/BackendArchitect + council/FirstPrinciples


任务概述

对 Phase 2 票务插件的 4 个已知问题进行根因分析,产出一份合并评估报告 reviews/council-phase2-assessment.md包含根因、修复方案、API 设计建议。


已知问题清单

  • Issue 1 (P0): 购物车提交格式错误 — ticket_detail.html 的 submit() 构造 params 不符合 GoodsCartService::Save 契约

    • 责任人BackendArchitect优先、FrontendDev配合验证前端逻辑
    • 关键文件:shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.htmlsubmit 函数)
  • [Done: council/FrontendDev] Issue 2 (P1): 缩放时舞台元素不跟随 — .vr-stage.vr-seat-rows 容器外

    • 根因:.vr-stage.vr-seat-rows.vr-seat-map-wrapper 的平级子元素,缩放不同步
    • 修复:引入 .vr-zoom-container 包裹两者,统一 transform-origin
    • findings: reviews/FrontendDev-Issue2-StageZoom.md
  • [Done: council/FrontendDev] Issue 3 (P1): spec 加载问题回滚 — 真实库存和已售座位未成功加载

    • 根因:loadSoldSeats() 是空 TODO stub无任何 AJAX 调用
    • 修复:实现 plugins/vr_ticket/index/sold_seats 接口,前端标记 .sold class
    • findings: reviews/FrontendDev-Issue3-SpecLoading.md
  • [Done: council/FrontendDev] Issue 4 (P2): 商品详情/图片加载现状评估

    • 结论:商品内容 正常;相册数据 ⚠️ 未使用;需补充相册渲染和 .goods-detail-content CSS
    • findings: reviews/FrontendDev-Issue4-GoodsDetail.md

阶段划分

阶段 内容 时长
Round 1 (本轮) 规划:各 Agent 独立分析,创建 findings 文件 ~2 min
Round 2 执行:读取关键文件,深入分析,产出初步 findings ~5 min
Round 3 合并:各 Agent 交叉审阅,合并至 reviews/council-phase2-assessment.md ~5 min
Round 4 收敛:投票 Consensus ~1 min

分工 Claim

Issue Claim
Issue 1 (P0) [Claimed: council/BackendArchitect] + [FrontendDev 验证前端 submit 逻辑]
Issue 2 (P1) [Claimed: council/FrontendDev]
Issue 3 (P1) [Claimed: council/BackendArchitect] + [FrontendDev 配合]
Issue 4 (P2) [Claimed: council/FrontendDev]
第一性原则综合分析 [Claimed: council/FirstPrinciples]

输出文件

  • reviews/FrontendDev-Issue2-StageZoom.md — Issue 2 根因 + 修复方案FrontendDev
  • reviews/FrontendDev-Issue3-SpecLoading.md — Issue 3 前端视角分析FrontendDev
  • reviews/FrontendDev-Issue4-GoodsDetail.md — Issue 4 评估FrontendDev
  • reviews/council-phase2-assessment.md合并报告(各 Agent 合并FrontendDev 汇总执笔)

第一性原则关键问题FirstPrinciples

  1. 多座位提交 API 设计是否正交?
  2. spec_base_id_map 是否过于复杂?
  3. 选座是否必须走购物车流程?
  4. spec/库存的真实业务价值是什么?

约束

  • 最大 4 轮,每轮 ≤ 25 tool turns
  • 最大总耗时 20 分钟
  • 不 push只 local merge 到 main