openlearn-next 0.4.2 → 0.7.3

package/migrations/019_plugins_version.sql

@@ -0,0 +1,61 @@
+-- UP
+-- 019_plugins_version.sql
+-- 审计项 H-3（原始编号 L-7）：plugins 表补 version 列，让「插件版本」可在 SQL 层查询。
+--
+-- 背景：plugins 表把整个 manifest 存成一列 JSON（`manifest`），版本信息只存在于
+-- `json_extract(manifest, '$.version')` 里面。这带来三个具体问题：
+--
+--   ① 无法用索引。社区市场、依赖解析、版本兼容性检查都需要「按版本筛选/排序」，
+--      `json_extract` 无法走索引，只能全表扫描。plugins 表行数不大但会随生态增长。
+--   ② 无法做 SQL 级 DISTINCT / GROUP BY 版本比较。
+--      「哪些插件是 1.x」「有没有两个插件声明了同一版本」这类问题写不出来。
+--   ③ 无法对版本做 CHECK 约束。manifest 里的 version 写错了也照样入库，
+--      只在插件真正激活时才可能在别处炸。
+--
+-- 为什么不是「从 manifest 里读就行」：
+--   读得到不等于查得起。插件宿主本身已有 `resolvePluginUuid()` 用
+--   `json_extract(manifest, '$.id')` 做主键回查（index.ts），说明这个模式可用；
+--   但那是一次性 O(1) 点查，而版本筛选是集合查询，代价差异很大。
+--   同时把 version 提升为独立列后，它才能参与索引与约束 —— 这才是本迁移的目的。
+--
+-- 数据回填：从已有 manifest JSON 抽取。抽不出（manifest 非合法 JSON 或无 version）
+-- 的行留 NULL —— 不猜、不填占位符。NULL 语义明确为「版本未知」。
+--
+-- 维护说明：安装/更新插件的路径（installPlugin / installPluginFromZip /
+-- updatePluginFromZip）需同步写入该列，否则新装插件的 version 仍为 NULL。
+-- 读路径已兼容 NULL：既有代码从 manifest JSON 读 version，本列是**加速索引**，
+-- 不是唯一真源 —— 这样即使某条写入路径漏了也不会造成功能回归。
+
+ALTER TABLE plugins ADD COLUMN version TEXT;
+
+-- 回填：从 manifest JSON 抽取。
+-- 实测：UPDATE ... WHERE json_valid(manifest) 会先过滤再求值，脏行被跳过、不会中断整表；
+-- 真正会被脏行炸掉的是下面的**表达式索引**（建索引必须逐行求值），故那里用部分索引。
+UPDATE plugins
+   SET version = json_extract(manifest, '$.version')
+ WHERE json_valid(manifest)
+   AND json_extract(manifest, '$.version') IS NOT NULL;
+
+-- 索引：版本筛选 + 排序（社区市场「按版本列出」、兼容性检查「找出低于 X 的插件」）
+CREATE INDEX IF NOT EXISTS idx_plugins_version ON plugins(version);
+
+-- manifest.id 是逻辑主键（DB 主键是 UUID），PluginHost.resolvePluginUuid 按它查。
+--
+-- 必须用**部分索引**：`json_extract()` 遇到非法 JSON 会抛 `malformed JSON`，
+-- 而建表达式索引时 SQLite 会对**每一行**求值 —— 一条脏数据就让整条 DDL 失败。
+-- 实测（SQLite 3.53.2）：
+--   无条件表达式索引 → 抛错 "malformed JSON"
+--   带 WHERE json_valid(manifest) 的部分索引 → 通过
+--
+-- 刻意**不**采用「先把非法 manifest 改写成 {}」的替代方案：那会销毁损坏数据的现场。
+-- manifest 理论上只由本宿主写入（JSON.stringify），脏行意味着另有原因，
+-- 不该被本迁移顺手掩盖。
+CREATE INDEX IF NOT EXISTS idx_plugins_manifest_id
+  ON plugins(json_extract(manifest, '$.id'))
+  WHERE json_valid(manifest);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_plugins_manifest_id;
+DROP INDEX IF EXISTS idx_plugins_version;
+-- SQLite 3.35+ 支持 DROP COLUMN；旧版走表重建兜底由 migrate 层处理
+ALTER TABLE plugins DROP COLUMN version;

package/migrations/020_upload_max_file_mb.sql

