From 0148c320918f039c2420fc182575f91d6dfb9486 Mon Sep 17 00:00:00 2001
From: sileya-ai <sileya-ai@openclaw.ai>
Date: Mon, 13 Apr 2026 15:52:38 +0800
Subject: [PATCH] feat: plugin scaffold + initial directories

---
 README.md   | 40 ++++++++++++++++++++++++++++++++++++++++
 plugin.json | 28 ++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 README.md
 create mode 100644 plugin.json

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..719fb07
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# ShopXO VR票务插件
+
+基于 ShopXO 生态的 VR 演唱会票务解决方案（Plan B）。
+
+## 功能特性
+
+- ✅ 场次管理（多日期/多票价/库存追踪）
+- ✅ 观演人信息收集（下单时强制填写）
+- ✅ QR 电子票生成（支付成功后自动发放）
+- ✅ B 端扫码核销（支持多核销员）
+- ✅ 复用 ShopXO 会员/积分/优惠券体系
+- ✅ 插件独立部署，不修改 ShopXO 核心代码
+
+## 快速开始
+
+```bash
+# 1. 克隆插件
+git clone http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin.git
+
+# 2. 上传至 ShopXO 插件目录
+cp -r vr-shopxo-plugin /path/to/shopxo/app/plugins/
+
+# 3. 后台安装插件
+# 管理后台 → 应用中心 → 插件管理 → 安装 VR票务插件
+
+# 4. 数据库迁移
+# 访问 /plugins/vr-ticket/admin/migrate
+```
+
+## 架构文档
+
+详见 [ARCHITECTURE.md](ARCHITECTURE.md)
+
+## 开发状态
+
+🚧 正在规划中，尚未开始编码。
+
+---
+
+**仓库**：`http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin`
diff --git a/plugin.json b/plugin.json
new file mode 100644
index 0000000..e4b0914
--- /dev/null
+++ b/plugin.json
@@ -0,0 +1,28 @@
+{
+    "name": "vr-ticket",
+    "title": "VR票务插件",
+    "description": "为ShopXO添加VR演唱会票务功能：场次管理、观演人收集、QR电子票、核销组件",
+    "version": "1.0.0",
+    "author": "sileya-ai",
+    "author_url": "http://xmhome.ow-my.com:3000/sileya-ai/vr-shopxo-plugin",
+    "shopxo_version": ">=1.0.0",
+    "dependencies": [],
+    "menus": [
+        {
+            "title": "VR票务",
+            "icon": "icon-ticket",
+            "submenus": [
+                {"title": "活动管理", "url": "/plugins/vr-ticket/admin/event/list"},
+                {"title": "场次管理", "url": "/plugins/vr-ticket/admin/session/list"},
+                {"title": "电子票管理", "url": "/plugins/vr-ticket/admin/ticket/list"},
+                {"title": "核销记录", "url": "/plugins/vr-ticket/admin/verification/list"}
+            ]
+        }
+    ],
+    "listen_events": [
+        "order.paid"
+    ],
+    "hooks": [
+        "onOrderPaid"
+    ]
+}