From e8554f29ad72866f4b8c0c8ffb25be7ed880e752 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 05:25:54 +0800 Subject: [PATCH 01/12] =?UTF-8?q?council(draft):=20Architect=20-=20?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AF=84=E4=BC=B0=E8=AE=A1=E5=88=92=EF=BC=88?= =?UTF-8?q?Round=201=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 评审三份文档： - docs/14_TEMPLATE_RENDER_INVESTIGATION.md - docs/PHASE2_PLAN.md - docs/DEVELOPMENT_LOG.md（第十一、十二章） Co-Authored-By: Claude Sonnet 4.6 --- plan.md | 232 +++++++------------------------------------------------- 1 file changed, 29 insertions(+), 203 deletions(-) diff --git a/plan.md b/plan.md index 0112369..93418b3 100644 --- a/plan.md +++ b/plan.md @@ -1,228 +1,54 @@ -# vr-shopxo-plugin Phase 2 Bugfix — plan.md +# Plan — 文档评估 (Architect) -> 版本：v1.0 | 日期：2026-04-16 | Agent：council/FrontendDev -> 背景：Phase 2 后台管理两个致命问题 — 侧栏乱码 + 路由无法渲染 +> 版本：v1.0 | 日期：2026-04-20 | Agent：council/Architect --- -## 问题总览 +## 任务概述 -| # | 问题 | 症状 | 优先级 | -|---|------|------|--------| -| **P1** | 插件控制器路由无法渲染 | 内容区空白，"template not exists" | 高 | -| **P2** | 侧边栏插件名乱码 | `VR票务`（应为 `VR票务`） | 中 | +对 vr-shopxo-plugin 项目三份文档进行评审： +1. `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` +2. `docs/PHASE2_PLAN.md` +3. `docs/DEVELOPMENT_LOG.md`（第十一、十二章） + +评审维度：准确性、完整性、可操作性、一致性、误导风险。 +**不读代码文件，只读文档。输出到 `reviews/` 目录。** --- -## P1 — 路由无法渲染问题 +## 任务清单 -### 已知现象 -- 访问 `adminwatekc.php?s=VrTicket/SeatTemplateList` → 侧栏正常，主内容区空白 -- ShopXO `Plugins/Index` 控制器调用插件时有 `strtolower+ucfirst` 类名匹配问题 -- 当前 `SeatTemplate.php` 在 `admin/controller/` 子目录 +- [ ] **Task 1**: 评审 `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` → `reviews/Architect-on-doc14.md` + - [Claimed: council/Architect] -### 已知正确模式（freightfee/answers） -``` -app/plugins/{plugin}/ -├── Admin.php ← 直接在插件根目录，继承 think\Controller -├── Hook.php -├── config.json -└── admin/view/... ← 视图在 admin/view/ 子目录 -``` +- [ ] **Task 2**: 评审 `docs/PHASE2_PLAN.md` → `reviews/Architect-on-PHASE2_PLAN.md` + - [Claimed: council/Architect] -### 当前 vr_ticket 结构（有问题） -``` -app/plugins/vr_ticket/ -├── admin/controller/SeatTemplate.php ← ❌ 在子目录 -└── admin/view/seat_template/list.html -``` +- [ ] **Task 3**: 评审 `docs/DEVELOPMENT_LOG.md`（第十一、十二章）→ `reviews/Architect-on-DEV_LOG.md` + - [Claimed: council/Architect] -### 任务清单 - -- [x] **P1-T1**: 验证 `strtolower+ucfirst` 路由匹配机制 - - PluginsService::PluginsControlCall: `class = \app\plugins\{plugin}\{group}\{ucfirst(control)}` - - sidebar URL `/plugins/vr_ticket/admin/seatTemplateList` - - → pluginsname=vr_ticket, pluginscontrol=admin, pluginsaction=seatTemplateList - - → class = \app\plugins\vr_ticket\admin\Admin ✓ - - → method = ucfirst('seatTemplateList') = 'SeatTemplateList' ✓ -- [x] **P1-T2**: 对比 Admin.php 根目录模式 vs 当前 admin/controller/ 子目录模式 - - 根目录 Admin.php (`app/plugins/vr_ticket/admin/Admin.php`) 可以被正确加载 ✓ - - 旧子目录控制器无法被 PluginsService 找到（类路径不匹配）✗ -- [x] **P1-T3**: 实施修复 — 创建 `admin/Admin.php`（注意：不是根目录，是 admin/ 子目录） - - `admin/Admin.php` 路径 → 类名 `\app\plugins\vr_ticket\admin\Admin` ✓ - - 方法使用 camelCase：`SeatTemplateList()`, `TicketList()` 等 - - sidebar URL 必须用 camelCase：`pluginsaction=seatTemplateList` - - 修复 plugin.json sidebar URL：改为 `/plugins/vr_ticket/admin/seatTemplateList` 格式 -- [ ] **P1-T4**: 验证修复后路由能否正常渲染（需实际访问 URL 截图） - ---- - -## P2 — 侧栏插件名乱码问题 - -### 已知现象 -- 侧栏显示：`VR票务`（应为 `VR票务`） -- 这是 UTF-8 字符串被当作 Latin1/ISO-8859-1 解码的结果 -- 乱码规律：`票` (E7 A5 8A) → Latin1 解码为 `票务` - -### 乱码根因假设 -| 假设 | 可能性 | 验证方式 | -|------|--------|----------| -| 数据库 `vrt_power` 表 name 字段 latin1 编码存储 | 高 | 检查 MySQL `SHOW CREATE TABLE vrt_power` | -| 数据库连接 charset 不匹配 | 中 | 检查 ShopXO 数据库配置 charset | -| plugin.json 编码问题 | 低 | plugin.json 已是正确 UTF-8 | - -### 任务清单 - -- [ ] **P2-T1**: 确认乱码根因 — 检查 vrt_power 表结构 - - `SHOW CREATE TABLE vrt_power` - - `SHOW FULL COLUMNS FROM vrt_power` - - 确认 name 字段 charset 和 collate -- [ ] **P2-T2**: 如果是数据库 latin1 问题 — 修复方案 - - 方案A：ALTER TABLE 转换 latin1 → utf8mb4 - - 方案B：MySQL CONVERT/CAST 函数读取时转换 - - 方案C：PHP 层以 latin1 读出再转 utf8 - ---- - -## 视图路径问题（Round 5 根因确认 + 修复） - -### 根因（BackendArchitect 分析） -ThinkPHP 5 视图路径解析规则： -1. 相对路径（如 `'seat_template/list'`）：相对于**控制器 namespace 对应的默认视图目录** -2. namespace `app\plugins\vr_ticket\admin` → 默认视图目录 `app/plugins/vr_ticket/admin/view/` -3. 实际文件在 `app/admin/view/default/plugins/view/vr_ticket/admin/view/` ← 路径不匹配！ - -### 实际文件位置 -``` -app/admin/view/default/plugins/view/vr_ticket/admin/view/ -├── seat_template/ -│ ├── list.html -│ └── save.html -├── ticket/ -│ ├── list.html -│ └── detail.html -├── venue/ -│ ├── list.html -│ └── save.html -├── verifier/ -│ ├── list.html -│ └── save.html -└── verification/ - └── list.html -``` - -### 修复方案 -ThinkPHP 5 以 `/` 开头的视图路径为**绝对路径**，相对于配置的视图根目录（`app/admin/view/default/`）解析。 - -修复前（错误）： -```php -return view('seat_template/list', $data); // 解析到 app/plugins/vr_ticket/admin/view/ ← 不存在 -``` - -修复后（正确）： -```php -return view('/plugins/view/vr_ticket/admin/view/seat_template/list', $data); -// → app/admin/view/default/plugins/view/vr_ticket/admin/view/seat_template/list.html ✓ -``` - -**所有 9 个 view() 调用已全部修复为绝对路径格式。** - -### Vrticket.php 的参考价值 -`shopxo/app/admin/controller/Vrticket.php` 使用 `MyView('../../../plugins/vr_ticket/admin/' . $template)` 手动处理路径。 -Admin.php 使用 ThinkPHP `view()` 函数，以 `/` 开头则由 ThinkPHP 自动解析到 `app/admin/view/default/`。 +- [ ] **Task 4**: 综合三份评审，输出 Top 3 修正建议 → `reviews/Architect-DOC-SUMMARY.md` + - [Claimed: council/Architect] --- ## 阶段划分 -| 阶段 | 内容 | 负责 | -|------|------|------| -| **Round 1（规划）** | 分析根因，制定修复方案 | FrontendDev | -| **Round 2（执行）** | 实施 admin/Admin.php + plugin.json 修复 | FrontendDev | -| **Round 3（综合）** | 合并到 main，完整验证 | 所有成员 | +| 阶段 | 内容 | +|------|------| +| **Draft** | Task 1-3：逐份文档输出独立评审报告 | +| **Review** | Task 4：综合汇总，Top 3 修正建议 | +| **Finalize** | 提交到 main，标注完成 | --- -## 依赖关系 +## 依赖 -- P1-T3 和 P1-T4 需要实际访问 URL 验证（无法在 CLI 环境截图） -- P2-T1 需要连接数据库检查编码 +- 三份文档已读取完毕，无需额外探索 +- 不需要 BackendArchitect / SecurityEngineer 配合，可独立完成 --- -## 交付物 +## 执行顺序 -1. 修复后的 `shopxo/app/plugins/vr_ticket/admin/Admin.php`（路由正确） -2. 修复后的 `shopxo/app/plugins/vr_ticket/plugin.json`（sidebar URL 使用 camelCase） -3. 乱码问题修复（需数据库层修复） - -## 状态 - -| 任务 | 状态 | 备注 | -|------|------|------| -| P1-T1 | [Done] | PluginsService 路由机制已分析 | -| P1-T2 | [Done] | admin/Admin.php 模式正确 | -| P1-T3 | [Done] | admin/Admin.php 已创建 + plugin.json 已修复 | -| P1-T4 | [Pending] | 需实际访问 URL 截图验证 | -| P2-T1 | [Done] | 根因：plugins.name 字段 Latin1 存储 | -| P2-T2 | [Done] | SQL 修复脚本见 docs/SQL_FIX_garbled_plugin_name.md | -| P1-视图路径 | [Done] | 所有 9 个 view() 改为绝对路径 `/plugins/view/vr_ticket/admin/view/...` | - ---- - -## BackendArchitect Round 5 实现 - -### 交付物 -1. ✅ `shopxo/app/plugins/vr_ticket/admin/Admin.php` — 9 个 view() 调用全部改为 `/plugins/view/vr_ticket/admin/view/...` 绝对路径 -2. ✅ `docs/SQL_FIX_garbled_plugin_name.md` — 乱码修复 SQL 脚本 -3. ✅ `plan.md` — 更新根因分析 - -### P1 乱码 DB 根因（最终确认） -- `plugins.name` 字段 = `VR票务`（Latin1 解码的 UTF-8 字节） -- 安装时 `plugin.json` 的 `title: "VR票务"` 被以 Latin1 编码存入 MySQL -- 读取时 MySQL 连接 charset 是 utf8mb4，所以 Latin1 字节被错误解码为乱码 -- **修复**：执行 `UPDATE sx_plugins SET name = 'VR票务' WHERE plugins = 'vr_ticket'` - -### 乱码字节分析 -`票` UTF-8: `E7 A5 8A` → Latin1 解读为: `票务` -`务` UTF-8: `E5 8A B1` → (in `VR票务` combined string) - - ---- - -## SecurityEngineer Round 5 补充 - -### 关键发现：VenueList() 方法缺失（Critical Bug） -plugin.json sidebar URL `/plugins/vr_ticket/admin/venueList` 链接到 `VenueList()` 方法，但 admin/Admin.php 中该方法不存在 → 点击"场馆配置"菜单会导致 500 错误。 - -**已修复**：在 admin/Admin.php 中添加： -- `VenueList()` — 场馆列表（含 v3.0 seat_map 解析） -- `VenueSave()` — 场馆创建/编辑（含 v3.0 JSON 构建和验证） -- `VenueDelete()` — 场馆软删除（含审计日志） -- `countSeatsV2()` — v2 格式（数组）座位计数辅助方法 - -### 安全审计结论 - -| 安全项 | 风险等级 | 结论 | -|--------|----------|------| -| SQL 注入 | LOW | 所有查询使用 ThinkPHP query builder + 参数绑定 | -| XSS | LOW | ThinkPHP 模板引擎自动转义，无 `\|raw` 输出 | -| 路径遍历 | LOW | 所有视图路径为硬编码方法名，无用户输入 | -| CSRF | MEDIUM | ShopXO 框架级缺失，插件层面无法单独修复 | -| 数据编码（P1乱码）| LOW | DB latin1 存储导致乱码，非安全漏洞 | - -### P1 乱码 DB 修复 SQL - -```sql --- 1. 诊断 -SELECT id, name, title, LENGTH(name), HEX(name) FROM shx_plugins WHERE name LIKE '%vr%'; - --- 2. 修复 plugins 表 -UPDATE shx_plugins SET name = 'vr_ticket', title = 'VR票务' WHERE name = 'vr_ticket'; - --- 3. 修复 vrt_power 表（如果存在乱码） -SELECT id, name, LENGTH(name), HEX(name) FROM vrt_power WHERE name LIKE '%票%'; -UPDATE vrt_power SET name = 'VR票务' WHERE HEX(name) LIKE '%E7A58A%'; -``` - -详细安全分析见：`reviews/SecurityEngineer-round5-review.md` +Task 1 → Task 2 → Task 3 → Task 4（串行，每份评审写完即 commit） From 496271c468f7b0a93f495d8551451078d789d344 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 05:29:36 +0800 Subject: [PATCH 02/12] =?UTF-8?q?council(review):=20Architect=20-=20?= =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=B8=89=E4=BB=BD=E6=96=87=E6=A1=A3=E8=AF=84?= =?UTF-8?q?=E5=AE=A1=EF=BC=8C=E8=BE=93=E5=87=BA=20Top=203=20=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3=E5=BB=BA=E8=AE=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Top 3 问题： 1. `{include}` 标签验证状态未闭环（已提交 ≠ 已验证） 2. DEVELOPMENT_LOG 两条 Git 时间线未衔接 3. 测试数据 goods_id 在多份文档中出现三个不同值 详见 reviews/Architect-DOC-SUMMARY.md Co-Authored-By: Claude Sonnet 4.6 --- plan.md | 22 +++--- reviews/Architect-DOC-SUMMARY.md | 107 ++++++++++++++++++++++++++++ reviews/Architect-on-DEV_LOG.md | 76 ++++++++++++++++++++ reviews/Architect-on-PHASE2_PLAN.md | 67 +++++++++++++++++ reviews/Architect-on-doc14.md | 65 +++++++++++++++++ 5 files changed, 326 insertions(+), 11 deletions(-) create mode 100644 reviews/Architect-DOC-SUMMARY.md create mode 100644 reviews/Architect-on-DEV_LOG.md create mode 100644 reviews/Architect-on-PHASE2_PLAN.md create mode 100644 reviews/Architect-on-doc14.md diff --git a/plan.md b/plan.md index 93418b3..0d9a11f 100644 --- a/plan.md +++ b/plan.md @@ -18,17 +18,17 @@ ## 任务清单 -- [ ] **Task 1**: 评审 `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` → `reviews/Architect-on-doc14.md` - - [Claimed: council/Architect] +- [x] **Task 1**: 评审 `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` → `reviews/Architect-on-doc14.md` + - [Done: council/Architect] -- [ ] **Task 2**: 评审 `docs/PHASE2_PLAN.md` → `reviews/Architect-on-PHASE2_PLAN.md` - - [Claimed: council/Architect] +- [x] **Task 2**: 评审 `docs/PHASE2_PLAN.md` → `reviews/Architect-on-PHASE2_PLAN.md` + - [Done: council/Architect] -- [ ] **Task 3**: 评审 `docs/DEVELOPMENT_LOG.md`（第十一、十二章）→ `reviews/Architect-on-DEV_LOG.md` - - [Claimed: council/Architect] +- [x] **Task 3**: 评审 `docs/DEVELOPMENT_LOG.md`（第十一、十二章）→ `reviews/Architect-on-DEV_LOG.md` + - [Done: council/Architect] -- [ ] **Task 4**: 综合三份评审，输出 Top 3 修正建议 → `reviews/Architect-DOC-SUMMARY.md` - - [Claimed: council/Architect] +- [x] **Task 4**: 综合三份评审，输出 Top 3 修正建议 → `reviews/Architect-DOC-SUMMARY.md` + - [Done: council/Architect] --- @@ -36,9 +36,9 @@ | 阶段 | 内容 | |------|------| -| **Draft** | Task 1-3：逐份文档输出独立评审报告 | -| **Review** | Task 4：综合汇总，Top 3 修正建议 | -| **Finalize** | 提交到 main，标注完成 | +| **Draft** | ✅ Task 1-3：逐份文档输出独立评审报告 | +| **Review** | ✅ Task 4：综合汇总，Top 3 修正建议 | +| **Finalize** | ✅ 提交到 main，标注完成 | --- diff --git a/reviews/Architect-DOC-SUMMARY.md b/reviews/Architect-DOC-SUMMARY.md new file mode 100644 index 0000000..616adb1 --- /dev/null +++ b/reviews/Architect-DOC-SUMMARY.md @@ -0,0 +1,107 @@ +# 文档评审综合报告 + +> 评估时间：2026-04-20 | 评估人：council/Architect +> 评审范围：docs/14_TEMPLATE_RENDER_INVESTIGATION.md、docs/PHASE2_PLAN.md、docs/DEVELOPMENT_LOG.md（十一、十二章） + +--- + +## 各文档评分汇总 + +| 文档 | 准确性 | 完整性 | 可操作性 | 一致性 | 综合 | +|------|--------|--------|----------|--------|------| +| docs/14_TEMPLATE_RENDER_INVESTIGATION.md | 7/10 | 6/10 | 8/10 | 8/10 | **7.3** | +| docs/PHASE2_PLAN.md | 7/10 | 7/10 | 7/10 | 8/10 | **7.3** | +| docs/DEVELOPMENT_LOG.md（十一、十二章）| 6/10 | 7/10 | 7/10 | 5/10 | **6.3** | + +--- + +## Top 3 最需要修正的问题 + +### 🔴 问题 1：`{include}` 标签验证状态未闭环（高风险） + +**涉及文档**：doc14（Section 2.1/4）、PHASE2_PLAN.md（Section 2） + +**问题描述**： +doc14 在 Section 2.1 标题标注"✅ 已验证（已提交 7bd896764）"，Section 6 "关联提交"也声称代码已提交。但在 Section 4 模板渲染现状表格中，`{include file="public/head"}` 明确标注"⚠️ 待验证"，Section 5 列出了方向 A/B/C 作为待实测方案。PHASE2_PLAN.md Section 2 也将 `{include}` 解析列为"待实测项"。 + +**核心矛盾**：已提交 ≠ 已验证成功。这两件事被混淆在同一份文档里，读者无法判断票务商品详情页的 `{include}` 标签当前是否工作。 + +**实际状态**：根据 commit 7bd896764 的描述，该提交仅完成了" Goods.php 绝对路径方案 + SeatSkuService::GetGoodsViewData() + TicketService::onOrderPaid() 修复"，`{include}` 标签解析**从未在容器内被实测验证**。这是 Phase 2 当前最大的未闭环风险点。 + +**修正建议**： +1. doc14 Section 2.1 标题的"✅ 已验证"改为"✅ 代码已提交（P0：容器内实测待完成）" +2. Section 4 状态表格提升优先级标注：标记 `{include}` 解析为 **P0**，而非普通"待验证"项 +3. 在 PHASE2_PLAN.md Section 3 Step 1 补充：执行 curl 之前必须先确认测试数据存在（goods_id=118 + 对应座位模板 + 场次 spec_base） + +--- + +### 🔴 问题 2：DEVELOPMENT_LOG 存在两条未衔接的 Git 时间线（高风险） + +**涉及文档**：docs/DEVELOPMENT_LOG.md + +**问题描述**： +Chapter 8.1（"当前状态快照 2026-04-15"）记录 commit 历史截止 `7508bed`（Phase 0/1 完成）。Chapter 11（"Phase 2 前台展示层完成 2026-04-20"）直接引用 commit `7bd896764` 作为当前 HEAD，但该 commit 未出现在 Chapter 8.1 的历史列表中。同时，Chapter 5.1 的 Goods.php 代码示例（Phase 1 版本）与 doc14 Section 2.1（Phase 2 最终版本）存在根本性差异（相对路径 vs 绝对路径），后者没有在 DEVELOPMENT_LOG 中记录。 + +**风险**：接手者无法从 DEVELOPMENT_LOG 独立重建"Phase 1 → Phase 2"的代码演进路径。Chapter 5.1 的 Goods.php 代码示例是已被替换的旧版本，但没有任何注释说明。 + +**修正建议**： +1. 将 DEVELOPMENT_LOG 的 Git 历史合并为单一时间线，从 `34f7045`（Phase 0）到 `7bd896764`（Phase 2 前台），在 Chapter 11.3 中补充完整的 commit 序列 +2. 在 Chapter 5.1 或新增 Chapter 10.5 中记录 Phase 1 → Phase 2 Goods.php 代码的演进原因（为什么从相对路径 MyView 改为绝对路径 View::fetch） +3. 清理 Chapter 8.3 失效路径信息（`~/.openclaw/workspace/...`），改为当前 vr-shopxo-plugin 的实际目录结构 + +--- + +### 🟡 问题 3：测试数据 goods_id 在四份文档中出现三个不同值（误导风险） + +**涉及文档**：DEVELOPMENT_LOG.md（Chapter 4/5）、doc14（Section 1）、PHASE2_PLAN.md（Section 3 Step 1） + +**问题描述**： +| 来源 | goods_id | 含义 | +|------|----------|------| +| DEVELOPMENT_LOG Chapter 4 | 112 | Phase 0 测试数据："VR演唱会电子票 2024" | +| DEVELOPMENT_LOG Chapter 5.2 | 1 | Phase 1 URL 测试：`id/1` | +| doc14 Section 1 | 118 | 调查对象 URL：`id/118.html` | +| PHASE2_PLAN.md Step 1 | 118 | Step 1 实测 URL：`id/118.html` | + +没有任何文档解释：goods_id 112 和 118 是否是同一商品的不同 ID？goods_id=1 是什么商品？Phase 1 和 Phase 2 是否使用不同的测试商品？ + +**风险**：读者无法判断当前哪个 goods_id 是有效的测试入口，容易在调研过程中以错误的 ID 访问到不相关商品，进而对系统行为产生误判。 + +**修正建议**： +1. 在 DEVELOPMENT_LOG Chapter 4 测试数据节中，明确列出所有 Phase 0-2 使用过的测试商品 ID 及其用途（如 goods_id=112 是 Phase 0 场次模板绑定测试商品，goods_id=118 是 Phase 2 票务详情页渲染测试商品） +2. PHASE2_PLAN.md Step 1 补充"当前有效测试商品"清单（只保留 goods_id=118，标注为 Phase 2 唯一有效测试入口） +3. 删除或标注 goods_id=1 的 Phase 1 测试记录（因为它与当前代码版本不对应） + +--- + +## 次要问题（建议修复，但不阻塞） + +| # | 问题 | 涉及文档 | 优先级 | +|---|------|----------|--------| +| A | `spec_base_id_map` JSON 结构未记录（座位图渲染核心字段）| doc14 Section 2.2 | 高 | +| B | Step 4 核销 API 缺少认证/权限上下文 | PHASE2_PLAN.md Section 3 | 高 | +| C | `vrt_vr_tickets.order_no` 无 NOT NULL 约束，缺少空值防御 | DEVELOPMENT_LOG Chapter 4 | 中 | +| D | "第十二章"在任务要求中出现但文档中不存在 | DEVELOPMENT_LOG.md | 中 | +| E | 决策点3（Layui 是否继续使用）已过时（后台已用 Layui）| PHASE2_PLAN.md Section 6 | 低 | +| F | doc14 Section 3.1 缺少根因总结（view_path 拼接错误）| doc14 Section 3.1 | 低 | + +--- + +## 文档间一致性总览 + +| 检查项 | 状态 | 说明 | +|--------|------|------| +| 表名前缀（vrt_vr_ vs sx_/sxo_） | ✅ 一致 | 插件表 vrt_vr_，ShopXO 原生平表 sxo_ | +| commit 7bd896764 引用 | ✅ 一致 | 三份文档均引用 | +| `goods.vr_goods_config` JSON 字段 | ✅ 一致 | 三份文档均正确 | +| `sxo_order_detail` 表名 | ✅ 一致 | 三份文档均一致 | +| Goods.php 方法名（Index vs detail）| ❌ 不一致 | DEVELOPMENT_LOG 写 detail()，doc14 写 Index() | +| Goods.php 路径方案（相对 vs 绝对）| ❌ 不一致 | Phase 1 相对路径 vs Phase 2 绝对路径 | +| goods_id 测试数据 | ❌ 不一致 | 1 / 112 / 118 三个不同值 | +| Git 时间线 | ❌ 不一致 | Chapter 8.1 截止 Phase 1，Chapter 11 从 Phase 2 开始 | + +--- + +## 总体结论 + +三份文档的修正意识值得肯定（doc14 修正说明表格、Chapter 11 清理记录），但在"已提交 vs 已验证"的闭环性、多时间线合并、以及测试数据的唯一性方面存在系统性问题。最紧迫的是**立即在容器内实测 `{include}` 标签解析**（Top 1），这是整个 Phase 2 前台展示层是否真正完成的关键验证节点；其次是**整理 DEVELOPMENT_LOG 的时间线**（Top 2），使项目历史可以被独立追溯；最后**统一测试数据 goods_id**（Top 3），避免后续开发者在错误的测试数据上浪费时间。 diff --git a/reviews/Architect-on-DEV_LOG.md b/reviews/Architect-on-DEV_LOG.md new file mode 100644 index 0000000..4dd82e8 --- /dev/null +++ b/reviews/Architect-on-DEV_LOG.md @@ -0,0 +1,76 @@ +# docs/DEVELOPMENT_LOG.md 评估报告（第十一、十二章） + +> 评估时间：2026-04-20 | 评估人：council/Architect + +--- + +## 准确性评分：6/10 + +- **问题1（高）**：Chapter 8.1 "Git Commit 历史"最新记录是 `7508bed`（Phase 0/1 完成），但 Chapter 11 开篇就提到 commit `7bd896764`（Phase 2 前台展示层），该 commit **未出现在 Chapter 8.1 的历史列表中**。Chapter 8.1 的历史在 Chapter 11 之后被追加，但两章内容没有合并，造成同一日志中出现两段不同时间线的 commit 历史。 + +- **问题2（高）**：Chapter 5.1 "修改内容"中 `return MyView('public/../../../plugins/vr_ticket/view/goods/ticket_detail', [...])` 这行代码使用的是相对路径 `public/../../../`，而 doc14 中说明的实际实现（commit 7bd896764）使用的是**绝对路径** `ROOT . 'app' . DS . 'plugins' ...`。两个文件描述的是**不同版本的代码**，Chapter 5.1 记录的是 Phase 1 早期版本，而非最终提交版本。 + +- **问题3（高）**：Chapter 5.1 位置描述"detail() 方法"，但 doc14 和 PHASE2_PLAN.md 均使用 `Goods::Index()`。ShopXO Goods 控制器实际方法名为 `Index()`（对应 `goods/index` 路由）或 `detail()`（对应 `goods/detail` 路由），需要确认实际的路由 URL 才能判断哪个正确——但基于文档内部不一致，**必定有一处是错的**。 + +- **问题4（中等）**：Chapter 4 Phase 0 建表 DDL 中 `vrt_vr_tickets.order_no VARCHAR(64)` 没有 NOT NULL 约束，但 TicketService::onOrderPaid()（doc14 Section 2.3）会写入 `order_no` 字段。如果 phase0 建表时 order_no 允许 NULL，后续业务逻辑没有对此做防御性处理。 + +- **问题5（中等）**：Chapter 4 DDL `spec_base JSON COMMENT '座位规格基数据'` 字段名是 `spec_base`，但 doc14 Section 2.2 中 `vr_seat_templates` 表的联查提到的是 `goods_spec_value` + `goods_spec_base`。两张表都叫 `spec_base`，但一个是插件表 JSON 列（`vrt_vr_seat_templates.spec_base`），一个是 ShopXO 原生平表（`goods_spec_base`）。文档没有明确区分，容易混淆。 + +--- + +## 完整性评分：7/10 + +- **缺失项1（高）**：Chapter 5 Phase 1 完成内容（座位图三行渲染、场次选择、观演人表单）没有说明这些 UI 是在 Phase 1 完成还是在 Phase 2 完成。Chapter 11 说 Phase 2 前台展示层（commit 7bd896764）才引入 `SeatSkuService::GetGoodsViewData()` 和独立 `ticket_detail.html`，而 Chapter 5 的 Phase 1 记录里 Goods.php 代码示例没有提到这个服务。这说明 Phase 1 和 Phase 2 的前端渲染能力有显著差异，但两章的边界描述不够清晰。 + +- **缺失项2（中等）**：Chapter 11.4 Phase 2 剩余工作提到 "vr_ticket Hook.php 补充：`plugins_service_goods_spec_data`"，但没有说明这个钩子**为什么未实现**、对票务功能的具体影响是什么，以及**是否阻塞**其他任务。 + +- **缺失项3（中等）**：Chapter 11.5 清理记录提到"临时测试脚本 → 移至 `_backup_20260420/`"，但没有说明该备份目录是否已提交到仓库，还是只存在于本地文件系统。 + +- **缺失项4（低）**：Chapter 12（第十二章）在当前 DEVELOPMENT_LOG.md 中**完全不存在**，只到第十一章。但任务要求评审"第十一、十二章"。这可能意味着第十二章尚未创建，或日志结构与要求不符。 + +--- + +## 可操作性评分：7/10 + +- **优点**：Chapter 11.1 完成内容中每个文件改动都有简洁说明，便于后续接手者定位改动范围。清理记录（Chapter 11.5）有助于理解项目状态的来龙去脉。 + +- **建议1（中等）**：Chapter 8.3 "关键文件路径"中的 ShopXO 容器源码路径 (`~/.openclaw/...`) 是旧的工作空间路径，与当前 `vr-shopxo-plugin` 的实际目录结构不符。应更新为当前实际路径或删除此节（该节内容已严重过时）。 + +- **建议2（低）**：Chapter 4 DDL 建表语句没有版本号或日期标记，后续如果表结构变更，无法追溯哪个版本引入了哪些字段。建议在 DDL 头部加上版本注释（如 `-- v1.0 2026-04-15 Phase 0`）。 + +--- + +## 一致性评分：5/10 + +- **冲突项1（高）**：`goods_id` 在不同章节不一致： + - Chapter 4 测试数据：`goods_id = 112` + - Chapter 5.2 URL：商品1（`id/1`） + - doc14 调查 URL：`id/118.html` + - PHASE2_PLAN.md Step 1：`id/118.html` + 四个不同的 goods_id，没有解释为什么。读者无法判断哪个是当前有效的测试商品。 + +- **冲突项2（高）**：Goods.php 代码示例在 Chapter 5.1（Phase 1 记录）与 doc14 Section 2.1（Phase 2 最终版本）完全不同：Phase 1 用相对路径 `MyView('public/../../../plugins/...')`，Phase 2 用绝对路径 `View::fetch($tplFile)`。DEVELOPMENT_LOG 没有说明这次重大改动的背景和原因。 + +- **冲突项3（中等）**：Chapter 8.1 Git 历史截止 `7508bed`，而 Chapter 11.3 Git 状态显示 `7bd896764` 才是 HEAD。两段 commit 历史没有衔接，读者无法理解从 Phase 0/1 到 Phase 2 的演进路径。 + +- **一致项**： + - vrt_ 表前缀使用一致 + - 票务插件目录结构（`app/plugins/vr_ticket/`）记录一致 + +--- + +## 误导风险评估 + +- **高风险项**： + - Goods.php 代码示例（Chapter 5.1）展示的是 Phase 1 早期版本，但没有任何注释说明这是"旧版本/已被替换"。接手者如果从 DEVELOPMENT_LOG 出发，很可能直接复制这段代码使用，而不知道 doc14 中有更新的版本。 + - 四个不同的 `goods_id`（1 / 112 / 118 / 未指定）散布在不同章节，没有任何解释，极易让读者认为存在多个测试商品或数据混乱，进而对整体系统状态产生错误判断。 + - "第十二章"在任务要求中出现但文档中不存在，可能导致任务发起者误以为章节已写而未被评审。 + +- **低风险项**： + - Chapter 8.3 的旧路径信息（如 `~/.openclaw/workspace/council-research/...`）现在完全无效，但仍然保留在文档中。读者如果信任这个路径去查找文件，会浪费时间。 + +--- + +## 总体评价 + +DEVELOPMENT_LOG.md 是项目的核心历史记录，第十一章对 Phase 2 前台展示层的完成内容有较为清晰的总结，清理记录也有助于理解项目演进。主要问题集中在**两段时间线未合并**（Chapter 8.1 截止 Phase 1，Chapter 11 从 Phase 2 重新开始），以及 **Goods.php 代码示例存在两个不同版本**（Phase 1 相对路径 vs Phase 2 绝对路径），均未标注版本关系。这使得 DEVELOPMENT_LOG 无法独立作为"当前状态参考"，必须配合 doc14 和 commit 历史才能还原真实代码演进。建议将 DEVELOPMENT_LOG 重组为时间线顺序（Phase 0 → Phase 1 → Phase 2），并为每个关键代码示例标注对应的 commit hash。同时，"第十二章"缺失需要向任务发起者确认是否需要补充。 diff --git a/reviews/Architect-on-PHASE2_PLAN.md b/reviews/Architect-on-PHASE2_PLAN.md new file mode 100644 index 0000000..2bacde5 --- /dev/null +++ b/reviews/Architect-on-PHASE2_PLAN.md @@ -0,0 +1,67 @@ +# docs/PHASE2_PLAN.md 评估报告 + +> 评估时间：2026-04-20 | 评估人：council/Architect + +--- + +## 准确性评分：7/10 + +- **问题1（中等）**：Section 2 "模板渲染问题现状"描述"Goods.php 原来用 `MyView()` 加载主题模板"，但实际 Goods.php 原代码中使用的是 `return MyView();`（无参数），而修正方案改用 `View::fetch($tplFile)`。文档将"原方案"简化为 `MyView()`，忽略了 `MyView()` 在 Phase 1 验证阶段已经过多次迭代（详见 DEVELOPMENT_LOG Chapter 5），读者无法理解这次改动的上下文。 + +- **问题2（中等）**：Section 2 解决路径第7步写"ThinkTemplate 渲染 ticket_detail.html（含 {include} 标签）"，但如 doc14 评审所指出，`{include}` 标签是否能正确解析**从未被容器实测验证**。将此描述为"解决路径"而非"待验证路径"存在准确性风险。 + +- **问题3（低）**：Section 3 Step 1 成功标准写"HTML 源码中不再有 ThinkTemplate 标签（`{include}` / `{$` / `{if}`）"，但实际上票务模板可能根本没有 `{if}` 标签，这个成功标准缺少针对性。 + +--- + +## 完整性评分：7/10 + +- **缺失项1（高）**：Section 3 "Phase 2 接下来的工作"没有说明 Step 1 的依赖条件——需要商品数据（goods_id=118 的票务商品 + 绑定座位模板 + 场次 spec_base）。如果这些测试数据不存在，Step 1 根本无法执行。应在 Step 1 前补充"前置条件检查清单"。 + +- **缺失项2（高）**：Step 4 "核销 API"只写了端点 `POST /api/vr_ticket/verify`，但没有说明认证方式（JWT token / session）、权限模型（RLS profiles.role='staff'）和请求参数格式。这使 Step 4 几乎无法直接执行。 + +- **缺失项3（中等）**：Section 5 "已知风险"没有提到"测试数据缺失"风险——容器内商品 ID 118 是否存在？座位模板是否已绑定对应分类？这些是 Step 1 的前置依赖，但风险表中未提及。 + +- **缺失项4（中等）**：Section 6 "决策点"第2点"loadSoldSeats() 是否需要实时查库"没有给出背景说明——为什么这是决策项？实时查库的性能影响有多大？前端座位状态管理的备选方案各有什么优劣？ + +- **缺失项5（低）**：Section 4 数据库表结构中没有列出 `goods` 表（ShopXO 原生平表），但这是 Phase 2 前台展示层最重要的数据来源之一，缺少它会导致读者对数据流理解不完整。 + +--- + +## 可操作性评分：7/10 + +- **优点**：Step 顺序清晰，每个 Step 都有操作命令示例（docker / curl），失败备选也有代码。 + +- **建议1（中等）**：Step 1 提到"操作人：大头（容器在本机）"，但计划文档应该是环境无关的行动指南，不应将操作绑定到个人。建议改为"前置条件：容器运行中 + 测试数据就绪"，避免文档因人员变动而失效。 + +- **建议2（中等）**：Step 3 "后台管理页面联调"列出了3个子项（路由、CRUD、RLS），但没有给出具体的 URL 格式和期望行为定义。接手者需要自行探索 ShopXO 后台路由规则。建议补充期望的 URL 和返回格式。 + +- **建议3（低）**：Step 2 loadSoldSeats() 的描述是文字说明，没有给出 spec_base_id_map 如何映射到已售座位的具体逻辑，这会让实现者产生歧义。 + +--- + +## 一致性评分：8/10 + +- **一致项**： + - 表名 `sxo_order_detail` / `goods.vr_goods_config` 与 doc14 一致 + - commit 7bd896764 引用一致 + - vrt_vr_* 表前缀使用合理（插件表 vs ShopXO 原生平表区分清晰） + +- **不一致项（低）**：Section 5 风险表提到"shopxo-php 容器未启动"，但这个风险在 Step 1 里没有对应的预防性检查命令。建议统一：在 Step 1 开头加 `docker ps | grep shopxo-php` 检查。 + +--- + +## 误导风险评估 + +- **高风险项**： + - Step 4 "核销 API"缺少认证和权限描述，可能让接手者直接实现一个无鉴权的 API，在测试环境中暴露安全风险。 + - "决策点"中"Layui 是否继续使用"列在决策项里，但 4 个后台控制器（Section 1 ❌ 未开始）如果已经用了 Layui，这实际上不是一个待决策项。容易让读者困惑当前技术栈状态。 + +- **低风险项**： + - "容器内操作"的说明文字暗示这是开发人员的手动步骤，但没有说明如何在 CI/CD 或自动化测试环境中复现，降低了文档的长期可维护性。 + +--- + +## 总体评价 + +PHASE2_PLAN.md 作为阶段性状态文档，结构清晰、优先级划分合理，对已完成工作的记录较为准确。主要风险在于 Step 1 的前置条件（测试数据、容器状态）描述不足，使得"看起来可执行"但"实际无法直接执行"；Step 4 核销 API 缺少安全上下文的描述，存在直接实现无鉴权接口的误导风险。决策点的第三项（Layui 选型）已过时（后台控制器已使用 Layui），建议删除或改为确认项。整体适合作为技术负责人的执行参考，但需要补充前置条件清单和 API 安全规范才能独立驱动开发。 diff --git a/reviews/Architect-on-doc14.md b/reviews/Architect-on-doc14.md new file mode 100644 index 0000000..9eb76ad --- /dev/null +++ b/reviews/Architect-on-doc14.md @@ -0,0 +1,65 @@ +# docs/14_TEMPLATE_RENDER_INVESTIGATION.md 评估报告 + +> 评估时间：2026-04-20 | 评估人：council/Architect + +--- + +## 准确性评分：7/10 + +- **问题1（中等）**：Section 2.1 Goods.php 代码示例中 `$assign` 变量未定义。实际代码（Section 2.2）中数据通过 `MyViewAssign()` 注入，而非 `fetch($tplFile, $assign)` 的第二个参数传参。示例代码与说明不一致，容易让读者误以为 `$assign` 需要额外构建。 + +- **问题2（中等）**：Section 2.2 数据流第4步描述"从 ShopXO 原生表 `goods_spec_value` + `goods_spec_base` 联查"，但没有说明联查的 JOIN 条件（`spec_base_id` / `goods_id`）。缺少关键连接字段会让接手者无法独立还原查询逻辑。 + +- **问题3（低）**：Section 4 模板渲染现状表格中，`{include file="public/head"}` 和 `{$vr_seat_template.seat_map|raw}` 均标注"⚠️ 待验证"，但 Section 2.1 标题已写"✅ 已验证（已提交）"。状态标记存在矛盾。 + +- **问题4（低）**：Section 3.1 描述 ThinkTemplate `parseTemplateFile()` 时，写的是 `$template = $this->config['view_path'] . $template . '.' . $view_suffix`，这是 ThinkPHP 5 的标准行为，但文档没有说明这正是导致票务模板无法渲染的根因（ThinkTemplate 拼接了错误的 view_path 前缀）。 + +--- + +## 完整性评分：6/10 + +- **缺失项1（高）**：`vr_seat_templates.spec_base_id_map` JSON 的结构完全没有说明。这个字段是前端渲染座位图的核心数据源，缺少字段说明会导致接手者无法理解座位 ID 如何映射到 spec_base_id。 + +- **缺失项2（高）**：`plugins_service_goods_spec_data` 钩子未实现（P1 问题），文档中仅一句话带过，但没有说明这个钩子当前对票务功能的影响范围（是否会导致某些规格无法显示）。 + +- **缺失项3（中等）**：`loadSoldSeats()` 函数为空（TODO），但没有说明这个函数应该由谁实现、前端座位图对已售座位的灰化处理依赖此函数。 + +- **缺失项4（中等）**：Section 2.2 第5步返回三个 key，但 Goods.php 中实际注入的是 `vr_seat_template` 和 `goods_spec_data`（与模板变量名对应）。文档没有说明为什么返回结构与模板使用结构有差异，以及这些变量在模板中具体如何使用。 + +--- + +## 可操作性评分：8/10 + +- **优点**：三个方向（A/B/C）描述清晰，每种方案都有具体操作步骤，失败切换路径明确。 + +- **建议1（低）**：Section 5 容器实测命令缺少 `docker ps` 前置确认，建议加入 `--first-flow` 步骤，避免读者在容器未启动时执行 curl 导致误导（误以为方案失败）。 + +- **建议2（低）**：`sxo_order_detail.spec` JSON 解码逻辑（Section 2.3）只是描述性文字，没有给出 PHP 示例代码。后续接手者需要参考 `TicketService.php` 源码才能理解实际解析方式，建议在此补充一行示例。 + +--- + +## 一致性评分：8/10 + +- **冲突项（低）**：Section 6 "关联提交"中声称"代码已提交"，但 Section 4 的状态表格明确列出 `{include}` 和 `{$vr_seat_template.seat_map|raw}` 均未验证。已提交 ≠ 已验证成功，这种混淆会导致读者认为功能已完成。 + +- **一致项**： + - 表名 `sxo_order_detail` 与 PHASE2_PLAN.md 一致 + - commit 7bd896764 在各文档中引用一致 + - `goods.vr_goods_config` JSON 字段描述一致 + +--- + +## 误导风险评估 + +- **高风险项**： + - "Section 2.1 改动状态：✅ 已提交（7bd896764）"与"Section 4 `{include}` 标签：⚠️ 待验证"并存在同一文档中，读者容易误认为 `{include}` 问题已解决，而实际上问题未经验证。 + - Section 3.1 的 ThinkTemplate 根因分析没有明确指出"错误的 view_path 拼接"是渲染失败的根本原因，读者可能无法理解为什么Goods.php 绝对路径方案能work。 + +- **低风险项**： + - 修正说明表格（Section 0）设计良好，清晰告知读者哪些内容已被修正，降低了误信旧信息的风险。 + +--- + +## 总体评价 + +这份文档在修正版中大幅改善了表名和数据流描述（相比原版），修正说明表格设计合理，体现了良好的文档维护意识。主要风险在于"已提交"与"已验证"的混淆——`{include}` 标签解析在容器内**从未被实测验证过**，但文档的语气暗示问题已解决。此外 `spec_base_id_map` JSON 结构完全缺失，使得文档只能指导"怎么改的"而无法回答"为什么这样改"。建议在完成容器实测后更新 Section 4 的状态标记，并在 Section 2.2 补充 spec_base_id_map 结构说明。 From bf71aa10987235064744501f806d80f8ad9dfcc7 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 05:30:23 +0800 Subject: [PATCH 03/12] docs: add Council evaluation report (Architect + BackendArchitect) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 综合评审： - docs/14: 表名前缀不一致（vr_seat_templates vs vrt_vr_seat_templates） - DEVELOPMENT_LOG: Git 状态落后一个提交 - PHASE2_PLAN: 核销 API 安全上下文缺失 Top 3 问题已定位，行动清单已列出 --- docs/COUNCIL_EVALUATION_REPORT.md | 192 ++++++++++++++++++++++++++++++ 1 file changed, 192 insertions(+) create mode 100644 docs/COUNCIL_EVALUATION_REPORT.md diff --git a/docs/COUNCIL_EVALUATION_REPORT.md b/docs/COUNCIL_EVALUATION_REPORT.md new file mode 100644 index 0000000..15f0b1c --- /dev/null +++ b/docs/COUNCIL_EVALUATION_REPORT.md @@ -0,0 +1,192 @@ +# 文档评估综合报告 + +> 评估时间：2026-04-20 | Council: Architect + BackendArchitect +> 评审文档：docs/14_TEMPLATE_RENDER_INVESTIGATION.md / docs/PHASE2_PLAN.md / docs/DEVELOPMENT_LOG.md + +--- + +## 一、docs/14_TEMPLATE_RENDER_INVESTIGATION.md + +### 各维度评分 + +| 维度 | Architect | BackendArchitect | +|------|-----------|-----------------| +| 准确性 | 7/10 | 7/10 | +| 完整性 | 6/10 | 6/10 | +| 可操作性 | 8/10 | 7/10 | +| 一致性 | 8/10 | 5/10 | + +### 跨文档共识问题 + +**表名前缀不一致（一致性 5/10）** + +| 文档 | 表名 | +|------|------| +| docs/14 Section 2.2 | `vr_seat_templates`（无前缀）❌ | +| DEVELOPMENT_LOG.md 建表 SQL | `vrt_vr_seat_templates`（有前缀）✅ | +| PHASE2_PLAN.md | `vrt_vr_seat_templates`（有前缀）✅ | + +这是**唯一的重大跨文档一致性问题**，必须修正。 + +### Architect 发现 + +- `$assign` 变量在 Section 2.1 代码示例中未定义（与实际 `MyViewAssign()` 不符） +- JOIN 联查条件（`spec_base_id` / `goods_id`）未记录 +- Section 2.1 标题写"✅ 已提交"，Section 4 状态表写"⚠️ 待验证"——矛盾 + +### BackendArchitect 发现 + +- "ShopXO 原生平表"说法不精确，应改为"本项目对应的 `sxo_order_detail`" +- `|raw` 过滤器安全性前提未注明（需后台管理端完全控制） +- Phase 1/Phase 2 两套 Goods.php 改法（MyView vs 绝对路径）关系未说明 + +--- + +## 二、docs/PHASE2_PLAN.md + +### 各维度评分 + +| 维度 | Architect | BackendArchitect | +|------|-----------|-----------------| +| 准确性 | 7/10 | 7/10 | +| 完整性 | 7/10 | 6/10 | +| 可操作性 | 7/10 | 7/10 | +| 一致性 | 8/10 | 8/10 | + +### Architect 发现 + +**高风险：Step 4 核销 API 缺少认证描述** +- 无 JWT token / session 说明 +- 无权限模型（RLS profiles.role='staff'）说明 +- 直接实现可能暴露无鉴权接口 + +**高风险：决策点第3项过时** +- "Layui 是否继续使用"列在决策项，但 4 个后台控制器已用 Layui +- 容易让读者困惑当前技术栈状态 + +**缺失：Step 1 前置条件清单** +- 需确认：goods_id=118 的票务商品 + 座位模板绑定 + 场次 spec_base +- 无测试数据则 Step 1 无法执行 + +### BackendArchitect 发现 + +**高风险：Step 1 操作绑定个人** +- "操作人：大头" → 其他成员无法执行 +- 应改为说明容器访问方式（Docker exec / SSH） + +**缺失：决策点无决策框架** +- loadSoldSeats 实时查库 vs 前端 JS 状态管理各自的优劣未列出 +- 长期悬而未决会阻塞 Step 1-4 + +**轻微：Step 3 联调缺少 URL 格式和期望行为定义** + +--- + +## 三、docs/DEVELOPMENT_LOG.md（第十一、十二章） + +### 各维度评分 + +| 维度 | BackendArchitect | +|------|-----------------| +| 准确性 | 8/10 | +| 完整性 | 6/10 | +| 可操作性 | 7/10 | +| 一致性 | 7/10 | + +### BackendArchitect 发现 + +**高风险：Git 状态快照落后一个提交** +- 11.3 写最新提交是 `7bd896764` +- 实际最新是 `914e2a0fc`（docs 修正提交） +- 基于旧快照做 git blame 会误判 + +**缺失：执行人/决策人未记录** +- Phase 2 比 Phase 1 更复杂，缺少执行人记录影响知识传递 + +**缺失：Phase 2 与 Phase 1 关系未说明** +- Section 11.1 未说明 Phase 1 的 `MyView()` 改法是否被替代 +- docs/14 提到 Phase 2 绝对路径方案，但 DEVELOGOPMENT_LOG 无对应说明 + +**轻微：cleanup 记录措辞歧义** +- "重写修正版"让人以为物理覆盖原文件 + +--- + +## 四、Top 3 最需要修正的问题 + +### 🔴 #1：跨文档表名前缀不一致 + +**问题**：`docs/14` 第 2.2 节用 `vr_seat_templates`（无前缀），其他文档统一用 `vrt_vr_seat_templates`（有前缀）。 + +**修正**：docs/14 Section 2.2 第 3 步，将 `vr_seat_templates` → `vrt_vr_seat_templates`。 + +**影响**：不修正在此文档指导下工作的人会查询不存在的表。 + +--- + +### 🔴 #2：docs/DEVELOPMENT_LOG.md Section 11.3 Git 状态落后 + +**问题**：记录最新提交为 `7bd896764`，实际为 `914e2a0fc`，相差一个 docs 修正提交。 + +**修正**：Section 11.3 更正为： +``` +914e2a0fc docs: 修正 docs/14 + 新增 PHASE2_PLAN.md ← HEAD +7bd896764 feat(Phase 2): 完成票务商品前端展示层 +``` + +**影响**：开发者基于此做 git blame / git log 会误判最新状态。 + +--- + +### 🟡 #3：docs/PHASE2_PLAN.md Step 4 核销 API 安全上下文缺失 + +**问题**：`POST /api/vr_ticket/verify` 无认证机制、权限模型、请求参数格式说明。 + +**修正**：补充以下内容： +``` +### 核销 API 设计要点 + +认证：JWT Bearer Token（从微信小程序静默登录获取） +权限：RLS — `auth.jwt->>'role' = 'staff'` + +请求： +POST /api/vr_ticket/verify +{ + "ticket_code": "string", + "verifier_id": int, + "token": "Bearer " +} + +响应： +{ + "code": 0, + "msg": "核销成功", + "data": { seat_info, real_name, goods_name } +} +``` + +**影响**：不做此补充，后续实现可能产生无鉴权接口，在测试环境暴露安全风险。 + +--- + +## 五、各文档综合评价 + +| 文档 | 综合评分 | 评价 | +|------|---------|------| +| docs/14 | 6.8/10 | 技术分析价值高，但表名前缀错误和状态矛盾是硬伤。修正说明机制设计良好。 | +| PHASE2_PLAN | 7.0/10 | 结构清晰，现状准确，Step 1 成功标准写得很好。核销 API 安全上下文缺失是最大风险。 | +| DEVELOPMENT_LOG | 7.0/10 | commit 号准确，时间线一致。Git 快照落后 + 缺少执行人记录是主要问题。 | + +--- + +## 六、下一步行动 + +| 优先级 | 行动 | 负责人 | +|--------|------|--------| +| P0 | 修正 docs/14 表名前缀（`vr_seat_templates` → `vrt_vr_seat_templates`） | 西莉雅 | +| P0 | 更新 DEVELOPMENT_LOG Section 11.3 Git 状态快照 | 西莉雅 | +| P1 | PHASE2_PLAN Step 1 补充前置条件清单（测试数据检查） | 西莉雅 | +| P1 | PHASE2_PLAN Step 4 补充核销 API 安全设计要点 | 西莉雅 | +| P2 | DEVELOPMENT_LOG 补充执行人记录 | 待定 | +| P2 | docs/14 补充 spec_base_id_map JSON 结构说明 | 待定 | +| P3 | docs/14 明确 Phase 1 / Phase 2 两套 Goods.php 改法的替代关系 | 待定 | From 349ec063c1e89a07607e42a4276f3bad9a65ff78 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 06:23:29 +0800 Subject: [PATCH 04/12] =?UTF-8?q?fix:=20=E6=9B=BF=E6=8D=A2=20ThinkTemplate?= =?UTF-8?q?=20=E6=A0=87=E7=AD=BE=E4=B8=BA=20PHP=20ModuleInclude?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 路线 B：票务模板不依赖 ThinkTemplate 解析引擎 - {include file=...} → - {:Config()} / {:IsMobileLogin()} → / - {$var|default=...} → - {$var|json_encode|raw} → 绕过 ThinkTemplate parseTemplateFile() 路径拼接 bug（Linux view_depr=/ 导致 include 路径解析错误） --- .../vr_ticket/view/goods/ticket_detail.html | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html b/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html index 119b269..f92d52e 100644 --- a/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html +++ b/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html @@ -1,4 +1,4 @@ -{include file="public/head" /} + + + + +
+
+ + {{if isset($is_page_loading) and $is_page_loading eq 1}} + {{:ModuleInclude('public/page_loading')}} + {{/if}} + + + {{if (!isset($page_pure) or $page_pure neq 1) and (!isset($is_header) or $is_header eq 1)}} + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_css +
+ {{/if}} + {{/if}} + + + {{if (!isset($page_pure) or $page_pure neq 1) and (!isset($is_header) or $is_header eq 1)}} + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_common_header +
+ {{/if}} + {{/if}} + + {{if empty($module_data) or !isset($module_data['is_header_hook']) or $module_data['is_header_hook'] eq 1}} + + {{if !isset($page_pure) or $page_pure neq 1}} + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_top +
+ {{/if}} + {{if !empty($plugins_view_common_top_data) and is_array($plugins_view_common_top_data)}} + {{foreach $plugins_view_common_top_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + {{/if}} + + + {{if !isset($is_header) or $is_header eq 1}} + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_top_header +
+ {{/if}} + {{if !empty($plugins_view_common_top_header_data) and is_array($plugins_view_common_top_header_data)}} + {{foreach $plugins_view_common_top_header_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + {{/if}} + {{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav.html b/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav.html new file mode 100755 index 0000000..448f729 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav.html @@ -0,0 +1,139 @@ +{{if MyC('home_main_header_status', 1) eq 1}} +
+
+ + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_header_nav_left +
+ {{/if}} + {{if !empty($plugins_view_common_header_nav_left_data) and is_array($plugins_view_common_header_nav_left_data)}} + {{foreach $plugins_view_common_header_nav_left_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + + + + + + +
+ {{:MyLang('common.all_category_text')}} +
+ + + + + +
+ + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_header_nav_content_inside_top +
+ {{/if}} + {{if !empty($plugins_view_common_header_nav_content_inside_top_data) and is_array($plugins_view_common_header_nav_content_inside_top_data)}} + {{foreach $plugins_view_common_header_nav_content_inside_top_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + + {{if empty($user)}} + +
+ {{if !empty($home_user_login_type)}} + {{:MyLang('common.login_title')}} + {{/if}} + {{if !empty($home_user_reg_type)}} + {{:MyLang('common.register_title')}} + {{/if}} +
+ {{/if}} + + + {{if !empty($nav_header)}} + + {{/if}} + + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_header_nav_content_inside_bottom +
+ {{/if}} + {{if !empty($plugins_view_common_header_nav_content_inside_bottom_data) and is_array($plugins_view_common_header_nav_content_inside_bottom_data)}} + {{foreach $plugins_view_common_header_nav_content_inside_bottom_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
+ + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_header_nav_right +
+ {{/if}} + {{if !empty($plugins_view_common_header_nav_right_data) and is_array($plugins_view_common_header_nav_right_data)}} + {{foreach $plugins_view_common_header_nav_right_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
+
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav_simple.html b/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav_simple.html new file mode 100755 index 0000000..07fe9d8 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/header_nav_simple.html @@ -0,0 +1,60 @@ +
+
+ + {{if !empty($module_data['title'])}} + + {{/if}} + {{if !empty($module_data['search']) and $module_data['search'] eq 1}} +
+ + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_search_inside_left +
+ {{/if}} + {{if !empty($plugins_view_common_search_inside_left_data) and is_array($plugins_view_common_search_inside_left_data)}} + {{foreach $plugins_view_common_search_inside_left_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + + +
+
+ + +
+
+ + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_search_inside_right +
+ {{/if}} + {{if !empty($plugins_view_common_search_inside_right_data) and is_array($plugins_view_common_search_inside_right_data)}} + {{foreach $plugins_view_common_search_inside_right_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
+ {{/if}} + {{if isset($module_data['is_go_home']) and $module_data['is_go_home'] eq 1}} +

+ + + +

+ {{/if}} +
+
\ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/header_style_root.html b/shopxo/app/plugins/vr_ticket/view/goods/public/header_style_root.html new file mode 100644 index 0000000..0b5c7b7 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/header_style_root.html @@ -0,0 +1,166 @@ +/* 基础 */ +--html-body-size: 10px; +--body-bg-color: #f7f7f7; +--color-price: #E22C08; +--color-red: #E22C08; +--color-yellow: #E22C08; +--color-blue: #76AFFF; +--color-green: #5EB95E; + +/* 主色 */ +--color-main: #E22C08; +--color-main-light: #ffe3de; +--color-main-hover: #EA6B52; + +/* 次色 */ +--color-secondary: #FFB8AA; + +/* 圆角 */ +--border-radius-sm: 0.2rem; +--border-radius: 0.4rem; +--border-radius-lg: 0.8rem; + +/* 阴影 */ +--box-shadow: 0 5px 20px rgba(50,55,58,0.1); +--box-shadow-sm: 0 2px 8px rgba(50,55,58,0.1); +--box-shadow-lg: 0 8px 34px rgba(50,55,58,0.1); + +/* 按钮部分 */ +/* 默认基础色 - 按钮 */ +--color-button-default: #EEEEEE; +--color-button-default-hover: #dddddd; +--color-button-default-focus: #c7c7c7; +--color-button-default-active: #c7c7c7; +--color-button-default-disabled: #c2c2c2; +--color-button-default-border: #EEEEEE; +--color-button-default-hover-border: #dddddd; +--color-button-default-focus-border: #c7c7c7; +--color-button-default-active-border: #c7c7c7; +--color-button-default-disabled-border: #c7c7c7; +--color-button-default-text: #666666; +--color-button-default-hover-text: #444444; +--color-button-default-focus-text: #444444; +--color-button-default-active-text: #444444; +--color-button-default-disabled-text: #444444; + +/* 主色 - 按钮 */ +--color-button-primary: #E22C08; +--color-button-primary-hover: #EA6B52; +--color-button-primary-focus: #C02000; +--color-button-primary-active: #C02000; +--color-button-primary-disabled: #F6BFB4; +--color-button-primary-border: #E22C08; +--color-button-primary-hover-border: #EA6B52; +--color-button-primary-focus-border: #C02000; +--color-button-primary-active-border: #C02000; +--color-button-primary-disabled-border: #F6BFB4; +--color-button-primary-text: #FFFFFF; +--color-button-primary-hover-text: #FFFFFF; +--color-button-primary-focus-text: #FFFFFF; +--color-button-primary-active-text: #FFFFFF; +--color-button-primary-disabled-text: #FFFFFF; + +/* 次色 - 按钮 */ +--color-button-secondary: #FFEFE5; +--color-button-secondary-hover: #FCE9E6; +--color-button-secondary-focus: #FCE9E6; +--color-button-secondary-active: #F5B5A9; +--color-button-secondary-disabled: #F5B5A9; +--color-button-secondary-border: #FFCBAB; +--color-button-secondary-hover-border: #FDB6B0; +--color-button-secondary-focus-border: #FDB6B0; +--color-button-secondary-active-border: #F5B5A9; +--color-button-secondary-disabled-border: #F5B5A9; +--color-button-secondary-text: #E22C08; +--color-button-secondary-hover-text: #EA6247; +--color-button-secondary-focus-text: #E64829; +--color-button-secondary-active-text: #E2300D; +--color-button-secondary-disabled-text: #E2300D; + +/* 成功 - 按钮 */ +--color-button-success: #a8e6a8; +--color-button-success-hover: #97ee97; +--color-button-success-focus: #5eb95e; +--color-button-success-active: #85c085; +--color-button-success-disabled: #85c085; +--color-button-success-border: #7fe27f; +--color-button-success-hover-border: #97ee97; +--color-button-success-focus-border: #5eb95e; +--color-button-success-active-border: #85c085; +--color-button-success-disabled-border: #85c085; +--color-button-success-text: #258f25; +--color-button-success-hover-text: #239b23; +--color-button-success-focus-text: #FFFFFF; +--color-button-success-active-text: #bffbbf; +--color-button-success-disabled-text: #bffbbf; + +/* 警告 - 按钮 */ +--color-button-warning: #FAAD14; +--color-button-warning-hover: #FBC55A; +--color-button-warning-focus: #FBC55A; +--color-button-warning-active: #EB9C00; +--color-button-warning-disabled: #FDE6B8; +--color-button-warning-border: #FAAD14; +--color-button-warning-hover-border: #FBC55A; +--color-button-warning-focus-border: #FBC55A; +--color-button-warning-active-border: #EB9C00; +--color-button-warning-disabled-border: #FDE6B8; +--color-button-warning-text: #FFFFFF; +--color-button-warning-hover-text: #FFFFFF; +--color-button-warning-focus-text: #FFFFFF; +--color-button-warning-active-text: #FFFFFF; +--color-button-warning-disabled-text: #FFFFFF; + +/* 危险 - 按钮 */ +--color-button-danger: #ffebeb; +--color-button-danger-hover: #FFEFED; +--color-button-danger-focus: #FFEFED; +--color-button-danger-active: #FFC2B6; +--color-button-danger-disabled: #FFFFFF; +--color-button-danger-border: #E33816; +--color-button-danger-hover-border: #DF2500; +--color-button-danger-focus-border: #D58576; +--color-button-danger-active-border: #FFC2B6; +--color-button-danger-disabled-border: #D58E80; +--color-button-danger-text: #da5c43; +--color-button-danger-hover-text: #e04527; +--color-button-danger-focus-text: #E12C08; +--color-button-danger-active-text: #C72100; +--color-button-danger-disabled-text: #FFC3B7; + +/* 小徽章部分 */ +/* 默认基础色 - 小徽章 */ +--color-badge-default: #EEEEEE; +--color-badge-default-hover: #e9e9e9; +--color-badge-default-text: #666666; +--color-badge-default-hover-text: #666666; + +/* 主色 - 小徽章 */ +--color-badge-primary: #eaf1fb; +--color-badge-primary-hover: #e4eefe; +--color-badge-primary-text: #0c7cd5; +--color-badge-primary-hover-text: #0c7cd5; + +/* 次色 - 小徽章 */ +--color-badge-secondary: #ffefe5; +--color-badge-secondary-hover: #ffebdf; +--color-badge-secondary-text: #f18f51; +--color-badge-secondary-hover-text: #f18f51; + +/* 成功色 - 小徽章 */ +--color-badge-success: #d5fbd5; +--color-badge-success-hover: #c6f9c6; +--color-badge-success-text: #46cf45; +--color-badge-success-hover-text: #46cf45; + +/* 警告色 - 小徽章 */ +--color-badge-warning: #ffeac2; +--color-badge-warning-hover: #ffe3ae; +--color-badge-warning-text: #f3a200; +--color-badge-warning-hover-text: #f3a200; + +/* 危险色 - 小徽章 */ +--color-badge-danger: #FFE6E6; +--color-badge-danger-hover: #ffdcdc; +--color-badge-danger-text: #e04527; +--color-badge-danger-hover-text: #e04527; \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/header_top_nav.html b/shopxo/app/plugins/vr_ticket/view/goods/public/header_top_nav.html new file mode 100755 index 0000000..ce285c3 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/header_top_nav.html @@ -0,0 +1,207 @@ +{{if MyC('home_main_top_header_status', 1) eq 1}} + +
+
+
    +
    +
    + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
    + plugins_view_header_navigation_top_left_begin +
    + {{/if}} + {{if !empty($plugins_view_header_navigation_top_left_begin_data) and is_array($plugins_view_header_navigation_top_left_begin_data)}} + {{foreach $plugins_view_header_navigation_top_left_begin_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + + {{if empty($user)}} + {{:MyLang('common.header_top_nav_left_not_login_first')}} + {{$home_site_name}} + {{if !empty($home_user_login_type)}} + [{{:MyLang('common.login_title')}}] + {{/if}} + {{if !empty($home_user_reg_type)}} + [{{:MyLang('common.register_title')}}] + {{/if}} + {{else /}} + {{:MyLang('common.header_top_nav_left_login_first')}} + {{if !empty($user['icon'])}} + + {{/if}} + {{if !empty($user['user_name_view'])}} + {{$user.user_name_view}} + {{/if}} + {{:MyLang('common.header_top_nav_left_login_last')}} + {{$home_site_name}} + [{{:MyLang('common.logout_title')}}] + {{/if}} + + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
    + plugins_view_header_navigation_top_left_end +
    + {{/if}} + {{if !empty($plugins_view_header_navigation_top_left_end_data) and is_array($plugins_view_header_navigation_top_left_end_data)}} + {{foreach $plugins_view_header_navigation_top_left_end_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
    +
    +
+ + + + +
+
+ +{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/home_banner.html b/shopxo/app/plugins/vr_ticket/view/goods/public/home_banner.html new file mode 100755 index 0000000..d1f1977 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/home_banner.html @@ -0,0 +1,27 @@ +{{if !empty($banner_list)}} + +{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/home_nav.html b/shopxo/app/plugins/vr_ticket/view/goods/public/home_nav.html new file mode 100644 index 0000000..a89c766 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/home_nav.html @@ -0,0 +1,28 @@ +{{if !empty($navigation)}} +
+
+ {{foreach $navigation as $nav}} +
+ {{switch nav.event_type}} + {{case 3}} + + +
+ {{/foreach}} +
+
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/index.html b/shopxo/app/plugins/vr_ticket/view/goods/public/index.html new file mode 100755 index 0000000..0519ecb --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/index.html @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/jump_error.html b/shopxo/app/plugins/vr_ticket/view/goods/public/jump_error.html new file mode 100755 index 0000000..0758055 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/jump_error.html @@ -0,0 +1,50 @@ +{{:ModuleInclude('public/header')}} + + +{{if isset($is_header) and $is_header eq 1}} + + {{:ModuleInclude('public/header_top_nav')}} + + + {{:ModuleInclude('public/nav_search')}} + + + {{:ModuleInclude('public/header_nav')}} + + + {{:ModuleInclude('public/goods_category')}} +{{/if}} + + + +
+
+

+

{{if isset($msg)}}{{$msg}}{{else /}}{{:MyLang('operate_fail')}}{{/if}}

+

+ {{:MyLang('back_prev_page_name')}} + {{if empty($wait_time)}}5{{else /}}{{$wait_time}}{{/if}}{{:MyLang('back_prev_time_auto_text')}} +

+
+
+ + + +{{:ModuleInclude('public/footer')}} + \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/jump_success.html b/shopxo/app/plugins/vr_ticket/view/goods/public/jump_success.html new file mode 100755 index 0000000..99d3bde --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/jump_success.html @@ -0,0 +1,50 @@ +{{:ModuleInclude('public/header')}} + + +{{if isset($is_header) and $is_header eq 1}} + + {{:ModuleInclude('public/header_top_nav')}} + + + {{:ModuleInclude('public/nav_search')}} + + + {{:ModuleInclude('public/header_nav')}} + + + {{:ModuleInclude('public/goods_category')}} +{{/if}} + + + +
+
+

+

{{if isset($msg)}}{{$msg}}{{else /}}{{:MyLang('operate_success')}}{{/if}}

+

+ {{:MyLang('back_prev_page_name')}} + {{if empty($wait_time)}}5{{else /}}{{$wait_time}}{{/if}}{{:MyLang('back_prev_time_auto_text')}} +

+
+
+ + + +{{:ModuleInclude('public/footer')}} + \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/loading.html b/shopxo/app/plugins/vr_ticket/view/goods/public/loading.html new file mode 100644 index 0000000..287c99f --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/loading.html @@ -0,0 +1,4 @@ +
+ +

{{:MyLang('processing_tips')}}

+
\ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/login_success.html b/shopxo/app/plugins/vr_ticket/view/goods/public/login_success.html new file mode 100644 index 0000000..bdfd85b --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/login_success.html @@ -0,0 +1,56 @@ +{{:ModuleInclude('public/header')}} + + +{{if isset($is_header) and $is_header eq 1}} + + {{:ModuleInclude('public/header_top_nav')}} + + + {{:ModuleInclude('public/nav_search')}} + + + {{:ModuleInclude('public/header_nav')}} + + + {{:ModuleInclude('public/goods_category')}} +{{/if}} + + + +
+
+ + {{$msg}} + {{if !isset($is_home) or $is_home eq 1}} +
+ {{:MyLang('common.back_to_the_home_title')}} +
+ {{/if}} +
+
+ + +{{:ModuleInclude('public/footer')}} + +{{if !empty($data['body_html'])}} + {{$data.body_html|raw}} +{{/if}} + + \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/nav.html b/shopxo/app/plugins/vr_ticket/view/goods/public/nav.html new file mode 100755 index 0000000..f256dae --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/nav.html @@ -0,0 +1,15 @@ +{{if !empty($common_bottom_nav_list)}} +
    + {{foreach $common_bottom_nav_list as $nav}} +
  • + + {{if isset($nav['badge']) and $nav['badge'] nheq null and $nav['badge'] gt 0}} + {{$nav.badge}} + {{/if}} +
    • + {{/foreach}} +
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/nav_search.html b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_search.html new file mode 100755 index 0000000..0352e0a --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_search.html @@ -0,0 +1,87 @@ +{{if MyC('home_main_logo_search_status', 1) eq 1}} + +
+
+
+ + {{$home_site_name}} + +
+ + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_logo_right +
+ {{/if}} + {{if !empty($plugins_view_common_logo_right_data) and is_array($plugins_view_common_logo_right_data)}} + {{foreach $plugins_view_common_search_right_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + +
+ + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_search_inside_left +
+ {{/if}} + {{if !empty($plugins_view_common_search_inside_left_data) and is_array($plugins_view_common_search_inside_left_data)}} + {{foreach $plugins_view_common_search_inside_left_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} + + +
+
+ + +
+ {{if !empty($home_search_keywords)}} +
    + {{foreach $home_search_keywords as $v}} +
  • {{$v}}
    • + {{/foreach}} +
+ {{/if}} +
+ + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_search_inside_right +
+ {{/if}} + {{if !empty($plugins_view_common_search_inside_right_data) and is_array($plugins_view_common_search_inside_right_data)}} + {{foreach $plugins_view_common_search_inside_right_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
+ + + {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} +
+ plugins_view_common_search_right +
+ {{/if}} + {{if !empty($plugins_view_common_search_right_data) and is_array($plugins_view_common_search_right_data)}} + {{foreach $plugins_view_common_search_right_data as $hook}} + {{if is_string($hook) or is_int($hook)}} + {{$hook|raw}} + {{/if}} + {{/foreach}} + {{/if}} +
+
+ +{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_btn.html b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_btn.html new file mode 100644 index 0000000..b0f5525 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_btn.html @@ -0,0 +1,9 @@ +{{if !empty($module_data['nav_data']) and is_array($module_data['nav_data'])}} +
+ {{foreach $module_data.nav_data as $k=>$v}} + {{if (!isset($v.is_show) or $v.is_show eq 1) and isset($v['key']) and isset($v['name'])}} + {{$v.name}} + {{/if}} + {{/foreach}} +
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_tabs.html b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_tabs.html new file mode 100644 index 0000000..463bde3 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/nav_switch_tabs.html @@ -0,0 +1,25 @@ +{{if !empty($module_data['nav_data']) and is_array($module_data['nav_data'])}} +
+
    + {{foreach $module_data.nav_data as $v}} + + {{if !empty($module_data['view_type']) and isset($module_data['view_type'])}} +
  • + {{$v.name}} +
    • + {{else /}} + +
  • + {{$v.name}} +
    • + {{/if}} + {{/foreach}} +
+ {{if !empty($module_data['other']) and !empty($module_data['other_url'])}} + + + {{$module_data.other_name}} + + {{/if}} +
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/not_data.html b/shopxo/app/plugins/vr_ticket/view/goods/public/not_data.html new file mode 100755 index 0000000..35bf6f3 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/not_data.html @@ -0,0 +1,4 @@ +
+ +

{{if !empty($module_data) and !empty($module_data['msg'])}}{{$module_data.msg}}{{else /}}{{:MyLang('no_data')}}{{/if}}

+
\ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/page_loading.html b/shopxo/app/plugins/vr_ticket/view/goods/public/page_loading.html new file mode 100644 index 0000000..d43d23d --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/page_loading.html @@ -0,0 +1,7 @@ +
+ {{if isset($is_page_loading_images) and $is_page_loading_images eq 1 and !empty($page_loading_images_url)}} + + {{else /}} +
+ {{/if}} +
\ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav.html b/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav.html new file mode 100644 index 0000000..c3247ea --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav.html @@ -0,0 +1,20 @@ +{{if !empty($module_data['plugins']) and (!empty($module_data['title']) or (!empty($module_data['nav_data']) and is_array($module_data['nav_data'])))}} +
+ {{if !empty($module_data['back_url'])}} + + + + {{/if}} + {{if !empty($module_data['nav_data']) and is_array($module_data['nav_data'])}} +
    + {{foreach $module_data.nav_data as $v}} +
  • + {{$v.name}} +
    • + {{/foreach}} +
+ {{else /}} + {{$module_data.title}} + {{/if}} +
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav_btn.html b/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav_btn.html new file mode 100644 index 0000000..a49ee25 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/plugins_admin_nav_btn.html @@ -0,0 +1,9 @@ +{{if !empty($module_data['plugins']) and !empty($module_data['nav_data']) and is_array($module_data['nav_data'])}} +
+ {{foreach $module_data.nav_data as $k=>$v}} + {{if !isset($v.is_show) or $v.is_show eq 1}} + {{$v.name}} + {{/if}} + {{/foreach}} +
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/tips_error.html b/shopxo/app/plugins/vr_ticket/view/goods/public/tips_error.html new file mode 100755 index 0000000..411851b --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/tips_error.html @@ -0,0 +1,37 @@ +{{:ModuleInclude('public/header')}} + + +{{if isset($is_header) and $is_header eq 1}} + + {{:ModuleInclude('public/header_top_nav')}} + + + {{:ModuleInclude('public/nav_search')}} + + + {{:ModuleInclude('public/header_nav')}} + + + {{:ModuleInclude('public/goods_category')}} +{{/if}} + + + +
+
+ + {{$msg}} +
+ {{if !isset($is_to_home) or $is_to_home eq 1}} + {{:MyLang('common.back_to_the_home_title')}} + {{/if}} + {{if !empty($to_url) and !empty($to_title)}} + {{$to_title}} + {{/if}} +
+
+
+ + + +{{:ModuleInclude('public/footer')}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/tips_success.html b/shopxo/app/plugins/vr_ticket/view/goods/public/tips_success.html new file mode 100755 index 0000000..9a5989c --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/tips_success.html @@ -0,0 +1,37 @@ +{{:ModuleInclude('public/header')}} + + +{{if isset($is_header) and $is_header eq 1}} + + {{:ModuleInclude('public/header_top_nav')}} + + + {{:ModuleInclude('public/nav_search')}} + + + {{:ModuleInclude('public/header_nav')}} + + + {{:ModuleInclude('public/goods_category')}} +{{/if}} + + + +
+
+ + {{$msg}} +
+ {{if !isset($is_to_home) or $is_to_home eq 1}} + {{:MyLang('common.back_to_the_home_title')}} + {{/if}} + {{if !empty($to_url) and !empty($to_title)}} + {{$to_title}} + {{/if}} +
+
+
+ + + +{{:ModuleInclude('public/footer')}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/user_center_main_title.html b/shopxo/app/plugins/vr_ticket/view/goods/public/user_center_main_title.html new file mode 100644 index 0000000..32cb55e --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/user_center_main_title.html @@ -0,0 +1,28 @@ +{{if !empty($home_seo_site_title)}} +
+ {{if !empty($module_data['operate_url']) and !empty($module_data['operate_name'])}} + + {{if !empty($module_data['operate_icon'])}} + + {{/if}} + {{$module_data['operate_name']}} + + | + {{/if}} +

+ {{if empty($module_data['title'])}} + {{if empty($user_center_main_title)}} + {{if stripos($home_seo_site_title, ' - ') heq false}} + {{$home_seo_site_title}} + {{else /}} + {{:explode(' - ', $home_seo_site_title)[0]}} + {{/if}} + {{else /}} + {{$user_center_main_title}} + {{/if}} + {{else /}} + {{$module_data.title}} + {{/if}} +

+
+{{/if}} \ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/user_menu.html b/shopxo/app/plugins/vr_ticket/view/goods/public/user_menu.html new file mode 100755 index 0000000..aab92d3 --- /dev/null +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/user_menu.html @@ -0,0 +1,87 @@ + +
+
+ +
+
+ + + + + +
+
+
+

{{:MyLang('common.avatar_upload_title')}}

+ × +
+
+
+
+
+ Picture +
+
+
+
+ + + + + +
+
+ +
+ + +
+ +
+ + {{if is_array(MyLang('common.avatar_upload_tips'))}} +
+

{{:implode('

', MyLang('common.avatar_upload_tips'))}}

+
+ {{/if}} + +
+ + +
+
+
+
+
\ No newline at end of file diff --git a/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html b/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html index f92d52e..f4ea8e4 100644 --- a/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html +++ b/shopxo/app/plugins/vr_ticket/view/goods/ticket_detail.html @@ -448,4 +448,4 @@ })(); - + From 1b0ac3276dd99212b344b9ee5a7748eb9fa1eb6d Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 06:35:24 +0800 Subject: [PATCH 06/12] =?UTF-8?q?fix:=20=E6=9B=BF=E6=8D=A2=E4=B8=BA?= =?UTF-8?q?=E7=A5=A8=E5=8A=A1=E4=B8=93=E7=94=A8=E7=B2=BE=E7=AE=80=20footer?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 移除 ShopXO 默认导航（关于我们/招聘/客户服务等） 保留：返回首页 + 版权 + ICP备案 --- .../vr_ticket/view/goods/public/footer.html | 498 ++---------------- 1 file changed, 51 insertions(+), 447 deletions(-) diff --git a/shopxo/app/plugins/vr_ticket/view/goods/public/footer.html b/shopxo/app/plugins/vr_ticket/view/goods/public/footer.html index f581a2c..6ad1dcf 100755 --- a/shopxo/app/plugins/vr_ticket/view/goods/public/footer.html +++ b/shopxo/app/plugins/vr_ticket/view/goods/public/footer.html @@ -1,453 +1,57 @@ -
+ +
-
- - {{if empty($module_data) or !isset($module_data['is_footer_nav']) or $module_data['is_footer_nav'] eq 1}} - {{if (!isset($page_pure) or $page_pure neq 1) and (!isset($is_footer) or $is_footer eq 1)}} - {{:ModuleInclude('public/footer_nav', isset($module_data) ? $module_data : [])}} - {{/if}} - {{/if}} - + - - {{if empty($module_data) or !isset($module_data['is_footer_hook']) or $module_data['is_footer_hook'] eq 1}} - - {{if !isset($page_pure) or $page_pure neq 1}} - {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} -
- plugins_view_common_bottom -
- {{/if}} - {{if !empty($plugins_view_common_bottom_data) and is_array($plugins_view_common_bottom_data)}} - {{foreach $plugins_view_common_bottom_data as $hook}} - {{if is_string($hook) or is_int($hook)}} - {{$hook|raw}} - {{/if}} - {{/foreach}} - {{/if}} - {{/if}} - - - {{if !isset($is_footer) or $is_footer eq 1}} - {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} -
- plugins_view_common_bottom_footer -
- {{/if}} - {{if !empty($plugins_view_common_bottom_footer_data) and is_array($plugins_view_common_bottom_footer_data)}} - {{foreach $plugins_view_common_bottom_footer_data as $hook}} - {{if is_string($hook) or is_int($hook)}} - {{$hook|raw}} - {{/if}} - {{/foreach}} - {{/if}} - {{/if}} - {{/if}} -
+
+
+ 返回首页
- - - - - - - - -
-
-
- {{:MyLang('reminder_title')}} - × -
-
- -
- {{:MyLang('common.user_cart_success_modal_tips')}} -
-
- {{:MyLang('common.user_cart_success_modal_text_first')}} - {{$user_cart_summary.buy_number}} - {{:MyLang('common.user_cart_success_modal_text_last')}} -
-
- {{:MyLang('common.user_cart_success_modal_cart_title')}} - -
-
-
+
+ © All Rights Reserved.
- - - - - {{if !empty($theme_data_admin_data) and isset($theme_data_admin_data['status']) and $theme_data_admin_data['status'] eq 1 and !empty($theme_data_admin_data['admin_url_data']) and !in_array($action_name, ['modallogininfo'])}} -
- - - {{:MyLang('quit_admin_title')}} - -
- {{/if}} - - - - - - - - - - - -{{if isset($is_load_imagezoom) and $is_load_imagezoom eq 1}} - -{{/if}} - - -{{if isset($is_load_echarts) and $is_load_echarts eq 1}} - - - -{{/if}} - - - - - - - - - - - - - - - - - - - - - - - - - - - -{{if isset($is_load_animation_count) and $is_load_animation_count eq 1}} - -{{/if}} - - - - - - - - - - - - - - - - - - -{{if isset($is_load_ckplayer) and $is_load_ckplayer eq 1}} - -{{/if}} - - -{{if isset($is_load_xgplayer) and $is_load_xgplayer eq 1}} - -{{/if}} - - -{{if isset($is_load_hlsjs) and $is_load_hlsjs eq 1}} - -{{/if}} - - -{{if isset($is_load_barcode) and $is_load_barcode eq 1}} - -{{/if}} - - -{{if isset($is_load_map_api) and $is_load_map_api eq 1 and !empty($load_map_type)}} - {{switch $load_map_type}} - {{case baidu}} - - {{/case}} - {{case amap}} - - - {{/case}} - {{case tencent}} - - - {{/case}} - {{case tianditu}} - - {{/case}} - {{/switch}} -{{/if}} - - -{{if isset($is_load_hiprint) and $is_load_hiprint eq 1}} - - - - - - - - - - - -{{/if}} - - -{{if isset($is_load_video_scan) and $is_load_video_scan eq 1}} - -{{/if}} - - -{{if isset($is_load_ace_builds) and $is_load_ace_builds eq 1}} - -{{/if}} - - -{{if isset($is_load_jrange) and $is_load_jrange eq 1}} - -{{/if}} - - -{{if isset($is_load_webuploader) and $is_load_webuploader eq 1}} - -{{/if}} - - -{{if isset($is_load_uniapp_webview) and $is_load_uniapp_webview eq 1}} - - - - - -{{/if}} - - - - - - - -{{if !empty($static_path_data['common_js'])}} - -{{/if}} -{{if !empty($static_path_data['theme_import_js']) and is_array($static_path_data['theme_import_js'])}} - {{foreach $static_path_data.theme_import_js as $v}} - - {{/foreach}} -{{/if}} -{{if !empty($static_path_data['module_js'])}} - -{{/if}} -{{if !empty($static_path_data['other_js'])}} - -{{/if}} -{{if isset($is_load_layout_admin) and $is_load_layout_admin eq 1}} - -{{/if}} - - -{{if !empty($static_path_data['plugins_js'])}} - -{{/if}} - - -{{if !empty($static_path_data['page_js'])}} - -{{/if}} - - -{{if (!isset($page_pure) or $page_pure neq 1) and (!isset($is_footer) or $is_footer eq 1)}} - {{:MyC('home_footer_info')}} -{{/if}} - - -{{if (!isset($page_pure) or $page_pure neq 1) and (!isset($is_footer) or $is_footer eq 1)}} - {{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} -
- plugins_js -
- {{/if}} -{{/if}} -{{if !empty($plugins_js_data) and is_array($plugins_js_data)}} - {{foreach $plugins_js_data as $hook}} - {{if !empty($hook) and is_string($hook)}} - {{if substr($hook, 0, 4) eq 'http'}} - - {{else /}} - - {{/if}} - {{elseif is_array($hook) /}} - {{foreach $hook as $hook_js}} - {{if !empty($hook_js) and is_string($hook_js)}} - {{if substr($hook_js, 0, 4) eq 'http'}} - - {{else /}} - - {{/if}} - {{/if}} - {{/foreach}} - {{/if}} - {{/foreach}} -{{/if}} - - -{{if isset($shopxo_is_develop) and $shopxo_is_develop eq true}} -
- plugins_common_page_bottom -
-{{/if}} -{{if !empty($plugins_common_page_bottom_data) and is_array($plugins_common_page_bottom_data)}} - {{foreach $plugins_common_page_bottom_data as $hook}} - {{if is_string($hook) or is_int($hook)}} - {{$hook|raw}} - {{/if}} - {{/foreach}} -{{/if}} \ No newline at end of file +' : ''; ?> From 977cc57aefcc1babef52dc2bc54cb33ba33d076b Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 07:24:57 +0800 Subject: [PATCH 07/12] docs: new vr_goods_config spec + Phase 2 v2.0 plan --- docs/DEVELOPMENT_LOG.md | 59 ++++++++++ docs/PHASE2_PLAN.md | 210 ++++++++++++++++++----------------- docs/VR_GOODS_CONFIG_SPEC.md | 190 +++++++++++++++++++++++++++++++ 3 files changed, 360 insertions(+), 99 deletions(-) create mode 100644 docs/VR_GOODS_CONFIG_SPEC.md diff --git a/docs/DEVELOPMENT_LOG.md b/docs/DEVELOPMENT_LOG.md index 078f3b2..605effd 100644 --- a/docs/DEVELOPMENT_LOG.md +++ b/docs/DEVELOPMENT_LOG.md @@ -445,3 +445,62 @@ dc63cff77 chore: clean up my_test_plugin residual hooks - `shopxo/test_ticket.php` → 移至 `_backup_20260420/test_ticket.php`（临时测试脚本，不入仓库） - `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` → 重写修正版（删除错误信息，保留调查价值） - 核心代码（Goods.php / SeatSkuService.php / TicketService.php）→ 全部提交推送 + +--- + +## 十二、模板渲染修复 + JSON 格式升级（2026-04-20 白天） + +### 12.1 模板渲染修复（v2.0 路线 B） + +**问题**：ThinkTemplate 的 `{include file="public/head"}` 标签在 Linux 下因 `view_depr=/` 导致路径拼接错误，页面以纯文本输出。 + +**解决方案（路线 B）**： +1. `{include}` / `{:}` ThinkTemplate 标签 → `` 原生 PHP +2. `{$var|default='...'}` → `` +3. `{json_decode(...)|raw}` → `` +4. 复制 ShopXO `app/index/view/default/public/` → `plugins/vr_ticket/view/goods/public/` + +**提交记录**： +``` +349ec063c fix: 替换 ThinkTemplate 标签为 PHP ModuleInclude +c894e7018 fix: 复制 ShopXO public 模板 + 修复 footer_page 不存在问题 +1b0ac3276 fix: 替换为票务专用精简 footer（449行→53行） +``` + +**渲染结果**：✅ 商品详情页正常渲染，但场次为空（待适配新 JSON 格式）。 + +### 12.2 vr_goods_config JSON 格式重新设计（重大变更） + +**背景**：大头 + Gemini 重新设计了 vr_goods_config 规格，从依赖 `vr_seat_templates` 表实时查询，改为商品发布时快照模式。 + +**新格式核心**： +- `goods.vr_goods_config` 包含完整的 `rooms[]` 快照（座位图+sections+seats） +- 不再需要实时查 `vr_seat_templates` 表 +- `spec_base_id_map` 格式：`{room_id}_{row}_{colNum}` → `spec_base_id` + +**设计原则**： +- 商品发布时快照 → 已发布商品与 `vr_seat_templates` 解耦 +- 修改模板不影响已发布商品 → 绝对一致性 +- SKU 和 config 一起过时、一起更新 + +**新文档**： +- `docs/VR_GOODS_CONFIG_SPEC.md` — 新 JSON 格式完整规格说明（已确认） +- `docs/PHASE2_PLAN.md` v2.0 — 同步更新，下一步工作计划 + +### 12.3 当前 Git 状态 + +``` +1b0ac3276 fix: 替换为票务专用精简 footer ← HEAD +c894e7018 fix: 复制 ShopXO public 模板 +349ec063c fix: 替换 ThinkTemplate 标签为 PHP ModuleInclude +7bd896764 feat(Phase 2): 完成票务商品前端展示层 +``` + +### 12.4 接下来需要实现 + +| 任务 | 负责人 | 依赖 | +|------|--------|------| +| 重写 GetGoodsViewData() 适配新格式 | 待定 | VR_GOODS_CONFIG_SPEC.md 已确认 | +| 更新 ticket_detail.html JS（rooms[] 结构） | 待定 | GetGoodsViewData() 输出确定后 | +| AdminGoodsSaveHandle SKU 生成 | 待定 | 新格式已确认 | +| loadSoldSeats() 实现 | 待定 | vr_tickets 有数据后 | diff --git a/docs/PHASE2_PLAN.md b/docs/PHASE2_PLAN.md index a8bf379..cf575cb 100644 --- a/docs/PHASE2_PLAN.md +++ b/docs/PHASE2_PLAN.md @@ -1,146 +1,158 @@ # Phase 2 — 计划与当前状态 -> 版本：v1.0 | 日期：2026-04-20 | 状态：执行中 -> 关联提交：7bd896764 +> 版本：v2.0 | 日期：2026-04-20 | 状态：执行中 +> 关联提交：c894e7018（模板渲染已通）、1b0ac3276（精简 footer） +> 关联文档：`docs/VR_GOODS_CONFIG_SPEC.md`（新 JSON 格式规格） --- -## 一、Phase 2 完成情况 +## ⚠️ 重大更新（v2.0） + +**vr_goods_config JSON 格式已重新设计。** + +旧格式依赖 `vr_seat_templates` 表实时查询，新格式在商品发布时将 `rooms` 快照存入商品表，前端不再跨表查询。 + +详见 `docs/VR_GOODS_CONFIG_SPEC.md`。 + +--- + +## 一、Phase 2 当前状态 ### ✅ 已完成 -| 任务 | 文件 | 说明 | +| 任务 | 提交 | 说明 | |------|------|------| -| Goods.php 改法 | `app/index/controller/Goods.php` | item_type=ticket → ticket_detail.html + 数据注入 | -| GetGoodsViewData() | `SeatSkuService.php` | 为前端模板提供座位图+场次数据 | -| onOrderPaid() 修复 | `TicketService.php` | sxo_order_detail + JSON spec 解析 | -| 模板渲染调研 | `docs/14_TEMPLATE_RENDER_INVESTIGATION.md` | 已修正，记录完整调查过程 | +| 模板渲染 | c894e7018 | ThinkTemplate → PHP ModuleInclude，渲染正常 | +| 票务专用 footer | 1b0ac3276 | 精简 footer，移除 ShopXO 默认导航 | +| Goods.php 改法 | 7bd896764 | item_type=ticket → ticket_detail.html | +| onOrderPaid() 修复 | 7bd896764 | sxo_order_detail + JSON spec 解析 | -### ⚠️ 待验证（容器内） +### ⚠️ 进行中 -| 任务 | 优先级 | 说明 | -|------|--------|------| -| `{include}` 标签实测 | P0 | ticket_detail.html 中 `{include file="public/head"}` 是否能正确解析 | -| ModuleInclude 备选方案 | P1 | 若 `{include}` 失败，切换 `ModuleInclude()` | -| loadSoldSeats() | P1 | 查询已售座位，前端座位图需显示已售状态 | +| 任务 | 说明 | 依赖 | +|------|------|------| +| GetGoodsViewData() 重写 | 适配新 vr_goods_config JSON 格式 | VR_GOODS_CONFIG_SPEC.md 已确认 | +| 前端 JS 更新 | 适配 rooms[] 结构渲染 | GetGoodsViewData() 输出格式确定后 | +| loadSoldSeats() 实现 | 查询 vr_tickets，标记已售座位 | vr_tickets 表有数据后 | ### ❌ 未开始 | 任务 | 说明 | |------|------| -| vr_ticket Hook.php 钩子补充 | 缺失 `plugins_service_goods_spec_data` 处理 | -| 后台座位模板管理 | admin/controller/SeatTemplate.php（已生成，未调试） | -| 后台电子票列表 | admin/controller/Ticket.php（已生成，未调试） | -| 后台核销员管理 | admin/controller/Verifier.php（已生成，未调试） | -| 后台核销记录 | admin/controller/Verification.php（已生成，未调试） | -| 核销 API | B 端扫码核销 REST 接口 | +| AdminGoodsSaveHandle SKU 生成 | 根据 selected_rooms 生成 goods_spec_base 条目 | +| 后台 4 控制器联调 | SeatTemplate/Ticket/Verifier/Verification | +| 核销 API | POST /api/vr_ticket/verify | --- -## 二、模板渲染问题现状 +## 二、vr_goods_config 新格式（已确认） -### 问题 - -票务商品详情页 ThinkTemplate 标签未解析（`{$...}` / `{include}` / `{if}` 以原文输出）。 - -### 根因 - -Goods.php 原来用 `MyView()` 加载主题模板，票务商品需要加载插件独立模板 `ticket_detail.html`。 - -### 解决路径（Goods.php 绝对路径方案） - -``` -Goods::Index() - → $goods['item_type'] === 'ticket' - → SeatSkuService::GetGoodsViewData($goods_id) - → MyViewAssign([vr_seat_template, goods_spec_data]) - → View::fetch($tplFile) [$tplFile = 绝对路径] - → ThinkTemplate 渲染 ticket_detail.html（含 {include} 标签） +```json +[ + { + "template_id": 4, + "selected_rooms": ["room_id_xxx"], + "selected_sections": { "room_id_xxx": ["A", "B"] }, + "rooms": [ + { + "id": "room_id_xxx", + "name": "1号放映室VV", + "map": ["AAAAB__BBB_BAAAA", "AAAAB__BBB_BAAAA"], + "sections": [ + { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + ], + "seats": { + "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + } + } + ], + "sessions": [ + { "start": "15:00", "end": "16:59" }, + { "start": "18:00", "end": "21:59" } + ] + } +] ``` -### 待实测项（容器内操作） +**核心变化**： +- `rooms[]` 包含完整座位图+sections+seats，不再查 `vr_seat_templates` 表 +- `selected_sections` 控制每个房间内渲染哪些分区 +- `spec_base_id_map` 格式：`{room_id}_{row}_{colNum}` → `spec_base_id` -```bash -# 在 shopxo-php 容器内 -docker exec -it shopxo-php bash -cd /var/www/html -curl "http://localhost:10000/?s=goods/index/id/118.html" +完整规格见 `docs/VR_GOODS_CONFIG_SPEC.md`。 -# 检查： -# 1. {include file="public/head"} 是否被解析为 HTML 内容 -# 2. {$goods.title} 是否显示商品标题 -# 3. 座位图是否正常渲染 -``` +--- -### 失败备选 +## 三、下一步工作 -若 `{include}` 标签失败，修改 `ticket_detail.html`： +### Step 1（立即）：重写 GetGoodsViewData() + +**目标**：适配新 JSON 格式，从 `goods.vr_goods_config` 直接读取 rooms[]，注入前端模板。 + +**新输出格式**： ```php - -{include file="public/head" /} - - +[ + 'vr_seat_template' => [ + 'rooms' => [...], // 直接透传 vr_goods_config[0].rooms + 'sessions' => [...], // 直接透传 vr_goods_config[0].sessions + 'selected_sections' => {...}, // 直接透传 vr_goods_config[0].selected_sections + ], + 'goods_spec_data' => [...], // 场次+价格（用于前端卡片） + 'goods_config' => {...} // 原始 vr_goods_config[0] +] ``` +**降级兼容**：若 `vr_goods_config` 中无 `rooms` 字段，按旧逻辑查 `vr_seat_templates` 表。 + +### Step 2（立即）：更新 ticket_detail.html JS + +**目标**：适配 `rooms[]` 结构，多房间支持。 + +**改动点**： +1. `seatMap` → `rooms[]`（数组，每个房间一个座位图） +2. `renderSeatMap()` → `renderRoom(roomIndex)`（按房间渲染） +3. `specBaseIdMap` 格式变为 `{room_id}_{row}_{colNum}` → `spec_base_id` +4. `loadSoldSeats()` 实现：查 `vr_tickets.seat_info` 格式为 `room_id/rowLabel/colNum` + +### Step 3：AdminGoodsSaveHandle SKU 生成 + +**目标**：用户选择房间后，在商品保存时自动生成 `goods_spec_base` SKU 条目。 + +**逻辑**：展开 rooms[].map，生成每个座位的 SKU，存入 `spec_base_id_map`。 + --- -## 三、Phase 2 接下来的工作 +## 四、模板渲染当前状态 -### Step 1：模板渲染实测（容器内） - -**操作人：** 大头（容器在本机） - -```bash -docker ps | grep shopxo-php # 确认容器运行中 -curl -s "http://localhost:10000/?s=goods/index/id/118.html" | head -50 -``` - -**成功标准：** HTML 源码中不再有 ThinkTemplate 标签（`{include}` / `{$` / `{if}`），座位图 div 正常显示。 - -### Step 2：座位图已售状态 - -SeatSkuService 需要补充 `loadSoldSeats()` 方法，查询 `vr_tickets` 表中该商品+场次已生成的票，返回已售座位 ID 列表，前端据此灰化已售座位。 - -### Step 3：后台管理页面联调 - -4 个后台控制器（SeatTemplate / Ticket / Verifier / Verification）均已生成，需要： -1. 确认路由可访问（后台 URL 格式） -2. 验证 CRUD 操作正常 -3. 确认 RLS 策略 - -### Step 4：核销 API - -`POST /api/vr_ticket/verify` — B 端小程序扫码调用。 +| 项目 | 状态 | +|------|------| +| 模板渲染 | ✅ 正常（PHP ModuleInclude 方案） | +| 票务 footer | ✅ 已精简 | +| 场次显示 | ❌ 待适配新 JSON 格式 | +| 座位图渲染 | ❌ 待适配 rooms[] 结构 | +| 已售座位标记 | ❌ 待实现 loadSoldSeats() | --- -## 四、数据库表结构（当前） +## 五、数据库表结构（当前） | 表名 | 用途 | 状态 | |------|------|------| -| `vrt_vr_seat_templates` | 座位模板 | ✅ | +| `vrt_vr_seat_templates` | 场馆模板（rooms 母版） | ✅ | | `vrt_vr_tickets` | 电子票 | ✅ | | `vrt_vr_verifiers` | 核销员 | ✅ | | `vrt_vr_verifications` | 核销记录 | ✅ | -| `vrt_vr_audit_log` | 审计日志 | ✅ | -| `goods.vr_goods_config` | 商品配置（JSON） | ✅ | -| `sxo_order_detail` | 订单明细（ShopXO） | ✅ | +| `goods.vr_goods_config` | 商品配置快照（新 JSON 格式） | ⚠️ 待适配 | +| `goods_spec_base` | SKU 库存（ShopXO 原生平表） | ⚠️ 待自动生成 | --- -## 五、已知风险 +## 六、已知风险 | 风险 | 影响 | 缓解 | |------|------|------| -| `{include}` 标签容器内解析失败 | P0，页面无样式 | 切换 ModuleInclude 方案 | -| shopxo-php 容器未启动 | 无法验证 | 每次操作前 `docker ps` 确认 | -| Admin 控制器鉴权链不完整 | 后台无法访问 | 确认继承 Common 并调用 IsLogin/IsPower | -| 座位模板与商品分类绑定逻辑 | 需确认 1:N 还是 1:1 | 实测验证 | - ---- - -## 六、决策点（待大头确认） - -1. **模板 include 方案**：先试 `{include}`，失败后换 `ModuleInclude()`，还是直接内联 CSS/JS？ -2. **loadSoldSeats()**：是否需要实时查库，还是前端纯靠 JS 状态管理？ -3. **后台前端框架**：Layui 是否继续使用，还是改用其他方案？ +| vr_goods_config 仍是旧格式 | 场次/座位图不显示 | AdminGoodsSaveHandle 生成新格式后可解决 | +| 旧版 GetGoodsViewData 未适配新格式 | 前端无数据 | Step 1 完成后解决 | +| spec_base_id_map 格式变化 | 已选座位提交逻辑需同步更新 | Step 2 中同步更新 JS | diff --git a/docs/VR_GOODS_CONFIG_SPEC.md b/docs/VR_GOODS_CONFIG_SPEC.md new file mode 100644 index 0000000..61e1c2b --- /dev/null +++ b/docs/VR_GOODS_CONFIG_SPEC.md @@ -0,0 +1,190 @@ +# vr_goods_config JSON 规格说明 + +> 版本：v2.0 | 日期：2026-04-20 | 状态：已确认，待实现 + +--- + +## 一、设计原则 + +1. **商品发布时快照**：用户在后端选择场馆房间后，将完整的房间数据**复制一份**存入 `goods.vr_goods_config`。不从 `vr_seat_templates` 实时读取。 +2. **绝对一致性**：修改 `vr_seat_templates` 不影响已发布的商品。SKU（spec_base）和 `vr_goods_config` 一起过时、一起更新。 +3. **向下兼容**：保留 `template_id` 字段（用于标识来源），但不再用它去查 `vr_seat_templates` 表。 +4. **单一真相源**：前端渲染所需的所有数据（座位图、场次、价格）全部来自 `vr_goods_config` 的快照，不跨表查询。 + +--- + +## 二、vr_goods_config JSON 结构 + +```json +[ + { + "template_id": 4, + "selected_rooms": ["room_id_1776341371905"], + "selected_sections": { + "room_id_1776341371905": ["A", "B"] + }, + "rooms": [ + { + "id": "room_id_1776341371905", + "name": "1号放映室VV", + "map": [ + "AAAAB__BBB_BAAAA", + "AAAAB__BBB_BAAAA", + "AAAAB__BBB_BAAAA" + ], + "sections": [ + { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + ], + "seats": { + "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + } + } + ], + "sessions": [ + { "start": "15:00", "end": "16:59" }, + { "start": "18:00", "end": "21:59" } + ] + } +] +``` + +### 字段说明 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| `template_id` | int | ✅ | 来源场馆模板 ID（用于溯源，不用于查询） | +| `selected_rooms` | string[] | ✅ | 本商品启用的房间 ID 列表 | +| `selected_sections` | object | ✅ | key=房间ID，value=启用的分区字符列表（如 `["A","B"]`） | +| `rooms` | object[] | ✅ | 房间完整数据快照（直接复制自 `vr_seat_templates.rooms`） | +| `sessions` | object[] | ✅ | 本商品的场次列表 | + +### rooms.seats 字段说明 + +`seats` 是 `sections` 的快捷索引，key = `char`（座位字符），格式与 `sections` 条目相同： +```json +"seats": { + "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } +} +``` + +### 向下兼容（旧格式迁移） + +旧格式（有 `vr_seat_templates` 表关联逻辑）： +```json +{ + "template_id": 4, + "sessions": [{"start": "...", "end": "..."}] +} +``` +识别方式：`rooms` 字段不存在 → 降级读取 `vr_seat_templates` 表。 + +--- + +## 三、SKU 生成逻辑（AdminGoodsSaveHandle Hook） + +商品保存时，根据 `selected_rooms` 数组，从 `vr_seat_templates.rooms` 取出对应房间，展开每个房间的 `map` 座位，生成 SKU 条目到 `goods_spec_base` + `goods_spec_value`。 + +``` +rooms[room_id].map + └─ 每行字符串（如 "AAAAB__BBB_BAAAA"） + └─ 每个非 _ / - 的字符 → 一个 SKU + ├─ goods_spec_base.id → 库存主键 + ├─ goods_spec_base.spec_name → "排:row, 座:colNum" + ├─ goods_spec_base.price → seats[char].price + └─ goods_spec_base.spec_type → "vrseat:{room_id}:{char}" +``` + +**spec_base_id_map（存到 vr_goods_config 的 rooms[] 中）格式：** +```json +{ + "{room_id}_{row}_{colNum}": goods_spec_base.id +} +``` + +> 注：具体 SKU 生成字段名/存储位置待 AdminGoodsSaveHandle 实现时确认。 + +--- + +## 四、前端渲染数据流 + +``` +goods.vr_goods_config（快照） + └─ [0].rooms[] → 前端 JS rooms[] + └─ [0].sessions[] → 场次卡片 + └─ [0].selected_sections{} → 控制哪些分区渲染 +``` + +### 前端数据结构 + +```javascript +// GetGoodsViewData() 注入给模板 +{ + vr_seat_template: { + rooms: [...], // rooms 快照数组 + sessions: [...], // 场次列表 + selected_sections: {} // 分区过滤 + }, + goods_spec_data: [...], // 场次规格（price 来自 goods_spec_base） + goods_config: { ... } // 原始 vr_goods_config[0] +} +``` + +### loadSoldSeats（已选座位） + +从 `vr_tickets` 表查询该商品+当前场次已生成的票： +```sql +SELECT seat_info FROM vrt_vr_tickets +WHERE goods_id = :goods_id AND verify_status != 1 +``` +`seat_info` 格式：`"room_id/rowLabel/colNum"`（例：`room_id_xxx/A/3`） + +--- + +## 五、GetGoodsViewData() 重写要点 + +**输入**：`goods_id` + +**输出**： +```php +[ + 'vr_seat_template' => [ + 'rooms' => [...], // 来自 vr_goods_config[0].rooms + 'sessions' => [...], // 来自 vr_goods_config[0].sessions + 'selected_sections' => {...}, // 来自 vr_goods_config[0].selected_sections + ], + 'goods_spec_data' => [...], // 场次+价格（用于前端场次卡片） + 'goods_config' => {...} // 原始 vr_goods_config[0] +] +``` + +**逻辑**： +1. 读取 `goods.vr_goods_config` JSON +2. 若 `rooms` 字段存在 → 直接使用（新格式） +3. 若 `rooms` 不存在 → 降级：按旧逻辑查 `vr_seat_templates` 表（旧格式兼容） +4. 场次价格从 `goods_spec_base` 表读取 + +--- + +## 六、需要更新的文件 + +| 文件 | 操作 | 说明 | +|------|------|------| +| `SeatSkuService.php` | 重写 GetGoodsViewData() | 新 JSON 格式解析 | +| `ticket_detail.html` | 更新 JS | rooms[] 结构渲染 + loadSoldSeats | +| `docs/VR_GOODS_CONFIG_SPEC.md` | 新建 | 本文档，记录 JSON 规格 | +| `docs/PHASE2_PLAN.md` | 更新 | 补充新格式 + 待办 | +| `docs/DEVELOPMENT_LOG.md` | 追加 | 记录本次 JSON 格式升级 | + +--- + +## 七、已确认的设计决策 + +1. ✅ 商品发布时快照 `vr_seat_templates.rooms` 到 `goods.vr_goods_config.rooms` +2. ✅ `vr_goods_config` 包含完整的座位图+sections+seats 数据 +3. ✅ 前端不跨表查询，全部数据来自 `vr_goods_config` 快照 +4. ✅ `spec_base_id_map` 格式：`{room_id}_{row}_{colNum}` → `spec_base_id` +5. ✅ 座位已售状态：查 `vr_tickets.seat_info`（格式：`room_id/rowLabel/colNum`） +6. ⚠️ SKU 生成字段名/存储位置：待 AdminGoodsSaveHandle 实现时确认 From 6daa3323231bcb6cd59d9bf129b46567aa9817a5 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 08:30:00 +0800 Subject: [PATCH 08/12] docs: v3.0 vr_goods_config spec + Phase2 plan v3.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit v3.0 核心变更： - selected_sections 改为数组格式 [A,B] - spec_base_id_map 使用 goods_spec_base.extends 动态构建 - seat_key 格式: roomId_rowLabel_colNum（无 MD5） - 完整规格文档: docs/VR_GOODS_CONFIG_SPEC.md --- docs/PHASE2_PLAN.md | 193 +++++++++----------- docs/VR_GOODS_CONFIG_SPEC.md | 341 +++++++++++++++++++++++------------ 2 files changed, 308 insertions(+), 226 deletions(-) diff --git a/docs/PHASE2_PLAN.md b/docs/PHASE2_PLAN.md index cf575cb..d31304b 100644 --- a/docs/PHASE2_PLAN.md +++ b/docs/PHASE2_PLAN.md @@ -1,18 +1,18 @@ # Phase 2 — 计划与当前状态 -> 版本：v2.0 | 日期：2026-04-20 | 状态：执行中 -> 关联提交：c894e7018（模板渲染已通）、1b0ac3276（精简 footer） -> 关联文档：`docs/VR_GOODS_CONFIG_SPEC.md`（新 JSON 格式规格） +> 版本：v3.0 | 日期：2026-04-20 | 状态：实现准备就绪 +> 关联提交：c894e7018（模板渲染）、1b0ac3276（精简 footer） +> 关联文档：`docs/VR_GOODS_CONFIG_SPEC.md`（v3.0 JSON 格式，已确认） --- -## ⚠️ 重大更新（v2.0） +## ⚠️ v3.0 重大变更摘要 -**vr_goods_config JSON 格式已重新设计。** +- `vr_goods_config` 包含完整 `rooms[]` 快照，不再查 `vr_seat_templates` 表 +- `spec_base_id_map` 不入库，GetGoodsViewData 动态从 `goods_spec_base.extends->seat_key` 构建 +- `selected_sections` 改为数组格式 `["A","B"]`（不是对象） -旧格式依赖 `vr_seat_templates` 表实时查询，新格式在商品发布时将 `rooms` 快照存入商品表，前端不再跨表查询。 - -详见 `docs/VR_GOODS_CONFIG_SPEC.md`。 +完整规格见 `docs/VR_GOODS_CONFIG_SPEC.md`。 --- @@ -22,137 +22,112 @@ | 任务 | 提交 | 说明 | |------|------|------| -| 模板渲染 | c894e7018 | ThinkTemplate → PHP ModuleInclude，渲染正常 | -| 票务专用 footer | 1b0ac3276 | 精简 footer，移除 ShopXO 默认导航 | -| Goods.php 改法 | 7bd896764 | item_type=ticket → ticket_detail.html | -| onOrderPaid() 修复 | 7bd896764 | sxo_order_detail + JSON spec 解析 | +| 模板渲染 | c894e7018 | PHP ModuleInclude，渲染正常 | +| 票务专用 footer | 1b0ac3276 | 精简 footer | -### ⚠️ 进行中 +### ⚠️ 实现准备就绪（待动手） | 任务 | 说明 | 依赖 | |------|------|------| -| GetGoodsViewData() 重写 | 适配新 vr_goods_config JSON 格式 | VR_GOODS_CONFIG_SPEC.md 已确认 | -| 前端 JS 更新 | 适配 rooms[] 结构渲染 | GetGoodsViewData() 输出格式确定后 | -| loadSoldSeats() 实现 | 查询 vr_tickets，标记已售座位 | vr_tickets 表有数据后 | +| BatchGenerate 写入 extends | 存储 seat_key 到 goods_spec_base.extends | VR_GOODS_CONFIG_SPEC.md 已确认 | +| GetGoodsViewData 重写 | 动态构建 spec_base_id_map + 适配 selected_sections | 同上 | +| ticket_detail.html JS 更新 | seatKey 格式改为 roomId_rowLabel_colNum | 同上 | ### ❌ 未开始 -| 任务 | 说明 | -|------|------| -| AdminGoodsSaveHandle SKU 生成 | 根据 selected_rooms 生成 goods_spec_base 条目 | -| 后台 4 控制器联调 | SeatTemplate/Ticket/Verifier/Verification | -| 核销 API | POST /api/vr_ticket/verify | +| 任务 | +|------| +| 核销 API | +| 后台 4 控制器联调 | +| AdminGoodsSaveHandle selected_sections 透传确认 | --- -## 二、vr_goods_config 新格式（已确认） +## 二、vr_goods_config v3.0 结构（已确认） ```json -[ - { - "template_id": 4, - "selected_rooms": ["room_id_xxx"], - "selected_sections": { "room_id_xxx": ["A", "B"] }, - "rooms": [ - { - "id": "room_id_xxx", - "name": "1号放映室VV", - "map": ["AAAAB__BBB_BAAAA", "AAAAB__BBB_BAAAA"], - "sections": [ - { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, - { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } - ], - "seats": { - "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, - "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } - } - } - ], - "sessions": [ - { "start": "15:00", "end": "16:59" }, - { "start": "18:00", "end": "21:59" } - ] - } -] +{ + "version": 1.0, + "template_id": 4, + "selected_rooms": ["room_id_xxx"], + "selected_sections": ["A", "B"], + "sessions": [{ "start": "15:00", "end": "16:59" }], + "venue": { "name": "...", "address": "...", "location": {}, "images": [] }, + "rooms": [{ "id": "room_id_xxx", "name": "...", "map": [...], "sections": [...], "seats": {...} }] +} ``` -**核心变化**： -- `rooms[]` 包含完整座位图+sections+seats，不再查 `vr_seat_templates` 表 -- `selected_sections` 控制每个房间内渲染哪些分区 -- `spec_base_id_map` 格式：`{room_id}_{row}_{colNum}` → `spec_base_id` - -完整规格见 `docs/VR_GOODS_CONFIG_SPEC.md`。 +详细字段说明见 `docs/VR_GOODS_CONFIG_SPEC.md` 第一章。 --- -## 三、下一步工作 +## 三、spec_base_id_map 解决方案（已确认） -### Step 1（立即）：重写 GetGoodsViewData() +### 断路根因 -**目标**：适配新 JSON 格式，从 `goods.vr_goods_config` 直接读取 rooms[]，注入前端模板。 +BatchGenerate 生成 GoodsSpecBase.id 后，从未写入 spec_base_id_map。前端用 `roomId_row_col` 格式查，存储端从未按此格式写入。 + +### 解决方案：使用 goods_spec_base.extends + +``` +BatchGenerate 写入时： + extends.seat_key = "room_id_rowLabel_colNum" (无 MD5) + +GetGoodsViewData 读取时： + 遍历 goods_spec_base（inventory > 0） + → 解析 extends.seat_key + → 构建 spec_base_id_map[key] = id + +前端 submit() 时： + seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum + specBaseId = spec_base_id_map[seatKey] +``` + +详见 `docs/VR_GOODS_CONFIG_SPEC.md` 第三章。 + +--- + +## 四、下一步工作（实现顺序） + +### Step 1：BatchGenerate 写入 extends -**新输出格式**： ```php -[ - 'vr_seat_template' => [ - 'rooms' => [...], // 直接透传 vr_goods_config[0].rooms - 'sessions' => [...], // 直接透传 vr_goods_config[0].sessions - 'selected_sections' => {...}, // 直接透传 vr_goods_config[0].selected_sections - ], - 'goods_spec_data' => [...], // 场次+价格（用于前端卡片） - 'goods_config' => {...} // 原始 vr_goods_config[0] -] +// SeatSkuService::BatchGenerate() 中，insertGetId 前： +$extends = json_encode([ + 'seat_key' => $roomId . '_' . $rowLabel . '_' . $col +], JSON_UNESCAPED_UNICODE); + +// insertGetId 中加入： +'extends' => $extends, ``` -**降级兼容**：若 `vr_goods_config` 中无 `rooms` 字段，按旧逻辑查 `vr_seat_templates` 表。 +### Step 2：GetGoodsViewData 重写 -### Step 2（立即）：更新 ticket_detail.html JS +```php +// 1. 读取 vr_goods_config[0] +// 2. 直接透传 rooms[] / sessions[] / selected_sections / venue +// 3. 动态构建 spec_base_id_map（从 goods_spec_base.extends） +// 4. 生成 goods_spec_data（场次+最低价聚合） +// 5. 返回 { vr_seat_template, goods_spec_data, goods_config } +``` -**目标**：适配 `rooms[]` 结构，多房间支持。 +### Step 3：ticket_detail.html JS -**改动点**： -1. `seatMap` → `rooms[]`（数组，每个房间一个座位图） -2. `renderSeatMap()` → `renderRoom(roomIndex)`（按房间渲染） -3. `specBaseIdMap` 格式变为 `{room_id}_{row}_{colNum}` → `spec_base_id` -4. `loadSoldSeats()` 实现：查 `vr_tickets.seat_info` 格式为 `room_id/rowLabel/colNum` - -### Step 3：AdminGoodsSaveHandle SKU 生成 - -**目标**：用户选择房间后，在商品保存时自动生成 `goods_spec_base` SKU 条目。 - -**逻辑**：展开 rooms[].map，生成每个座位的 SKU，存入 `spec_base_id_map`。 +```javascript +// seatKey 格式改为带 roomId： +var seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum; +// 例："room_id_1776341371905_A_3" +var specBaseId = self.specBaseIdMap[seatKey] || 0; +``` --- -## 四、模板渲染当前状态 +## 五、模板渲染当前状态 | 项目 | 状态 | |------|------| -| 模板渲染 | ✅ 正常（PHP ModuleInclude 方案） | +| 模板渲染 | ✅ 正常 | | 票务 footer | ✅ 已精简 | -| 场次显示 | ❌ 待适配新 JSON 格式 | -| 座位图渲染 | ❌ 待适配 rooms[] 结构 | -| 已售座位标记 | ❌ 待实现 loadSoldSeats() | - ---- - -## 五、数据库表结构（当前） - -| 表名 | 用途 | 状态 | -|------|------|------| -| `vrt_vr_seat_templates` | 场馆模板（rooms 母版） | ✅ | -| `vrt_vr_tickets` | 电子票 | ✅ | -| `vrt_vr_verifiers` | 核销员 | ✅ | -| `vrt_vr_verifications` | 核销记录 | ✅ | -| `goods.vr_goods_config` | 商品配置快照（新 JSON 格式） | ⚠️ 待适配 | -| `goods_spec_base` | SKU 库存（ShopXO 原生平表） | ⚠️ 待自动生成 | - ---- - -## 六、已知风险 - -| 风险 | 影响 | 缓解 | -|------|------|------| -| vr_goods_config 仍是旧格式 | 场次/座位图不显示 | AdminGoodsSaveHandle 生成新格式后可解决 | -| 旧版 GetGoodsViewData 未适配新格式 | 前端无数据 | Step 1 完成后解决 | -| spec_base_id_map 格式变化 | 已选座位提交逻辑需同步更新 | Step 2 中同步更新 JS | +| 场次显示 | ❌ 待 GetGoodsViewData 重写 | +| 座位图渲染 | ❌ 待 GetGoodsViewData + JS 更新 | +| 已售座位标记 | ❌ 待 loadSoldSeats() 实现 | diff --git a/docs/VR_GOODS_CONFIG_SPEC.md b/docs/VR_GOODS_CONFIG_SPEC.md index 61e1c2b..ff7c638 100644 --- a/docs/VR_GOODS_CONFIG_SPEC.md +++ b/docs/VR_GOODS_CONFIG_SPEC.md @@ -1,27 +1,38 @@ # vr_goods_config JSON 规格说明 -> 版本：v2.0 | 日期：2026-04-20 | 状态：已确认，待实现 +> 版本：v3.0 | 日期：2026-04-20 | 状态：**已确认，待实现** +> 关联提交：待实现 --- -## 一、设计原则 +## ⚠️ 重要：v3.0 vs 旧版本的区别 -1. **商品发布时快照**：用户在后端选择场馆房间后，将完整的房间数据**复制一份**存入 `goods.vr_goods_config`。不从 `vr_seat_templates` 实时读取。 -2. **绝对一致性**：修改 `vr_seat_templates` 不影响已发布的商品。SKU（spec_base）和 `vr_goods_config` 一起过时、一起更新。 -3. **向下兼容**：保留 `template_id` 字段（用于标识来源），但不再用它去查 `vr_seat_templates` 表。 -4. **单一真相源**：前端渲染所需的所有数据（座位图、场次、价格）全部来自 `vr_goods_config` 的快照，不跨表查询。 +**v2.0（旧）**：rooms/sections/seats 存放在 `vr_seat_templates.seat_map` JSON 里，前端需要跨表查询。 + +**v3.0（新）**：完整快照直接嵌入 `goods.vr_goods_config`，前端完全不跨表。 + +**破坏性变更**：`selected_sections` 从**对象格式** `{"room_id": ["A","B"]}` 改为**数组格式** `["A","B"]`（每个房间一个选中分区列表）。 --- -## 二、vr_goods_config JSON 结构 +## 一、vr_goods_config 完整结构 ```json [ { + "version": 1.0, "template_id": 4, - "selected_rooms": ["room_id_1776341371905"], - "selected_sections": { - "room_id_1776341371905": ["A", "B"] + "selected_rooms": ["room_id_1776341371905", "room_id_1776341444657"], + "selected_sections": ["A", "B"], + "sessions": [ + { "start": "15:00", "end": "16:59" }, + { "start": "18:00", "end": "21:59" } + ], + "venue": { + "name": "测试 2", + "address": "测试地址", + "location": { "lng": "", "lat": "" }, + "images": [] }, "rooms": [ { @@ -41,10 +52,6 @@ "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } } } - ], - "sessions": [ - { "start": "15:00", "end": "16:59" }, - { "start": "18:00", "end": "21:59" } ] } ] @@ -54,137 +61,237 @@ | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| -| `template_id` | int | ✅ | 来源场馆模板 ID（用于溯源，不用于查询） | -| `selected_rooms` | string[] | ✅ | 本商品启用的房间 ID 列表 | -| `selected_sections` | object | ✅ | key=房间ID，value=启用的分区字符列表（如 `["A","B"]`） | -| `rooms` | object[] | ✅ | 房间完整数据快照（直接复制自 `vr_seat_templates.rooms`） | -| `sessions` | object[] | ✅ | 本商品的场次列表 | - -### rooms.seats 字段说明 - -`seats` 是 `sections` 的快捷索引，key = `char`（座位字符），格式与 `sections` 条目相同： -```json -"seats": { - "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, - "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } -} -``` - -### 向下兼容（旧格式迁移） - -旧格式（有 `vr_seat_templates` 表关联逻辑）： -```json -{ - "template_id": 4, - "sessions": [{"start": "...", "end": "..."}] -} -``` -识别方式：`rooms` 字段不存在 → 降级读取 `vr_seat_templates` 表。 +| `version` | float | ✅ | 协议版本，当前 1.0，用于前向兼容判断 | +| `template_id` | int | ✅ | 来源场馆模板 ID（溯源用，不用于查询） | +| `selected_rooms` | string[] | ✅ | 本商品启用的房间 ID 列表（决定渲染哪些房间） | +| `selected_sections` | string[] | ✅ | 本商品选中的分区字符列表（当前房间的分区，`["A","B"]`） | +| `sessions` | object[] | ✅ | 本商品场次列表 | +| `venue` | object | ✅ | 场馆基本信息快照 | +| `rooms` | object[] | ✅ | 房间完整数据快照（直接复制自 vr_seat_templates.rooms） | --- -## 三、SKU 生成逻辑（AdminGoodsSaveHandle Hook） +## 二、selected_sections 格式说明 -商品保存时，根据 `selected_rooms` 数组，从 `vr_seat_templates.rooms` 取出对应房间，展开每个房间的 `map` 座位，生成 SKU 条目到 `goods_spec_base` + `goods_spec_value`。 +**格式**：`string[]` — 选中分区的字符列表，应用于 `selected_rooms` 中的**当前选中房间**。 -``` -rooms[room_id].map - └─ 每行字符串（如 "AAAAB__BBB_BAAAA"） - └─ 每个非 _ / - 的字符 → 一个 SKU - ├─ goods_spec_base.id → 库存主键 - ├─ goods_spec_base.spec_name → "排:row, 座:colNum" - ├─ goods_spec_base.price → seats[char].price - └─ goods_spec_base.spec_type → "vrseat:{room_id}:{char}" +**为什么不是对象**：`{"room_id": ["A","B"]}`（v2.0 旧格式）改为 `["A","B"]`。 + +**简化理由**：用户在后端编辑商品时，一次只能编辑一个房间的分区选择。所以 `selected_sections` 是"当前房间的选中分区"，不需要跨房间存储。 + +```php +// AdminGoodsSaveHandle 中的转换（旧格式 → 新格式） +// 旧格式（已废弃）： +// $config['selected_sections'] = { "room_id_xxx": ["A","B"] } + +// 新格式（v3.0）： +// 前端传入 selected_sections: ["A","B"] +// 直接存储，不做任何转换 +$selectedSections = $config['selected_sections'] ?? []; + +// BatchGenerate 适配（详见第五章） ``` -**spec_base_id_map（存到 vr_goods_config 的 rooms[] 中）格式：** +--- + +## 三、spec_base_id_map 生成与存储 + +### 3.1 当前断路问题 + +``` +BatchGenerate() → 生成 GoodsSpecBase.id + → 从未写入 spec_base_id_map ← 断路 + +Admin.php Save → 从 form 存旧格式 spec_base_id_map（空或无效） +GetGoodsViewData → 读 vr_seat_templates.spec_base_id_map（旧路径） +前端 JS → 用 "A_3" 格式查 → key 不匹配 → 永远查不到 +``` + +### 3.2 解决方案：使用 goods_spec_base.extends 字段 + +ShopXO 原生 `goods_spec_base` 表有 `extends` 字段（JSON 扩展数据），我们的 BatchGenerate 每次都重建全量 spec（delete + insert），所以写入 `extends` 不会被覆盖。 + +**存储时**（BatchGenerate 写入 GoodsSpecBase）： +```php +$extends = json_encode([ + 'seat_key' => $roomId . '_' . $rowLabel . '_' . $col // 例："room_id_xxx_A_3" +], JSON_UNESCAPED_UNICODE); + +Db::name('GoodsSpecBase')->insertGetId([ + 'goods_id' => $goodsId, + 'price' => $seatPrice, + 'inventory' => 1, + // ... 其他字段 + 'extends' => $extends, // ← 新增 +]); +``` + +**读取时**（GetGoodsViewData 动态构建 spec_base_id_map）： +```php +$specs = Db::name('GoodsSpecBase') + ->where('goods_id', $goodsId) + ->where('inventory', '>', 0) + ->select(); + +$specBaseIdMap = []; +foreach ($specs as $spec) { + $ext = json_decode($spec['extends'] ?? '{}', true); + if (!empty($ext['seat_key'])) { + $specBaseIdMap[$ext['seat_key']] = intval($spec['id']); + } +} +``` + +**spec_base_id_map 最终格式**： ```json { - "{room_id}_{row}_{colNum}": goods_spec_base.id + "room_id_1776341371905_A_3": 2001, + "room_id_1776341371905_B_5": 2002, + "room_id_1776341444657_A_1": 2050 } ``` -> 注：具体 SKU 生成字段名/存储位置待 AdminGoodsSaveHandle 实现时确认。 +### 3.3 字段不冲突说明 + +`extends` 字段是 ShopXO 的标准扩展字段，ShopXO 自己的 GoodsSave 更新 spec 时只修改核心字段（price/inventory 等），不碰 `extends`。而我们的 BatchGenerate 在商品保存时全量重建 spec，`extends` 由我们写入，不存在被覆盖的风险。 --- -## 四、前端渲染数据流 +## 四、前端数据结构（GetGoodsViewData 输出） -``` -goods.vr_goods_config（快照） - └─ [0].rooms[] → 前端 JS rooms[] - └─ [0].sessions[] → 场次卡片 - └─ [0].selected_sections{} → 控制哪些分区渲染 -``` - -### 前端数据结构 - -```javascript -// GetGoodsViewData() 注入给模板 -{ - vr_seat_template: { - rooms: [...], // rooms 快照数组 - sessions: [...], // 场次列表 - selected_sections: {} // 分区过滤 - }, - goods_spec_data: [...], // 场次规格（price 来自 goods_spec_base） - goods_config: { ... } // 原始 vr_goods_config[0] -} -``` - -### loadSoldSeats（已选座位） - -从 `vr_tickets` 表查询该商品+当前场次已生成的票： -```sql -SELECT seat_info FROM vrt_vr_tickets -WHERE goods_id = :goods_id AND verify_status != 1 -``` -`seat_info` 格式：`"room_id/rowLabel/colNum"`（例：`room_id_xxx/A/3`） - ---- - -## 五、GetGoodsViewData() 重写要点 - -**输入**：`goods_id` - -**输出**： ```php [ 'vr_seat_template' => [ - 'rooms' => [...], // 来自 vr_goods_config[0].rooms - 'sessions' => [...], // 来自 vr_goods_config[0].sessions - 'selected_sections' => {...}, // 来自 vr_goods_config[0].selected_sections + 'venue' => $config['venue'], // 场馆信息 + 'rooms' => $config['rooms'], // 房间快照 + 'sessions' => $config['sessions'], // 场次列表 + 'selected_rooms' => $config['selected_rooms'], + 'selected_sections'=> $config['selected_sections'], + 'spec_base_id_map' => $specBaseIdMap, // 动态构建（见3.2） ], - 'goods_spec_data' => [...], // 场次+价格（用于前端场次卡片） - 'goods_config' => {...} // 原始 vr_goods_config[0] + 'goods_spec_data' => [...], // 场次+价格（用于前端场次卡片） + 'goods_config' => $config // 原始 vr_goods_config[0] ] ``` -**逻辑**： -1. 读取 `goods.vr_goods_config` JSON -2. 若 `rooms` 字段存在 → 直接使用（新格式） -3. 若 `rooms` 不存在 → 降级：按旧逻辑查 `vr_seat_templates` 表（旧格式兼容） -4. 场次价格从 `goods_spec_base` 表读取 +### goods_spec_data 生成逻辑 + +从 `goods_spec_base` 按场次维度聚合（每个座位 = 一条 GoodsSpecBase）： + +```php +// 取每个场次的最低价格作为卡片显示价 +$specs = Db::name('GoodsSpecBase') + ->where('goods_id', $goodsId) + ->where('inventory', '>', 0) + ->select(); + +$sessionPrices = []; // sessionStr => minPrice +$sessionSpecs = []; // sessionStr => first spec_base_id + +foreach ($specs as $spec) { + // 从 goods_spec_value 找到场次维度值 + $sessionValue = Db::name('GoodsSpecValue') + ->where('goods_spec_base_id', $spec['id']) + ->where('value', 'like', '%-%:%') + ->find(); + + if ($sessionValue) { + $sessionStr = $sessionValue['value']; + if (!isset($sessionPrices[$sessionStr]) || $spec['price'] < $sessionPrices[$sessionStr]) { + $sessionPrices[$sessionStr] = floatval($spec['price']); + } + if (!isset($sessionSpecs[$sessionStr])) { + $sessionSpecs[$sessionStr] = intval($spec['id']); + } + } +} + +// 构建 goods_spec_data +$goodsSpecData = []; +foreach ($sessions as $s) { + $start = $s['start'] ?? ''; + $end = $s['end'] ?? ''; + $sessionStr = $start && $end ? "{$start}-{$end}" : ($start ?: $end); + $goodsSpecData[] = [ + 'spec_id' => $sessionSpecs[$sessionStr] ?? 0, + 'spec_name' => $sessionStr, + 'price' => $sessionPrices[$sessionStr] ?? floatval($goods['price'] ?? 0), + ]; +} +``` + +### 前端 JS 使用方式 + +```javascript +// ticket_detail.html JS +var specBaseIdMap = ; + +// submit() 时：根据选中座位查 spec_base_id +var seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum; +// 例："room_id_1776341371905_A_3" +var specBaseId = specBaseIdMap[seatKey] || 0; + +// goods_params 格式（每座一行） +{ + goods_id: goodsId, + spec_base_id: specBaseId, // ← 用 seatKey 查到 + stock: 1, + extension_data: JSON.stringify({ attendee, seat: {...} }) +} +``` --- -## 六、需要更新的文件 +## 五、需要修改的文件 -| 文件 | 操作 | 说明 | -|------|------|------| -| `SeatSkuService.php` | 重写 GetGoodsViewData() | 新 JSON 格式解析 | -| `ticket_detail.html` | 更新 JS | rooms[] 结构渲染 + loadSoldSeats | -| `docs/VR_GOODS_CONFIG_SPEC.md` | 新建 | 本文档，记录 JSON 规格 | -| `docs/PHASE2_PLAN.md` | 更新 | 补充新格式 + 待办 | -| `docs/DEVELOPMENT_LOG.md` | 追加 | 记录本次 JSON 格式升级 | +| 文件 | 改动 | +|------|------| +| `SeatSkuService::BatchGenerate()` | 写入 `extends` JSON（含 `seat_key`） | +| `SeatSkuService::GetGoodsViewData()` | 动态从 `extends` 构建 `spec_base_id_map`；适配 `selected_sections` 数组格式 | +| `ticket_detail.html` JS | `seatKey` 格式改为 `roomId + '_' + rowLabel + '_' + colNum` | +| `AdminGoodsSaveHandle` | selected_sections 透传（已经是数组格式，无需改动） | --- -## 七、已确认的设计决策 +## 六、数据库迁移（如需要） -1. ✅ 商品发布时快照 `vr_seat_templates.rooms` 到 `goods.vr_goods_config.rooms` -2. ✅ `vr_goods_config` 包含完整的座位图+sections+seats 数据 -3. ✅ 前端不跨表查询，全部数据来自 `vr_goods_config` 快照 -4. ✅ `spec_base_id_map` 格式：`{room_id}_{row}_{colNum}` → `spec_base_id` -5. ✅ 座位已售状态：查 `vr_tickets.seat_info`（格式：`room_id/rowLabel/colNum`） -6. ⚠️ SKU 生成字段名/存储位置：待 AdminGoodsSaveHandle 实现时确认 +如后续需要在 `goods_spec_base` 加专用列（非必须，`extends` 已够用）： + +```sql +ALTER TABLE `{{prefix}}goods_spec_base` ADD COLUMN `seat_key` VARCHAR(100) DEFAULT NULL COMMENT '座位键：roomId_row_col'; +``` + +--- + +## 七、版本判断（降级兼容） + +```php +$config = json_decode($goods['vr_goods_config'] ?? '', true); +if (empty($config)) { + return ['vr_seat_template' => null, 'goods_spec_data' => [], 'goods_config' => null]; +} + +$config = $config[0]; + +if (empty($config['rooms'])) { + // v1/v2 旧格式：降级读 vr_seat_templates 表 + return self::GetGoodsViewDataLegacy($goodsId, $config); +} + +// v3.0 新格式 +$version = $config['version'] ?? 1.0; +// ... +``` + +--- + +## 八、已确认的设计决策 + +| 决策 | 结论 | +|------|------| +| `selected_sections` 格式 | 数组 `["A","B"]`，不是对象 | +| `spec_base_id_map` 存储 | 不入库，GetGoodsViewData 动态构建 | +| seat_key 存储位置 | `goods_spec_base.extends->seat_key`（JSON） | +| seat_key 格式 | `{roomId}_{rowLabel}_{colNum}`（无 MD5） | +| goods_spec_data.price | 取该场次所有座位中的最低价（用于卡片显示） | +| 降级兼容 | `version` 字段判断，v1/v2 走旧 vr_seat_templates 表路径 | From 741f25451c536533b2e1fa88a699efd7c908c931 Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 09:04:23 +0800 Subject: [PATCH 09/12] =?UTF-8?q?docs:=20v3.0=20=E6=9C=80=E7=BB=88?= =?UTF-8?q?=E8=A7=84=E6=A0=BC=20-=20template=5Fsnapshot=20=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=20+=20selected=5Fsections=20=E5=AF=B9=E8=B1=A1?= =?UTF-8?q?=E6=A0=BC=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 核心变更： - 新增 template_snapshot 字段（发布时从 vr_seat_templates 读取并存储） - selected_sections 确认为对象格式 { room_id: ["A","B"] } - spec_base_id_map 使用 goods_spec_base.extends 动态构建 - 现有前端编辑体验完全不受影响 - Issue #13 已同步更新 --- docs/PHASE2_PLAN.md | 121 +++++----------- docs/VR_GOODS_CONFIG_SPEC.md | 260 +++++++++++++++++++---------------- 2 files changed, 176 insertions(+), 205 deletions(-) diff --git a/docs/PHASE2_PLAN.md b/docs/PHASE2_PLAN.md index d31304b..6f235d1 100644 --- a/docs/PHASE2_PLAN.md +++ b/docs/PHASE2_PLAN.md @@ -1,59 +1,35 @@ # Phase 2 — 计划与当前状态 > 版本：v3.0 | 日期：2026-04-20 | 状态：实现准备就绪 -> 关联提交：c894e7018（模板渲染）、1b0ac3276（精简 footer） +> 关联 Issue：#13 > 关联文档：`docs/VR_GOODS_CONFIG_SPEC.md`（v3.0 JSON 格式，已确认） --- -## ⚠️ v3.0 重大变更摘要 +## ⚠️ v3.0 核心变更摘要 -- `vr_goods_config` 包含完整 `rooms[]` 快照，不再查 `vr_seat_templates` 表 -- `spec_base_id_map` 不入库，GetGoodsViewData 动态从 `goods_spec_base.extends->seat_key` 构建 -- `selected_sections` 改为数组格式 `["A","B"]`（不是对象） +- 新增 `template_snapshot` 字段（发布时从 `vr_seat_templates.seat_map` 读取并存储） +- `selected_sections` 保持对象格式 `{ room_id: ["A","B"] }` +- `spec_base_id_map` 不入库，GetGoodsViewData 从 `goods_spec_base.extends->seat_key` 动态构建 +- 现有前端编辑体验**完全不受影响**（前端只提交选择项） 完整规格见 `docs/VR_GOODS_CONFIG_SPEC.md`。 --- -## 一、Phase 2 当前状态 - -### ✅ 已完成 - -| 任务 | 提交 | 说明 | -|------|------|------| -| 模板渲染 | c894e7018 | PHP ModuleInclude，渲染正常 | -| 票务专用 footer | 1b0ac3276 | 精简 footer | - -### ⚠️ 实现准备就绪（待动手） - -| 任务 | 说明 | 依赖 | -|------|------|------| -| BatchGenerate 写入 extends | 存储 seat_key 到 goods_spec_base.extends | VR_GOODS_CONFIG_SPEC.md 已确认 | -| GetGoodsViewData 重写 | 动态构建 spec_base_id_map + 适配 selected_sections | 同上 | -| ticket_detail.html JS 更新 | seatKey 格式改为 roomId_rowLabel_colNum | 同上 | - -### ❌ 未开始 - -| 任务 | -|------| -| 核销 API | -| 后台 4 控制器联调 | -| AdminGoodsSaveHandle selected_sections 透传确认 | - ---- - -## 二、vr_goods_config v3.0 结构（已确认） +## 一、vr_goods_config v3.0 结构（已确认） ```json { - "version": 1.0, + "version": 3.0, "template_id": 4, "selected_rooms": ["room_id_xxx"], - "selected_sections": ["A", "B"], + "selected_sections": { "room_id_xxx": ["A", "B"] }, "sessions": [{ "start": "15:00", "end": "16:59" }], - "venue": { "name": "...", "address": "...", "location": {}, "images": [] }, - "rooms": [{ "id": "room_id_xxx", "name": "...", "map": [...], "sections": [...], "seats": {...} }] + "template_snapshot": { + "venue": { ... }, + "rooms": [{ "id": "...", "name": "...", "map": [...], "sections": [...], "seats": {...} }] + } } ``` @@ -61,73 +37,42 @@ --- -## 三、spec_base_id_map 解决方案（已确认） +## 二、实现顺序（Issue #13） -### 断路根因 +### Step 1：AdminGoodsSaveHandle — 保存时填充 template_snapshot -BatchGenerate 生成 GoodsSpecBase.id 后，从未写入 spec_base_id_map。前端用 `roomId_row_col` 格式查，存储端从未按此格式写入。 +在 `save_thing_end` 时机，BatchGenerate 之前： +1. 用 `template_id` 读取 `vr_seat_templates.seat_map`（最新数据） +2. 按 `selected_rooms` 过滤（只存用户选中的房间） +3. 填充 `config.template_snapshot` -### 解决方案：使用 goods_spec_base.extends +### Step 2：BatchGenerate — 写入 extends -``` -BatchGenerate 写入时： - extends.seat_key = "room_id_rowLabel_colNum" (无 MD5) +insertGetId 中加入 `extends.seat_key = roomId_rowLabel_colNum` -GetGoodsViewData 读取时： - 遍历 goods_spec_base（inventory > 0） - → 解析 extends.seat_key - → 构建 spec_base_id_map[key] = id +### Step 3：GetGoodsViewData — 重写 -前端 submit() 时： - seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum - specBaseId = spec_base_id_map[seatKey] -``` +- 读 `vr_goods_config[0]`，透传 `template_snapshot` +- 从 `goods_spec_base.extends` 动态构建 `spec_base_id_map` +- `selected_sections` 适配对象格式 +- `goods_spec_data` 按场次聚合 -详见 `docs/VR_GOODS_CONFIG_SPEC.md` 第三章。 - ---- - -## 四、下一步工作（实现顺序） - -### Step 1：BatchGenerate 写入 extends - -```php -// SeatSkuService::BatchGenerate() 中，insertGetId 前： -$extends = json_encode([ - 'seat_key' => $roomId . '_' . $rowLabel . '_' . $col -], JSON_UNESCAPED_UNICODE); - -// insertGetId 中加入： -'extends' => $extends, -``` - -### Step 2：GetGoodsViewData 重写 - -```php -// 1. 读取 vr_goods_config[0] -// 2. 直接透传 rooms[] / sessions[] / selected_sections / venue -// 3. 动态构建 spec_base_id_map（从 goods_spec_base.extends） -// 4. 生成 goods_spec_data（场次+最低价聚合） -// 5. 返回 { vr_seat_template, goods_spec_data, goods_config } -``` - -### Step 3：ticket_detail.html JS +### Step 4：ticket_detail.html JS — seatKey 格式 ```javascript -// seatKey 格式改为带 roomId： +// 改为带 roomId： var seatKey = seat.roomId + '_' + seat.rowLabel + '_' + seat.colNum; -// 例："room_id_1776341371905_A_3" var specBaseId = self.specBaseIdMap[seatKey] || 0; ``` --- -## 五、模板渲染当前状态 +## 三、Phase 2 当前状态 -| 项目 | 状态 | +| 任务 | 状态 | |------|------| | 模板渲染 | ✅ 正常 | | 票务 footer | ✅ 已精简 | -| 场次显示 | ❌ 待 GetGoodsViewData 重写 | -| 座位图渲染 | ❌ 待 GetGoodsViewData + JS 更新 | -| 已售座位标记 | ❌ 待 loadSoldSeats() 实现 | +| Issue #13 实现（v3.0 落地） | ⚠️ 待动手 | +| 核销 API | ❌ 未开始 | +| 后台 4 控制器联调 | ❌ 未开始 | diff --git a/docs/VR_GOODS_CONFIG_SPEC.md b/docs/VR_GOODS_CONFIG_SPEC.md index ff7c638..51ec6fe 100644 --- a/docs/VR_GOODS_CONFIG_SPEC.md +++ b/docs/VR_GOODS_CONFIG_SPEC.md @@ -1,17 +1,15 @@ # vr_goods_config JSON 规格说明 > 版本：v3.0 | 日期：2026-04-20 | 状态：**已确认，待实现** -> 关联提交：待实现 +> 关联 Issue：#13 --- -## ⚠️ 重要：v3.0 vs 旧版本的区别 +## ⚠️ v3.0 vs 旧版本的区别 -**v2.0（旧）**：rooms/sections/seats 存放在 `vr_seat_templates.seat_map` JSON 里，前端需要跨表查询。 +**旧版**：rooms/sections/seats 存放在 `vr_seat_templates.seat_map` JSON 里，前端需要跨表查询。 -**v3.0（新）**：完整快照直接嵌入 `goods.vr_goods_config`，前端完全不跨表。 - -**破坏性变更**：`selected_sections` 从**对象格式** `{"room_id": ["A","B"]}` 改为**数组格式** `["A","B"]`（每个房间一个选中分区列表）。 +**v3.0（最终）**：发布时将 `vr_seat_templates.seat_map` 快照存入 `template_snapshot`，和用户选择一起存储，前端完全不跨表。 --- @@ -20,39 +18,40 @@ ```json [ { - "version": 1.0, + "version": 3.0, "template_id": 4, "selected_rooms": ["room_id_1776341371905", "room_id_1776341444657"], - "selected_sections": ["A", "B"], + "selected_sections": { + "room_id_1776341371905": ["A", "B"], + "room_id_1776341444657": ["A"] + }, "sessions": [ { "start": "15:00", "end": "16:59" }, { "start": "18:00", "end": "21:59" } ], - "venue": { - "name": "测试 2", - "address": "测试地址", - "location": { "lng": "", "lat": "" }, - "images": [] - }, - "rooms": [ - { - "id": "room_id_1776341371905", - "name": "1号放映室VV", - "map": [ - "AAAAB__BBB_BAAAA", - "AAAAB__BBB_BAAAA", - "AAAAB__BBB_BAAAA" - ], - "sections": [ - { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, - { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } - ], - "seats": { - "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, - "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + "template_snapshot": { + "venue": { + "name": "测试 2", + "address": "测试地址", + "location": { "lng": "", "lat": "" }, + "images": [] + }, + "rooms": [ + { + "id": "room_id_1776341371905", + "name": "1号放映室VV", + "map": ["AAAAB__BBB_BAAAA", "AAAAB__BBB_BAAAA"], + "sections": [ + { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + ], + "seats": { + "A": { "char": "A", "name": "VIP区", "price": 100, "color": "#f06292" }, + "B": { "char": "B", "name": "看台区", "price": 50, "color": "#4fc3f7" } + } } - } - ] + ] + } } ] ``` @@ -61,36 +60,51 @@ | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| -| `version` | float | ✅ | 协议版本，当前 1.0，用于前向兼容判断 | -| `template_id` | int | ✅ | 来源场馆模板 ID（溯源用，不用于查询） | -| `selected_rooms` | string[] | ✅ | 本商品启用的房间 ID 列表（决定渲染哪些房间） | -| `selected_sections` | string[] | ✅ | 本商品选中的分区字符列表（当前房间的分区，`["A","B"]`） | -| `sessions` | object[] | ✅ | 本商品场次列表 | -| `venue` | object | ✅ | 场馆基本信息快照 | -| `rooms` | object[] | ✅ | 房间完整数据快照（直接复制自 vr_seat_templates.rooms） | +| `version` | float | ✅ | 协议版本（当前 3.0），用于前向兼容判断 | +| `template_id` | int | ✅ | 发布/编辑时读取最新 vr_seat_templates 的依据 | +| `selected_rooms` | string[] | ✅ | 用户选择：启用了哪些演播（房间 ID 列表） | +| `selected_sections` | object | ✅ | 用户选择：key=房间ID，value=该房间选中的分区字符列表 | +| `sessions` | object[] | ✅ | 用户管理：场次列表 | +| `template_snapshot` | object | ✅ | 发布时从 vr_seat_templates.seat_map 读取的快照（含 venue + rooms） | + +### selected_sections 格式说明 + +```json +"selected_sections": { + "room_id_1776341371905": ["A", "B"], + "room_id_1776341444657": ["A"] +} +``` + +key = 房间 ID，value = 该房间选中的分区字符数组。为什么用对象格式？因为同一个 section char（如 "A"）可能在不同房间里代表不同的区（VIP区 vs 普通区），所以必须按 room_id 区分。 --- -## 二、selected_sections 格式说明 +## 二、设计意图 -**格式**：`string[]` — 选中分区的字符列表，应用于 `selected_rooms` 中的**当前选中房间**。 +### 流程说明 -**为什么不是对象**：`{"room_id": ["A","B"]}`（v2.0 旧格式）改为 `["A","B"]`。 - -**简化理由**：用户在后端编辑商品时，一次只能编辑一个房间的分区选择。所以 `selected_sections` 是"当前房间的选中分区"，不需要跨房间存储。 - -```php -// AdminGoodsSaveHandle 中的转换（旧格式 → 新格式） -// 旧格式（已废弃）： -// $config['selected_sections'] = { "room_id_xxx": ["A","B"] } - -// 新格式（v3.0）： -// 前端传入 selected_sections: ["A","B"] -// 直接存储，不做任何转换 -$selectedSections = $config['selected_sections'] ?? []; - -// BatchGenerate 适配（详见第五章） ``` +商品发布/编辑时： + 前端提交 → selected_rooms / selected_sections / sessions + 后端 AdminGoodsSaveHandle → + 1. 用 template_id 读取 vr_seat_templates.seat_map（最新数据） + 2. 按 selected_rooms 过滤，填充 template_snapshot + 3. 和 selected_* 一起写入 goods.vr_goods_config + 4. BatchGenerate 生成 SKU +``` + +### 现有前端兼容性 + +- 前端只提交 `selected_rooms` / `selected_sections` / `sessions`，**不提交 `template_snapshot`** +- `template_snapshot` 由后端在保存时自动填充 +- 现有商品编辑体验**完全不受影响** + +### template_snapshot 的作用 + +- 前端渲染所需的所有座位图/sections/seats 数据都来自 `template_snapshot` +- `selected_rooms` / `selected_sections` 用于高亮、过滤等交互逻辑 +- 若 `template_snapshot` 为空（兼容旧商品），降级读 `vr_seat_templates` 表 --- @@ -101,20 +115,17 @@ $selectedSections = $config['selected_sections'] ?? []; ``` BatchGenerate() → 生成 GoodsSpecBase.id → 从未写入 spec_base_id_map ← 断路 - -Admin.php Save → 从 form 存旧格式 spec_base_id_map（空或无效） -GetGoodsViewData → 读 vr_seat_templates.spec_base_id_map（旧路径） -前端 JS → 用 "A_3" 格式查 → key 不匹配 → 永远查不到 +前端 JS → 用 "roomId_row_col" 格式查 → 永远查不到 ``` -### 3.2 解决方案：使用 goods_spec_base.extends 字段 +### 3.2 解决方案：使用 goods_spec_base.extends -ShopXO 原生 `goods_spec_base` 表有 `extends` 字段（JSON 扩展数据），我们的 BatchGenerate 每次都重建全量 spec（delete + insert），所以写入 `extends` 不会被覆盖。 +ShopXO 原生 `goods_spec_base` 表有 `extends` 字段（JSON 扩展数据）。BatchGenerate 每次都删除+重建全量 spec，放心写入 `extends`。 **存储时**（BatchGenerate 写入 GoodsSpecBase）： ```php $extends = json_encode([ - 'seat_key' => $roomId . '_' . $rowLabel . '_' . $col // 例："room_id_xxx_A_3" + 'seat_key' => $roomId . '_' . $rowLabel . '_' . $col ], JSON_UNESCAPED_UNICODE); Db::name('GoodsSpecBase')->insertGetId([ @@ -122,11 +133,11 @@ Db::name('GoodsSpecBase')->insertGetId([ 'price' => $seatPrice, 'inventory' => 1, // ... 其他字段 - 'extends' => $extends, // ← 新增 + 'extends' => $extends, ]); ``` -**读取时**（GetGoodsViewData 动态构建 spec_base_id_map）： +**读取时**（GetGoodsViewData 动态构建）： ```php $specs = Db::name('GoodsSpecBase') ->where('goods_id', $goodsId) @@ -146,53 +157,80 @@ foreach ($specs as $spec) { ```json { "room_id_1776341371905_A_3": 2001, - "room_id_1776341371905_B_5": 2002, - "room_id_1776341444657_A_1": 2050 + "room_id_1776341371905_B_5": 2002 } ``` -### 3.3 字段不冲突说明 +--- -`extends` 字段是 ShopXO 的标准扩展字段，ShopXO 自己的 GoodsSave 更新 spec 时只修改核心字段（price/inventory 等），不碰 `extends`。而我们的 BatchGenerate 在商品保存时全量重建 spec，`extends` 由我们写入，不存在被覆盖的风险。 +## 四、AdminGoodsSaveHandle 改动方案 + +### 保存时填充 template_snapshot + +在 `save_thing_end` 时机，BatchGenerate 之前： + +```php +// foreach ($configs as $config) 循环内： +$templateId = intval($config['template_id'] ?? 0); +$selectedRooms = $config['selected_rooms'] ?? []; + +// 1. 读取最新 vr_seat_templates.seat_map +$template = Db::name(self::table('seat_templates'))->find($templateId); +$seatMap = json_decode($template['seat_map'] ?? '{}', true); +$allRooms = $seatMap['rooms'] ?? []; + +// 2. 按 selected_rooms 过滤（只存用户选中的房间） +$filteredRooms = []; +foreach ($allRooms as $room) { + if (in_array($room['id'], $selectedRooms)) { + $filteredRooms[] = $room; + } +} + +// 3. 填充 template_snapshot +$config['template_snapshot'] = [ + 'venue' => $seatMap['venue'] ?? [], + 'rooms' => $filteredRooms, +]; + +// 4. 用更新后的 config 覆盖（$configs[$i] = $config） +// 5. 后续 BatchGenerate 继续使用更新后的 $config +``` --- -## 四、前端数据结构（GetGoodsViewData 输出） +## 五、前端数据结构（GetGoodsViewData 输出） ```php [ 'vr_seat_template' => [ - 'venue' => $config['venue'], // 场馆信息 - 'rooms' => $config['rooms'], // 房间快照 - 'sessions' => $config['sessions'], // 场次列表 - 'selected_rooms' => $config['selected_rooms'], - 'selected_sections'=> $config['selected_sections'], - 'spec_base_id_map' => $specBaseIdMap, // 动态构建（见3.2） + 'venue' => $config['template_snapshot']['venue'] ?? [], + 'rooms' => $config['template_snapshot']['rooms'] ?? [], // 直接透传快照 + 'sessions' => $config['sessions'] ?? [], + 'selected_rooms' => $config['selected_rooms'] ?? [], + 'selected_sections'=> $config['selected_sections'] ?? {}, // {room_id: [chars]} + 'spec_base_id_map' => $specBaseIdMap, // 动态构建 ], - 'goods_spec_data' => [...], // 场次+价格（用于前端场次卡片） - 'goods_config' => $config // 原始 vr_goods_config[0] + 'goods_spec_data' => $goodsSpecData, + 'goods_config' => $config ] ``` ### goods_spec_data 生成逻辑 -从 `goods_spec_base` 按场次维度聚合（每个座位 = 一条 GoodsSpecBase）： - ```php -// 取每个场次的最低价格作为卡片显示价 -$specs = Db::name('GoodsSpecBase') - ->where('goods_id', $goodsId) - ->where('inventory', '>', 0) - ->select(); +// 从 goods_spec_base 按场次维度聚合（每个座位 = 一条 GoodsSpecBase） +$specs = Db::name('GoodsSpecBase')->where('goods_id', $goodsId) + ->where('inventory', '>', 0)->select(); -$sessionPrices = []; // sessionStr => minPrice -$sessionSpecs = []; // sessionStr => first spec_base_id +$sessionPrices = []; +$sessionSpecs = []; foreach ($specs as $spec) { - // 从 goods_spec_value 找到场次维度值 + // 从 goods_spec_value 找到场次维度值（格式："HH:mm-HH:mm"） $sessionValue = Db::name('GoodsSpecValue') ->where('goods_spec_base_id', $spec['id']) - ->where('value', 'like', '%-%:%') + ->where('value', 'REGEXP', '^[0-9]{2}:[0-9]{2}-[0-9]{2}:[0-9]{2}$') ->find(); if ($sessionValue) { @@ -206,7 +244,6 @@ foreach ($specs as $spec) { } } -// 构建 goods_spec_data $goodsSpecData = []; foreach ($sessions as $s) { $start = $s['start'] ?? ''; @@ -234,7 +271,7 @@ var specBaseId = specBaseIdMap[seatKey] || 0; // goods_params 格式（每座一行） { goods_id: goodsId, - spec_base_id: specBaseId, // ← 用 seatKey 查到 + spec_base_id: specBaseId, stock: 1, extension_data: JSON.stringify({ attendee, seat: {...} }) } @@ -242,44 +279,33 @@ var specBaseId = specBaseIdMap[seatKey] || 0; --- -## 五、需要修改的文件 +## 六、需要修改的文件 | 文件 | 改动 | |------|------| -| `SeatSkuService::BatchGenerate()` | 写入 `extends` JSON（含 `seat_key`） | -| `SeatSkuService::GetGoodsViewData()` | 动态从 `extends` 构建 `spec_base_id_map`；适配 `selected_sections` 数组格式 | +| `AdminGoodsSaveHandle` | save_thing_end 中 BatchGenerate 之前：从 vr_seat_templates 读取并填充 `config.template_snapshot` | +| `SeatSkuService::BatchGenerate()` | insertGetId 中写入 `extends.seat_key` | +| `SeatSkuService::GetGoodsViewData()` | 重写：读 `template_snapshot`；从 `extends` 动态构建 `spec_base_id_map`；适配 `selected_sections` 对象格式 | | `ticket_detail.html` JS | `seatKey` 格式改为 `roomId + '_' + rowLabel + '_' + colNum` | -| `AdminGoodsSaveHandle` | selected_sections 透传（已经是数组格式，无需改动） | --- -## 六、数据库迁移（如需要） - -如后续需要在 `goods_spec_base` 加专用列（非必须，`extends` 已够用）： - -```sql -ALTER TABLE `{{prefix}}goods_spec_base` ADD COLUMN `seat_key` VARCHAR(100) DEFAULT NULL COMMENT '座位键：roomId_row_col'; -``` - ---- - -## 七、版本判断（降级兼容） +## 七、降级兼容 ```php $config = json_decode($goods['vr_goods_config'] ?? '', true); if (empty($config)) { - return ['vr_seat_template' => null, 'goods_spec_data' => [], 'goods_config' => null]; + return /* 错误 */; } -$config = $config[0]; +$config = $config[0] ?? $config; -if (empty($config['rooms'])) { - // v1/v2 旧格式：降级读 vr_seat_templates 表 +if (version_compare($config['version'] ?? 0, 3.0, '<')) { + // 旧版格式（无 template_snapshot）：降级读 vr_seat_templates 表 return self::GetGoodsViewDataLegacy($goodsId, $config); } // v3.0 新格式 -$version = $config['version'] ?? 1.0; // ... ``` @@ -289,9 +315,9 @@ $version = $config['version'] ?? 1.0; | 决策 | 结论 | |------|------| -| `selected_sections` 格式 | 数组 `["A","B"]`，不是对象 | -| `spec_base_id_map` 存储 | 不入库，GetGoodsViewData 动态构建 | -| seat_key 存储位置 | `goods_spec_base.extends->seat_key`（JSON） | -| seat_key 格式 | `{roomId}_{rowLabel}_{colNum}`（无 MD5） | -| goods_spec_data.price | 取该场次所有座位中的最低价（用于卡片显示） | -| 降级兼容 | `version` 字段判断，v1/v2 走旧 vr_seat_templates 表路径 | +| `selected_sections` 格式 | 对象 `{ room_id: ["A","B"] }`（每个房间独立选择） | +| `template_snapshot` | 发布时从 vr_seat_templates.seat_map 读取并存储，不实时查表 | +| `spec_base_id_map` | 不入库，GetGoodsViewData 动态从 `extends.seat_key` 构建 | +| `seat_key` 格式 | `{roomId}_{rowLabel}_{colNum}`（无 MD5） | +| `goods_spec_data.price` | 取该场次所有座位中的最低价（用于卡片显示） | +| 现有前端兼容性 | ✅ 前端只提交选择项，template_snapshot 由后端保存时填充 | From 7f32ad87c23cc20fa2201903067ca06f7d10e55b Mon Sep 17 00:00:00 2001 From: Council Date: Mon, 20 Apr 2026 09:25:01 +0800 Subject: [PATCH 10/12] =?UTF-8?q?docs:=20README=20=E9=87=8D=E6=9E=84=20+?= =?UTF-8?q?=20VR=5FGOODS=5FCONFIG=5FSPEC.md=20=E5=8A=A0=E7=9B=AE=E5=BD=95?= =?UTF-8?q?=20+=20=E8=BF=BD=E5=8A=A0=E5=BC=80=E5=8F=91=E6=97=A5=E5=BF=97?= =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=B8=89=E7=AB=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: 新增清晰文档索引（必读/实现参考/调研存档/历史存档四分类） - VR_GOODS_CONFIG_SPEC.md: 加 Markdown TOC - DEVELOPMENT_LOG.md: 追加第十三章（模板渲染修复 + v3.0 格式确认） --- README.md | 174 ++++++++++++++++++++--------------- docs/DEVELOPMENT_LOG.md | 79 ++++++++++++++++ docs/VR_GOODS_CONFIG_SPEC.md | 10 ++ 3 files changed, 189 insertions(+), 74 deletions(-) diff --git a/README.md b/README.md index 4bb9763..2c779ee 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # VR票务插件 for ShopXO > 基于 ShopXO 生态的 VR 演唱会票务解决方案（Plan B） +> 仓库：`http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin` --- @@ -14,104 +15,129 @@ --- -## ⚠️ 踩坑经验（接手本插件前必读） +## 📚 文档索引 -> 本插件经历了一整夜重构调试，发现了大量反直觉的坑。**任何 agent 或开发者接手前，请先阅读这份经验文档，避免重蹈覆辙。** +### 🔴 必读 -📋 **[docs/EXPERIENCES.md](docs/EXPERIENCES.md)** — ShopXO 插件踩坑经验全记录（16条核心教训） +| 文档 | 说明 | +|------|------| +| **[docs/VR_GOODS_CONFIG_SPEC.md](docs/VR_GOODS_CONFIG_SPEC.md)** | ⚠️ **vr_goods_config JSON 格式 v3.0 完整规格**（商品配置核心） | +| **[docs/PHASE2_PLAN.md](docs/PHASE2_PLAN.md)** | Phase 2 当前状态 + 下一步工作计划 | +| **[docs/EXPERIENCES.md](docs/EXPERIENCES.md)** | ⚠️ **踩坑经验（必读）** — 16条核心教训 | +| **[docs/DEVELOPMENT_LOG.md](docs/DEVELOPMENT_LOG.md)** | 开发日志（完整变更记录） | -> **最关键的3条**： -> 1. `{{:ModuleInclude('public/footer')}}` 缺失 → 页面无限加载（不是后端死循环） -> 2. Vue 3 `[[ ]]` 插值禁止用于 `