# 学业邑规划 - 数据库设计文档

## 一、设计说明

### 1.1 数据库信息
- **数据库类型**：SQL Server 2022
- **字符集**：UTF-8
- **排序规则**：Chinese_PRC_CI_AS

### 1.2 命名规范
- 表名：snake_case 命名，如 `users`、`assessment_records`
- 字段名：PascalCase 命名，如 `UserId`、`CreateTime`
- 主键：`Id`（bigint 自增）
- 外键：`表名Id`，如 `UserId`、`OrderId`
- 时间字段：`CreateTime`、`UpdateTime`
- 状态字段：`Status`
- 软删除：`IsDeleted`（bit）

### 1.3 SQL 脚本位置
- 业务数据库：`server/MiAssessment/scripts/init_business_db.sql`
- 管理后台数据库：`server/MiAssessment/scripts/init_admin_db.sql`

### 1.3 通用字段
每张业务表包含以下通用字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| Id | bigint | 主键，自增 |
| CreateTime | datetime2 | 创建时间 |
| UpdateTime | datetime2 | 更新时间 |
| IsDeleted | bit | 软删除标记，默认0 |

---

## 二、表结构设计

### 2.1 用户模块

#### 2.1.1 users（用户表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Uid | nvarchar(6) | 是 | - | 用户UID，6位数字 |
| OpenId | nvarchar(64) | 是 | - | 微信OpenId |
| UnionId | nvarchar(64) | 否 | - | 微信UnionId |
| GzhOpenId | nvarchar(64) | 否 | - | 公众号OpenId |
| Phone | nvarchar(20) | 否 | - | 手机号 |
| Nickname | nvarchar(50) | 否 | - | 昵称 |
| Avatar | nvarchar(500) | 否 | - | 头像URL |
| UserLevel | int | 是 | 1 | 用户等级：1普通用户 2合伙人 3渠道合伙人 |
| ParentUserId | bigint | 否 | - | 上级用户ID |
| InviteCode | nvarchar(10) | 否 | - | 用户专属邀请码 |
| Balance | decimal(10,2) | 是 | 0 | 可提现余额 |
| TotalIncome | decimal(10,2) | 是 | 0 | 累计收益 |
| WithdrawnAmount | decimal(10,2) | 是 | 0 | 已提现金额 |
| Status | int | 是 | 1 | 状态：0禁用 1正常 |
| IsTest | int | 是 | 0 | 是否测试用户 |
| LastLoginTime | datetime2 | 否 | - | 最后登录时间 |
| LastLoginIp | nvarchar(50) | 否 | - | 最后登录IP |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- UK_users_uid (Uid) UNIQUE
- UK_users_open_id (OpenId) UNIQUE
- IX_users_phone (Phone)
- IX_users_parent_user_id (ParentUserId)
- IX_users_user_level (UserLevel)

#### 2.1.2 user_refresh_tokens（刷新令牌表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| UserId | bigint | 是 | - | 用户ID |
| TokenHash | nvarchar(256) | 是 | - | Token哈希值 |
| ExpiresAt | datetime2 | 是 | - | 过期时间 |
| CreatedAt | datetime2 | 是 | GETDATE() | 创建时间 |
| CreatedByIp | nvarchar(50) | 否 | - | 创建IP |
| RevokedAt | datetime2 | 否 | - | 撤销时间 |
| RevokedByIp | nvarchar(50) | 否 | - | 撤销IP |
| ReplacedByToken | nvarchar(256) | 否 | - | 替换Token |

#### 2.1.3 user_login_logs（登录日志表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| UserId | bigint | 是 | - | 用户ID |
| LoginType | nvarchar(20) | 是 | - | 登录类型 |
| LoginIp | nvarchar(50) | 否 | - | 登录IP |
| UserAgent | nvarchar(500) | 否 | - | 用户代理 |
| Platform | nvarchar(20) | 否 | - | 平台 |
| Status | int | 是 | 1 | 状态：0失败 1成功 |
| FailReason | nvarchar(200) | 否 | - | 失败原因 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |

---

### 2.2 内容管理模块

#### 2.2.1 banners（轮播图表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Title | nvarchar(100) | 否 | - | 标题 |
| ImageUrl | nvarchar(500) | 是 | - | 图片URL |
| LinkType | int | 是 | 0 | 跳转类型：0无 1内部页面 2外部链接 3小程序 |
| LinkUrl | nvarchar(500) | 否 | - | 跳转地址 |
| AppId | nvarchar(50) | 否 | - | 小程序AppId |
| Sort | int | 是 | 0 | 排序，越大越靠前 |
| Status | int | 是 | 1 | 状态：0禁用 1启用 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

