zhjwxt/niucloud/databasedoc/school_personnel.md

school_personnel 表文档

表概述

表名: school_personnel
功能: 人员信息管理表，存储教务系统中所有工作人员（教师、销售、教务等）的基本信息、系统账号关联、微信绑定等核心数据

字段说明

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	姓名
head_img	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	头像
gender	tinyint(1)	NULL	NO		0		select,insert,update,references	性别：1男性，2女性 0不详
birthday	date	NULL	YES		NULL		select,insert,update,references	生日
phone	varchar(15)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	电话
email	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	邮箱
wx	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	微信号
address	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	家庭住址
native_place	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	祖籍
education	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	学历
profile	text	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	个人简介
emergency_contact_phone	varchar(15)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	应急联系人电话
id_card_front	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	身份证正面
id_card_back	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	身份证反面
employee_number	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	员工编号
status	tinyint(1)	NULL	NO		1		select,insert,update,references	状态：1待审核，2已审核，0已禁用
is_sys_user	tinyint(1)	NULL	NO		NULL		select,insert,update,references	是否登录系统
sys_user_id	int	NULL	YES		NULL		select,insert,update,references	系统用户id
account_type	varchar(255)	utf8mb4_0900_ai_ci	NO		NULL		select,insert,update,references	账号类型(前端用来登录时确认订单身份的标识)|teacher=老师,market=销售
create_time	datetime	NULL	NO		NULL		select,insert,update,references	创建时间
update_time	datetime	NULL	YES		NULL		select,insert,update,references	更新时间
deleted_at	varchar(255)	utf8mb4_0900_ai_ci	NO		0		select,insert,update,references	逻辑删除字段
join_time	datetime	NULL	YES		NULL		select,insert,update,references	入职时间
work_call	varchar(255)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	职称
wxminiopenid	varchar(52)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	微信小程序 openid
wxgzhopenid	varchar(52)	utf8mb4_0900_ai_ci	YES		NULL		select,insert,update,references	微信公众号 openid

功能用途

主要功能

1. 人员基础管理: 存储员工姓名、性别、生日、联系方式等基本信息
2. 身份证件管理: 管理身份证正反面照片，用于实名认证
3. 系统账号关联: 通过sys_user_id关联系统登录账号
4. 账号类型管理: 区分教师(teacher)和销售(market)等不同角色
5. 微信集成: 支持微信小程序和公众号openid绑定
6. 状态审核管理: 人员状态审核流程（待审核、已审核、已禁用）
7. 员工档案管理: 学历、简介、入职时间等档案信息

业务场景

1. 员工入职: 新员工信息录入、身份验证、账号开通
2. 权限管理: 根据account_type分配不同的系统权限
3. 排课安排: 教师人员参与课程安排和班级管理
4. 销售管理: 销售人员进行客户跟进和业绩统计
5. 微信办公: 通过微信小程序进行移动办公
6. 人事管理: 员工档案维护、状态变更、离职处理
7. 应急联系: 紧急情况下的员工联系和通知

关联关系

主要关联表

1. sys_user: 系统用户表（sys_user_id字段关联）
2. school_class: 班级表（head_coach, assistant_coach关联）
3. school_schedule: 排课表（教师排课关联）
4. school_order: 订单表（销售人员关联）
5. school_teacher_course: 教师课程关联表
6. school_campus: 校区表（人员所属校区）
7. school_member: 会员表（销售跟进关联）
8. school_performance: 业绩表（销售业绩统计）

关联说明

1. 系统账号关联: 通过sys_user_id与系统登录账号一对一关联
2. 教学关联: 教师与班级、课程、排课等教学资源关联
3. 销售关联: 销售人员与客户、订单、业绩等销售数据关联
4. 微信关联: 通过openid实现微信生态集成
5. 校区关联: 人员归属特定校区，支持多校区管理
6. 角色关联: account_type决定人员在系统中的角色和权限

索引建议

1. 主键索引: id（已存在）
2. 唯一索引:
   • phone（手机号唯一）
   • employee_number（员工编号唯一）
   • sys_user_id（系统用户ID唯一）
   • wxminiopenid（微信小程序openid唯一）
   • wxgzhopenid（微信公众号openid唯一）
3. 普通索引:
   • account_type（账号类型筛选）
   • status（状态筛选）
   • create_time（创建时间排序）
   • join_time（入职时间排序）
4. 复合索引:
   • (account_type, status)（类型+状态查询）
   • (status, join_time)（状态+入职时间查询）

注意事项

1. 数据安全: 身份证照片等敏感信息需要加密存储
2. 唯一性约束: 手机号、员工编号、系统用户ID等需要保证唯一性
3. 软删除: 使用deleted_at字段实现软删除，保护历史数据
4. 状态流转: status状态变更需要记录操作日志
5. 账号类型: account_type变更需要同步更新系统权限
6. 微信绑定: openid绑定需要验证微信账号的有效性
7. 系统关联: sys_user_id关联需要确保系统用户的存在性
8. 应急联系: emergency_contact_phone字段在紧急情况下的重要性