# 学生换班级记录表设计说明

## 📋 文档说明

**版本**: v1.0.0
**制定时间**: 2025-01-25
**适用范围**: 学生换班级业务模块
**重要性**: ⚠️ **核心业务表** - 记录所有学生换班级操作的历史数据

---

## 🎯 设计目标

### 1. 业务需求

- **记录完整历史**: 记录学生换班级的完整过程和历史数据
- **支持审批流程**: 包含换班级的申请、审批、执行全流程
- **数据追溯**: 提供完整的换班级操作审计和追溯能力
- **业务统计**: 支持换班级数据的统计分析和报表生成

### 2. 技术要求

- **数据完整性**: 遵循项目数据库设计规范
- **性能优化**: 合理的索引设计，支持高效查询
- **扩展性**: 预留扩展字段，支持未来功能需求
- **安全性**: 多租户隔离，完整的审计追踪

---

## 🗄️ 表结构设计

### 表名：`xg_student_class_change`

### 字段分类说明

#### 🔴 强制基础字段（必须）

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `id` | bigint(20) | - | 主键ID（雪花ID） |
| `tenant_id` | varchar(20) | '000000' | 租户编号 |
| `create_dept` | bigint(20) | NULL | 创建部门 |
| `create_by` | bigint(20) | NULL | 创建者 |
| `create_time` | datetime | NULL | 创建时间 |
| `update_by` | bigint(20) | NULL | 更新者 |
| `update_time` | datetime | NULL | 更新时间 |
| `deleted` | tinyint(1) | 0 | 删除标志（0存在 1删除） |

#### 👤 学生基本信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `student_id` | bigint(20) | - | 学生ID，关联xg_student_msg.id |
| `student_no` | varchar(32) | - | 学号 |
| `student_name` | varchar(50) | - | 学生姓名 |

#### 📚 原班级信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `original_college_id` | bigint(20) | NULL | 原学院ID，关联sys_dept.dept_id |
| `original_college_name` | varchar(100) | NULL | 原学院名称 |
| `original_major_id` | bigint(20) | NULL | 原专业ID，关联xg_major_msg.id |
| `original_major_name` | varchar(100) | NULL | 原专业名称 |
| `original_class_id` | bigint(20) | NULL | 原班级ID，关联xg_class_msg.id |
| `original_class_code` | varchar(32) | NULL | 原班级代码 |
| `original_class_name` | varchar(100) | NULL | 原班级名称 |

#### 📚 新班级信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `new_college_id` | bigint(20) | NULL | 新学院ID，关联sys_dept.dept_id |
| `new_college_name` | varchar(100) | NULL | 新学院名称 |
| `new_major_id` | bigint(20) | NULL | 新专业ID，关联xg_major_msg.id |
| `new_major_name` | varchar(100) | NULL | 新专业名称 |
| `new_class_id` | bigint(20) | NULL | 新班级ID，关联xg_class_msg.id |
| `new_class_code` | varchar(32) | NULL | 新班级代码 |
| `new_class_name` | varchar(100) | NULL | 新班级名称 |

#### 🔄 换班级业务信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `change_reason` | varchar(500) | NULL | 换班级原因 |
| `change_type` | char(1) | '1' | 换班级类型：1-主动申请，2-学校调整，3-专业调整，4-其他 |
| `change_time` | datetime | NULL | 换班级时间 |
| `effective_time` | datetime | NULL | 生效时间 |
| `status` | char(1) | '0' | 处理状态：0-未处理，1-已处理 |

#### ✅ 审批流程信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `approval_status` | char(1) | '0' | 审批状态：0-待审批，1-审批通过，2-审批拒绝，3-已撤销 |
| `approval_by` | bigint(20) | NULL | 审批人ID |
| `approval_time` | datetime | NULL | 审批时间 |
| `approval_remarks` | varchar(500) | NULL | 审批备注 |

#### 📎 附件信息

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `attachment_ids` | text | NULL | 附件文件ID（逗号分隔） |

#### 📝 扩展字段

| 字段名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `remark` | varchar(500) | NULL | 备注 |

---

## 🔍 索引设计

### 基础索引（必须）

```sql
KEY `idx_tenant_id` (`tenant_id`),
KEY `idx_deleted` (`deleted`),
KEY `idx_create_time` (`create_time`),
KEY `idx_tenant_deleted` (`tenant_id`, `deleted`)
```

### 业务索引

```sql
KEY `idx_student_id` (`student_id`),
KEY `idx_student_no` (`student_no`),
KEY `idx_original_class_id` (`original_class_id`),
KEY `idx_new_class_id` (`new_class_id`),
KEY `idx_change_time` (`change_time`),
KEY `idx_effective_time` (`effective_time`),
KEY `idx_approval_status` (`approval_status`)
```

