vr-shopxo-plugin/README.md

# VR票务插件 for ShopXO

> 基于 ShopXO 生态的 VR 演唱会票务解决方案（Plan B）

## 核心能力

| 能力 | 实现方式 |
|---|---|
| 场次管理 | 插件独立表 `vr_events` / `vr_sessions` |
| 商品详情页定制 | 30+ 钩子注入，或 1 行控制器代码替换模板 |
| 选座 UI | 自定义 Vue 组件，Fork shopxo-uniapp |
| 观演人收集 | 插件钩子收集，下单时写入 `vr_tickets` 表 |
| QR 电子票 | ShopXO 内置 `\base\Qrcode` + phpqrcode |
| 微信小程序 | shopxo-uniapp 已支持，HBuilderX 一键发行 |
| B 端核销 | Fork `realstore/check/check.vue`，完整参考 |
| 会员/积分/优惠券 | 全部复用 ShopXO 内置能力 |

## 快速开始

```bash
# 1. 克隆本仓库
git clone http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin.git

# 2. 上传插件到 ShopXO
cp -r vr-shopxo-plugin/app/plugins/vr_ticket /path/to/shopxo/app/plugins/

# 3. 数据库迁移
# 访问 /admin/plugins/vr_ticket/migrate 或手动执行 SQL

# 4. 后台安装
# 管理后台 → 应用中心 → 插件管理 → 安装 VR票务插件

# 5. shopxo-uniapp 改造
# HBuilderX 导入 shopxo-uniapp
# 添加 pages/ticket-buy/ 和 pages/ticket-verify/
# 配置 manifest.json 的 AppID
# 发行 → 微信小程序
```

## 技术调研文档

- [ShopXO 技术能力调研](docs/01_SHOPXO_TECHNICAL_RESEARCH.md) — DIY/CustomView/钩子/插件完整分析
- [uni-app 前端定制](docs/02_FRONTEND_CUSTOMIZATION.md) — 小程序编译与自定义组件
- [核销系统设计](docs/03_VERIFICATION_SYSTEM.md) — QR 生成/核销 API/票夹
- [实施路线图](docs/04_IMPLEMENTATION_ROADMAP.md) — Agent 分工与开发计划

## 关键发现（2026-04-14）

- ✅ ShopXO 内置 **CustomView Ace 编辑器**（全代码自定义页面）
- ✅ 商品详情页 **30+ 插件钩子**，最佳注入点 `plugins_view_goods_detail_base_sku_top`
- ✅ shopxo-uniapp **已支持微信小程序**，条件编译已配置
- ✅ ShopXO 内置 **phpqrcode** QR 码生成库
- ✅ `realstore/check/check.vue` 是 **B 端核销页最佳参考**

## 项目状态

🚧 **调研完成，尚未开始编码**

## 仓库地址

`http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin`