-- =========================================== -- 多班级版班级管理系统 - 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;