### 唯一约束

```sql
UNIQUE KEY `uk_student_change_time` (`student_id`, `change_time`, `tenant_id`, `deleted`)
```

---

## 🔄 业务流程

### 1. 换班级申请流程

```
学生申请 → 提交申请 → 管理员处理 → 执行换班级
```

### 2. 数据状态流转

```
未处理(0) → 已处理(1) → 执行换班级 → 生效
```

### 3. 换班级类型说明

| 类型代码 | 类型名称 | 说明 |
|----------|----------|------|
| 1 | 主动申请 | 学生主动提出换班级申请 |
| 2 | 学校调整 | 学校根据教学需要调整班级 |
| 3 | 专业调整 | 学生转专业导致班级变化 |
| 4 | 其他 | 其他特殊情况 |

---

## 📊 数据关联关系

### 关联表说明

- **xg_student_msg**: 学生信息表（通过student_id关联）
- **xg_class_msg**: 班级信息表（通过original_class_id、new_class_id关联）
- **xg_major_msg**: 专业信息表（通过original_major_id、new_major_id关联）
- **sys_dept**: 部门信息表（通过original_college_id、new_college_id关联）
- **sys_user**: 用户信息表（通过create_by、update_by、approval_by关联）

### 注意事项

⚠️ **不使用数据库外键约束**：所有关联关系通过应用层逻辑维护

---

## 📈 统计分析支持

### 支持的统计维度

1. **按时间统计**: 换班级数量趋势分析
2. **按原因统计**: 换班级原因分布统计
3. **按班级统计**: 各班级换班级情况统计
4. **按审批状态**: 换班级申请处理情况统计
5. **按操作人**: 换班级操作人员工作量统计

### 示例统计SQL

```sql
-- 按月份统计换班级数量
SELECT
    DATE_FORMAT(change_time, '%Y-%m') AS month,
    COUNT(*) AS change_count
FROM xg_student_class_change
WHERE deleted = 0 AND approval_status = '1'
GROUP BY DATE_FORMAT(change_time, '%Y-%m')
ORDER BY month;

-- 按原因统计换班级分布
SELECT
    change_type,
    COUNT(*) AS count
FROM xg_student_class_change
WHERE deleted = 0 AND approval_status = '1'
GROUP BY change_type;
```

---

## 🔒 安全考虑

### 数据安全

1. **多租户隔离**: 通过tenant_id实现数据隔离
2. **权限控制**: 基于角色的数据访问控制
3. **操作审计**: 完整的操作日志记录
4. **数据加密**: 敏感信息加密存储

### 业务安全

1. **审批流程**: 多级审批确保操作合规
2. **数据校验**: 换班级前进行业务规则校验
3. **操作限制**: 防止重复换班级和无效操作
4. **回滚机制**: 支持换班级操作的回滚

---

## 🚀 使用说明

### 数据插入规范

```sql
INSERT INTO xg_student_class_change (
    id, tenant_id, create_by, create_time,
    student_id, student_no, student_name,
    original_class_id, original_class_name,
    new_class_id, new_class_name,
    change_reason, change_type, change_time,
    approval_status
) VALUES (
    雪花ID, '000000', 操作人ID, NOW(),
    学生ID, '学号', '学生姓名',
    原班级ID, '原班级名称',
    新班级ID, '新班级名称',
    '换班级原因', '1', NOW(),
    '0'  -- 待审批状态
);
```

### 查询优化建议

1. **分页查询**: 大数据量时必须分页
2. **索引使用**: 充分利用业务索引提升查询性能
3. **关联查询**: 注意避免复杂的多表关联查询
4. **缓存策略**: 对常用数据进行适当缓存

---

## 📞 维护说明

### 定期维护任务

1. **数据清理**: 定期清理已删除的历史数据
2. **索引优化**: 定期检查和优化索引性能
3. **统计更新**: 定期更新统计数据
4. **备份策略**: 定期备份重要数据

### 扩展规划

1. **字段扩展**: 预留扩展字段用于未来需求
2. **流程优化**: 支持更复杂的审批流程
3. **自动化**: 支持自动换班级处理
4. **集成**: 与教务系统深度集成

---

## ⚠️ 重要提醒

1. **数据一致性**: 换班级操作必须确保数据的一致性
2. **业务规则**: 严格遵守学校的换班级管理规定
3. **审批流程**: 必须经过完整的审批流程
4. **文档同步**: 代码变更必须同步更新相关文档
5. **测试验证**: 新功能必须经过充分的测试验证

---

**最后更新**: 2025-01-25
**维护人员**: AI Assistant
**联系方式**: 项目技术团队