80 lines
3.4 KiB
Markdown
80 lines
3.4 KiB
Markdown
# 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](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/
|
||
```
|