feat: 多班级版 v2.0 - Go后端重写 + 43轮代码审查

- 后端从 Python FastAPI 重写为 Go Gin(端口 56789)
- 多班级完全隔离
- 超级管理员独立登录
- 课代表作业管理、排行榜分项排行
- 角色加减分上下限可配置
- 家长改密功能(可开关)
- 周度/月度重置功能
- MySQL 5.7 兼容
- 43轮代码审查+全部修复
- Apache 2.0 许可证
This commit is contained in:
2026-06-22 10:06:10 +08:00
parent 4084afc53c
commit d6dec878bd
214 changed files with 12622 additions and 9725 deletions

View File

@@ -1,136 +1,53 @@
-- ===========================================
-- 班级操行分管理系统 - v2.0.1 → v2.1 升级脚本
-- 主要内容:添加缺失的数据库索引,优化查询性能
-- 多班级版班级管理系统 - v2.1 升级脚本
-- 修复 review-report-v14 中发现的安全和逻辑问题
--
-- 开发者: Canglan
-- 联系方式: admin@sea-studio.top
-- 版权归属: Sea Network Technology Studio
-- 许可证: Apache License 2.0
--
-- 版权所有 © Sea Network Technology Studio
--
-- 升级说明:
-- 1. 为 super_admins 表添加 need_change_password 字段
-- 2. 为 existing 超级管理员设置默认值(首次登录强制改密)
-- ===========================================
-- ===========================================
-- 升级步骤 1: conduct_records 表添加 student_id + created_at 联合索引
-- ===========================================
USE `classmanagerdb`;
DROP PROCEDURE IF EXISTS `upgrade_add_conduct_student_created_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_conduct_student_created_idx`()
-- 为 super_admins 表添加 need_change_password 字段
-- 已存在则跳过(使用存储过程检测)
DROP PROCEDURE IF EXISTS `add_column_if_not_exists`;
DELIMITER //
CREATE PROCEDURE `add_column_if_not_exists`(
IN p_table VARCHAR(64),
IN p_column VARCHAR(64),
IN p_definition VARCHAR(512)
)
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'conduct_records'
AND INDEX_NAME = 'idx_student_created'
) THEN
ALTER TABLE `conduct_records` ADD INDEX `idx_student_created` (`student_id`, `created_at`);
DECLARE col_count INT DEFAULT 0;
SELECT COUNT(*) INTO col_count
FROM information_schema.columns
WHERE table_schema = DATABASE()
AND table_name = p_table
AND column_name = p_column;
IF col_count = 0 THEN
SET @sql = CONCAT('ALTER TABLE `', p_table, '` ADD COLUMN `', p_column, '` ', p_definition);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
END IF;
END$$
END //
DELIMITER ;
CALL `upgrade_add_conduct_student_created_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_conduct_student_created_idx`;
CALL `add_column_if_not_exists`('super_admins', 'need_change_password', 'TINYINT DEFAULT 1 COMMENT \'1=0=\' AFTER `status`');
-- ===========================================
-- 升级步骤 2: conduct_records 表添加 recorder_id 索引
-- ===========================================
DROP PROCEDURE IF EXISTS `add_column_if_not_exists`;
DROP PROCEDURE IF EXISTS `upgrade_add_conduct_recorder_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_conduct_recorder_idx`()
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'conduct_records'
AND INDEX_NAME = 'idx_recorder_id'
) THEN
ALTER TABLE `conduct_records` ADD INDEX `idx_recorder_id` (`recorder_id`);
END IF;
END$$
DELIMITER ;
-- 更新系统版本号
INSERT INTO `system_settings` (`setting_key`, `setting_value`)
VALUES ('db_version', '2.1')
ON DUPLICATE KEY UPDATE `setting_value` = '2.1';
CALL `upgrade_add_conduct_recorder_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_conduct_recorder_idx`;
-- ===========================================
-- 升级步骤 3: attendance_records 表添加 date 索引
-- ===========================================
DROP PROCEDURE IF EXISTS `upgrade_add_attendance_date_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_attendance_date_idx`()
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'attendance_records'
AND INDEX_NAME = 'idx_date'
) THEN
ALTER TABLE `attendance_records` ADD INDEX `idx_date` (`date`);
END IF;
END$$
DELIMITER ;
CALL `upgrade_add_attendance_date_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_attendance_date_idx`;
-- ===========================================
-- 升级步骤 4: login_logs 表添加 username + created_at 联合索引
-- ===========================================
DROP PROCEDURE IF EXISTS `upgrade_add_login_username_created_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_login_username_created_idx`()
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'login_logs'
AND INDEX_NAME = 'idx_username_created'
) THEN
ALTER TABLE `login_logs` ADD INDEX `idx_username_created` (`username`, `created_at`);
END IF;
END$$
DELIMITER ;
CALL `upgrade_add_login_username_created_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_login_username_created_idx`;
-- ===========================================
-- 升级步骤 5: operation_logs 表添加 operator_id + created_at 联合索引
-- ===========================================
DROP PROCEDURE IF EXISTS `upgrade_add_operation_operator_created_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_operation_operator_created_idx`()
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'operation_logs'
AND INDEX_NAME = 'idx_operator_created'
) THEN
ALTER TABLE `operation_logs` ADD INDEX `idx_operator_created` (`operator_id`, `created_at`);
END IF;
END$$
DELIMITER ;
CALL `upgrade_add_operation_operator_created_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_operation_operator_created_idx`;
-- ===========================================
-- 升级步骤 6: semester_archives 表添加 semester_id 索引
-- ===========================================
DROP PROCEDURE IF EXISTS `upgrade_add_archive_semester_idx`;
DELIMITER $$
CREATE PROCEDURE `upgrade_add_archive_semester_idx`()
BEGIN
IF NOT EXISTS (
SELECT 1 FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'semester_archives'
AND INDEX_NAME = 'idx_semester_id'
) THEN
ALTER TABLE `semester_archives` ADD INDEX `idx_semester_id` (`semester_id`);
END IF;
END$$
DELIMITER ;
CALL `upgrade_add_archive_semester_idx`();
DROP PROCEDURE IF EXISTS `upgrade_add_archive_semester_idx`;
SELECT '升级完成!版本: v2.1' AS message;