openlearn-next 0.4.2 → 0.7.3

package/migrations/007_interactive_classroom.sql

@@ -0,0 +1,119 @@
+-- UP
+-- Interactive Classroom & Lesson Lifecycle Runtime Tables
+
+CREATE TABLE IF NOT EXISTS lesson_quiz_submissions (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  element_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  student_name TEXT,
+  answer TEXT NOT NULL,
+  score REAL DEFAULT 0,
+  is_correct INTEGER DEFAULT 0,
+  time_spent_ms INTEGER DEFAULT 0,
+  submitted_at INTEGER NOT NULL,
+  -- CONCUR-01：唯一键必须含 lesson_id。否则同一 element_id 被多个课节
+  -- 复用时（课程复制 / 同模板多节课），后一节课的作答会覆盖前一节课的记录。
+  UNIQUE(lesson_id, element_id, student_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_lqs_lesson_element ON lesson_quiz_submissions(lesson_id, element_id);
+CREATE INDEX IF NOT EXISTS idx_lqs_lesson_student ON lesson_quiz_submissions(lesson_id, student_id);
+CREATE INDEX IF NOT EXISTS idx_lqs_student ON lesson_quiz_submissions(student_id);
+
+CREATE TABLE IF NOT EXISTS classroom_sessions (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  class_id TEXT,
+  teacher_id TEXT NOT NULL,
+  stage TEXT DEFAULT 'PRE_CLASS_READY',
+  current_segment_id TEXT,
+  checkin_code TEXT,
+  focus_mode INTEGER DEFAULT 0,
+  started_at INTEGER,
+  ended_at INTEGER,
+  settings_json TEXT DEFAULT '{}',
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_cs_lesson ON classroom_sessions(lesson_id, stage);
+
+CREATE TABLE IF NOT EXISTS classroom_quick_polls (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  question_type TEXT NOT NULL,
+  title TEXT,
+  options_json TEXT NOT NULL,
+  correct_option TEXT,
+  status TEXT DEFAULT 'ACTIVE',
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_cqp_session ON classroom_quick_polls(session_id, status);
+
+CREATE TABLE IF NOT EXISTS classroom_poll_votes (
+  id TEXT PRIMARY KEY,
+  poll_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  student_name TEXT,
+  selected_option TEXT NOT NULL,
+  voted_at INTEGER NOT NULL,
+  UNIQUE(poll_id, student_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cpv_poll ON classroom_poll_votes(poll_id);
+
+CREATE TABLE IF NOT EXISTS classroom_buzzers (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  title TEXT,
+  status TEXT DEFAULT 'READY',
+  winner_student_id TEXT,
+  winner_student_name TEXT,
+  winner_response_time_ms INTEGER,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS classroom_exit_tickets (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  student_name TEXT,
+  rating INTEGER,
+  puzzled_concept TEXT,
+  feedback TEXT,
+  created_at INTEGER NOT NULL,
+  UNIQUE(session_id, student_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cet_session ON classroom_exit_tickets(session_id);
+
+CREATE TABLE IF NOT EXISTS classroom_pacing_signals (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  signal_type TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_cps_session ON classroom_pacing_signals(session_id, created_at);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_cps_session;
+DROP TABLE IF EXISTS classroom_pacing_signals;
+DROP INDEX IF EXISTS idx_cet_session;
+DROP TABLE IF EXISTS classroom_exit_tickets;
+DROP TABLE IF EXISTS classroom_buzzers;
+DROP INDEX IF EXISTS idx_cpv_poll;
+DROP TABLE IF EXISTS classroom_poll_votes;
+DROP INDEX IF EXISTS idx_cqp_session;
+DROP TABLE IF EXISTS classroom_quick_polls;
+DROP INDEX IF EXISTS idx_cs_lesson;
+DROP TABLE IF EXISTS classroom_sessions;
+DROP INDEX IF EXISTS idx_lqs_lesson_student;
+DROP INDEX IF EXISTS idx_lqs_student;
+DROP INDEX IF EXISTS idx_lqs_lesson_element;
+DROP TABLE IF EXISTS lesson_quiz_submissions;

package/migrations/008_teaching_modes.sql

@@ -0,0 +1,36 @@
+-- UP
+-- 教学模式（Teaching Modes）
+--
+-- 课堂启动门户（Classroom Entry Portal）的「教学模式选择器」数据源。
+-- 教师为当次课堂选择一种教学模式，用于匹配合适的课堂节奏与互动策略。
+--
+-- 设计取舍：内置模式定义在代码常量中（server/routes/classroom.ts 的
+-- BUILTIN_TEACHING_MODES），不在此处 seed。原因是内置模式的文案需要跟随
+-- i18n 与产品迭代变化，写进迁移会造成「迁移与业务常量两处维护」。
+-- API 读取时以「数据库记录优先 + 内置常量兜底」合并返回；
+-- is_builtin 用于禁止删除内置模式。
+
+CREATE TABLE IF NOT EXISTS teaching_modes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  name_en TEXT,
+  description TEXT,
+  description_en TEXT,
+  icon TEXT,
+  color TEXT,
+  is_builtin INTEGER DEFAULT 0,
+  sort_order INTEGER DEFAULT 100,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_teaching_modes_sort ON teaching_modes(sort_order, created_at);
+
+-- 当次课堂选用的教学模式。单独成列而非写入 settings_json，便于后续按模式
+-- 聚合教学行为分布（如「不同模式下的互动次数 / 专注率」对比分析）。
+ALTER TABLE classroom_sessions ADD COLUMN teaching_mode_id TEXT;
+
+-- DOWN
+DROP INDEX IF EXISTS idx_teaching_modes_sort;
+DROP TABLE IF EXISTS teaching_modes;
+ALTER TABLE classroom_sessions DROP COLUMN teaching_mode_id;

package/migrations/009_classroom_peer_review.sql

@@ -0,0 +1,159 @@
+-- UP
+-- ═══════════════════════════════════════════════════════════════════════════
+-- 009_classroom_peer_review.sql — 课中全班大屏互评（Peer Review Showcase）
+--
+-- 背景：`src/features/classroom/peer-review/*`（Stitch 21e2dac1 全班大屏作业互评）
+-- 此前只有前端 UI，无任何后端表；界面靠内置 mock 学生/作品/评分渲染。
+-- 本迁移补齐课中互评的真实数据模型，使互评秀场可用真实数据驱动。
+--
+-- 与既有「作业级互评」（005_assignment_hub.sql 的 plugin_peer_review_*）的区别：
+--   plugin_peer_review_*  作业为中心，跨课时生效，带双盲/量规/截止
+--   classroom_peer_review_* 课堂为中心，随 session 生命周期，服务课中大屏场景
+-- 两者互不影响，可并存。
+--
+-- 设计要点：
+--   1. 所有表以 session_id 为主归属（课堂实时数据随会话结束即冻结）；
+--   2. 分配任务唯一键 (session_id, reviewer_id, target_attempt_id) —— 防止
+--      同一评阅人对同一份作品重复分配；
+--   3. 评语唯一键 (session_id, reviewer_id, target_attempt_id) —— 支持重复修改
+--      （同一条记录被 UPDATE），避免刷出多条互评记录；
+--   4. 目标作品用 courseware_attempt.id 引用（不冗余作品内容），便于大屏展示
+--      时按需联表取真实成绩与完成度；
+--   5. 徽章/提名/弹幕均为真实课堂互动事件，供大屏实时展示与统计。
+-- ═══════════════════════════════════════════════════════════════════════════
+
+-- ── 1. 互评任务分配 ────────────────────────────────────────────────────────
+-- 教师一键「1 生评 2 份」时写入；学生端按此拉取自己的待评列表。
+CREATE TABLE IF NOT EXISTS classroom_peer_review_tasks (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  class_id TEXT,
+  -- 评阅人（学生）
+  reviewer_id TEXT NOT NULL,
+  reviewer_name TEXT,
+  -- 被评对象：提交作品的学生 + 具体 attempt（真实课件作答）
+  target_student_id TEXT NOT NULL,
+  target_student_name TEXT,
+  target_attempt_id TEXT,
+  -- 展示口径（来自 courseware_attempt 快照，避免大屏每帧联表）
+  target_work_title TEXT,
+  target_score REAL,
+  -- 分层对调：'benchmark'（标杆范本）| 'improve'（攻坚作业）
+  tier TEXT DEFAULT 'benchmark',
+  status TEXT DEFAULT 'pending', -- pending | in_progress | submitted
+  created_at INTEGER NOT NULL,
+  submitted_at INTEGER,
+  UNIQUE(session_id, reviewer_id, target_attempt_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cprt_session ON classroom_peer_review_tasks(session_id, status);
+CREATE INDEX IF NOT EXISTS idx_cprt_reviewer ON classroom_peer_review_tasks(session_id, reviewer_id);
+
+-- ── 2. 互评评语（学生提交的评分 + 评语 + 量规维度分） ─────────────────────
+-- 唯一键含 session/reviewer/target_attempt，保证「同一人评同一份作品」只有一条，
+-- 重复提交走 UPDATE（学生可反复改分直到教师锁榜）。
+CREATE TABLE IF NOT EXISTS classroom_peer_reviews (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  reviewer_id TEXT NOT NULL,
+  reviewer_name TEXT,
+  target_student_id TEXT NOT NULL,
+  target_attempt_id TEXT,
+  score REAL NOT NULL,
+  max_score REAL DEFAULT 5,
+  comment TEXT,
+  -- 量规维度分：{"algorithm":4,"style":5,...}（JSON，维度定义见 rubric 表）
+  dimension_scores_json TEXT DEFAULT '{}',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  UNIQUE(session_id, reviewer_id, target_attempt_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cpr_session ON classroom_peer_reviews(session_id, target_student_id);
+
+-- ── 3. 随堂互评微勋章（学生互赠，用于大屏徽章流） ────────────────────────
+CREATE TABLE IF NOT EXISTS classroom_peer_badges (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  sender_id TEXT NOT NULL,
+  sender_name TEXT,
+  receiver_id TEXT NOT NULL,
+  receiver_name TEXT,
+  -- 勋章类型键（对应前端徽章定义，如 'brilliant_idea' | 'self_heal' | 'best_solution'）
+  badge_key TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  UNIQUE(session_id, sender_id, receiver_id, badge_key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cpb_session ON classroom_peer_badges(session_id, receiver_id);
+
+-- ── 4. 先锋榜提名（按票数排名，供大屏领奖台） ────────────────────────────
+-- 每次提名一行（而非计数器列），便于去重与追溯；票数由 COUNT 聚合得到。
+CREATE TABLE IF NOT EXISTS classroom_peer_nominations (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  nominator_id TEXT NOT NULL,
+  nominated_student_id TEXT NOT NULL,
+  nominated_student_name TEXT,
+  honor_key TEXT, -- 荣誉标签键（如 'best_open_source' | 'best_progress'）
+  created_at INTEGER NOT NULL,
+  UNIQUE(session_id, nominator_id, nominated_student_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cpn_session ON classroom_peer_nominations(session_id, nominated_student_id);
+
+-- ── 5. 大屏弹幕（文字 / 语音弹幕） ───────────────────────────────────────
+CREATE TABLE IF NOT EXISTS classroom_danmaku (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  sender_id TEXT,
+  sender_name TEXT,
+  text TEXT NOT NULL,
+  -- 'text' | 'voice'（voice 附带时长秒数）
+  type TEXT DEFAULT 'text',
+  voice_duration_seconds INTEGER,
+  -- 弹幕纵向位置百分比（0-100），由前端随机分配后落库，保证多端位置一致
+  top_percent INTEGER DEFAULT 20,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_cd_session ON classroom_danmaku(session_id, created_at DESC);
+
+-- ── 6. 互评量规维度定义（教师可自定义，服务 rubric 看板） ─────────────────
+CREATE TABLE IF NOT EXISTS classroom_peer_rubric_dimensions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  -- 展示用色（Tailwind 类名，随主题无关的固定色板）
+  color_class TEXT,
+  bar_color_class TEXT,
+  max_score REAL DEFAULT 5,
+  weight REAL DEFAULT 1,
+  sort_order INTEGER DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  UNIQUE(session_id, label)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cprd_session ON classroom_peer_rubric_dimensions(session_id, sort_order);
+
+-- DOWN
+-- 回滚 009：删除课中全班大屏互评（Peer Review）相关表与索引
+DROP INDEX IF EXISTS idx_cprt_session;
+DROP INDEX IF EXISTS idx_cprt_reviewer;
+DROP INDEX IF EXISTS idx_cpr_session;
+DROP INDEX IF EXISTS idx_cpb_session;
+DROP INDEX IF EXISTS idx_cpn_session;
+DROP INDEX IF EXISTS idx_cd_session;
+DROP INDEX IF EXISTS idx_cprd_session;
+DROP TABLE IF EXISTS classroom_peer_rubric_dimensions;
+DROP TABLE IF EXISTS classroom_peer_nominations;
+DROP TABLE IF EXISTS classroom_peer_badges;
+DROP TABLE IF EXISTS classroom_danmaku;
+DROP TABLE IF EXISTS classroom_peer_reviews;
+DROP TABLE IF EXISTS classroom_peer_review_tasks;

package/migrations/010_class_groups.sql

@@ -0,0 +1,33 @@
+-- UP
+-- 班级固定分组（Class Seating Groups）
+--
+-- 机房管理中为班级学生建立持久化学习小组：支持自动分组、指定组长、
+-- 手动调整成员归属；上课需要分组活动时默认按该分组进行，
+-- 同时课堂内可临时新建分组或调整（临时分组只写 classroom_sessions 侧，不改本表）。
+--
+-- 设计取舍：
+--  - is_default 标记「上课默认分组方案」，同一班级至多一套；
+--  - member_ids / leader_id 用 JSON 保存整组成员与组长，
+--    组数通常为个位数、成员为几十人，单行读取即可渲染整组面板，
+--    避免额外的成员关系表与多查询往返；
+--  - name_en 记录可选英文组名，跟随平台的 i18n 口径。
+
+CREATE TABLE IF NOT EXISTS class_groups (
+  id TEXT PRIMARY KEY,
+  class_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  name_en TEXT,
+  color TEXT DEFAULT 'bg-indigo-500',
+  member_ids TEXT NOT NULL DEFAULT '[]',
+  leader_id TEXT,
+  is_default INTEGER DEFAULT 0,
+  sort_order INTEGER DEFAULT 100,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_class_groups_class ON class_groups(class_id, sort_order, created_at);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_class_groups_class;
+DROP TABLE IF EXISTS class_groups;

package/migrations/011_classroom_feed.sql

@@ -0,0 +1,34 @@
+-- UP
+-- 011: 课堂动态流持久化（课堂会话保存与恢复）
+--
+-- 背景：liveClassFeed 此前是纯前端内存态（appStore 上限 50 条），教师离开
+-- 课堂再回来后动态流清零。本表把课堂动态（随堂作答、签到、表彰、作业提交/
+-- 批改、进度里程碑等）落库为会话级事实，重进课堂时按 lesson 回放。
+--
+-- 写入方：server/services/classroom-feed-service.ts（订阅内核事件总线，
+-- 与 server/event-routing.ts 的声明式路由同款模式）。
+-- 读取方：GET /api/classroom/sessions/:lessonId 的 feedReplay 字段。
+
+CREATE TABLE IF NOT EXISTS classroom_feed (
+  id TEXT PRIMARY KEY,
+  session_id TEXT,
+  lesson_id TEXT NOT NULL,
+  class_id TEXT,
+  -- 动态类型：quiz_answered / checkin / achievement / assignment_submitted /
+  -- assignment_graded / progress / courseware_submitted / info
+  type TEXT NOT NULL,
+  message TEXT NOT NULL,
+  actor_id TEXT,
+  actor_name TEXT,
+  source TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_classroom_feed_lesson ON classroom_feed(lesson_id, created_at);
+CREATE INDEX IF NOT EXISTS idx_classroom_feed_session ON classroom_feed(session_id, created_at);
+
+-- DOWN
+-- 回滚 011：删除课堂动态流表与索引
+DROP INDEX IF EXISTS idx_classroom_feed_lesson;
+DROP INDEX IF EXISTS idx_classroom_feed_session;
+DROP TABLE IF EXISTS classroom_feed;

package/migrations/012_auto_record_score.sql

@@ -0,0 +1,48 @@
+-- UP
+-- Courseware Auto Grade Recording Rule (auto-record)
+--
+-- 把「学生提交数据」页的**逐条手动「录入成绩」**升级为**按规则自动录入**：
+-- 教师先设定规则（开关 + 完成度门槛），之后课件被提交时由服务端自动把成绩
+-- 写入学期成绩（assignment_submissions），无需逐条点击。
+--
+-- 设计要点：
+--   1. 字段挂在既有 courseware_score_config 上，复用它「课件专属 → 全局 '*' → 内置默认」
+--      的三级继承（见 packages/plugins/courseware-score.ts 的 resolveScoreConfig），
+--      不另立配置表，避免出现两套成绩配置。
+--   2. auto_record_enabled 默认 0（关闭）：不改变现有行为，教师显式开启才生效。
+--   3. auto_record_min_completion 为完成度门槛（0~1）。完成度低于门槛的提交不自动录入，
+--      留在「学生提交数据」页由教师人工判定 —— 规则只自动化"确定性足够"的记录。
+--   4. 分数始终取课件聚合分（submission_result.score）。**没有分数一律不录**，
+--      绝不凭空造分（历史上 promote 的 finalScore 默认 100 会给满分，已改为拒绝）。
+
+ALTER TABLE courseware_score_config ADD COLUMN auto_record_enabled INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE courseware_score_config ADD COLUMN auto_record_min_completion REAL NOT NULL DEFAULT 0;
+
+-- DOWN
+-- 不使用 ALTER TABLE ... DROP COLUMN（旧版 SQLite 内核不支持，且迁移执行器只对
+-- "duplicate column name" 容错，失败会中断回滚）。改为标准的「重建表」回滚。
+CREATE TABLE courseware_score_config__rollback (
+  courseware_id TEXT PRIMARY KEY,
+  courseware_name TEXT,
+  score_policy TEXT NOT NULL DEFAULT 'LATEST',
+  score_fields TEXT NOT NULL DEFAULT '',
+  raw_full_score REAL NOT NULL DEFAULT 100,
+  target_full_score REAL NOT NULL DEFAULT 100,
+  weight_percentage REAL NOT NULL DEFAULT 100,
+  lesson_id TEXT,
+  updated_at INTEGER NOT NULL DEFAULT 0
+);
+
+INSERT INTO courseware_score_config__rollback
+  (courseware_id, courseware_name, score_policy, score_fields,
+   raw_full_score, target_full_score, weight_percentage, lesson_id, updated_at)
+SELECT
+  courseware_id, courseware_name, score_policy, score_fields,
+  raw_full_score, target_full_score, weight_percentage, lesson_id, updated_at
+FROM courseware_score_config;
+
+DROP TABLE courseware_score_config;
+
+ALTER TABLE courseware_score_config__rollback RENAME TO courseware_score_config;
+
+CREATE INDEX IF NOT EXISTS idx_courseware_score_config_lesson ON courseware_score_config(lesson_id);

package/migrations/013_score_source_strategy.sql

@@ -0,0 +1,81 @@
+-- UP
+-- 成绩来源（source）与自动录入更新策略（auto_record_strategy）
+--
+-- 背景（2026-09-30 审计教学缺口 2）：
+--   1. 自动录入（autoRecordAttempt，submit_attempt 实时触发）无条件 upsert 覆盖
+--      —— 教师手动调整过的分数会被课件分冲掉。
+--   2. 批量补录（autoRecordForLesson）只要已有成绩行就跳过
+--      —— 学生重做课件后，自动录入的旧分永不更新。
+--   根因是 assignment_submissions 无法区分「手动录入」与「自动录入」。
+--
+-- 设计要点：
+--   1. source 列区分成绩来源：'manual'（教师录入/改判，受保护）与 'auto'（规则自动录入，可刷新）。
+--      auto 路径遇 source='manual' 跳过（manual-protected），auto 行按策略刷新。
+--   2. 存量回填：自动路径写入的 feedback 固定以「由自动录入规则。」开头
+--      （见 auto-record-score.ts 的 sourceLabel），据此回填 source='auto'；其余一律 'manual'
+--      （含历史自动录入但 feedback 文案不符合的行 —— 宁可多保护，不可误覆盖）。
+--   3. status='absent'（缺考）行在 auto 路径同样受保护（absent-protected），见 commit 3。
+--   4. auto_record_strategy 挂在既有 courseware_score_config 上，复用其三级继承：
+--      'latest'（默认，最新一次 attempt 分数覆盖）/ 'highest'（仅新分更高才覆盖，鼓励重做）。
+
+ALTER TABLE assignment_submissions ADD COLUMN source TEXT;
+
+UPDATE assignment_submissions SET source =
+  CASE WHEN feedback LIKE '由自动录入规则。%' THEN 'auto' ELSE 'manual' END;
+
+ALTER TABLE courseware_score_config ADD COLUMN auto_record_strategy TEXT NOT NULL DEFAULT 'latest';
+
+-- DOWN
+-- 「重建表」回滚（同 012：不用 ALTER TABLE ... DROP COLUMN，旧版 SQLite 内核不支持）。
+
+CREATE TABLE assignment_submissions__rollback (
+  assignment_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  content TEXT,
+  score INTEGER,
+  feedback TEXT,
+  submitted_at INTEGER NOT NULL,
+  graded_at INTEGER,
+  status TEXT NOT NULL DEFAULT 'submitted',
+  PRIMARY KEY (assignment_id, student_id)
+);
+
+INSERT INTO assignment_submissions__rollback
+  (assignment_id, student_id, content, score, feedback, submitted_at, graded_at, status)
+SELECT
+  assignment_id, student_id, content, score, feedback, submitted_at, graded_at, status
+FROM assignment_submissions;
+
+DROP TABLE assignment_submissions;
+
+ALTER TABLE assignment_submissions__rollback RENAME TO assignment_submissions;
+
+CREATE TABLE courseware_score_config__rollback (
+  courseware_id TEXT PRIMARY KEY,
+  courseware_name TEXT,
+  score_policy TEXT NOT NULL DEFAULT 'LATEST',
+  score_fields TEXT NOT NULL DEFAULT '',
+  raw_full_score REAL NOT NULL DEFAULT 100,
+  target_full_score REAL NOT NULL DEFAULT 100,
+  weight_percentage REAL NOT NULL DEFAULT 100,
+  lesson_id TEXT,
+  updated_at INTEGER NOT NULL DEFAULT 0,
+  auto_record_enabled INTEGER NOT NULL DEFAULT 0,
+  auto_record_min_completion REAL NOT NULL DEFAULT 0
+);
+
+INSERT INTO courseware_score_config__rollback
+  (courseware_id, courseware_name, score_policy, score_fields,
+   raw_full_score, target_full_score, weight_percentage, lesson_id, updated_at,
+   auto_record_enabled, auto_record_min_completion)
+SELECT
+  courseware_id, courseware_name, score_policy, score_fields,
+  raw_full_score, target_full_score, weight_percentage, lesson_id, updated_at,
+  auto_record_enabled, auto_record_min_completion
+FROM courseware_score_config;
+
+DROP TABLE courseware_score_config;
+
+ALTER TABLE courseware_score_config__rollback RENAME TO courseware_score_config;
+
+CREATE INDEX IF NOT EXISTS idx_courseware_score_config_lesson ON courseware_score_config(lesson_id);

package/migrations/014_performance_indexes.sql

@@ -0,0 +1,21 @@
+-- UP
+-- 性能索引补充（DATA-INT-02 / 路线图 A6）
+--
+-- 高频查询路径缺失索引，数据量增长后退化为全表扫描：
+--   1. vfs_nodes(parent_id)：VFS 目录树逐级下钻（workspace GET /files/* 每层一次 parent 查询）
+--   2. plugin_submissions(lesson_id)：插件提交按课节检索
+--   3. student_point_logs(student_id)：积分台账按学生检索
+--   4. student_rollcalls(class_id) / (student_id)：点名记录按班级/学生检索
+
+CREATE INDEX IF NOT EXISTS idx_vfs_nodes_parent ON vfs_nodes(parent_id);
+CREATE INDEX IF NOT EXISTS idx_plugin_submissions_lesson ON plugin_submissions(lesson_id);
+CREATE INDEX IF NOT EXISTS idx_student_point_logs_student ON student_point_logs(student_id);
+CREATE INDEX IF NOT EXISTS idx_student_rollcalls_class ON student_rollcalls(class_id);
+CREATE INDEX IF NOT EXISTS idx_student_rollcalls_student ON student_rollcalls(student_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_student_rollcalls_student;
+DROP INDEX IF EXISTS idx_student_rollcalls_class;
+DROP INDEX IF EXISTS idx_student_point_logs_student;
+DROP INDEX IF EXISTS idx_plugin_submissions_lesson;
+DROP INDEX IF EXISTS idx_vfs_nodes_parent;

package/migrations/015_demo_data_registry.sql

@@ -0,0 +1,26 @@
+-- UP
+-- 演示数据登记表（DEMO-SEED-01）
+--
+-- 一键演示数据的**精确作用域**保障。
+--
+-- 背景：既有 `POST /api/admin/seed-demo` 依赖标题模糊匹配来识别演示数据
+-- （`title LIKE 'E2E %'`），无法区分"演示数据"与"恰好同名的真实数据"，
+-- 清理时存在误伤风险。本表记录播种时**实际创建的每一行**，清理时据此
+-- 精确删除，不再依赖任何命名约定。
+--
+-- 约束：
+--   1. 清理只删除本表登记的行；未登记的一律不碰。
+--   2. 管理员账号（users.role='administrator'）永不删除，代码侧另有兜底断言。
+
+CREATE TABLE IF NOT EXISTS demo_data_registry (
+  entity_type TEXT NOT NULL,
+  entity_id   TEXT NOT NULL,
+  created_at  INTEGER NOT NULL,
+  PRIMARY KEY (entity_type, entity_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_demo_data_registry_type ON demo_data_registry(entity_type);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_demo_data_registry_type;
+DROP TABLE IF EXISTS demo_data_registry;

package/migrations/016_preset_polls_and_passcode_expiry.sql

@@ -0,0 +1,33 @@
+-- UP
+-- 016_preset_polls_and_passcode_expiry.sql
+-- 补齐课程预设投票表与班级口令有效期、梯级下课条、随机点名奖赏字段
+
+CREATE TABLE IF NOT EXISTS lesson_preset_polls (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  question_type TEXT NOT NULL DEFAULT 'ABCD',
+  options_json TEXT NOT NULL,
+  correct_option TEXT,
+  sort_order INTEGER DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_lpp_lesson ON lesson_preset_polls(lesson_id);
+
+ALTER TABLE classes ADD COLUMN class_passcode_expires_at INTEGER;
+
+ALTER TABLE student_rollcalls ADD COLUMN rating TEXT;
+ALTER TABLE student_rollcalls ADD COLUMN score INTEGER DEFAULT 0;
+ALTER TABLE student_rollcalls ADD COLUMN reward_coins INTEGER DEFAULT 0;
+ALTER TABLE student_rollcalls ADD COLUMN difficulty TEXT;
+
+ALTER TABLE classroom_exit_tickets ADD COLUMN core_answer TEXT;
+ALTER TABLE classroom_exit_tickets ADD COLUMN is_correct INTEGER DEFAULT 0;
+ALTER TABLE classroom_exit_tickets ADD COLUMN tier_level TEXT DEFAULT 'passed';
+ALTER TABLE classroom_exit_tickets ADD COLUMN challenge_answer TEXT;
+
+-- DOWN
+DROP INDEX IF EXISTS idx_lpp_lesson;
+DROP TABLE IF EXISTS lesson_preset_polls;

package/migrations/017_pacing_signals_segment.sql

@@ -0,0 +1,6 @@
+-- UP
+ALTER TABLE classroom_pacing_signals ADD COLUMN segment_id TEXT;
+CREATE INDEX IF NOT EXISTS idx_cps_session_segment ON classroom_pacing_signals(session_id, segment_id, student_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_cps_session_segment;

package/migrations/018_processes_plugin_owner.sql

@@ -0,0 +1,26 @@
+-- UP
+-- 018_processes_plugin_owner.sql
+-- 审计项 B-5：processes 表补 plugin_id，让后台任务的归属可判定。
+--
+-- 背景：ProcessManager.spawn / registerInterval 把任务写进全局 processes 表，
+-- 且 processId 经全局事件总线 `process.spawned` 广播（任意插件可订阅拿到）。
+-- 但 kill(processId) 只按 id UPDATE、无归属校验 —— 插件可以杀掉他人后台任务。
+-- 没有 plugin_id 列就无法判定归属，只能靠内存 Map（重启即丢，且 restore()
+-- 从 DB 重建的任务会失去归属信息），故落成列。
+--
+-- 历史行为：存量行的 plugin_id 为 NULL，表示「非插件进程」（内核自身任务）。
+-- kill 校验对 NULL 的处理见 context-builder.wrapProcessManager 的 isOwnProcess：
+-- 查不到归属时不拦截，避免误杀内核任务与存量行。
+
+ALTER TABLE processes ADD COLUMN plugin_id TEXT;
+
+-- 归属查询的热路径：按 owner 列出其全部进程
+CREATE INDEX IF NOT EXISTS idx_processes_plugin_id ON processes(plugin_id);
+
+-- 按 owner + 状态筛选（restore 只需处理 running，但内核自身任务 owner 为 NULL）
+CREATE INDEX IF NOT EXISTS idx_processes_plugin_status ON processes(plugin_id, status);
+-- DOWN
+DROP INDEX IF EXISTS idx_processes_plugin_status;
+DROP INDEX IF EXISTS idx_processes_plugin_id;
+-- SQLite 3.35+ 支持 DROP COLUMN；旧版走表重建兜底由 migrate 层处理
+ALTER TABLE processes DROP COLUMN plugin_id;