zhjwxt/niucloud/databasedoc/school_student.md

school_student 表文档

表概述

表名: school_student
功能: 学员信息管理表，用于存储和管理学员的基本信息、学习状态、关联关系等核心数据，是教务系统的核心业务表之一。

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	学员ID
name	varchar(255)	utf8mb4_0900_ai_ci	NO		NULL		select,insert,update,references	学员姓名
gender	tinyint	NULL	NO		NULL		select,insert,update,references	性别: 0未知, 1男, 2女
age	decimal(4,2)	NULL	YES		NULL		select,insert,update,references	年龄，支持小数表示，例如3.11表示3岁11个月
birthday	date	NULL	YES		NULL		select,insert,update,references	生日
user_id	int	NULL	NO		NULL		select,insert,update,references	资源ID
campus_id	int	NULL	YES		NULL		select,insert,update,references	校区ID
class_id	int	NULL	YES		NULL		select,insert,update,references	班级ID
note	text	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	备注信息
status	tinyint	NULL	NO		NULL		select,insert,update,references	学员状态: 0无效, 1有效，2 过期，3 结业
created_at	datetime	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	创建时间
updated_at	datetime	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	修改时间
deleted_at	int	NULL	NO		0		select,insert,update,references	逻辑删除时间
emergency_contact	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	紧急联系人
contact_phone	varchar(20)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	联系人电话
member_label	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	学员标签
consultant_id	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	顾问ID
coach_id	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	教练ID
trial_class_count	int	NULL	YES		0		select,insert,update,references	体验课次数|默认0
headimg	varchar(1000)	utf8mb4_general_ci	NO				select,insert,update,references	会员头像
first_come	timestamp	NULL	YES		NULL		select,insert,update,references	一访时间
second_come	timestamp	NULL	YES		NULL		select,insert,update,references	二访时间
created_person_id	int	NULL	YES		NULL		select,insert,update,references	首次创建人 id

功能用途

主要功能

1. 学员基础信息管理: 存储学员姓名、性别、年龄、生日等基本信息
2. 学员状态管理: 跟踪学员的学习状态（有效、无效、过期、结业）
3. 关联关系管理: 关联校区、班级、顾问、教练等相关信息
4. 联系信息管理: 存储紧急联系人、联系电话等重要联系方式
5. 学习跟踪: 记录体验课次数、访问时间等学习轨迹
6. 个性化标签: 支持学员标签分类和个性化管理
7. 数据完整性: 提供软删除和创建人追踪机制

业务场景

• 学员入学注册和信息录入
• 学员学习状态跟踪和管理
• 班级学员分配和调整
• 顾问和教练的学员分配
• 学员联系信息维护
• 体验课程安排和统计
• 学员标签分类和精准营销
• 学员学习轨迹分析

关联关系

直接关联表

1. school_campus: 通过campus_id字段关联学员所属校区
2. school_class: 通过class_id字段关联学员所在班级
3. school_sys_user: 通过consultant_id、coach_id关联顾问和教练
4. school_sys_user: 通过created_person_id关联创建人
5. school_user: 通过user_id字段关联用户资源信息

间接关联表

1. school_course: 通过班级间接关联课程信息
2. school_schedule: 通过班级间接关联课程安排
3. school_attendance: 通过学员ID关联考勤记录
4. school_fee: 通过学员ID关联费用记录
5. school_exam: 通过学员ID关联考试记录
6. school_homework: 通过学员ID关联作业记录

关联说明

• id字段作为主键，在多个业务表中作为student_id外键引用
• campus_id关联校区，实现多校区学员管理
• class_id关联班级，支持学员班级调整
• consultant_id和coach_id关联员工，实现责任制管理
• user_id关联用户资源，支持学员登录和在线学习
• 学员状态影响相关业务功能的可用性

索引建议

• 主键索引：id（自动创建）
• 普通索引：campus_id（按校区查询学员）
• 普通索引：class_id（按班级查询学员）
• 普通索引：status（按状态查询活跃学员）
• 普通索引：deleted_at（软删除查询）
• 复合索引：campus_id + status（查询校区活跃学员）
• 复合索引：class_id + status（查询班级活跃学员）
• 普通索引：consultant_id（按顾问查询学员）
• 普通索引：coach_id（按教练查询学员）
• 普通索引：created_at（按创建时间排序）

注意事项

1. 年龄字段: age使用decimal类型支持精确到月的年龄表示
2. 软删除: 使用deleted_at字段实现软删除，保护历史数据
3. 状态管理: status字段需要与业务流程保持一致，状态变更需要记录日志
4. 外键约束: campus_id、class_id等外键需要保证数据完整性
5. 联系信息: 紧急联系人和电话是重要安全信息，需要格式验证
6. 头像存储: headimg字段存储图片路径，需要配合文件服务
7. 访问时间: first_come和second_come用于跟踪学员访问轨迹
8. 体验课统计: trial_class_count需要与实际课程记录保持同步
9. 数据隐私: 学员个人信息需要符合数据保护法规
10. 批量操作: 大批量学员数据操作需要考虑性能影响