#### 2.2.2 promotions（宣传图表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Title | nvarchar(100) | 否 | - | 标题 |
| ImageUrl | nvarchar(500) | 是 | - | 图片URL |
| Position | int | 是 | 1 | 位置：1首页底部 2团队页 |
| Sort | int | 是 | 0 | 排序 |
| Status | int | 是 | 1 | 状态：0禁用 1启用 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

---

### 2.3 测评模块

#### 2.3.1 AssessmentType（测评类型表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Name | nvarchar(50) | 是 | - | 测评名称 |
| Code | nvarchar(50) | 是 | - | 测评编码，如 MI（多元智能） |
| ImageUrl | nvarchar(500) | 是 | - | 入口图片 |
| IntroContent | nvarchar(max) | 否 | - | 介绍内容（富文本/图片） |
| Price | decimal(10,2) | 是 | 0 | 价格 |
| QuestionCount | int | 是 | 80 | 题目数量 |
| Sort | int | 是 | 0 | 排序 |
| Status | int | 是 | 1 | 状态：0已下线 1已上线 2即将上线 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

#### 2.3.2 Question（题目表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| AssessmentTypeId | bigint | 是 | - | 测评类型ID |
| QuestionNo | int | 是 | - | 题号 |
| Content | nvarchar(1000) | 是 | - | 题目内容 |
| Sort | int | 是 | 0 | 排序 |
| Status | int | 是 | 1 | 状态：0禁用 1启用 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_Question_AssessmentTypeId (AssessmentTypeId)
- UK_Question_TypeNo (AssessmentTypeId, QuestionNo) UNIQUE

#### 2.3.3 ReportCategory（报告分类表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| AssessmentTypeId | bigint | 是 | - | 测评类型ID |
| ParentId | bigint | 否 | 0 | 父分类ID，0为顶级 |
| Name | nvarchar(50) | 是 | - | 分类名称 |
| Code | nvarchar(50) | 是 | - | 分类编码 |
| CategoryType | int | 是 | - | 分类类型：1八大智能 2个人特质 3细分能力 4先天学习 5学习能力 6大脑类型 7性格类型 8未来能力 |
| ScoreRule | int | 是 | 1 | 计分规则：1累加(1-10分) 2二值(0/1分) |
| Sort | int | 是 | 0 | 排序 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_ReportCategory_AssessmentTypeId (AssessmentTypeId)
- IX_ReportCategory_ParentId (ParentId)

#### 2.3.4 QuestionCategoryMapping（题目分类映射表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| QuestionId | bigint | 是 | - | 题目ID |
| CategoryId | bigint | 是 | - | 分类ID |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |

**索引**：
- IX_QuestionCategoryMapping_QuestionId (QuestionId)
- IX_QuestionCategoryMapping_CategoryId (CategoryId)
- UK_QuestionCategoryMapping (QuestionId, CategoryId) UNIQUE

#### 2.3.5 ReportConclusion（报告结论表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| CategoryId | bigint | 是 | - | 分类ID |
| ConclusionType | int | 是 | - | 结论类型：1最强 2较强 3较弱 4最弱 |
| Title | nvarchar(100) | 否 | - | 结论标题 |
| Content | nvarchar(max) | 是 | - | 结论内容（富文本） |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_ReportConclusion_CategoryId (CategoryId)


---

### 2.4 测评记录模块

#### 2.4.1 AssessmentRecord（测评记录表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| UserId | bigint | 是 | - | 用户ID |
| OrderId | bigint | 是 | - | 订单ID |
| AssessmentTypeId | bigint | 是 | - | 测评类型ID |
| Name | nvarchar(50) | 是 | - | 测评人姓名 |
| Phone | nvarchar(20) | 是 | - | 手机号 |
| Gender | int | 是 | - | 性别：1男 2女 |
| Age | int | 是 | - | 年龄 |
| EducationStage | int | 是 | - | 学业阶段：1小学及以下 2初中 3高中 4大专 5本科 6研究生及以上 |
| Province | nvarchar(50) | 是 | - | 省份 |
| City | nvarchar(50) | 是 | - | 城市 |
| District | nvarchar(50) | 是 | - | 区县 |
| Status | int | 是 | 1 | 状态：1待测评 2测评中 3生成中 4已完成 |
| StartTime | datetime2 | 否 | - | 开始答题时间 |
| SubmitTime | datetime2 | 否 | - | 提交答题时间 |
| CompleteTime | datetime2 | 否 | - | 报告生成完成时间 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_AssessmentRecord_UserId (UserId)
- IX_AssessmentRecord_OrderId (OrderId)
- IX_AssessmentRecord_Status (Status)

