From 7fcefb439b4fedd088dc351df13257d872b884e1 Mon Sep 17 00:00:00 2001
From: zk <sim18502043706@163.com>
Date: Thu, 12 Mar 2026 16:50:45 +0800
Subject: [PATCH] =?UTF-8?q?=E8=B7=9F=E6=96=B0=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 项目结构说明.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/项目结构说明.md b/项目结构说明.md
index 2a4c644..fcb3439 100644
--- a/项目结构说明.md
+++ b/项目结构说明.md
@@ -154,3 +154,14 @@ offerpie/back-end
   3. **common** → 所有层共同依赖的底层设施（配置、工具、拦截、异常、支付、邮件等）。
 - 权限体系分两层：前端路由控制菜单可见性，后端切面控制功能点权限与库存扣减。
 - 权限和菜单作为商品维度，框架只负责校验和库存管理，不关心权限来源。
+
+## 4.5️⃣ 邀请模块设计
+### 数据库表（1张）
+| 表名 | 说明 |
+|------|------|
+| `bg_user_invite` | 用户邀请记录（记录邀请人与被邀请人的关系及邀请时间） |
+
+### 核心逻辑
+- 用户注册时自动生成10位邀请码（大写字母+数字），存入 `User.invite_code`，碰撞检查最多重试3次
+- 注册时可携带 `inviteCode`，有效则写入邀请记录，无效仅日志警告不阻断注册
+- 注册逻辑由 `UserRegisterServer` 独立承担，`LoginServer` 委托调用