63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# VR票务插件 for ShopXO
|
||
|
||
> Plan B：基于 ShopXO 生态的 VR 演唱会票务解决方案
|
||
> 当 vr-ticket-mp（Go + Supabase + uni-app 主线）不适用时，选用此方案
|
||
|
||
## 核心能力
|
||
|
||
| 能力 | 实现方式 |
|
||
|---|---|
|
||
| 场次管理 | 插件独立表 `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`
|