@@ -0,0 +1,14 @@
+-- UP
+-- 020_upload_max_file_mb.sql
+-- v0.6.1：课件上传文件大小上限改为管理员可配置（管理后台 → 站点设置）。
+--
+-- site_settings 增加 upload_max_file_mb 列（MB，整数）。NULL = 未配置，
+-- 运行时取默认 10MB（与历史 express.json 10MB 限制下的实际可用值一致）。
+-- 硬上限 90MB：受 express.json 的 110MB 全局 JSON 上限约束（base64 膨胀
+-- ~33%），服务端 /api/upload 在解码后按此列逐请求强制执行。
+
+ALTER TABLE site_settings ADD COLUMN upload_max_file_mb INTEGER;
+
+-- DOWN
+-- SQLite 3.35+ 支持 DROP COLUMN（Node 24 内置版本满足）；旧版需表重建兜底
+ALTER TABLE site_settings DROP COLUMN upload_max_file_mb;

package/migrations/021_class_owner_and_password_gate.sql

@@ -0,0 +1,11 @@
+-- UP
+-- 021_class_owner_and_password_gate.sql
+-- 班级归属：教师只能管理 owner_user_id 指向自己的班级；历史空值仅管理员可访问，需回填。
+-- 种子账号：must_change_password=1 时，除改密/登出/会话查询外的 API（含 GET）一律拒绝。
+
+ALTER TABLE classes ADD COLUMN owner_user_id TEXT;
+ALTER TABLE users ADD COLUMN must_change_password INTEGER NOT NULL DEFAULT 0;
+
+-- DOWN
+ALTER TABLE classes DROP COLUMN owner_user_id;
+ALTER TABLE users DROP COLUMN must_change_password;

package/migrations/022_plugin_public_routes.sql

@@ -0,0 +1,14 @@
+-- UP
+-- 插件公开路由必须由管理员显式批准。manifest 的 auth:false 不再单独放行。
+-- plugin_key 同时写入 DB UUID 与 manifest.id，网关用任一身份都能命中。
+
+CREATE TABLE IF NOT EXISTS plugin_public_routes (
+  plugin_key TEXT NOT NULL,
+  method TEXT NOT NULL,
+  path TEXT NOT NULL,
+  approved_at INTEGER NOT NULL,
+  PRIMARY KEY (plugin_key, method, path)
+);
+
+-- DOWN
+DROP TABLE IF EXISTS plugin_public_routes;

package/migrations/023_encrypt_class_passcodes.sql

@@ -0,0 +1,18 @@
+-- UP
+-- 班级临时口令改为 AES-256-GCM 密文（前缀 olenc1:）。
+-- 纯 SQL 拿不到 ENCRYPTION_KEY，真正的加密在启动时由
+-- encryptStoredClassPasscodes() 完成：已是 olenc1: 密文的行跳过，可重复执行。
+-- 本表只用于在 _migrations 之外留下「这一列已经按密文约定存储」的标记。
+
+CREATE TABLE IF NOT EXISTS _class_passcode_encryption (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  note TEXT NOT NULL
+);
+
+INSERT OR IGNORE INTO _class_passcode_encryption (id, note)
+VALUES (1, 'class_passcode is sealed with olenc1: AES-256-GCM. plaintext rows are encrypted on startup');
+
+-- DOWN
+-- 不能在 SQL 里把密文还原成明文（需要 ENCRYPTION_KEY，而且会重新暴露口令）。
+-- 回滚应用代码前，请改用迁移前的数据库快照。已加密的 class_passcode 保持不动。
+DROP TABLE IF EXISTS _class_passcode_encryption;

package/migrations/024_segment_gates.sql

