129 lines
6.0 KiB
Markdown
129 lines
6.0 KiB
Markdown
# 学生退学、休学、毕业处理总览
|
||
|
||
## 📋 概述
|
||
|
||
本文档基于校园管理系统(hzdyjs_xg)的数据库表结构和业务逻辑分析，总结了学生退学、休学、毕业时需要处理的业务模块和数据变更。
|
||
|
||
本文档采用模块化组织方式，将详细的处理内容拆分到各个分文档中，便于查阅和维护。
|
||
|
||
## 📚 文档结构
|
||
|
||
### 📋 核心指导文档
|
||
- **[01-核心状态修改.md](01-核心状态修改.md)** - 学生学籍状态、用户登录状态
|
||
- **[02-组织关系处理.md](02-组织关系处理.md)** - 班级干部信息、社团成员关系
|
||
- **[03-经济资助处理.md](03-经济资助处理.md)** - 非核心业务，已简化处理
|
||
- **[04-其他业务处理.md](04-其他业务处理.md)** - 住宿管理退宿处理
|
||
|
||
### 🛠️ 实施文档
|
||
- **[06-完整SQL脚本.md](06-完整SQL脚本.md)** - 完整的数据库处理脚本和事务管理
|
||
- **[07-快速执行脚本.md](07-快速执行脚本.md)** - 快速执行的简化脚本和批量处理
|
||
|
||
## 🔍 业务逻辑分析
|
||
|
||
通过分析数据库表结构、外键关系、字段定义和索引设计，可以推断出以下业务规则：
|
||
|
||
### 核心业务特征
|
||
1. **工作流驱动**: 大部分业务模块都涉及审批流程（奖学金、勤工俭学、宿舍等）
|
||
2. **批次管理**: 奖学金等业务按批次进行管理
|
||
3. **状态流转**: 各业务模块有明确的生命周期状态
|
||
4. **关联处理**: 学生状态变更需要联动处理多个相关业务
|
||
5. **数据完整性**: 通过外键约束确保数据一致性
|
||
|
||
### 处理原则
|
||
- **状态一致性**: 确保学生状态变更后，各业务模块状态保持逻辑一致
|
||
- **流程终止**: 终止进行中的审批流程，避免业务悬空
|
||
- **数据追溯**: 保留历史记录，便于审计和分析
|
||
- **业务连续性**: 考虑不同状态变更类型的差异化处理
|
||
|
||
## 🎯 处理流程概览
|
||
|
||
学生退学、休学、毕业处理涉及多个业务模块的联动更新，具体处理内容请参考各分文档：
|
||
|
||
### 📋 处理步骤
|
||
1. **确定变更类型**: 休学(XIU_XUE)/退学(TUI_XUE)/复学(FU_XUE)/毕业(BI_YE)
|
||
2. **创建状态变更记录**: 插入 `xg_student_status_change` 表记录
|
||
3. **备份原始数据**: 将相关表数据备份到对应的his表
|
||
4. **核心状态修改**: 更新 `xg_student_msg.student_status` 和 `sys_user.status`
|
||
5. **组织关系处理**: 处理班级干部、社团成员等关系变更（仅退学、休学、毕业时）
|
||
6. **住宿管理处理**: 处理宿舍退宿（仅退学、毕业时）
|
||
7. **更新处理状态**: 将 `xg_student_status_change.process_status` 设为1
|
||
8. **数据验证**: 确保所有相关数据已正确处理
|
||
|
||
### 🔄 状态映射关系
|
||
- **休学**: `student_status='2'`，`sys_user.status='1'`，终止组织关系
|
||
- **退学**: `student_status='4'`，`sys_user.status='1'`，终止组织关系和住宿
|
||
- **复学**: `student_status='3'`，`sys_user.status='0'`，恢复账号
|
||
- **毕业**: `student_status='5'`，`sys_user.status='1'`，终止组织关系和住宿
|
||
|
||
### 🏗️ 技术架构
|
||
基于代码分析，主要涉及以下技术组件：
|
||
- **核心实体**:
|
||
- `XgStudentMsg`: 学生基本信息实体
|
||
- `XgStudentStatusChange`: 学生状态变更记录实体
|
||
- `XgClassPosMsg`: 班级干部信息实体
|
||
- `ClubMember`: 社团成员关系实体
|
||
- `StglMember`: 志愿者成员关系实体
|
||
- `XgDormBedStudent`: 宿舍床位分配实体
|
||
- **业务服务**:
|
||
- `XgStudentStatusChangeServiceImpl`: 学生状态变更服务
|
||
- `XgClassPosMsgServiceImpl`: 班级干部管理服务
|
||
- `XgDormBedStudentServiceImpl`: 宿舍管理服务
|
||
- **数据访问**: MyBatis-Plus Mapper接口和XML配置
|
||
- **事务管理**: Spring `@Transactional` 声明式事务
|
||
- **状态机**: 通过状态字段值变化实现业务状态流转
|
||
- **his表备份**: 所有数据修改前自动备份到历史表
|
||
|
||
### 🎯 业务处理策略
|
||
- ✅ **核心状态**: 必须修改（学籍状态+用户账号状态）
|
||
- ✅ **his表备份**: 所有修改前备份原始数据
|
||
- ✅ **组织关系**: 退学、休学、毕业时解除干部和社团关系
|
||
- ✅ **住宿管理**: 退学、毕业时处理退宿
|
||
- ✅ **复学处理**: 仅涉及核心状态恢复
|
||
|
||
## 📊 数据库表统计
|
||
|
||
涉及的数据库表总数：**8个核心表**
|
||
|
||
| 模块 | 涉及表数量 | 重要程度 | 核心表名 |
|
||
|------|-----------|----------|----------|
|
||
| 核心状态管理 | 3 | ⭐⭐⭐⭐⭐ | `xg_student_msg`, `sys_user`, `xg_student_status_change` |
|
||
| 组织关系 | 3 | ⭐⭐⭐⭐⭐ | `xg_class_pos_msg`, `club_member`, `stgl_member` |
|
||
| 住宿管理 | 2 | ⭐⭐⭐⭐⭐ | `xg_dorm_bed_student`, `xg_dorm_bed` |
|
||
| his表备份 | 8 | ⭐⭐⭐⭐⭐ | 各主表对应的his表 |
|
||
|
||
## ⚠️ 重要注意事项
|
||
|
||
1. **数据备份**: 操作前务必备份相关数据
|
||
2. **事务处理**: 建议使用数据库事务确保数据一致性
|
||
3. **权限控制**: 确保操作人员具有相应权限
|
||
4. **日志记录**: 记录所有操作日志便于审计
|
||
5. **业务沟通**: 与相关部门沟通确认处理方案
|
||
|
||
## 🔄 系统集成考虑
|
||
- **审批流程**: 终止相关工作流
|
||
- **权限清理**: 清理角色权限
|
||
- **数据同步**: 确保各模块一致性
|
||
- **业务连续性**: 避免遗留问题
|
||
|
||
## 📚 快速开始
|
||
|
||
### 💡 使用指南
|
||
1. **确定变更类型**: 根据具体业务场景选择休学/退学/毕业
|
||
2. **查阅分文档**: 根据需要处理的业务模块查阅相应分文档
|
||
3. **执行处理**: 按分文档中的SQL脚本或业务逻辑进行处理
|
||
4. **验证结果**: 使用提供的验证脚本确认处理结果
|
||
5. **记录日志**: 确保所有操作都有完整的审计记录
|
||
|
||
---
|
||
|
||
## 📅 更新记录
|
||
|
||
- **2025-01-XX**: 初稿完成
|
||
- **2025-01-XX**: 添加完整SQL处理脚本
|
||
- **2025-12-XX**: 文档模块化拆分，将详细内容分离到分文档中
|
||
- **后续更新**: 根据实际业务需求持续完善
|
||
|
||
---
|
||
|
||
*本文档基于hzdyjs_xg校园管理系统数据库结构分析整理，采用模块化组织方式，详细处理内容请参考各分文档。*
|