vr-shopxo-plugin/docs/00_OVERVIEW.md

VR票务插件 — 项目总览

项目背景

大头的朋友需要一个外卖/包邮/自提 + 会员（充值/积分/优惠券）的小程序商城。 约束条件：无程序员/无运维/无前端，要直接可用，后期能用 AI 改代码，部署简单，不考虑 Java。

在 vr-ticket-mp（主线：Go + Supabase + uni-app）之外，建立 Plan B：基于 ShopXO 生态的票务插件。

---

双线策略

	vr-ticket-mp（主线）	vr-shopxo-plugin（Plan B）
定位	票务为核心，商城为辅	商城为主，票务为辅
后端	Go + Gin（自建）	PHP + ThinkPHP（ShopXO）
数据库	Supabase Postgres	ShopXO MySQL
前端	uni-app（自建）	shopxo-uniapp（已有）
会员/积分/优惠券	自建	ShopXO 内置
微信支付	自建	ShopXO 内置
部署	Docker	虚拟主机即可
维护成本	高	低
触发条件	—	电商需求 > 票务需求，或 vr-ticket-mp 维护成本过高

---

为什么选择 ShopXO

ShopXO 在 ShopXO / Bagisto / Saleor / Medusa 四个候选中断层第一推荐（9/10）。

能力	ShopXO	Bagisto	Saleor	Medusa
外卖/自提/包邮	✅ 全功能内置	❌ 无	❌ 无	❌ 无
会员充值/积分/优惠券	✅ 全功能内置	❌ 无	❌ 无	❌ 无
微信支付	✅ 内置	⚠️ 需配置	⚠️ 需配置	⚠️ 需配置
部署难度	⭐ 虚拟主机即可	⭐ VPS/SSH	⭐ Docker 门槛高	⭐ 云托管推荐
uni-app 前端	✅ shopxo-uniapp	❌ 无	❌	❌
票务插件	⚠️ 需开发	❌ 无	❌ 无	❌ 无
AI 友好度	⭐ 业务层 80% 可AI	⭐ 差	⭐ 差	⭐ 差
协议	MIT	MIT	MIT	MIT

---

今天调研的关键突破

1. CustomView Ace 编辑器：ShopXO 内置全代码自定义页面编辑器，HTML/CSS/JS 三栏，实时预览
2. 30+ 商品详情页钩子：plugins_view_goods_detail_base_sku_top 是票务 UI 最佳注入点
3. 商品详情页按类型替换模板：修改 Goods.php Index() 加 1 行判断即可
4. shopxo-uniapp 支持微信小程序：条件编译已配置，HBuilderX 一键发行
5. 核销机制现成可用：realstore/check/check.vue 是 B 端核销页最佳参考
6. QR 码生成内置：\base\Qrcode 类 + phpqrcode 库，URL 即用

---

文档目录

文档	内容
00_OVERVIEW.md	项目总览（本文档）
01_SHOPXO_TECHNICAL_RESEARCH.md	ShopXO 技术能力完整调研
02_FRONTEND_CUSTOMIZATION.md	shopxo-uniapp 编译与自定义
03_VERIFICATION_SYSTEM.md	核销系统设计
04_IMPLEMENTATION_ROADMAP.md	实施路线图与 Agent 分工
../ARCHITECTURE.md	核心架构设计（基础版）

---

关键文件路径（源码位置）

ShopXO 源码克隆自 https://gitee.com/zongzhige/shopxo，位于：

/Users/bigemon/.openclaw/workspace/council-research/shopxo-eval/.worktrees/shopxo-evaluator/shopxo-src/

shopxo-uniapp 克隆自 https://gitee.com/zongzhige/shopxo-uniapp，位于：

/Users/bigemon/.openclaw/workspace/council-research/shopxo-eval/.worktrees/shopxo-evaluator/shopxo-uniapp-src/