6.1 KiB
6.1 KiB
代码调整记录 - 2025-01-23
📋 变更信息
| 项目 | 信息 |
|---|---|
| 变更时间 | 2025-01-23 14:30:00 |
| 变更人员 | Cursor AI |
| 变更类型 | 数据库表创建 |
| 变更模块 | 学工管理-班级干部管理 |
| 变更影响 | 新增功能，无影响 |
🎯 变更概述
基于表模型要求，创建了两个核心表：班级干部职务字典表和班级干部信息表，完善了班级干部管理的数据模型。
📁 变更文件
新增文件
-
docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables.sql- 班级干部职务字典表结构
- 班级干部信息表结构
- 16个预设职务配置数据
- 3个查询视图
- 2个触发器
-
docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md- 详细的设计说明文档
- 字段说明和使用指南
- 查询示例和注意事项
-
docs/变更管理/code-adjust-record-2025-01-23-cursor.md- 本变更记录文档
🗄️ 数据表详情
1. xg_class_cadre_position_dict - 班级干部职务字典表
表功能: 存储班级干部职务的基础配置信息，作为职务管理的字典表
主要字段:
- 基础信息：position_code, position_name, position_category, position_level
- 配置规则：max_count_per_class, min_count_per_class, is_required, default_term_months
- 任职要求：min_grade_requirement, academic_requirements, skill_requirements
- 职责描述：responsibilities, duties, kpi_indicators, work_standards
- 权限配置：default_permissions, system_roles, access_level, data_access_scope
- 显示配置：icon, color, badge_text, display_name
预设数据: 16个职务配置
- 班级核心干部：班长、副班长、学习委员等10个
- 党团干部：团支书、组织委员、宣传委员等3个
- 其他职务：宿舍长、学习小组长、活动负责人等3个
2. xg_class_cadre_info - 班级干部信息表
表功能: 存储具体的班级干部任职信息，记录学生的职务任职情况
主要字段:
- 关联信息：class_id, student_id, position_code, position_name
- 任期信息：appointment_date, term_start_date, term_end_date, is_current
- 任职状态：cadre_status, is_concurrent, concurrent_positions, workload_percentage
- 任免信息：appointer_id, appointment_reason, dismissal_date, dismissal_reason
- 工作评价：work_performance, performance_score, work_summary, evaluation_comments
- 权限配置：permissions, system_roles, access_level, data_access_scope
- 联系信息：contact_phone, contact_email, emergency_contact, wechat_id, qq_number
- 工作记录：work_plan, achievements, training_records, meeting_attendance, work_logs
- 统计信息：meeting_count, activity_count, report_count, work_hours
🔧 技术特性
1. 遵循项目规范
- ✅ 雪花ID主键
- ✅ 逻辑删除支持
- ✅ 多租户隔离
- ✅ 完整审计字段
- ✅ 中文注释完整
2. 性能优化
- ✅ 合理的索引设计
- ✅ 复合索引优化查询
- ✅ 视图简化复杂查询
- ✅ 触发器维护数据一致性
3. 功能完整
- ✅ 职务配置管理
- ✅ 任期跟踪管理
- ✅ 绩效评价记录
- ✅ 权限分配管理
- ✅ 工作记录统计
📊 查询视图
1. v_current_class_cadres
显示所有当前在任的班干部信息，包含班级信息、职务信息、任期信息等。
2. v_class_cadre_statistics
按班级统计班干部数量、级别分布、绩效情况等。
3. v_position_dict_statistics
统计各职务的分配情况、使用频率、平均绩效等。
🔄 触发器
1. tr_cadre_info_update_class
当班干部信息表插入新记录时，自动更新班级信息表中的班干部字段。
2. tr_cadre_info_delete_class
当班干部信息表更新记录时，自动清理班级信息表中的班干部字段。
🎯 使用场景
- 班干部任命: 配置职务要求，记录任命信息，自动分配权限
- 任期管理: 跟踪任期时间，自动标记到期职务，支持换届管理
- 绩效评价: 记录工作表现，统计工作量，生成绩效报告
- 权限管理: 根据职务自动分配系统权限，支持自定义配置
- 统计分析: 班级配置统计，职务使用分析，绩效趋势分析
⚠️ 注意事项
1. 数据一致性
- 职务字典表的
position_code是班干部信息表的外键 - 通过触发器维护班级信息表的班干部字段
- 注意职务编码的唯一性
2. 权限控制
- 职务字典表支持多租户隔离
- 班干部信息表继承租户隔离
- 注意数据访问范围的权限控制
3. 性能优化
- 已创建必要的索引优化查询性能
- 使用视图简化复杂查询
- 注意大数据量时的查询优化
📈 后续计划
1. 工作流集成
- 支持班干部任免审批流程
- 集成请假和调任工作流
- 支持绩效评价流程
2. 移动端支持
- 班干部信息移动端展示
- 工作记录移动端录入
- 通知推送功能
3. 报表功能
- 班干部配置报表
- 绩效分析报表
- 任期统计报表
✅ 验证清单
- 表结构设计符合项目规范
- 字段类型和长度设置合理
- 索引设计优化查询性能
- 预设数据完整且合理
- 视图设计简化查询
- 触发器维护数据一致性
- 文档说明详细完整
- 变更记录及时更新
📝 总结
本次变更成功创建了班级干部管理的完整数据模型，包括：
- 职务字典表: 提供职务配置的基础数据支撑
- 班干部信息表: 记录具体的任职信息和历史
- 查询视图: 简化复杂查询操作
- 触发器: 维护数据一致性
- 完整文档: 提供详细的使用说明
这些表为班级干部管理功能提供了完整的数据支撑，支持职务配置、人员管理、任期跟踪、绩效评价等核心功能，为后续的业务开发奠定了坚实的基础。
📋 变更确认: 本次变更已完成，所有文件已创建并符合项目规范要求。