competition-website/database/migrations/025-scores-decimal-one-place.sql

-- ============================================================================
-- 025 一位小数评分支持：分数列 int(11) → DECIMAL(6,1)
--
-- 背景（2026-09-23）
--   需求：中职 / 高职「综合大题」的人工评分允许保留小数点后一位（如 7.5）。
--   现状：全库 23 个 score 类列**全部**为 int(11) ⇒ 小数落库即被静默截断；
--         且 service/bigQuestion.js:337 另有一处 Math.round() 主动取整。
--   本迁移把「得分」语义的列放宽为 DECIMAL(6,1)（上限 99999.9，保留 1 位小数）。
--
-- 范围（17 列）
--   改（得分 / 分数落点）：
--     big_question_answers.score_1 / score_2 / score_3 / total_score
--     contestants.exam_score / word_score / ppt_score / score
--     accounts.score
--     zhongzhi_submissions.score / gaozhi_submissions.score / exam_submissions.score
--     benke_submissions.score / jiaoshi_submissions.score / work_submissions.score
--     big_questions.score_per_sub / total_score（大题分值配置，随评分口径）
--   不改：
--     choice_questions.score / judge_questions.score
--       —— 客观题口径已固定为每题 1 分（service/admin.js OBJECTIVE_SCORE_PER_QUESTION），
--          且 scripts/check_question_bank_health.py 门禁断言其恒为 1；
--     word_questions.score、exam_questions/zhongzhi_questions/gaozhi_questions.score
--       —— 属题目分值配置或历史遗留题表，无小数需求。
--
-- 兼容性
--   INT → DECIMAL(6,1) 是**放宽**：既有整数值原样保留，读写语义不变。
--   ⚠️ 应用侧必须同步：
--     ① config/config.default.js 的 sequelize.dialectOptions.decimalNumbers = true
--        （否则 mysql2 把 DECIMAL 读成**字符串**）；
--     ② 相关 model 字段类型声明为 DECIMAL，且 getter 转 Number
--        （否则 Sequelize 的 INTEGER.parse 会把 7.5 二次截断成 7）。
--
-- 执行（在 database/ 目录下）：
--   mysql -uroot -p competition_db < migrations/025-scores-decimal-one-place.sql
-- 幂等：MODIFY 到同一类型可重复执行。
-- ============================================================================

-- ---------------------------------------------------------------- 大题作答
ALTER TABLE `big_question_answers`
  MODIFY COLUMN `score_1`     DECIMAL(6,1) NULL DEFAULT NULL COMMENT '第 1 小问得分（可含 1 位小数）',
  MODIFY COLUMN `score_2`     DECIMAL(6,1) NULL DEFAULT NULL COMMENT '第 2 小问得分（可含 1 位小数）',
  MODIFY COLUMN `score_3`     DECIMAL(6,1) NULL DEFAULT NULL COMMENT '第 3 小问得分（可含 1 位小数）',
  MODIFY COLUMN `total_score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '大题合计得分（可含 1 位小数）';

-- ---------------------------------------------------------------- 大题配置
ALTER TABLE `big_questions`
  MODIFY COLUMN `score_per_sub` DECIMAL(6,1) NOT NULL DEFAULT 10 COMMENT '每小题分值',
  MODIFY COLUMN `total_score`   DECIMAL(6,1) NOT NULL DEFAULT 30 COMMENT '大题总分 = 每小题分值 × 小问数';

-- ---------------------------------------------------------------- 选手成绩
ALTER TABLE `contestants`
  MODIFY COLUMN `exam_score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '卷面考试成绩',
  MODIFY COLUMN `word_score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT 'Word题/综合大题得分（可含 1 位小数）',
  MODIFY COLUMN `ppt_score`  DECIMAL(6,1) NULL DEFAULT NULL COMMENT 'PPT得分（本科/教师组，可含 1 位小数）',
  MODIFY COLUMN `score`      DECIMAL(6,1) NULL DEFAULT NULL COMMENT '选手总分（exam_score + word_score / word_score + ppt_score）';

-- ---------------------------------------------------------------- 账号分（历史兼容）
ALTER TABLE `accounts`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '总分（历史兼容字段）';

-- ---------------------------------------------------------------- 提交表分项
ALTER TABLE `zhongzhi_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '本题得分';
ALTER TABLE `gaozhi_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '本题得分';
ALTER TABLE `exam_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '卷面得分';
ALTER TABLE `benke_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '作品得分';
ALTER TABLE `jiaoshi_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '作品得分';
ALTER TABLE `work_submissions`
  MODIFY COLUMN `score` DECIMAL(6,1) NULL DEFAULT NULL COMMENT '作品得分';

-- ============================================================================
-- 回滚（⚠️ DECIMAL → INT 会**丢失**既有小数位，执行前务必确认无小数值：
--   SELECT COUNT(*) FROM contestants WHERE score <> FLOOR(score);  -- 应为 0）
--
-- ALTER TABLE `big_question_answers`
--   MODIFY COLUMN `score_1` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `score_2` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `score_3` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `total_score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `big_questions`
--   MODIFY COLUMN `score_per_sub` INT(11) NOT NULL DEFAULT 10,
--   MODIFY COLUMN `total_score` INT(11) NOT NULL DEFAULT 30;
-- ALTER TABLE `contestants`
--   MODIFY COLUMN `exam_score` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `word_score` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `ppt_score` INT(11) NULL DEFAULT NULL,
--   MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `accounts` MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `zhongzhi_submissions` MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `gaozhi_submissions`  MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `exam_submissions`    MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `benke_submissions`   MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `jiaoshi_submissions` MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ALTER TABLE `work_submissions`    MODIFY COLUMN `score` INT(11) NULL DEFAULT NULL;
-- ============================================================================