vr-shopxo-plugin/shopxo/app/plugins/vr_ticket
Council 2452fde466 refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php
Phase 2 completion - complete backend management rebuild:

Plugin architecture change (旧 → 新):
- 删: admin/controller/ 子目录多控制器 → 留: admin/Admin.php 单控制器
- 删: admin/view/ → 留: view/{module}/
- 删: EventListener.php, app.php, plugin.json → 留: Hook.php, config.json

New files:
- Hook.php: 插件钩子入口(侧边栏菜单 + 订单支付处理)
- config.json: 插件配置(is_enable 等)
- install.sql / uninstall.sql: 安装卸载脚本
- view/venue/list.html, save.html: 场馆管理视图(AmazeUI)
- view/admin/setup.html: 插件设置页

Modified files:
- service/AuditService.php, BaseService.php, SeatSkuService.php, TicketService.php
- admin/Admin.php: 全新 Admin.php 根目录控制器

ShopXO core changes:
- app/index/controller/Goods.php: ticket 类型商品详情页路由
- app/service/AdminPowerService.php: 权限系统适配
- config/shopxo.php: 配置

AmazeUI frontend migration:
- All views migrated from LayUI to AmazeUI
- Vue 3 editor for venue/seat configuration
- CDN: unpkg.com → cdn.staticfile.net

Fixes included:
- Infinite loading (missing footer include)
- Vue3 textarea interpolation bug
- Template path resolution (../../../plugins/...)
- Hook return fields (id/url/is_show)
- DB field names verified from source
2026-04-17 00:46:00 +08:00
..
admin refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
service refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
view refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
Hook.php refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
README.md
config.json refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
install.sql refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00
uninstall.sql refactor(vr_ticket): full plugin restructure - Admin.php root pattern + Hook.php 2026-04-17 00:46:00 +08:00

README.md

VR票务插件 - vr_ticket

核心原则:怎么快怎么来,怎么方便怎么来

安装

  1. 将本目录上传到 ShopXO 插件目录:
    cp -r vr_ticket /path/to/shopxo/app/plugins/
    
  2. 后台 → 应用中心 → 插件管理 → 找到「VR票务」→ 点击安装
  3. 数据库表自动创建

目录结构

vr_ticket/
├── plugin.json              # 插件配置(名称、菜单、钩子)
├── EventListener.php         # 安装/卸载/升级生命周期
├── service/
│   ├── BaseService.php       # 基础工具AES加密、QR生成
│   └── TicketService.php     # 核心票务逻辑(发票、核销)
├── admin/
│   ├── controller/
│   │   ├── SeatTemplate.php   # 座位模板 CRUD
│   │   ├── Ticket.php         # 电子票管理
│   │   ├── Verifier.php       # 核销员管理
│   │   └── Verification.php   # 核销记录
│   └── view/                  # 后台视图模板
│       ├── seat_template/
│       ├── ticket/
│       ├── verifier/
│       └── verification/
└── view/
    └── goods/
        └── ticket_detail.html  # 前端票务详情页(独立模板)

关键钩子

钩子 作用
plugins_service_order_pay_success_handle_end 支付成功 → 自动发放 QR 电子票
plugins_service_order_delete_success 订单删除 → 清理票务数据

前端票务详情页

需要在 ShopXO 核心文件 app/index/controller/Goods.php 中加 1 行:

// 在 return MyView(); 之前(约第 440 行)
if (!empty($assign['goods']['item_type']) && $assign['goods']['item_type'] == 'ticket') {
    return MyView('/../../../plugins/vr_ticket/view/goods/ticket_detail');
}

详见 docs/GOODS_PHP_MODIFICATION.md

数据库表

表名 用途
vrt_vr_seat_templates 座位模板(绑定分类)
vrt_vr_tickets 电子票(含观演人)
vrt_vr_verifiers 核销员
vrt_vr_verifications 核销记录

API

URL 方法 作用
/plugins/vr_ticket/admin/seat_template/list GET 座位模板列表
/plugins/vr_ticket/admin/seat_template/save GET/POST 添加/编辑模板
/plugins/vr_ticket/admin/ticket/list GET 电子票列表
/plugins/vr_ticket/admin/verification/list GET 核销记录