From 83a0f6d2f35608793f2d7dfe502bb9237da8973e Mon Sep 17 00:00:00 2001
From: hailin <hailin.zhao@gdzx.xyz>
Date: Sat, 20 Dec 2025 20:58:04 -0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20GENESIS=20?=
 =?UTF-8?q?=E7=B3=BB=E7=BB=9F=E6=8E=A8=E8=8D=90=E7=A0=81=E4=BD=BF=E7=94=A8?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/GENESIS_REFERRAL_CODE.md | 75 +++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 docs/GENESIS_REFERRAL_CODE.md

diff --git a/docs/GENESIS_REFERRAL_CODE.md b/docs/GENESIS_REFERRAL_CODE.md
new file mode 100644
index 00000000..b5cb04ec
--- /dev/null
+++ b/docs/GENESIS_REFERRAL_CODE.md
@@ -0,0 +1,75 @@
+# 系统推荐码使用指南
+
+## 📌 背景
+
+为了解决"第一个用户无法注册"的问题，系统已创建一个种子用户，提供**创世推荐码 (GENESIS)**。
+
+## 🔑 系统推荐码信息
+
+- **推荐码**: `GENESIS`
+- **用途**: 供第一批用户注册时使用
+- **特点**:
+  - ✅ 可被无限次使用
+  - ✅ 永久有效
+  - ✅ 不会过期
+
+## 📱 使用方法
+
+### 移动端注册流程
+
+1. 打开 App，进入向导页面
+2. 在推荐码输入框中输入：`GENESIS`
+3. 点击"下一步 (注册账号)"
+4. 完成后续注册流程
+
+### 示例截图位置
+
+```
+向导页 → 第5页 → 推荐码输入框 → 输入 "GENESIS"
+```
+
+## 🎯 适用场景
+
+1. **测试环境**: 开发和测试人员注册测试账号
+2. **生产环境**: 第一批真实用户注册
+3. **紧急情况**: 当其他推荐码不可用时的备用方案
+
+## ⚠️ 注意事项
+
+1. **系统用户不能登录**：此用户只提供推荐码功能
+2. **ID 固定为 1**：方便在数据库中识别
+3. **不要删除**：删除系统用户会导致推荐关系链断裂
+4. **推广策略**：建议在产品文档/公告中说明首批用户可使用 `GENESIS` 推荐码
+
+## 🔍 数据库查询
+
+查看系统种子用户：
+
+```sql
+SELECT * FROM user_accounts WHERE user_id = 1;
+```
+
+查看使用 GENESIS 推荐码注册的用户：
+
+```sql
+SELECT * FROM user_accounts WHERE inviter_sequence = 'SYSTEM00001';
+```
+
+## 📊 监控建议
+
+定期监控使用 GENESIS 推荐码注册的用户数量：
+
+```sql
+SELECT
+  COUNT(*) as total_users,
+  MIN(registered_at) as first_registration,
+  MAX(registered_at) as last_registration
+FROM user_accounts
+WHERE inviter_sequence = 'SYSTEM00001';
+```
+
+## 🚀 后续优化建议
+
+1. 考虑为运营团队创建专属推荐码
+2. 监控 GENESIS 使用频率，异常时告警
+3. 在管理后台显示使用统计数据