#### 2.4.2 AssessmentAnswer（测评答案表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| RecordId | bigint | 是 | - | 测评记录ID |
| QuestionId | bigint | 是 | - | 题目ID |
| QuestionNo | int | 是 | - | 题号 |
| AnswerValue | int | 是 | - | 答案值（1-10） |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |

**索引**：
- IX_AssessmentAnswer_RecordId (RecordId)
- UK_AssessmentAnswer (RecordId, QuestionId) UNIQUE

#### 2.4.3 AssessmentResult（测评结果表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| RecordId | bigint | 是 | - | 测评记录ID |
| CategoryId | bigint | 是 | - | 分类ID |
| Score | decimal(10,2) | 是 | - | 得分 |
| MaxScore | decimal(10,2) | 是 | - | 满分 |
| Percentage | decimal(5,2) | 是 | - | 百分比 |
| Rank | int | 是 | - | 排名（同类型内） |
| StarLevel | int | 是 | - | 星级（1-5） |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |

**索引**：
- IX_AssessmentResult_RecordId (RecordId)
- IX_AssessmentResult_CategoryId (CategoryId)


---

### 2.5 订单模块

#### 2.5.1 orders（订单表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| OrderNo | nvarchar(32) | 是 | - | 订单编号 |
| UserId | bigint | 是 | - | 用户ID |
| OrderType | int | 是 | - | 订单类型：1测评订单 2学业规划订单 |
| ProductId | bigint | 是 | - | 商品ID（测评类型ID/规划师ID） |
| ProductName | nvarchar(100) | 是 | - | 商品名称 |
| Amount | decimal(10,2) | 是 | - | 订单金额 |
| PayAmount | decimal(10,2) | 是 | - | 实付金额 |
| PayType | int | 否 | - | 支付方式：1微信支付 2邀请码 |
| InviteCodeId | bigint | 否 | - | 使用的邀请码ID |
| Status | int | 是 | 1 | 状态：1待支付 2已支付 3已完成 4退款中 5已退款 6已取消 |
| PayTime | datetime2 | 否 | - | 支付时间 |
| TransactionId | nvarchar(64) | 否 | - | 微信支付交易号 |
| RefundTime | datetime2 | 否 | - | 退款时间 |
| RefundAmount | decimal(10,2) | 否 | - | 退款金额 |
| RefundReason | nvarchar(500) | 否 | - | 退款原因 |
| Remark | nvarchar(500) | 否 | - | 备注 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- UK_orders_order_no (OrderNo) UNIQUE
- IX_orders_user_id (UserId)
- IX_orders_status (Status)
- IX_orders_create_time (CreateTime)
- IX_orders_order_type (OrderType)

#### 2.5.2 order_notifies（订单通知表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| OrderNo | nvarchar(64) | 是 | - | 订单编号 |
| TransactionId | nvarchar(64) | 否 | - | 微信交易号 |
| NotifyUrl | nvarchar(500) | 否 | - | 通知URL |
| NonceStr | nvarchar(64) | 否 | - | 随机字符串 |
| PayTime | datetime2 | 否 | - | 支付时间 |
| PayAmount | decimal(10,2) | 是 | 0 | 支付金额 |
| Status | int | 是 | 0 | 状态：0待处理 1已处理 |
| RetryCount | int | 是 | 0 | 重试次数 |
| Attach | nvarchar(100) | 否 | - | 附加数据 |
| OpenId | nvarchar(100) | 否 | - | 支付者OpenId |
| RawData | nvarchar(max) | 否 | - | 原始数据 |
| ErrorMessage | nvarchar(500) | 否 | - | 错误信息 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |

---

### 2.6 学业规划模块

#### 2.6.1 Planner（规划师表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Name | nvarchar(50) | 是 | - | 姓名 |
| Avatar | nvarchar(500) | 是 | - | 头像 |
| Introduction | nvarchar(1000) | 否 | - | 简介 |
| Price | decimal(10,2) | 是 | - | 咨询价格 |
| Sort | int | 是 | 0 | 排序 |
| Status | int | 是 | 1 | 状态：0禁用 1启用 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

