competition-website/database/migrations/023-024-big-question-tables.sql

-- ============================================================================
-- 023 / 024 · 综合大题改造（中职组 / 高职组取消 Word 上传题 → 随机抽取大题在线作答）
-- 日期：2026-09-21
-- 目标库：MariaDB 5.5.68  competition_db  （字符集 utf8mb4 / utf8mb4_general_ci）
--
-- 本文件是**服务器同步用**的可直接执行 DDL（与 023-*.js / 024-*.js 迁移等价）。
-- 本改造为纯 ADD TABLE：
--   · 不改动任何现有表结构
--   · 不动 zhongzhi_submissions / gaozhi_submissions（客观题链路）
--   · 不动 benke_submissions / jiaoshi_submissions（本科/教师组）
--   · 不动成绩发布门控与总分公式（中职/高职总分仍 = exam_score + word_score）
--
-- 注意：MariaDB 5.5 无 JSON 列类型（JSON 一律用 TEXT / MEDIUMTEXT 存文本）；
--       DATETIME 不支持 DEFAULT CURRENT_TIMESTAMP，时间戳由应用层写入。
-- ============================================================================

-- ---------------------------------------------------------------------------
-- 023 · 综合大题题库
-- ---------------------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `big_questions` (
  `id`            int(11)      NOT NULL AUTO_INCREMENT COMMENT '大题ID',
  `question_uid`  varchar(64)  NOT NULL                COMMENT '大题稳定标识（全局唯一，形如 big_12）',
  `group`         varchar(20)  NOT NULL                COMMENT '组别：zhongzhi/gaozhi',
  `title`         varchar(200) NOT NULL                COMMENT '大题标题',
  `description`   mediumtext   DEFAULT NULL            COMMENT '题干富文本 HTML（含表格）',
  `sub_prompt_1`  text         DEFAULT NULL            COMMENT '第1小问题干',
  `sub_prompt_2`  text         DEFAULT NULL            COMMENT '第2小问题干',
  `sub_prompt_3`  text         DEFAULT NULL            COMMENT '第3小问题干',
  `score_per_sub` int(11)      NOT NULL DEFAULT '10'   COMMENT '每小题分值',
  `total_score`   int(11)      NOT NULL DEFAULT '30'   COMMENT '大题总分',
  `sort_order`    int(11)      NOT NULL DEFAULT '0'    COMMENT '排序',
  `status`        int(11)      NOT NULL DEFAULT '1'    COMMENT '状态：1=启用（参与抽题），0=停用',
  `created_at`    datetime     DEFAULT NULL            COMMENT '创建时间',
  `updated_at`    datetime     DEFAULT NULL            COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_big_question_uid` (`question_uid`),
  KEY `idx_big_q_group_status` (`group`,`status`,`sort_order`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
  COMMENT='综合大题题库（中职/高职组，替代原 Word 上传题）';

-- ---------------------------------------------------------------------------
-- 024 · 综合大题作答（一考生一行）
-- ---------------------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `big_question_answers` (
  `id`                int(11)      NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `aggregation_uid`   int(11)      NOT NULL                COMMENT '聚合报名ID（中职/高职组 == contestants.id），唯一 → 一考生一行',
  `contestant_id`     int(11)      DEFAULT NULL            COMMENT '选手ID（冗余，便于管理端查证与排障）',
  `group`             varchar(20)  NOT NULL                COMMENT '组别：zhongzhi/gaozhi',
  `big_question_id`   int(11)      DEFAULT NULL            COMMENT '抽中的大题ID',
  `big_question_uid`  varchar(64)  DEFAULT NULL            COMMENT '抽中的大题稳定标识',
  `question_snapshot` mediumtext   DEFAULT NULL            COMMENT '抽题时刻的题干快照 JSON（防纠纷存证）',
  `answer_1`          text         DEFAULT NULL            COMMENT '第1小问作答（上限2000字，后端同步校验）',
  `answer_2`          text         DEFAULT NULL            COMMENT '第2小问作答（上限2000字）',
  `answer_3`          text         DEFAULT NULL            COMMENT '第3小问作答（上限2000字）',
  `score_1`           int(11)      DEFAULT NULL            COMMENT '第1小问得分（0-10，人工阅卷）',
  `score_2`           int(11)      DEFAULT NULL            COMMENT '第2小问得分（0-10，人工阅卷）',
  `score_3`           int(11)      DEFAULT NULL            COMMENT '第3小问得分（0-10，人工阅卷）',
  `total_score`       int(11)      DEFAULT NULL            COMMENT '三小问得分合计（回写 contestants.word_score 的依据）',
  `submit_time`       datetime     DEFAULT NULL            COMMENT '随整卷正式提交写入（未提交为 NULL）',
  `created_at`        datetime     DEFAULT NULL            COMMENT '创建时间',
  `updated_at`        datetime     DEFAULT NULL            COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_big_answer_agg` (`aggregation_uid`),
  KEY `idx_big_answer_group` (`group`),
  KEY `idx_big_answer_q` (`big_question_uid`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
  COMMENT='综合大题作答（一考生一行，含题干快照）';

-- ============================================================================
-- 回滚（仅在确认弃用时执行）
--   DROP TABLE IF EXISTS `big_question_answers`;
--   DROP TABLE IF EXISTS `big_questions`;
--
-- 历史数据清理（2026-09-21 用户确认：已弃用，可全部删除）
--   DELETE FROM zhongzhi_submissions;   -- 84 行（孤儿遗留，aggregation_uid 与现有选手不匹配）
--   DELETE FROM gaozhi_submissions;     -- 480 行
--   UPDATE competition_times SET word_template = NULL WHERE `group` IN ('zhongzhi','gaozhi');
--   -- 并删除磁盘旧文件：app/public/answers/{zhongzhi,gaozhi}/、app/public/templates/{zhongzhi,gaozhi}/
--   -- ⚠️ 仅限中职/高职；本科/教师组的 word_template 与作品文件一律不得触碰。
-- ============================================================================