feat: 多班级版班级管理系统 v2.0

技术栈：Go (Gin + GORM) + PHP + MySQL 5.7 + Redis 主要功能： - 多班级完全隔离（class_id 贯穿全系统） - 后端从 Python FastAPI 重写为 Go Gin（端口 56789） - 超级管理员独立登录（env 配置路径，默认账密 admin/Admin123） - 科任老师/课代表新角色 - 课代表作业管理页面 - 排行榜分项排行（操行分/考勤/作业） - 角色加减分上下限由班主任配置 - 家长改密功能（可开关） - 班级角色按需开关 - 宿舍号格式：南0-000 - 周度/月度重置功能 - MySQL 5.7 兼容 - Nginx 反向代理部署开发者: Canglan 版权归属: Sea Network Technology Studio 许可证: Apache License 2.0
2026-06-22 10:21:52 +08:00
commit 124d7f645e
140 changed files with 21103 additions and 0 deletions
--- a/sql/upgrades/v1.0.sql
+++ b/sql/upgrades/v1.0.sql
@@ -0,0 +1,264 @@
+-- ===========================================
+-- 多班级版班级管理系统 - v1.0 升级脚本
+-- 从旧版单班级系统升级到多班级版
+-- 
+-- 开发者: Canglan
+-- 联系方式: admin@sea-studio.top
+-- 版权归属: Sea Network Technology Studio
+-- 许可证: Apache License 2.0
+-- 
+-- 版权所有 © Sea Network Technology Studio
+-- 
+-- 升级说明：
+-- 1. 创建班级表、班级设置表、班级功能开关表
+-- 2. 将现有学生迁移到默认班级
+-- 3. 扩展管理员角色枚举（科任老师、课代表）
+-- 4. 修改学生表字段（parent_phone → parent_account）
+-- 5. 为所有现有表添加 class_id 字段
+-- 6. 创建系统管理员表（super_admins）
+-- 7. 添加班级设置预置项和功能开关预置项
+-- 8. 添加系统管理员登录路径配置
+-- ===========================================
+
+USE `classmanagerdb`;
+
+SET FOREIGN_KEY_CHECKS = 0;
+
+-- ===========================================
+-- 1. 创建班级表
+-- ===========================================
+CREATE TABLE IF NOT EXISTS `classes` (
+    `class_id` INT PRIMARY KEY AUTO_INCREMENT COMMENT '班级ID',
+    `class_name` VARCHAR(100) NOT NULL COMMENT '班级名称，如 高一(1)班',
+    `grade` VARCHAR(50) DEFAULT NULL COMMENT '年级',
+    `description` VARCHAR(255) DEFAULT NULL COMMENT '班级描述',
+    `status` TINYINT DEFAULT 1 COMMENT '状态：1=启用，0=禁用',
+    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY `uk_class_name` (`class_name`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- ===========================================
+-- 2. 创建班级设置表
+-- ===========================================
+CREATE TABLE IF NOT EXISTS `class_settings` (
+    `setting_id` INT PRIMARY KEY AUTO_INCREMENT,
+    `class_id` INT NOT NULL COMMENT '所属班级ID',
+    `setting_key` VARCHAR(50) NOT NULL COMMENT '设置项键名',
+    `setting_value` VARCHAR(255) NOT NULL COMMENT '设置项值',
+    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE CASCADE,
+    UNIQUE KEY `uk_class_setting` (`class_id`, `setting_key`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- ===========================================
+-- 3. 创建班级功能开关表
+-- ===========================================
+CREATE TABLE IF NOT EXISTS `class_features` (
+    `feature_id` INT PRIMARY KEY AUTO_INCREMENT,
+    `class_id` INT NOT NULL COMMENT '所属班级ID',
+    `feature_key` VARCHAR(50) NOT NULL COMMENT '功能标识',
+    `enabled` TINYINT DEFAULT 1 COMMENT '是否启用：1=启用，0=禁用',
+    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE CASCADE,
+    UNIQUE KEY `uk_class_feature` (`class_id`, `feature_key`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- ===========================================
+-- 4. 创建系统管理员表（super_admins）
+-- ===========================================
+CREATE TABLE IF NOT EXISTS `super_admins` (
+    `id` INT PRIMARY KEY AUTO_INCREMENT,
+    `username` VARCHAR(50) NOT NULL UNIQUE COMMENT '登录用户名',
+    `password_hash` VARCHAR(255) NOT NULL COMMENT '密码哈希（MD5(SHA1(password)+salt)）',
+    `salt` VARCHAR(64) NOT NULL COMMENT '密码盐值',
+    `real_name` VARCHAR(50) NOT NULL COMMENT '真实姓名',
+    `status` TINYINT DEFAULT 1 COMMENT '状态：1=启用，0=禁用',
+    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- ===========================================
+-- 5. 插入默认班级（现有数据迁移）
+-- ===========================================
+INSERT INTO `classes` (`class_name`, `grade`, `description`)
+VALUES ('默认班级', NULL, '系统升级时自动创建的默认班级')
+ON DUPLICATE KEY UPDATE `class_id` = `class_id`;
+
+-- 获取默认班级ID
+SET @default_class_id = (SELECT `class_id` FROM `classes` WHERE `class_name` = '默认班级' LIMIT 1);
+
+-- ===========================================
+-- 6. 学生表：添加 class_id 字段
+-- ===========================================
+ALTER TABLE `students`
+    ADD COLUMN `class_id` INT NOT NULL DEFAULT 1 COMMENT '所属班级ID' AFTER `student_no`,
+    ADD FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE RESTRICT;
+
+-- 将现有学生关联到默认班级
+UPDATE `students` SET `class_id` = @default_class_id WHERE `class_id` = 1;
+
+-- 修改唯一约束（学号+班级联合唯一）
+ALTER TABLE `students` DROP INDEX `student_no`;
+ALTER TABLE `students` ADD UNIQUE KEY `uk_student_no_class` (`student_no`, `class_id`);
+
+-- ===========================================
+-- 7. 学生表：parent_phone → parent_account
+-- ===========================================
+ALTER TABLE `students` CHANGE COLUMN `parent_phone` `parent_account` VARCHAR(50) DEFAULT NULL COMMENT '家长登录账号（推荐手机号）';
+
+-- 更新宿舍号字段注释（格式：南0-000）
+ALTER TABLE `students` MODIFY COLUMN `dormitory_number` VARCHAR(20) DEFAULT NULL COMMENT '宿舍号，格式：南0-000';
+
+-- ===========================================
+-- 8. 用户表：扩展 user_type 枚举
+-- ===========================================
+ALTER TABLE `users` MODIFY COLUMN `user_type` ENUM('student', 'parent', 'admin', 'super_admin') NOT NULL;
+
+-- ===========================================
+-- 9. 管理员角色表：添加 class_id 和扩展枚举
+-- ===========================================
+ALTER TABLE `admin_roles`
+    ADD COLUMN `class_id` INT NOT NULL DEFAULT 1 COMMENT '所属班级ID' AFTER `user_id`,
+    ADD FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE RESTRICT;
+
+-- 将现有管理员关联到默认班级
+UPDATE `admin_roles` SET `class_id` = @default_class_id WHERE `class_id` = 1;
+
+-- 扩展角色枚举
+ALTER TABLE `admin_roles` MODIFY COLUMN `role_type` ENUM('班主任', '班长', '学习委员', '考勤委员', '劳动委员', '志愿委员', '科任老师', '课代表') NOT NULL;
+
+-- 添加班级级唯一约束
+ALTER TABLE `admin_roles` ADD UNIQUE KEY `uk_user_class` (`user_id`, `class_id`);
+
+-- ===========================================
+-- 10. 作业表：添加 class_id
+-- ===========================================
+ALTER TABLE `assignments`
+    ADD COLUMN `class_id` INT NOT NULL DEFAULT 1 COMMENT '所属班级ID' AFTER `assignment_id`,
+    ADD FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE RESTRICT;
+
+UPDATE `assignments` SET `class_id` = @default_class_id WHERE `class_id` = 1;
+
+-- ===========================================
+-- 11. 学期归档表：添加 class_id
+-- ===========================================
+ALTER TABLE `semester_archives`
+    ADD COLUMN `class_id` INT NOT NULL DEFAULT 1 COMMENT '所属班级ID' AFTER `semester_id`,
+    ADD FOREIGN KEY (`class_id`) REFERENCES `classes`(`class_id`) ON DELETE RESTRICT;
+
+UPDATE `semester_archives` SET `class_id` = @default_class_id WHERE `class_id` = 1;
+
+-- ===========================================
+-- 12. 操作日志表：添加 class_id
+-- ===========================================
+ALTER TABLE `operation_logs`
+    ADD COLUMN `class_id` INT DEFAULT NULL COMMENT '操作所属班级ID' AFTER `operator_role`;
+
+-- ===========================================
+-- 13. 添加新索引（MySQL 5.7 兼容：使用存储过程检查索引是否存在）
+-- ===========================================
+DROP PROCEDURE IF EXISTS `add_index_if_not_exists`;
+DELIMITER //
+CREATE PROCEDURE `add_index_if_not_exists`(
+    IN p_table VARCHAR(64),
+    IN p_index VARCHAR(64),
+    IN p_columns VARCHAR(512)
+)
+BEGIN
+    DECLARE index_count INT DEFAULT 0;
+    SELECT COUNT(*) INTO index_count
+    FROM information_schema.statistics
+    WHERE table_schema = DATABASE()
+      AND table_name = p_table
+      AND index_name = p_index;
+    IF index_count = 0 THEN
+        SET @sql = CONCAT('ALTER TABLE `', p_table, '` ADD INDEX `', p_index, '` (', p_columns, ')');
+        PREPARE stmt FROM @sql;
+        EXECUTE stmt;
+        DEALLOCATE PREPARE stmt;
+    END IF;
+END //
+DELIMITER ;
+
+CALL `add_index_if_not_exists`('students', 'idx_student_class', '`class_id`');
+CALL `add_index_if_not_exists`('admin_roles', 'idx_admin_role_class', '`class_id`');
+CALL `add_index_if_not_exists`('assignments', 'idx_assignment_class', '`class_id`');
+CALL `add_index_if_not_exists`('assignments', 'idx_assignment_subject', '`subject_id`');
+CALL `add_index_if_not_exists`('semester_archives', 'idx_archive_class', '`class_id`');
+CALL `add_index_if_not_exists`('operation_logs', 'idx_operation_class', '`class_id`');
+CALL `add_index_if_not_exists`('conduct_records', 'idx_conduct_type_semester', '`semester_id`, `related_type`, `student_id`');
+CALL `add_index_if_not_exists`('conduct_records', 'idx_conduct_semester', '`semester_id`');
+CALL `add_index_if_not_exists`('conduct_records', 'idx_conduct_student', '`student_id`');
+CALL `add_index_if_not_exists`('conduct_records', 'idx_student_created', '`student_id`, `created_at`');
+CALL `add_index_if_not_exists`('conduct_records', 'idx_recorder_id', '`recorder_id`');
+CALL `add_index_if_not_exists`('attendance_records', 'idx_attendance_semester', '`semester_id`');
+CALL `add_index_if_not_exists`('attendance_records', 'idx_date', '`date`');
+CALL `add_index_if_not_exists`('login_logs', 'idx_username_created', '`username`, `created_at`');
+CALL `add_index_if_not_exists`('operation_logs', 'idx_operator_created', '`operator_id`, `created_at`');
+CALL `add_index_if_not_exists`('semester_archives', 'idx_semester_id', '`semester_id`');
+
+DROP PROCEDURE IF EXISTS `add_index_if_not_exists`;
+
+SET FOREIGN_KEY_CHECKS = 1;
+
+-- ===========================================
+-- 14. 为默认班级插入预置班级设置
+-- ===========================================
+INSERT INTO `class_settings` (`class_id`, `setting_key`, `setting_value`) VALUES
+-- 角色加减分上下限
+(@default_class_id, 'point_limit_班主任_max', '10'),
+(@default_class_id, 'point_limit_班主任_min', '-10'),
+(@default_class_id, 'point_limit_班长_max', '5'),
+(@default_class_id, 'point_limit_班长_min', '-5'),
+(@default_class_id, 'point_limit_学习委员_max', '5'),
+(@default_class_id, 'point_limit_学习委员_min', '-5'),
+(@default_class_id, 'point_limit_考勤委员_max', '8'),
+(@default_class_id, 'point_limit_考勤委员_min', '-8'),
+(@default_class_id, 'point_limit_劳动委员_max', '1'),
+(@default_class_id, 'point_limit_劳动委员_min', '-1'),
+(@default_class_id, 'point_limit_志愿委员_max', '5'),
+(@default_class_id, 'point_limit_志愿委员_min', '0'),
+(@default_class_id, 'point_limit_科任老师_max', '5'),
+(@default_class_id, 'point_limit_科任老师_min', '-5'),
+-- 操行分初始值
+(@default_class_id, 'initial_points', '60'),
+-- 扣分规则
+(@default_class_id, 'deduction_homework_not_submit', '2'),
+(@default_class_id, 'deduction_homework_late', '1'),
+(@default_class_id, 'deduction_attendance_absent', '3'),
+(@default_class_id, 'deduction_attendance_late', '1'),
+(@default_class_id, 'deduction_attendance_leave', '0'),
+-- 家长相关
+(@default_class_id, 'parent_password_change_enabled', 'true'),
+(@default_class_id, 'parent_account_enabled', 'true')
+ON DUPLICATE KEY UPDATE `setting_value` = VALUES(`setting_value`);
+
+-- ===========================================
+-- 15. 为默认班级插入预置功能开关
+-- ===========================================
+INSERT INTO `class_features` (`class_id`, `feature_key`, `enabled`) VALUES
+(@default_class_id, 'role_班长_enabled', 1),
+(@default_class_id, 'role_学习委员_enabled', 1),
+(@default_class_id, 'role_考勤委员_enabled', 1),
+(@default_class_id, 'role_劳动委员_enabled', 1),
+(@default_class_id, 'role_志愿委员_enabled', 1),
+(@default_class_id, 'role_科任老师_enabled', 1),
+(@default_class_id, 'role_课代表_enabled', 1)
+ON DUPLICATE KEY UPDATE `enabled` = VALUES(`enabled`);
+
+-- ===========================================
+-- 16. 添加系统管理员登录路径配置
+-- ===========================================
+INSERT INTO `system_settings` (`setting_key`, `setting_value`)
+VALUES ('super_admin_login_path', '/super-admin/login')
+ON DUPLICATE KEY UPDATE `setting_value` = '/super-admin/login';
+
+-- ===========================================
+-- 17. 更新系统版本号
+-- ===========================================
+INSERT INTO `system_settings` (`setting_key`, `setting_value`)
+VALUES ('db_version', '1.0')
+ON DUPLICATE KEY UPDATE `setting_value` = '1.0';
+
+-- 升级完成
+SELECT CONCAT('升级完成！版本: v1.0，默认班级ID: ', @default_class_id) AS message;