@@ -0,0 +1,37 @@
+-- UP
+-- 教学环节门槛：按学生记录在某一环节上的停留，以及教师对「某学生 × 某环节」的放行。
+-- 签到若没有排课行，lesson_checkins 仍留下课节级到课事实，供 checked_in 条件读取。
+
+CREATE TABLE IF NOT EXISTS segment_visits (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  segment_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  entered_at INTEGER NOT NULL,
+  left_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_segment_visits_lookup
+  ON segment_visits(lesson_id, student_id, segment_id);
+
+CREATE TABLE IF NOT EXISTS segment_gate_overrides (
+  lesson_id TEXT NOT NULL,
+  segment_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  actor_id TEXT NOT NULL,
+  reason TEXT,
+  created_at INTEGER NOT NULL,
+  PRIMARY KEY (lesson_id, segment_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS lesson_checkins (
+  lesson_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  checked_in_at INTEGER NOT NULL,
+  PRIMARY KEY (lesson_id, student_id)
+);
+
+-- DOWN
+DROP TABLE IF EXISTS lesson_checkins;
+DROP TABLE IF EXISTS segment_gate_overrides;
+DROP TABLE IF EXISTS segment_visits;

package/migrations/025_assignment_lookup_indexes.sql

@@ -0,0 +1,11 @@
+-- UP
+-- 课节进度按 student_id 聚合该课作业最高分，仪表盘按学生取提交。
+-- assignment_submissions 的主键是 (assignment_id, student_id)，不能单独服务 student_id 查找。
+-- assignments 已有 class_id 索引，没有 lesson_id 索引。
+
+CREATE INDEX IF NOT EXISTS idx_assignment_submissions_student ON assignment_submissions(student_id);
+CREATE INDEX IF NOT EXISTS idx_assignments_lesson ON assignments(lesson_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_assignments_lesson;
+DROP INDEX IF EXISTS idx_assignment_submissions_student;

package/migrations/026_plugin_grants.sql

@@ -0,0 +1,21 @@
+-- UP
+-- 第三方插件的能力授权与出站域名白名单必须由管理员显式批准写入。
+-- plugin_key 支持 DB UUID 与 manifest.id 双键查询，确保向后兼容与隔离。
+
+CREATE TABLE IF NOT EXISTS plugin_capability_grants (
+  plugin_key TEXT NOT NULL,
+  capability TEXT NOT NULL,
+  approved_at INTEGER NOT NULL,
+  PRIMARY KEY (plugin_key, capability)
+);
+
+CREATE TABLE IF NOT EXISTS plugin_network_grants (
+  plugin_key TEXT NOT NULL,
+  host TEXT NOT NULL,
+  approved_at INTEGER NOT NULL,
+  PRIMARY KEY (plugin_key, host)
+);
+
+-- DOWN
+DROP TABLE IF EXISTS plugin_capability_grants;
+DROP TABLE IF EXISTS plugin_network_grants;

package/migrations/027_academic_year.sql

@@ -0,0 +1,26 @@
+-- UP
+-- 学年维度 (academic_year)：允许按学年过滤、统计、导出；NULL 表示「未分类」。
+
+ALTER TABLE schedules ADD COLUMN academic_year TEXT;
+ALTER TABLE assignments ADD COLUMN academic_year TEXT;
+ALTER TABLE assignment_submissions ADD COLUMN academic_year TEXT;
+ALTER TABLE exams ADD COLUMN academic_year TEXT;
+ALTER TABLE exam_scores ADD COLUMN academic_year TEXT;
+ALTER TABLE attendance ADD COLUMN academic_year TEXT;
+ALTER TABLE student_semester_reports ADD COLUMN academic_year TEXT;
+ALTER TABLE student_lesson_progress ADD COLUMN academic_year TEXT;
+ALTER TABLE classroom_sessions ADD COLUMN academic_year TEXT;
+
+ALTER TABLE site_settings ADD COLUMN current_academic_year TEXT;
+ALTER TABLE site_settings ADD COLUMN academic_start_month INTEGER DEFAULT 9;
+
+CREATE INDEX IF NOT EXISTS idx_schedules_academic_year ON schedules(academic_year);
+CREATE INDEX IF NOT EXISTS idx_assignments_academic_year ON assignments(academic_year);
+CREATE INDEX IF NOT EXISTS idx_attendance_academic_year ON attendance(academic_year);
+CREATE INDEX IF NOT EXISTS idx_classroom_sessions_academic_year ON classroom_sessions(academic_year);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_classroom_sessions_academic_year;
+DROP INDEX IF EXISTS idx_attendance_academic_year;
+DROP INDEX IF EXISTS idx_assignments_academic_year;
+DROP INDEX IF EXISTS idx_schedules_academic_year;

package/migrations/028_classroom_indexes.sql

@@ -0,0 +1,14 @@
+-- UP
+-- 补齐课堂互动与会话高频查询/级联删除索引
+CREATE INDEX IF NOT EXISTS idx_classroom_buzzers_session ON classroom_buzzers(session_id);
+CREATE INDEX IF NOT EXISTS idx_classroom_buzzers_lesson ON classroom_buzzers(lesson_id);
+CREATE INDEX IF NOT EXISTS idx_classroom_sessions_class ON classroom_sessions(class_id);
+CREATE INDEX IF NOT EXISTS idx_classroom_sessions_created_at ON classroom_sessions(created_at);
+CREATE INDEX IF NOT EXISTS idx_classroom_sessions_teacher ON classroom_sessions(teacher_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_classroom_sessions_teacher;
+DROP INDEX IF EXISTS idx_classroom_sessions_created_at;
+DROP INDEX IF EXISTS idx_classroom_sessions_class;
+DROP INDEX IF EXISTS idx_classroom_buzzers_lesson;
+DROP INDEX IF EXISTS idx_classroom_buzzers_session;

package/migrations/029_clean_lesson_think_artifacts.sql

@@ -0,0 +1,13 @@
+-- UP
+-- 课程大纲模型思维链残留 (<think>...</think>) 清洗标记表。
+-- 真正的正则文本清洗由启动阶段 cleanStoredLessonThinkArtifacts(db) 幂等执行。
+CREATE TABLE IF NOT EXISTS _lesson_think_cleanup (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  note TEXT NOT NULL
+);
+
+INSERT OR IGNORE INTO _lesson_think_cleanup (id, note)
+VALUES (1, 'lessons.content reasoning artifacts cleaned on startup');
+
+-- DOWN
+DROP TABLE IF EXISTS _lesson_think_cleanup;

package/migrations/030_backfill_academic_year.sql

@@ -0,0 +1,30 @@
+-- UP
+-- 学年历史数据向后兼容回填标记与 SQL 级关联回填
+-- 细粒度日期推导由启动阶段 backfillAcademicYearData(db) 幂等执行。
+
+CREATE TABLE IF NOT EXISTS _academic_year_backfill (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  backfilled_at TEXT NOT NULL
+);
+
+-- SQL 级关联回填：优先从所属父实体继承已存在的学年
+UPDATE assignment_submissions
+SET academic_year = (SELECT a.academic_year FROM assignments a WHERE a.id = assignment_submissions.assignment_id)
+WHERE academic_year IS NULL
+  AND EXISTS (SELECT 1 FROM assignments a WHERE a.id = assignment_submissions.assignment_id AND a.academic_year IS NOT NULL);
+
+UPDATE attendance
+SET academic_year = (SELECT s.academic_year FROM schedules s WHERE s.id = attendance.schedule_id)
+WHERE academic_year IS NULL
+  AND EXISTS (SELECT 1 FROM schedules s WHERE s.id = attendance.schedule_id AND s.academic_year IS NOT NULL);
+
+UPDATE exam_scores
+SET academic_year = (SELECT e.academic_year FROM exams e WHERE e.id = exam_scores.exam_id)
+WHERE academic_year IS NULL
+  AND EXISTS (SELECT 1 FROM exams e WHERE e.id = exam_scores.exam_id AND e.academic_year IS NOT NULL);
+
+INSERT OR IGNORE INTO _academic_year_backfill (id, backfilled_at)
+VALUES (1, datetime('now'));
+
+-- DOWN
+DROP TABLE IF EXISTS _academic_year_backfill;

package/migrations/031_assessment_core.sql

@@ -0,0 +1,158 @@
+-- UP
+-- 测评子系统核心表（Issue #100 / 子 issue #120）。
+--
+-- 设计口径（记录在这里，避免和大纲脱节）：
+--   * 组卷即快照：题目加入试卷时就复制进 assessment_items（草稿自包含），
+--     发布只改 assessments.status；bank_item_id 仅作溯源，删题库不影响已组卷内容。
+--   * 权威答案字段是 answer_key_json，**只在服务端使用**，任何学生端响应都不得包含它
+--     （白名单序列化 + 单测门禁，见 packages/core/assessment/serialize.ts）。
+--   * 匿名问卷：assessment_attempts.student_id 为 NULL，用 anon_key（HMAC）去重；
+--     教师端响应不含 anon_key / student_id。
+--   * 多次作答的聚合口径（first/last/highest/average）实时计算，不落冗余列。
+--   * 超时用惰性结算：任何读取到 now > deadline_at 的 in_progress attempt 都结算为 submitted。
+--   * 表里没有"总分"冗余列以外的派生数据；assessment_attempts.score 是"已判分部分的合计"，
+--     needs_manual_review 指明是否还有待人工批改的题。
+
+CREATE TABLE IF NOT EXISTS assessments (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL CHECK (kind IN ('quiz', 'exam', 'survey')),
+  title TEXT NOT NULL,
+  description TEXT,
+  owner_id TEXT NOT NULL,
+  -- 计时 / 作答次数 / 乱序 / 匿名 / 结果可见性 / 计分策略，见 packages/core/assessment/settings.ts
+  settings_json TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL DEFAULT 'draft' CHECK (status IN ('draft', 'published', 'closed', 'archived')),
+  academic_year TEXT,
+  published_at INTEGER,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_assessments_owner ON assessments(owner_id, status);
+CREATE INDEX IF NOT EXISTS idx_assessments_kind ON assessments(kind, status);
+
+CREATE TABLE IF NOT EXISTS question_bank_items (
+  id TEXT PRIMARY KEY,
+  owner_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  stem TEXT NOT NULL,
+  config_json TEXT NOT NULL DEFAULT '{}',
+  -- 标准答案，仅服务端可读
+  answer_key_json TEXT,
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  difficulty INTEGER,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_question_bank_owner ON question_bank_items(owner_id, type);
+
+-- 试卷中的题：组卷时物化的快照（改题库不影响已组卷内容）
+CREATE TABLE IF NOT EXISTS assessment_items (
+  id TEXT PRIMARY KEY,
+  assessment_id TEXT NOT NULL,
+  -- 溯源用；题库条目被删后仍保留快照，因此可为 NULL
+  bank_item_id TEXT,
+  section TEXT,
+  sort_order INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  stem TEXT NOT NULL,
+  config_json TEXT NOT NULL DEFAULT '{}',
+  answer_key_json TEXT,
+  max_score REAL NOT NULL DEFAULT 1,
+  FOREIGN KEY (assessment_id) REFERENCES assessments(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_assessment_items_order ON assessment_items(assessment_id, sort_order);
+
+-- 发布到班级（可选关联课节 / 课表节次 / 课堂会话）
+CREATE TABLE IF NOT EXISTS assessment_assignments (
+  id TEXT PRIMARY KEY,
+  assessment_id TEXT NOT NULL,
+  class_id TEXT NOT NULL,
+  lesson_id TEXT,
+  schedule_id TEXT,
+  session_id TEXT,
+  opens_at INTEGER,
+  closes_at INTEGER,
+  duration_sec INTEGER,
+  -- P1 回写 exams/exam_scores 时的关联
+  exam_id TEXT,
+  academic_year TEXT,
+  status TEXT NOT NULL DEFAULT 'open' CHECK (status IN ('open', 'closed')),
+  -- 教师「发布成绩」后才允许学生看到分数与答案（exam 类型默认关闭）
+  score_released INTEGER NOT NULL DEFAULT 0,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (assessment_id) REFERENCES assessments(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_assessment_assignments_class ON assessment_assignments(class_id, status);
+CREATE INDEX IF NOT EXISTS idx_assessment_assignments_lesson ON assessment_assignments(lesson_id);
+CREATE INDEX IF NOT EXISTS idx_assessment_assignments_window
+  ON assessment_assignments(opens_at, closes_at);
+
+CREATE TABLE IF NOT EXISTS assessment_attempts (
+  id TEXT PRIMARY KEY,
+  assignment_id TEXT NOT NULL,
+  -- 匿名问卷为 NULL；非匿名为学生 id
+  student_id TEXT,
+  -- 匿名去重用的 HMAC（见 packages/core/assessment/anonymous.ts）
+  anon_key TEXT,
+  attempt_no INTEGER NOT NULL DEFAULT 1,
+  status TEXT NOT NULL DEFAULT 'in_progress'
+    CHECK (status IN ('in_progress', 'submitted', 'graded', 'released')),
+  started_at INTEGER NOT NULL,
+  submitted_at INTEGER,
+  deadline_at INTEGER,
+  -- 已判分部分的合计；人工批改后由服务端重算
+  score REAL,
+  max_score REAL,
+  -- 1 表示仍有题目在等人工批改（简答 / grader 返回 score=null）
+  needs_manual_review INTEGER NOT NULL DEFAULT 0,
+  -- 切屏 / 失焦计数等考试监考数据（P1 使用）
+  proctor_json TEXT NOT NULL DEFAULT '{}',
+  academic_year TEXT,
+  FOREIGN KEY (assignment_id) REFERENCES assessment_assignments(id) ON DELETE CASCADE
+);
+
+-- 同一身份（学生 id 或匿名 key）在同一份布置下，每个 attempt_no 只允许一条；
+-- 匿名问卷 max_attempts 恒为 1，因此这条索引同时承担「防一人多交」。
+CREATE UNIQUE INDEX IF NOT EXISTS idx_assessment_attempts_identity ON assessment_attempts(
+  assignment_id,
+  COALESCE(student_id, ''),
+  COALESCE(anon_key, ''),
+  attempt_no
+);
+
+CREATE INDEX IF NOT EXISTS idx_assessment_attempts_status ON assessment_attempts(assignment_id, status);
+CREATE INDEX IF NOT EXISTS idx_assessment_attempts_student ON assessment_attempts(student_id);
+
+CREATE TABLE IF NOT EXISTS assessment_answers (
+  attempt_id TEXT NOT NULL,
+  item_id TEXT NOT NULL,
+  answer_json TEXT,
+  score REAL,
+  max_score REAL,
+  is_correct INTEGER,
+  -- auto | manual | plugin:<id> | ai_suggested
+  grader TEXT,
+  feedback TEXT,
+  graded_by TEXT,
+  graded_at INTEGER,
+  -- 教师手动改过的行不被自动判分覆盖（判分幂等的一部分）
+  manual_override INTEGER NOT NULL DEFAULT 0,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (attempt_id, item_id),
+  FOREIGN KEY (attempt_id) REFERENCES assessment_attempts(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_assessment_answers_item ON assessment_answers(item_id);
+
+-- DOWN
+DROP TABLE IF EXISTS assessment_answers;
+DROP TABLE IF EXISTS assessment_attempts;
+DROP TABLE IF EXISTS assessment_assignments;
+DROP TABLE IF EXISTS assessment_items;
+DROP TABLE IF EXISTS question_bank_items;
+DROP TABLE IF EXISTS assessments;

package/migrations/032_progress_verification.sql

@@ -0,0 +1,17 @@
+-- UP
+-- 032_progress_verification.sql
+-- 学习进度区分「学生自报」与「已验证」：成绩只计入已验证进度。
+--   verified = 1            由教师/管理员、课件自动录入或受信插件写入
+--   verified_progress_percent 该次验证对应的进度值（学生自报只改展示值，不覆盖此列）
+--
+-- 历史数据：修复前所有进度都直接计入成绩，为保持既有成绩口径，全部回填为已验证。
+
+ALTER TABLE student_lesson_progress ADD COLUMN verified INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE student_lesson_progress ADD COLUMN verified_progress_percent INTEGER;
+
+UPDATE student_lesson_progress
+SET verified = 1, verified_progress_percent = progress_percent;
+
+-- DOWN
+ALTER TABLE student_lesson_progress DROP COLUMN verified_progress_percent;
+ALTER TABLE student_lesson_progress DROP COLUMN verified;

package/migrations/033_student_lock_mode.sql

@@ -0,0 +1,9 @@
+-- UP
+-- 学生端锁定模式 (lock_mode) 与锁定目标 (lock_target)（Issue #110）
+-- lock_mode: 'full' (完全锁定/只读跟随) | 'navigation' (答题锁定/放开输入作答，禁止离开)
+-- lock_target: JSON 字符串，例如 {"tab":"whiteboard"|"assignment"|"courseware","assignmentId":"...","elementId":"..."}
+
+ALTER TABLE students ADD COLUMN lock_mode TEXT DEFAULT 'full';
+ALTER TABLE students ADD COLUMN lock_target TEXT DEFAULT NULL;
+
+-- DOWN

package/migrations/034_plugin_orphan_data.sql

@@ -0,0 +1,27 @@
+-- UP
+-- 插件卸载的数据语义（Issue #141）：卸载默认保留数据，purge 需先导出归档。
+--
+-- `keep`（默认）：插件私有表、`plugin_migrations` 版本记录与 `plugin_storage`
+-- 键值原样保留，本表登记一条「孤立插件数据」；
+-- 重装同 manifest.id 时复用 plugin_id（原安装 UUID），表前缀 / 迁移版本 / 存储键
+-- 三者都会天然命中旧数据，无需搬迁。
+CREATE TABLE IF NOT EXISTS plugin_orphan_data (
+  manifest_id TEXT NOT NULL,
+  plugin_id TEXT NOT NULL,
+  plugin_name TEXT,
+  plugin_version TEXT,
+  table_prefixes TEXT NOT NULL DEFAULT '[]',
+  table_names TEXT NOT NULL DEFAULT '[]',
+  row_count INTEGER NOT NULL DEFAULT 0,
+  storage_keys INTEGER NOT NULL DEFAULT 0,
+  migration_version INTEGER,
+  last_export_path TEXT,
+  uninstalled_at INTEGER NOT NULL,
+  PRIMARY KEY (manifest_id, plugin_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_plugin_orphan_data_manifest ON plugin_orphan_data (manifest_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_plugin_orphan_data_manifest;
+DROP TABLE IF EXISTS plugin_orphan_data;

package/migrations/035_icebreaker_checkins.sql

@@ -0,0 +1,26 @@
+-- UP
+-- 课前破冰心情打卡持久化与去重（Issue #131）
+-- 记录班级、课节、学生的心情打卡状态，支持当日/当堂重复打卡幂等更新
+
+CREATE TABLE IF NOT EXISTS icebreaker_checkins (
+  id TEXT PRIMARY KEY,
+  class_id TEXT NOT NULL,
+  lesson_id TEXT,
+  scope_key TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  mood TEXT NOT NULL,
+  checkin_date TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_icebreaker_scope_student
+  ON icebreaker_checkins(class_id, scope_key, student_id);
+
+CREATE INDEX IF NOT EXISTS idx_icebreaker_lookup
+  ON icebreaker_checkins(class_id, lesson_id, checkin_date);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_icebreaker_lookup;
+DROP INDEX IF EXISTS idx_icebreaker_scope_student;
+DROP TABLE IF EXISTS icebreaker_checkins;

package/migrations/036_student_read_notifications_created_at.sql

@@ -0,0 +1,19 @@
+-- UP
+-- 学生已读通知保留策略支持：添加 created_at 时间戳列（Issue #145）
+-- 注意：SQLite 在非空表上执行 ALTER TABLE ADD COLUMN 时，禁止使用非字面常量的 DEFAULT 表达式（如 strftime）。
+-- 因此遵循 SQLite 标准做法，通过「新建临时表 + 迁移存量数据 + 替换表」实现幂等安全迁移。
+CREATE TABLE IF NOT EXISTS student_read_notifications_new (
+  student_id TEXT NOT NULL,
+  notification_id TEXT NOT NULL,
+  created_at INTEGER DEFAULT (strftime('%s','now')*1000),
+  PRIMARY KEY (student_id, notification_id)
+);
+
+INSERT OR IGNORE INTO student_read_notifications_new (student_id, notification_id, created_at)
+  SELECT student_id, notification_id, CAST(strftime('%s','now')*1000 AS INTEGER) FROM student_read_notifications;
+
+DROP TABLE IF EXISTS student_read_notifications;
+ALTER TABLE student_read_notifications_new RENAME TO student_read_notifications;
+
+-- DOWN
+ALTER TABLE student_read_notifications DROP COLUMN created_at;

package/migrations/037_plugin_config_scopes.sql

@@ -0,0 +1,40 @@
+-- Issue #151：插件配置分层（平台 → 学校 → 班级 → 插件默认值）。
+--
+-- 旧实现把配置值塞在 plugin_storage 的 `config:<key>` 里，只有一层（等价于平台层）。
+-- 新增独立表承载 scope，避免把作用域编码进 key 而无法按 scope 查询/清理。
+--
+-- 兼容性：
+-- * 建表幂等；
+-- * 旧值在迁移时原样搬到平台层（scope_type='platform', scope_id=''）；
+-- * ConfigService 仍会在新表缺行时回退读 plugin_storage，双重保险。
+
+CREATE TABLE IF NOT EXISTS plugin_config (
+  plugin_id   TEXT NOT NULL,
+  scope_type  TEXT NOT NULL DEFAULT 'platform',
+  scope_id    TEXT NOT NULL DEFAULT '',
+  key         TEXT NOT NULL,
+  value       TEXT NOT NULL,
+  updated_at  INTEGER NOT NULL,
+  PRIMARY KEY (plugin_id, scope_type, scope_id, key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_plugin_config_scope
+  ON plugin_config (plugin_id, scope_type, scope_id);
+
+-- 迁移旧值：plugin_storage.key = 'config:<key>' → plugin_config(platform, '', <key>)
+INSERT INTO plugin_config (plugin_id, scope_type, scope_id, key, value, updated_at)
+SELECT
+  plugin_id,
+  'platform',
+  '',
+  substr(key, 8),
+  value,
+  COALESCE(updated_at, 0)
+FROM plugin_storage
+WHERE key LIKE 'config:%'
+ON CONFLICT (plugin_id, scope_type, scope_id, key) DO NOTHING;
+
+-- DOWN
+-- 回滚只删新表/索引：旧值仍在 plugin_storage，回退到旧版 ConfigService 后可继续读取。
+DROP INDEX IF EXISTS idx_plugin_config_scope;
+DROP TABLE IF EXISTS plugin_config;

package/migrations/038_assessment_ai_grading_suggestion.sql

@@ -0,0 +1,10 @@
+-- Issue #187：AI 辅助批改建议（教师确认后生效）。
+--
+-- 建议与分数分开存：ai_suggestion_json 只放「建议分 + 理由 + 置信度」，
+-- 绝不直接写 score。教师确认走既有 manualGrade（manual_override = 1）。
+-- grader 列在未判分时记 'ai_suggested' 作为来源标记；已有分数的行不改 grader。
+
+ALTER TABLE assessment_answers ADD COLUMN ai_suggestion_json TEXT;
+
+-- DOWN
+ALTER TABLE assessment_answers DROP COLUMN ai_suggestion_json;

package/migrations/039_question_bank_sharing_and_papers.sql

@@ -0,0 +1,14 @@
+-- Issue #186：题库共享与按规则随机抽题（每人一卷）。
+--
+-- * question_bank_items.visibility：'private'（默认，仅 owner）| 'school'（同实例教师可见）。
+--   共享不复制条目：读取时按 owner_id + visibility 过滤。
+-- * assessment_attempts.paper_json：本次作答实际抽到的题目集合与种子（{ seed, itemIds }）。
+--   同一学生多次进入复用同一条 attempt/paper，保证题目一致；不同学生种子不同 → 卷不同。
+--   未配置抽题规则的试卷为 NULL（沿用整卷）。
+
+ALTER TABLE question_bank_items ADD COLUMN visibility TEXT NOT NULL DEFAULT 'private';
+ALTER TABLE assessment_attempts ADD COLUMN paper_json TEXT;
+
+-- DOWN
+ALTER TABLE assessment_attempts DROP COLUMN paper_json;
+ALTER TABLE question_bank_items DROP COLUMN visibility;

package/migrations/040_assignment_grade_history.sql

@@ -0,0 +1,37 @@
+-- UP
+-- 成绩审计与手动分保护（P1 审计修复）：
+--   1. assignment_grade_history：每次成绩变更一行，记录旧/新分数、状态、来源与操作者，
+--      用于回答「这个分数是谁、什么时候、为什么改的」。
+--   2. assignment_submissions.graded_by：最后一次成绩写入的操作者
+--      （`user:<id>:<role>` 或 `system`），学期成绩页可据此展示录入人。
+--   3. source 补齐：历史遗留 NULL（手动按钮、插件投影、学期成绩同步）按 manual 处理。
+--      自动录入只覆盖 source='auto' 的行，NULL 若不回填会被当成「未保护」直接冲掉。
+--   4. 缺考行（status='absent'）继续保持 source='manual'，自动规则不得覆盖。
+
+CREATE TABLE IF NOT EXISTS assignment_grade_history (
+  id TEXT PRIMARY KEY,
+  assignment_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  old_score REAL,
+  new_score REAL,
+  old_status TEXT,
+  new_status TEXT,
+  old_source TEXT,
+  new_source TEXT,
+  actor_id TEXT,
+  actor_role TEXT,
+  reason TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_assignment_grade_history_target
+  ON assignment_grade_history(assignment_id, student_id, created_at);
+
+ALTER TABLE assignment_submissions ADD COLUMN graded_by TEXT;
+
+UPDATE assignment_submissions SET source = 'manual' WHERE source IS NULL;
+
+-- DOWN
+DROP INDEX IF EXISTS idx_assignment_grade_history_target;
+DROP TABLE IF EXISTS assignment_grade_history;
+ALTER TABLE assignment_submissions DROP COLUMN graded_by;