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

80 lines
3.4 KiB
Markdown
Raw Normal View History

# VR票务插件 — 项目总览
## 项目背景
大头的朋友需要一个外卖/包邮/自提 + 会员(充值/积分/优惠券)的小程序商城。
约束条件:**无程序员/无运维/无前端,要直接可用,后期能用 AI 改代码,部署简单,不考虑 Java**。
在 vr-ticket-mp主线Go + Supabase + uni-app之外建立 **Plan B**:基于 ShopXO 生态的票务插件。
---
## 双线策略
| | vr-ticket-mp主线 | vr-shopxo-pluginPlan B |
|---|---|---|
| **定位** | 票务为核心,商城为辅 | 商城为主,票务为辅 |
| **后端** | Go + Gin自建 | PHP + ThinkPHPShopXO |
| **数据库** | 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](00_OVERVIEW.md) | 项目总览(本文档) |
| [01_SHOPXO_TECHNICAL_RESEARCH.md](01_SHOPXO_TECHNICAL_RESEARCH.md) | ShopXO 技术能力完整调研 |
| [02_FRONTEND_CUSTOMIZATION.md](02_FRONTEND_CUSTOMIZATION.md) | shopxo-uniapp 编译与自定义 |
| [03_VERIFICATION_SYSTEM.md](03_VERIFICATION_SYSTEM.md) | 核销系统设计 |
| [04_IMPLEMENTATION_ROADMAP.md](04_IMPLEMENTATION_ROADMAP.md) | 实施路线图与 Agent 分工 |
| [../ARCHITECTURE.md](../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/
```