技术栈: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
265 lines
13 KiB
SQL
265 lines
13 KiB
SQL
-- ===========================================
|
||
-- 多班级版班级管理系统 - 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;
|