#### 2.6.2 PlannerBooking（规划预约表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| UserId | bigint | 是 | - | 用户ID |
| OrderId | bigint | 是 | - | 订单ID |
| PlannerId | bigint | 是 | - | 规划师ID |
| BookingDate | date | 是 | - | 预约日期 |
| BookingTime | nvarchar(20) | 是 | - | 预约时间，如"15:00" |
| Name | nvarchar(50) | 是 | - | 姓名 |
| Phone | nvarchar(20) | 是 | - | 手机号 |
| Gender | int | 是 | - | 性别：1男 2女 |
| Grade | int | 是 | - | 年级：1小学 2初中 3高中 4大专 5本科 6研究生及以上 |
| MajorName | nvarchar(100) | 否 | - | 专业名称（大专及以上） |
| ScoreChinese | int | 否 | - | 语文成绩 |
| ScoreMath | int | 否 | - | 数学成绩 |
| ScoreEnglish | int | 否 | - | 英语成绩 |
| ScorePhysics | int | 否 | - | 物理成绩 |
| ScoreChemistry | int | 否 | - | 化学成绩 |
| ScoreBiology | int | 否 | - | 生物成绩 |
| ScoreGeography | int | 否 | - | 地理成绩 |
| ScorePolitics | int | 否 | - | 政治成绩 |
| Status | int | 是 | 1 | 状态：1待确认 2已确认 3已完成 4已取消 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_PlannerBooking_UserId (UserId)
- IX_PlannerBooking_PlannerId (PlannerId)
- IX_PlannerBooking_BookingDate (BookingDate)


---

### 2.7 分销模块

#### 2.7.1 InviteCode（邀请码表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| Code | nvarchar(10) | 是 | - | 邀请码（5位大写字母） |
| BatchNo | nvarchar(32) | 否 | - | 批次号 |
| AssignUserId | bigint | 否 | - | 分配给的用户ID（合伙人） |
| AssignTime | datetime2 | 否 | - | 分配时间 |
| UseUserId | bigint | 否 | - | 使用者用户ID |
| UseOrderId | bigint | 否 | - | 使用的订单ID |
| UseTime | datetime2 | 否 | - | 使用时间 |
| Status | int | 是 | 1 | 状态：1未分配 2已分配 3已使用 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- UK_InviteCode_Code (Code) UNIQUE
- IX_InviteCode_AssignUserId (AssignUserId)
- IX_InviteCode_Status (Status)

#### 2.7.2 Commission（佣金记录表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| UserId | bigint | 是 | - | 获得佣金的用户ID |
| FromUserId | bigint | 是 | - | 来源用户ID（下级） |
| OrderId | bigint | 是 | - | 关联订单ID |
| OrderAmount | decimal(10,2) | 是 | - | 订单金额 |
| CommissionRate | decimal(5,2) | 是 | - | 佣金比例（如30.00表示30%） |
| CommissionAmount | decimal(10,2) | 是 | - | 佣金金额 |
| Level | int | 是 | - | 层级：1直接下级 2间接下级 |
| Status | int | 是 | 1 | 状态：1待结算 2已结算 |
| SettleTime | datetime2 | 否 | - | 结算时间 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- IX_Commission_UserId (UserId)
- IX_Commission_FromUserId (FromUserId)
- IX_Commission_OrderId (OrderId)

#### 2.7.3 Withdrawal（提现记录表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| WithdrawalNo | nvarchar(32) | 是 | - | 提现单号 |
| UserId | bigint | 是 | - | 用户ID |
| Amount | decimal(10,2) | 是 | - | 提现金额 |
| BeforeBalance | decimal(10,2) | 是 | - | 提现前余额 |
| AfterBalance | decimal(10,2) | 是 | - | 提现后余额 |
| Status | int | 是 | 1 | 状态：1申请中 2提现中 3已提现 4已取消 |
| AuditUserId | bigint | 否 | - | 审核人ID |
| AuditTime | datetime2 | 否 | - | 审核时间 |
| AuditRemark | nvarchar(500) | 否 | - | 审核备注 |
| PayTime | datetime2 | 否 | - | 打款时间 |
| PayTransactionId | nvarchar(64) | 否 | - | 打款交易号 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- UK_Withdrawal_WithdrawalNo (WithdrawalNo) UNIQUE
- IX_Withdrawal_UserId (UserId)
- IX_Withdrawal_Status (Status)


---

