vr-shopxo-plugin/plan.md

3.5 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 设计建议。


已知问题清单

  • [Done: council/FrontendDev] Issue 1 (P0): 购物车提交格式错误 — submit() 已修复为 POST + goods_data

    • 根因GET goods_params → BuyController 期望 POST goods_data
    • 修复submit() 改为隐藏表单 POSTgoods_data base64(JSON)attendee_data 独立字段
    • BackendArchitect 审查: [APPROVE] — 格式与 BatchGenerate() 对齐
    • findings: reviews/council-phase2-assessment.md + reviews/BackendArchitect-on-FrontendDev-P1.md
  • [Done: council/FrontendDev] Issue 2 (P1): 缩放时舞台元素不跟随 — .vr-zoom-container 已引入

    • 根因:.vr-stage.vr-seat-rows.vr-seat-map-wrapper 的平级子元素,缩放不同步
    • 修复:引入 .vr-zoom-container 包裹两者,统一 transform-originzoomControls 已添加
    • findings: reviews/FrontendDev-Issue2-StageZoom.md
  • [Done: council/FrontendDev] Issue 3 (P1): spec 加载问题回滚 — loadSoldSeats() AJAX 骨架已实现

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

    • 结论:商品内容 正常;相册数据 ⚠️ 未使用;.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