数据设计

CREATE TABLE schools (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL UNIQUE,               -- 学校名称（全局唯一）
    code TEXT NOT NULL UNIQUE,               -- 学校代码（全局唯一，用于学校码登录/展示）
    status TEXT NOT NULL DEFAULT 'active',   -- active 启用 | disabled 停用
    note TEXT DEFAULT '',
    created_by INTEGER, created_at REAL);
-- 索引：idx_schools_status(status)

CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    school_id INTEGER NOT NULL DEFAULT 1,
    username TEXT NOT NULL,                  -- 学号/用户名（校内唯一）
    display_name TEXT NOT NULL,              -- 姓名/显示名
    phone TEXT UNIQUE, email TEXT UNIQUE,
    password_hash TEXT NOT NULL,             -- scrypt 哈希
    role TEXT NOT NULL DEFAULT 'student',     -- superadmin|admin|teacher|student
    status TEXT NOT NULL DEFAULT 'normal',    -- normal|disabled
    source TEXT NOT NULL DEFAULT 'import',    -- 账号来源
    batch_id INTEGER,                        -- 所属导入批次
    remark TEXT DEFAULT '',
    session_token TEXT,                      -- 兼容保留（新会话在 login_sessions）
    fail_count INTEGER DEFAULT 0, lock_until REAL,
    claimed_at REAL, last_login_at REAL,
    created_at REAL NOT NULL, updated_at REAL,
    profile_confirmed_at REAL,               -- 首次登录资料确认时间
    department TEXT DEFAULT '', created_by INTEGER,
    UNIQUE(school_id, username));
-- 索引：idx_users_status / idx_users_batch / idx_users_school / idx_users_token(部分索引)

CREATE TABLE qb_questions(
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    type TEXT NOT NULL,                      -- single|multi|judge|blank|material|code|excel_wps
    parent_id INTEGER,                       -- 材料大题 → 子题
    category_id INTEGER,
    stem TEXT NOT NULL DEFAULT '',           -- 题干（富文本）
    options TEXT,                            -- [{"k":"A","t":"..."}]
    answer TEXT,                             -- single "A" / multi ["A","C"] / judge "T|F" / code {lang,text} / blank 答案组
    analysis TEXT DEFAULT '',                -- 解析
    created INTEGER, updated INTEGER,
    difficulty TEXT NOT NULL DEFAULT 'medium',  -- easy|medium|hard
    points REAL NOT NULL DEFAULT 10,            -- 默认分值
    school_id INTEGER NOT NULL DEFAULT 1,
    visibility INTEGER NOT NULL DEFAULT 0,      -- 0 私有 | 1 公开（平台公共用 school_id=0）
    template_file_url TEXT, json_standard_url TEXT, judge_js_url TEXT,  -- 表格题三件套
    oj_lang TEXT, oj_testcases TEXT, oj_limit INTEGER NOT NULL DEFAULT 5, -- 编程题配置
    source_uid TEXT,                            -- 题库包稳定 ID
    local_edited INTEGER NOT NULL DEFAULT 0,    -- 本地已修改标记（题库更新不静默覆盖）
    ord INTEGER NOT NULL DEFAULT 0);            -- 子题序号
-- 索引：idx_qbq_parent / idx_qbq_school / idx_qb_questions_source_uid(部分唯一)

CREATE TABLE qb_papers(
    id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, note TEXT DEFAULT '',
    created INTEGER, code TEXT,               -- 6 位试卷/考试房间码
    school_id INTEGER NOT NULL DEFAULT 1, visibility INTEGER NOT NULL DEFAULT 0,
    source_uid TEXT);
CREATE TABLE qb_paper_items(
    id INTEGER PRIMARY KEY AUTOINCREMENT, paper_id INTEGER NOT NULL, qid INTEGER NOT NULL,
    ord INTEGER NOT NULL DEFAULT 0,           -- 卷内顺序
    points REAL DEFAULT 10);                  -- 题位分值（折算权重）

CREATE TABLE sessions (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    title TEXT NOT NULL,
    mode TEXT NOT NULL,                       -- live_sequence|live_random|live_buzz|exam
    paper_id INTEGER,
    quiz_plan TEXT NOT NULL DEFAULT '[]',      -- [{qn_id,qn_type,points,ord}]
    duration INTEGER DEFAULT 0,                -- 限时（秒）
    reveal_policy TEXT NOT NULL DEFAULT 'after_submit',  -- inline|submit|scheduled|never
    pass_line REAL DEFAULT 60,                 -- 达标线
    started_at REAL, ended_at REAL,
    status TEXT NOT NULL DEFAULT 'open',       -- open|ended|aborted
    revealed INTEGER DEFAULT 0, reveal_at REAL,-- 是否已公布 / 定时公布时间
    creator TEXT DEFAULT '',
    join_mode TEXT DEFAULT 'fixed',            -- fixed|assign|choose（多卷模式）
    paper_plans TEXT DEFAULT '[]',             -- 多卷快照
    code TEXT,                                 -- 考试码
    room_code TEXT DEFAULT '', note TEXT DEFAULT '',
    shuffle INTEGER DEFAULT 0,                 -- 整卷题序乱序
    school_id INTEGER NOT NULL DEFAULT 0,
    kind TEXT DEFAULT '',                      -- 如 mistake_redo（错题重做）
    owner_id INTEGER);
-- 索引：idx_sessions_status / idx_sessions_school / idx_sessions_code(部分唯一)

CREATE TABLE session_users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    session_id INTEGER NOT NULL, user_id INTEGER NOT NULL,
    score REAL DEFAULT 0, max_score REAL DEFAULT 0,
    correct_cnt INTEGER DEFAULT 0, answered_cnt INTEGER DEFAULT 0,
    used_secs INTEGER, submit_at REAL, paper_id INTEGER DEFAULT 0,
    UNIQUE(session_id, user_id));
-- 索引：idx_su_sess_score(session_id, score) —— 场控排行榜轮询使用

CREATE TABLE attempt_items (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    session_id INTEGER NOT NULL, user_id INTEGER NOT NULL,
    qn_type TEXT NOT NULL DEFAULT 'qb',        -- qb|legacy
    qn_id INTEGER NOT NULL,
    sel TEXT,                                  -- 学生作答
    is_correct INTEGER,                        -- 是否正确
    points_got REAL DEFAULT 0,                 -- 得分
    answered_at REAL, latency INTEGER,         -- 作答时间与耗时
    excel_sub_id INTEGER,                      -- 表格题作答关联
    free INTEGER DEFAULT 0,                    -- 是否补答
    oj_detail TEXT,                            -- 编程题用例明细
    UNIQUE(session_id, user_id, qn_type, qn_id));
-- 索引：idx_att_session / idx_att_user / idx_att_qn / idx_att_sess_qn

CREATE TABLE excel_submission (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    session_id INTEGER NOT NULL, user_id INTEGER NOT NULL, qn_id INTEGER NOT NULL,
    qb_id INTEGER, file_path TEXT, file_name TEXT, file_size INTEGER DEFAULT 0,
    score REAL DEFAULT 0, score_max REAL DEFAULT 0,
    passed INTEGER DEFAULT 0, failed INTEGER DEFAULT 0, unknown INTEGER DEFAULT 0,
    total_rules INTEGER DEFAULT 0,
    detail TEXT,                               -- 逐步骤明细（仅排查用）
    subs TEXT,                                 -- 合并小题计分结果（计分与展示以此为准）
    created_at REAL, updated_at REAL,
    UNIQUE(session_id, user_id, qn_id));
-- 索引：idx_exsub_session / idx_exsub_user / idx_exsub_qn