### 2.8 系统配置模块

#### 2.8.1 configs（系统配置表）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| Id | bigint | 是 | 自增 | 主键 |
| ConfigKey | nvarchar(100) | 是 | - | 配置键 |
| ConfigValue | nvarchar(max) | 是 | - | 配置值 |
| ConfigType | nvarchar(50) | 是 | - | 配置类型 |
| Description | nvarchar(500) | 否 | - | 描述 |
| Sort | int | 是 | 0 | 排序 |
| CreateTime | datetime2 | 是 | GETDATE() | 创建时间 |
| UpdateTime | datetime2 | 是 | GETDATE() | 更新时间 |
| IsDeleted | bit | 是 | 0 | 软删除 |

**索引**：
- UK_configs_key (ConfigKey) UNIQUE

**预置配置项**：
| ConfigKey | ConfigType | 说明 |
|---|---|---|
| assessment_price | price | 测评价格 |
| commission_rate_level1 | commission | 一级佣金比例 |
| commission_rate_level2 | commission | 二级佣金比例 |
| commission_rate_direct | commission | 无上级时直接佣金比例 |
| withdraw_min_amount | withdraw | 最低提现金额 |
| service_phone | contact | 客服电话 |
| service_wechat | contact | 客服微信 |
| user_agreement | agreement | 用户协议内容 |
| privacy_policy | agreement | 隐私政策内容 |
| about_us_content | content | 关于我们内容 |

---

## 三、ER关系图

```
┌─────────────┐     ┌─────────────────┐     ┌─────────────┐
│    User     │────<│      Order      │>────│ InviteCode  │
└─────────────┘     └─────────────────┘     └─────────────┘
      │                     │
      │                     │
      ▼                     ▼
┌─────────────┐     ┌─────────────────┐
│ Commission  │     │AssessmentRecord │
└─────────────┘     └─────────────────┘
      │                     │
      │                     │
      ▼                     ▼
┌─────────────┐     ┌─────────────────┐     ┌─────────────┐
│ Withdrawal  │     │AssessmentAnswer │     │AssessmentResult│
└─────────────┘     └─────────────────┘     └─────────────┘
                           │                       │
                           │                       │
                           ▼                       ▼
                    ┌─────────────┐         ┌─────────────┐
                    │  Question   │────────>│ReportCategory│
                    └─────────────┘         └─────────────┘
                           │                       │
                           │                       │
                           ▼                       ▼
                    ┌─────────────────────┐ ┌─────────────┐
                    │QuestionCategoryMapping│ │ReportConclusion│
                    └─────────────────────┘ └─────────────┘
```

---

## 四、核心业务关系说明

### 4.1 用户与分销关系
```
User.ParentUserId -> User.Id  （自关联，上下级关系）
Commission.UserId -> User.Id  （佣金归属）
Commission.FromUserId -> User.Id  （佣金来源）
```

### 4.2 测评流程关系
```
Order -> AssessmentRecord -> AssessmentAnswer -> Question
                         -> AssessmentResult -> ReportCategory -> ReportConclusion
```

### 4.3 题目与分类映射
```
Question <-> QuestionCategoryMapping <-> ReportCategory
（多对多关系：一道题可属于多个分类，一个分类包含多道题）
```

---

## 五、数据字典

### 5.1 用户等级 (UserLevel)
| 值 | 说明 |
|---|---|
| 1 | 普通用户 |
| 2 | 合伙人 |
| 3 | 渠道合伙人 |

### 5.2 订单类型 (OrderType)
| 值 | 说明 |
|---|---|
| 1 | 测评订单 |
| 2 | 学业规划订单 |

### 5.3 订单状态 (Order.Status)
| 值 | 说明 |
|---|---|
| 1 | 待支付 |
| 2 | 已支付 |
| 3 | 已完成 |
| 4 | 退款中 |
| 5 | 已退款 |
| 6 | 已取消 |

### 5.4 测评记录状态 (AssessmentRecord.Status)
| 值 | 说明 |
|---|---|
| 1 | 待测评 |
| 2 | 测评中 |
| 3 | 生成中 |
| 4 | 已完成 |

### 5.5 报告分类类型 (ReportCategory.CategoryType)
| 值 | 说明 |
|---|---|
| 1 | 八大智能 |
| 2 | 个人特质 |
| 3 | 细分能力 |
| 4 | 先天学习类型 |
| 5 | 学习关键能力 |
| 6 | 科学大脑类型 |
| 7 | 性格类型 |
| 8 | 未来发展能力 |

