openlearn-next 0.4.2 → 0.7.3

package/migrations/000_initial_schema.sql

@@ -0,0 +1,410 @@
+-- UP
+-- OpenLearn Core Initial Schema
+
+CREATE TABLE IF NOT EXISTS events (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  source TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  timestamp INTEGER NOT NULL,
+  correlationId TEXT
+);
+
+CREATE TABLE IF NOT EXISTS lessons (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  content TEXT,
+  timeline TEXT,
+  progress_mode TEXT DEFAULT 'manual',
+  progress_conditions TEXT,
+  creator_id TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS whiteboard_elements (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  data TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS plugins (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  manifest TEXT NOT NULL,
+  source_code TEXT NOT NULL,
+  status TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  loader_version TEXT DEFAULT 'vm',
+  zip_package BLOB,
+  file_path TEXT DEFAULT NULL,
+  updated_at INTEGER DEFAULT NULL
+);
+
+CREATE TABLE IF NOT EXISTS plugin_storage (
+  plugin_id TEXT NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (plugin_id, key)
+);
+
+CREATE TABLE IF NOT EXISTS pending_commands (
+  id TEXT PRIMARY KEY,
+  command_type TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  actor_id TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS processes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  status TEXT NOT NULL,
+  task_type TEXT,
+  payload TEXT,
+  state TEXT,
+  logs TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS vfs_nodes (
+  id TEXT PRIMARY KEY,
+  parent_id TEXT,
+  type TEXT NOT NULL,
+  name TEXT NOT NULL,
+  content TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS classes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  lab_id TEXT,
+  class_passcode TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS students (
+  id TEXT PRIMARY KEY,
+  student_number TEXT UNIQUE,
+  name TEXT NOT NULL,
+  email TEXT,
+  password TEXT,
+  locked_lesson_id TEXT,
+  private_notes TEXT,
+  avatar TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS class_students (
+  class_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  joined_at INTEGER NOT NULL,
+  PRIMARY KEY (class_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS student_lesson_progress (
+  student_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  completed INTEGER NOT NULL DEFAULT 0,
+  progress_percent INTEGER NOT NULL DEFAULT 0,
+  completed_segments TEXT,
+  assigned_at INTEGER NOT NULL,
+  PRIMARY KEY (student_id, lesson_id)
+);
+
+CREATE TABLE IF NOT EXISTS assignments (
+  id TEXT PRIMARY KEY,
+  class_id TEXT NOT NULL,
+  lesson_id TEXT,
+  title TEXT NOT NULL,
+  description TEXT,
+  content TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS assignment_submissions (
+  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)
+);
+
+CREATE TABLE IF NOT EXISTS schedules (
+  id TEXT PRIMARY KEY,
+  class_id TEXT NOT NULL,
+  lesson_id TEXT NOT NULL,
+  scheduled_date TEXT NOT NULL,
+  time_slot TEXT,
+  status TEXT DEFAULT 'scheduled',
+  notes TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS attendance (
+  schedule_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  status TEXT NOT NULL,
+  recorded_at INTEGER NOT NULL,
+  PRIMARY KEY (schedule_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS system_resources (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,
+  content TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS computer_labs (
+  id TEXT PRIMARY KEY,
+  room_number TEXT NOT NULL,
+  rows INTEGER NOT NULL,
+  cols INTEGER NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS student_seats (
+  class_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  lab_id TEXT NOT NULL,
+  row_idx INTEGER NOT NULL,
+  col_idx INTEGER NOT NULL,
+  PRIMARY KEY (class_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  username TEXT UNIQUE NOT NULL,
+  password_hash TEXT NOT NULL,
+  role TEXT NOT NULL,
+  name TEXT NOT NULL,
+  status TEXT DEFAULT 'active',
+  avatar TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS client_sessions (
+  id TEXT PRIMARY KEY,
+  session_data TEXT NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS student_read_notifications (
+  student_id TEXT NOT NULL,
+  notification_id TEXT NOT NULL,
+  PRIMARY KEY (student_id, notification_id)
+);
+
+CREATE TABLE IF NOT EXISTS ai_providers (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  api_url TEXT NOT NULL,
+  api_key TEXT,
+  model_name TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS exams (
+  id TEXT PRIMARY KEY,
+  class_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  max_score INTEGER NOT NULL DEFAULT 100,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS exam_scores (
+  exam_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  score REAL,
+  notes TEXT,
+  recorded_at INTEGER NOT NULL,
+  PRIMARY KEY (exam_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS class_grade_weights (
+  class_id TEXT PRIMARY KEY,
+  attendance_weight REAL NOT NULL DEFAULT 0.15,
+  progress_weight REAL NOT NULL DEFAULT 0.25,
+  assignment_weight REAL NOT NULL DEFAULT 0.35,
+  exam_weight REAL NOT NULL DEFAULT 0.25,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS student_semester_reports (
+  id TEXT PRIMARY KEY,
+  student_id TEXT NOT NULL,
+  class_id TEXT NOT NULL,
+  semester_name TEXT NOT NULL,
+  attendance_score REAL NOT NULL,
+  progress_score REAL NOT NULL,
+  assignment_score REAL NOT NULL,
+  exam_score REAL NOT NULL,
+  total_score REAL NOT NULL,
+  grade_level TEXT NOT NULL,
+  teacher_evaluation TEXT,
+  ai_evaluation TEXT,
+  dimension_scores TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  UNIQUE(student_id, class_id, semester_name)
+);
+
+CREATE TABLE IF NOT EXISTS student_point_logs (
+  id TEXT PRIMARY KEY,
+  student_id TEXT NOT NULL,
+  class_id TEXT NOT NULL,
+  dimension_id TEXT NOT NULL,
+  plugin_id TEXT,
+  delta_points REAL NOT NULL,
+  reason TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS courseware (
+  id TEXT PRIMARY KEY,
+  uuid TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  type TEXT,
+  entry TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS courseware_attempt (
+  id TEXT PRIMARY KEY,
+  courseware_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  started_at INTEGER NOT NULL,
+  finished_at INTEGER,
+  status TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS submission_raw (
+  id TEXT PRIMARY KEY,
+  attempt_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS submission_result (
+  id TEXT PRIMARY KEY,
+  attempt_id TEXT NOT NULL,
+  score REAL,
+  comment TEXT,
+  completion REAL,
+  extra_json TEXT
+);
+
+CREATE TABLE IF NOT EXISTS mfe_remotes (
+  name TEXT PRIMARY KEY,
+  entry TEXT NOT NULL,
+  meta TEXT DEFAULT '{}',
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS plugin_submissions (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  version INTEGER NOT NULL DEFAULT 1,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  UNIQUE(lesson_id, student_id)
+);
+
+CREATE TABLE IF NOT EXISTS plugin_peer_reviews (
+  id TEXT PRIMARY KEY,
+  submission_id TEXT NOT NULL,
+  reviewer_id TEXT NOT NULL,
+  score INTEGER NOT NULL,
+  comment TEXT,
+  created_at INTEGER NOT NULL,
+  UNIQUE(submission_id, reviewer_id)
+);
+
+CREATE TABLE IF NOT EXISTS plugin_grades (
+  id TEXT PRIMARY KEY,
+  submission_id TEXT NOT NULL UNIQUE,
+  teacher_score INTEGER,
+  teacher_comment TEXT,
+  teacher_weight REAL NOT NULL DEFAULT 0.6,
+  peer_weight REAL NOT NULL DEFAULT 0.4,
+  calculated_final_score INTEGER,
+  status TEXT NOT NULL DEFAULT 'draft',
+  graded_at INTEGER
+);
+
+-- Performance Indexes
+CREATE INDEX IF NOT EXISTS idx_whiteboard_lesson ON whiteboard_elements(lesson_id);
+CREATE INDEX IF NOT EXISTS idx_class_students_class ON class_students(class_id);
+CREATE INDEX IF NOT EXISTS idx_class_students_student ON class_students(student_id);
+CREATE INDEX IF NOT EXISTS idx_schedules_class_date ON schedules(class_id, scheduled_date);
+CREATE INDEX IF NOT EXISTS idx_courseware_attempt_cw_st ON courseware_attempt(courseware_id, student_id);
+CREATE INDEX IF NOT EXISTS idx_submission_result_attempt ON submission_result(attempt_id);
+CREATE INDEX IF NOT EXISTS idx_events_type_time ON events(type, timestamp);
+CREATE INDEX IF NOT EXISTS idx_assignments_class ON assignments(class_id);
+CREATE INDEX IF NOT EXISTS idx_attendance_schedule ON attendance(schedule_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_attendance_schedule;
+DROP INDEX IF EXISTS idx_assignments_class;
+DROP INDEX IF EXISTS idx_events_type_time;
+DROP INDEX IF EXISTS idx_submission_result_attempt;
+DROP INDEX IF EXISTS idx_courseware_attempt_cw_st;
+DROP INDEX IF EXISTS idx_schedules_class_date;
+DROP INDEX IF EXISTS idx_class_students_student;
+DROP INDEX IF EXISTS idx_class_students_class;
+DROP INDEX IF EXISTS idx_whiteboard_lesson;
+DROP TABLE IF EXISTS plugin_grades;
+DROP TABLE IF EXISTS plugin_peer_reviews;
+DROP TABLE IF EXISTS plugin_submissions;
+DROP TABLE IF EXISTS mfe_remotes;
+DROP TABLE IF EXISTS submission_result;
+DROP TABLE IF EXISTS submission_raw;
+DROP TABLE IF EXISTS courseware_attempt;
+DROP TABLE IF EXISTS courseware;
+DROP TABLE IF EXISTS student_point_logs;
+DROP TABLE IF EXISTS student_semester_reports;
+DROP TABLE IF EXISTS class_grade_weights;
+DROP TABLE IF EXISTS exam_scores;
+DROP TABLE IF EXISTS exams;
+DROP TABLE IF EXISTS ai_providers;
+DROP TABLE IF EXISTS student_read_notifications;
+DROP TABLE IF EXISTS client_sessions;
+DROP TABLE IF EXISTS users;
+DROP TABLE IF EXISTS student_seats;
+DROP TABLE IF EXISTS computer_labs;
+DROP TABLE IF EXISTS system_resources;
+DROP TABLE IF EXISTS attendance;
+DROP TABLE IF EXISTS schedules;
+DROP TABLE IF EXISTS assignment_submissions;
+DROP TABLE IF EXISTS assignments;
+DROP TABLE IF EXISTS student_lesson_progress;
+DROP TABLE IF EXISTS class_students;
+DROP TABLE IF EXISTS students;
+DROP TABLE IF EXISTS classes;
+DROP TABLE IF EXISTS vfs_nodes;
+DROP TABLE IF EXISTS processes;
+DROP TABLE IF EXISTS pending_commands;
+DROP TABLE IF EXISTS plugin_storage;
+DROP TABLE IF EXISTS plugins;
+DROP TABLE IF EXISTS whiteboard_elements;
+DROP TABLE IF EXISTS lessons;
+DROP TABLE IF EXISTS events;

package/migrations/001_add_execution_mode.sql

@@ -0,0 +1,6 @@
+-- UP
+-- Phase 5: Worker isolation mode support — execution_mode column for plugins table
+ALTER TABLE plugins ADD COLUMN execution_mode TEXT DEFAULT 'inline';
+
+-- DOWN
+-- Note: SQLite does not support DROP COLUMN in earlier versions without table recreation.

package/migrations/002_add_client_session_expiry.sql

@@ -0,0 +1,6 @@
+-- UP
+-- SEC-AUTH-03: client_sessions 添加 expires_at 列
+ALTER TABLE client_sessions ADD COLUMN expires_at INTEGER;
+
+-- DOWN
+-- Note: SQLite does not support DROP COLUMN in earlier versions without table recreation.

package/migrations/003_classroom_runtime.sql

@@ -0,0 +1,33 @@
+-- UP
+-- Classroom and AI Assistant Runtime Tables
+
+CREATE TABLE IF NOT EXISTS student_rollcalls (
+  id TEXT PRIMARY KEY,
+  student_id TEXT NOT NULL,
+  class_id TEXT,
+  lesson_id TEXT,
+  picked_time INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS site_settings (
+  id TEXT PRIMARY KEY,
+  site_name TEXT,
+  slogan TEXT,
+  logo_url TEXT
+);
+
+CREATE TABLE IF NOT EXISTS agent_conversations (
+  id TEXT PRIMARY KEY,
+  conv_key TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_conv_key ON agent_conversations(conv_key, created_at);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_agent_conv_key;
+DROP TABLE IF EXISTS agent_conversations;
+DROP TABLE IF EXISTS site_settings;
+DROP TABLE IF EXISTS student_rollcalls;

package/migrations/004_courseware_score_config.sql

@@ -0,0 +1,26 @@
+-- UP
+-- Courseware Score Aggregation Policy (native / platform side)
+--
+-- 记录每个互动课件的「成绩归集策略」：同一个 attempt 往往会产生多次分数样本
+-- （学生反复提交、或平台分数变量监视器持续采样），宿主按此策略决定最终成绩，
+-- 使记录层（submission_raw -> submission_result）自身闭环，不再依赖某个插件。
+--
+-- courseware_id = '*' 表示全局默认策略（课件没有单独配置时使用）。
+
+CREATE TABLE IF NOT EXISTS courseware_score_config (
+  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
+);
+
+CREATE INDEX IF NOT EXISTS idx_courseware_score_config_lesson ON courseware_score_config(lesson_id);
+
+-- DOWN
+DROP INDEX IF EXISTS idx_courseware_score_config_lesson;
+DROP TABLE IF EXISTS courseware_score_config;

package/migrations/005_assignment_hub.sql

@@ -0,0 +1,155 @@
+-- UP
+-- 作业中心（Assignment Hub）
+--
+-- 背景：白板上的「课堂作业任务」教学对象此前只有一个模拟上传按钮，而平台真正的
+-- 提交/互评/评分链路（plugin_submissions / plugin_peer_reviews / plugin_grades）
+-- 只按 lesson_id 记录、且重交会覆盖历史。本次把作业提升为一等实体：
+--   plugin_assignments       作业实体（可同时挂 lesson_id + class_id + 白板元素 id）
+--   plugin_submission_versions 每次提交留档（重交不丢历史）
+--   plugin_assignment_files   上传文件元数据（实体文件落盘，下载端点据此鉴权）
+--   plugin_peer_review_tasks  互评任务分配（谁评谁 / 匿名 / 截止）
+-- 并给 plugin_submissions 增加 assignment_id、plugin_grades / plugin_peer_reviews
+-- 补充作业维度与发布字段。
+
+CREATE TABLE IF NOT EXISTS plugin_assignments (
+  id TEXT PRIMARY KEY,
+  class_id TEXT,
+  lesson_id TEXT,
+  element_id TEXT,
+  title TEXT NOT NULL,
+  description TEXT,
+  instructions TEXT,
+  due_at INTEGER,
+  allow_late INTEGER NOT NULL DEFAULT 1,
+  allow_text INTEGER NOT NULL DEFAULT 1,
+  allow_link INTEGER NOT NULL DEFAULT 0,
+  max_files INTEGER NOT NULL DEFAULT 10,
+  max_file_size INTEGER NOT NULL DEFAULT 20971520,
+  allowed_ext TEXT NOT NULL DEFAULT '',
+  peer_review_mode TEXT NOT NULL DEFAULT 'assigned',
+  peer_review_count INTEGER NOT NULL DEFAULT 2,
+  peer_review_due_at INTEGER,
+  teacher_weight REAL NOT NULL DEFAULT 0.6,
+  peer_weight REAL NOT NULL DEFAULT 0.4,
+  status TEXT NOT NULL DEFAULT 'published',
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_plugin_assignments_element ON plugin_assignments(element_id);
+CREATE INDEX IF NOT EXISTS idx_plugin_assignments_lesson ON plugin_assignments(lesson_id);
+CREATE INDEX IF NOT EXISTS idx_plugin_assignments_class ON plugin_assignments(class_id);
+
+-- plugin_submissions 需要从「按 lesson 唯一」改为「按 assignment 唯一」，
+-- SQLite 无法删除表级 UNIQUE 约束，因此重建表并保留旧数据（旧数据 assignment_id 为 NULL）。
+CREATE TABLE IF NOT EXISTS plugin_submissions_new (
+  id TEXT PRIMARY KEY,
+  assignment_id TEXT,
+  lesson_id TEXT,
+  student_id TEXT NOT NULL,
+  file_path TEXT,
+  version INTEGER NOT NULL DEFAULT 1,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+INSERT OR IGNORE INTO plugin_submissions_new
+  (id, assignment_id, lesson_id, student_id, file_path, version, created_at, updated_at)
+SELECT id, NULL, lesson_id, student_id, file_path, version, created_at, updated_at FROM plugin_submissions;
+
+DROP TABLE IF EXISTS plugin_submissions;
+ALTER TABLE plugin_submissions_new RENAME TO plugin_submissions;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_plugin_submissions_assignment_student ON plugin_submissions(assignment_id, student_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_plugin_submissions_legacy ON plugin_submissions(lesson_id, student_id) WHERE assignment_id IS NULL;
+
+CREATE TABLE IF NOT EXISTS plugin_submission_versions (
+  id TEXT PRIMARY KEY,
+  submission_id TEXT NOT NULL,
+  assignment_id TEXT,
+  student_id TEXT NOT NULL,
+  version INTEGER NOT NULL,
+  files_json TEXT NOT NULL DEFAULT '[]',
+  text_content TEXT,
+  link_url TEXT,
+  is_late INTEGER NOT NULL DEFAULT 0,
+  submitted_at INTEGER NOT NULL,
+  UNIQUE(submission_id, version)
+);
+
+CREATE INDEX IF NOT EXISTS idx_plugin_submission_versions_submission ON plugin_submission_versions(submission_id);
+
+CREATE TABLE IF NOT EXISTS plugin_assignment_files (
+  id TEXT PRIMARY KEY,
+  assignment_id TEXT NOT NULL,
+  submission_id TEXT,
+  version_id TEXT,
+  student_id TEXT NOT NULL,
+  original_name TEXT NOT NULL,
+  stored_path TEXT NOT NULL,
+  size INTEGER NOT NULL DEFAULT 0,
+  mime TEXT,
+  sha256 TEXT,
+  uploaded_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_plugin_assignment_files_owner ON plugin_assignment_files(assignment_id, student_id);
+
+CREATE TABLE IF NOT EXISTS plugin_peer_review_tasks (
+  id TEXT PRIMARY KEY,
+  assignment_id TEXT NOT NULL,
+  submission_id TEXT NOT NULL,
+  reviewer_id TEXT NOT NULL,
+  anonymous INTEGER NOT NULL DEFAULT 1,
+  status TEXT NOT NULL DEFAULT 'pending',
+  due_at INTEGER,
+  created_at INTEGER NOT NULL,
+  UNIQUE(submission_id, reviewer_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_plugin_peer_review_tasks_reviewer ON plugin_peer_review_tasks(reviewer_id, status);
+
+ALTER TABLE plugin_peer_reviews ADD COLUMN assignment_id TEXT;
+ALTER TABLE plugin_peer_reviews ADD COLUMN task_id TEXT;
+ALTER TABLE plugin_peer_reviews ADD COLUMN anonymous INTEGER NOT NULL DEFAULT 1;
+ALTER TABLE plugin_peer_reviews ADD COLUMN status TEXT NOT NULL DEFAULT 'submitted';
+ALTER TABLE plugin_peer_reviews ADD COLUMN updated_at INTEGER;
+
+ALTER TABLE plugin_grades ADD COLUMN assignment_id TEXT;
+ALTER TABLE plugin_grades ADD COLUMN peer_average_score REAL;
+ALTER TABLE plugin_grades ADD COLUMN source TEXT NOT NULL DEFAULT 'teacher';
+ALTER TABLE plugin_grades ADD COLUMN published_at INTEGER;
+ALTER TABLE plugin_grades ADD COLUMN graded_by TEXT;
+
+-- DOWN
+DROP INDEX IF EXISTS idx_plugin_peer_review_tasks_reviewer;
+DROP TABLE IF EXISTS plugin_peer_review_tasks;
+DROP INDEX IF EXISTS idx_plugin_assignment_files_owner;
+DROP TABLE IF EXISTS plugin_assignment_files;
+DROP INDEX IF EXISTS idx_plugin_submission_versions_submission;
+DROP TABLE IF EXISTS plugin_submission_versions;
+
+DROP INDEX IF EXISTS idx_plugin_submissions_legacy;
+DROP INDEX IF EXISTS idx_plugin_submissions_assignment_student;
+CREATE TABLE IF NOT EXISTS plugin_submissions_legacy (
+  id TEXT PRIMARY KEY,
+  lesson_id TEXT NOT NULL,
+  student_id TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  version INTEGER NOT NULL DEFAULT 1,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  UNIQUE(lesson_id, student_id)
+);
+INSERT OR IGNORE INTO plugin_submissions_legacy (id, lesson_id, student_id, file_path, version, created_at, updated_at)
+SELECT id, COALESCE(lesson_id, assignment_id), student_id, COALESCE(file_path, ''), version, created_at, updated_at
+FROM plugin_submissions;
+DROP TABLE IF EXISTS plugin_submissions;
+ALTER TABLE plugin_submissions_legacy RENAME TO plugin_submissions;
+
+DROP INDEX IF EXISTS idx_plugin_assignments_class;
+DROP INDEX IF EXISTS idx_plugin_assignments_lesson;
+DROP INDEX IF EXISTS idx_plugin_assignments_element;
+DROP TABLE IF EXISTS plugin_assignments;

package/migrations/006_classroom_event_bus.sql

@@ -0,0 +1,28 @@
+-- UP
+-- 课堂事件统一：events 审计表补索引与课堂维度
+--
+-- 背景：课堂里的状态变更（锁屏、进度、随堂作答、课件 attempt、进度模式）此前
+-- 都是 REST 路由里直接 `io.emit`，绕过内核总线，因此不进 `events` 表。统一走
+-- 总线后，`events` 成为课堂的事实日志，读取形态也变了：
+--   - 按时间窗口查询（课堂报告、排障回溯）
+--   - 按 correlationId 串联同一条业务流（一次课件作答的 log → adopt → submit）
+--   - 按课节重放整堂课
+-- 现有索引只有 (type, timestamp)，上述三种查询都走不到索引。本次补齐：
+--   idx_events_timestamp     纯时间窗口查询
+--   idx_events_correlation   按 correlationId 串联
+--   events.lesson_id         课堂维度列 + (lesson_id, timestamp) 复合索引
+--
+-- 关于顺序：不额外引入 seq 列。SQLite 每张普通表都有单调递增的内建 rowid，
+-- 按 `ORDER BY rowid` 即可得到稳定的事件顺序，无需维护内存计数器，
+-- 也避免了进程重启后序号回退的问题。
+
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_events_correlation ON events(correlationId);
+ALTER TABLE events ADD COLUMN lesson_id TEXT;
+CREATE INDEX IF NOT EXISTS idx_events_lesson_time ON events(lesson_id, timestamp);
+
+-- DOWN
+-- 只回滚索引：DROP COLUMN 需要 SQLite 3.35+，且留下一个未被写入的 NULL 列是无害的。
+DROP INDEX IF EXISTS idx_events_timestamp;
+DROP INDEX IF EXISTS idx_events_correlation;
+DROP INDEX IF EXISTS idx_events_lesson_time;