# 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字段在紧急情况下的重要性