5.9 KiB

Raw Blame History

Council 评估报告 — FrontendDeveloper

评估时间：2026-05-26 评估人：FrontendDeveloper 议题：下一步主攻方向

一、现状评估

vr-shopxo-uniapp 前端状态

goods-vr-ticket 组件：任务描述称"council draft 刚完成"，但 ~/WorkSpace/vr-shopxo-uniapp/components/ 下不存在 goods-vr-ticket/ 目录。fork 完成但票务组件尚未建立。

ShopXO H5 票务详情页（ticket_detail.html，819行）：

核心结构存在：规格选择、座位选择、提交购票
loadSoldSeats() 函数：TODO 注释，未实现（Plan.md P5 级遗留问题）
观演人表单存在，submission 逻辑存在
可作为过渡方案独立推进

UniApp 整体状态：

基础框架已搭建（manifest.json, pages/, common/）
支付、购物车、用户等基础组件已有
票务相关页面和组件：空白

二、发现的 3 个 P0 API Gap 对前端的影响

Gap 1：seatSpecMap 后端未返回（P0 - 阻塞选座功能）

影响：选座 UI 的数据源缺失。

前端无法知道「场次 → 演播室 → 分区 → 座位」层级
无法渲染座位地图的规格树
SeatMapService 已有 buildSeatSpecMap()，但未注入商品详情 API

前端影响评级：🔴 致命阻塞 — 无 seatSpecMap，选座组件完全无法开发

可替代方案：ticket_detail.html（H5）通过 PHP 直接渲染，不走 API，可绕过此 Gap

Gap 2：CartSave extension_data 多座位链路未确认（P0 - 阻塞下单流程）

影响：多座位下单时观演人信息存储路径未知。

前端不知道每个座位的 attendee 信息应该放在 goods_data 的哪个字段
支付成功后的票生成逻辑依赖此链路

前端影响评级：🟠 重度阻塞 — 单座位流程勉强可猜解，多座位完全无法开发

可替代方案：目前先按单座位模式开发，多座位延后

Gap 3：QR payload 缺少 code 字段（P1 - 可变通处理）

影响：前端按文档解析 QR 会缺字段。

可变通：先用 id 和 g 验过期时间，code 字段前端忽略
后端 QR 验签不依赖前端处理，前端只需展示 QR 码

前端影响评级：🟡 中度影响 — 不阻塞开发，可快速适配

三、前端开发路径建议

路径 A：H5 优先（无阻塞，可立即启动）

ticket_detail.html（H5）绕过 API Gap 价值最高：

PHP 直出 HTML，选座逻辑内联，不依赖 seatSpecMap API
后端已实现 SeatSkuService::GetGoodsViewData()，数据已注入模板
可立即推进：loadSoldSeats() 实现、核销码展示、观演人表单美化
作为生产兜底：uniapp 延期时 H5 可先上线

执行步骤：

实现 loadSoldSeats() — 调用 seatmap API 获取已售座位，填充 soldSeats 数组
优化观演人表单 UX
核销码展示（QR + 短码）

路径 B：UniApp 选座组件开发（需等 Gap 1 解决）

Gap 1 解决后，UniApp 可完全独立推进：

goods-vr-ticket 组件框架
商品详情页 → 票务扩展信息渲染
选座页（依赖 seatSpecMap）
购票确认页（单座位先验）
票夹页（依赖 TicketWallet API）
核销页

执行步骤（Gap 1 解决后）：

goods-vr-ticket 组件基础框架
商品详情页集成 seatSpecMap
选座页 + 座位地图渲染
购票确认 + 支付

四、ticket_detail.html 价值评估

过渡方案价值：高

维度	评分	说明
功能完整性	7/10	核心流程已有，loadSoldSeats 缺失
开发成本	低	PHP 直出，无需前后端分离适配
用户体验	5/10	观演人表单粗糙，无选座动画
独立部署	可	嵌入 ShopXO H5 模板体系

结论：ticket_detail.html 是 H5 端票务的唯一载体，必须维护好。与 UniApp 是互补关系而非竞争关系。

五、优先级建议（前端维度）

P0（必须先做）

Gap 1 确认：后端在商品详情 API 注入 seatSpecMap，解锁 uniapp 选座开发
Gap 2 确认：CartSave extension_data 写入 order_detail 的路径文档化

P1（H5 优先，可立即执行）

实现 loadSoldSeats() — 调用 /seatmap API 获取已售座位
ticket_detail.html 观演人表单 UX 优化
核销码展示组件（QR 图 + 短码）

P2（Gap 1 解决后启动）

UniApp goods-vr-ticket 组件框架搭建
UniApp 商品详情页集成 seatSpecMap

六、投票

议题：下一步主攻方向

投票：C — 双线并行

理由：

H5 ticket_detail.html 完全独立于 API Gap，可立即推进（实现 loadSoldSeats + 表单优化）
UniApp 的 Gap 1（seatSpecMap）和 Gap 2（extension_data）需要后端配合，但可并行确认
选项 A（纯后端优先）会让前端空等，选项 B（H5 优先）忽视 Uniapp 的长期价值
选项 D（Phase 4 优先）属于锦上添花，Phase 3 核心票务流程尚未完成

补充 — 对其他成员提案的评估：

BackendArchitect 选 A：合理，Gap 1 和 Gap 2 确实是阻塞点。但纯后端优先会让前端团队空转。
PerformanceBenchmarker：seatmap API 性能影响选座体验，建议在 Phase 2 开发时做基准测试。
SecurityEngineer：支付链路安全是 P0，但与前端并行不冲突。

FrontendDeveloper 投票

议题：下一步主攻方向