### 5.6 计分规则 (ReportCategory.ScoreRule)
| 值 | 说明 |
|---|---|
| 1 | 累加计分（选项1-10对应1-10分） |
| 2 | 二值计分（选项1-5得0分，6-10得1分） |

### 5.7 结论类型 (ReportConclusion.ConclusionType)
| 值 | 说明 |
|---|---|
| 1 | 最强 |
| 2 | 较强 |
| 3 | 较弱 |
| 4 | 最弱 |

### 5.8 邀请码状态 (InviteCode.Status)
| 值 | 说明 |
|---|---|
| 1 | 未分配 |
| 2 | 已分配 |
| 3 | 已使用 |

### 5.9 提现状态 (Withdrawal.Status)
| 值 | 说明 |
|---|---|
| 1 | 申请中 |
| 2 | 提现中 |
| 3 | 已提现 |
| 4 | 已取消 |

### 5.10 学业阶段 (EducationStage)
| 值 | 说明 |
|---|---|
| 1 | 小学及以下 |
| 2 | 初中 |
| 3 | 高中 |
| 4 | 大专 |
| 5 | 本科 |
| 6 | 研究生及以上 |


---

## 六、表汇总

| 序号 | 表名 | 说明 | 模块 |
|---|---|---|---|
| 1 | users | 用户表 | 用户模块 |
| 2 | user_refresh_tokens | 刷新令牌表 | 用户模块 |
| 3 | user_login_logs | 登录日志表 | 用户模块 |
| 4 | banners | 轮播图表 | 内容管理 |
| 5 | promotions | 宣传图表 | 内容管理 |
| 6 | assessment_types | 测评类型表 | 测评模块 |
| 7 | questions | 题目表 | 测评模块 |
| 8 | report_categories | 报告分类表 | 测评模块 |
| 9 | question_category_mappings | 题目分类映射表 | 测评模块 |
| 10 | report_conclusions | 报告结论表 | 测评模块 |
| 11 | orders | 订单表 | 订单模块 |
| 12 | order_notifies | 订单通知表 | 订单模块 |
| 13 | assessment_records | 测评记录表 | 测评记录 |
| 14 | assessment_answers | 测评答案表 | 测评记录 |
| 15 | assessment_results | 测评结果表 | 测评记录 |
| 16 | planners | 规划师表 | 学业规划 |
| 17 | planner_bookings | 规划预约表 | 学业规划 |
| 18 | invite_codes | 邀请码表 | 分销模块 |
| 19 | commissions | 佣金记录表 | 分销模块 |
| 20 | withdrawals | 提现记录表 | 分销模块 |
| 21 | configs | 系统配置表 | 系统配置 |

**共计 21 张业务表**

---

## 七、初始化数据

### 7.1 系统配置初始数据
```sql
INSERT INTO configs (ConfigKey, ConfigValue, ConfigType, Description)
VALUES 
('assessment_price', '99.00', 'price', N'测评价格'),
('commission_rate_level1', '0.30', 'commission', N'一级分销佣金比例'),
('commission_rate_level2', '0.10', 'commission', N'二级分销佣金比例'),
('commission_rate_direct', '0.40', 'commission', N'无上级时直接佣金比例'),
('withdraw_min_amount', '10.00', 'withdraw', N'最低提现金额'),
('service_phone', '400-000-0000', 'contact', N'客服电话'),
('service_wechat', '', 'contact', N'客服微信'),
('user_agreement', '', 'agreement', N'用户协议内容'),
('privacy_policy', '', 'agreement', N'隐私政策内容'),
('about_us_content', '', 'content', N'关于我们内容');
```

### 7.2 测评类型初始数据
```sql
INSERT INTO assessment_types (Name, Code, Price, QuestionCount, Sort, Status)
VALUES (N'多元智能测评', 'MI_ASSESSMENT', 99.00, 80, 1, 1);
```

---

## 八、备注

### 8.1 性能优化建议
1. 对高频查询字段建立索引
2. 大文本字段（如报告结论）考虑分表存储
3. 历史数据定期归档

### 8.2 扩展预留
1. User 表预留 UnionId 字段，支持多端打通
2. Order 表预留 Remark 字段，支持业务扩展
3. SystemConfig 表支持动态配置扩展

### 8.3 安全考虑
1. 手机号等敏感信息加密存储
2. 支付相关字段记录完整交易信息
3. 软删除保留数据可追溯