openlearn-next 0.4.2 → 0.7.3

package/migrations/041_course_package_idempotency.sql

@@ -0,0 +1,33 @@
+-- UP
+-- 课程包导入幂等（G-06，docs/audit/course-import-audit.md）：
+--
+-- 课程包格式本身没有天然主键（不像数据库行有 id），去重键只能派生：
+--   * 包声明了 meta.id  → key = "id:<meta.id>"（作者给的稳定标识，抗内容漂移）
+--   * 包没声明 meta.id  → key = "sha256:<内容哈希>"（规范化内容，见
+--                         server/services/course-package-identity.ts）
+--
+-- 三列各司其职：
+--   source_package_key   去重键本体。查重就查它 —— 命中即视为「同一个包」。
+--   source_package_hash  内容哈希。即便包声明了 id 也要留着：换了内容但沿用
+--                        同一个 id 时，能看出「内容确实变过」。
+--   source_package_id    包声明的 meta.id（可空）。仅为可读性/排查而存在。
+--
+-- 作用域是**按创建者**：内置课程模板要能被每一位教师各导入一份，
+-- 所以去重只在同一 creator_id 内生效，不做全局去重。
+--
+-- 键随课程行一起存在 → 教师删课即释放该键，无需额外的清理链路。
+
+ALTER TABLE lessons ADD COLUMN source_package_key TEXT;
+ALTER TABLE lessons ADD COLUMN source_package_hash TEXT;
+ALTER TABLE lessons ADD COLUMN source_package_id TEXT;
+
+-- 查重路径：creator_id + source_package_key 精确命中。
+CREATE INDEX IF NOT EXISTS idx_lessons_source_package_key
+  ON lessons(creator_id, source_package_key)
+  WHERE source_package_key IS NOT NULL;
+
+-- DOWN
+DROP INDEX IF EXISTS idx_lessons_source_package_key;
+ALTER TABLE lessons DROP COLUMN source_package_id;
+ALTER TABLE lessons DROP COLUMN source_package_hash;
+ALTER TABLE lessons DROP COLUMN source_package_key;

package/migrations/042_assignment_grade_resubmit_audit.sql

@@ -0,0 +1,12 @@
+-- UP
+-- Issue #248：学生重交会替换已批改行的作答内容，但 `assignment_grade_history`
+--   只记分数 / 状态 / 来源 —— 查不到「这份分数是针对哪份内容给的」。
+--   于是出现「内容换了、分数没动、历史里查不出来」的脱钩。
+--
+-- 补一列 `old_content`：只存**被替换掉的那份**内容（带分数的那份）。
+-- 新内容就在 `assignment_submissions` 行里，不必再存一份 ——
+-- 避免审计表被大段文本撑爆。
+ALTER TABLE assignment_grade_history ADD COLUMN old_content TEXT;
+
+-- DOWN
+ALTER TABLE assignment_grade_history DROP COLUMN old_content;

package/migrations/043_mark_sha256_passwords.sql

@@ -0,0 +1,31 @@
+-- UP
+-- Issue #227：users 表里仍可能存在**无盐 SHA-256** 的口令摘要 ——
+-- 由 builtin.user 插件命令的 user.create / user.update 写入（现已改用 bcrypt）。
+--
+-- SHA-256 是快速哈希，没有盐也没有工作因子：库一旦泄露（备份文件 / SQLite 文件
+-- 被拷走），这些口令的爆破成本几乎为零。与 bcrypt 账号混在同一张表里，
+-- 排查时也容易误以为全库都是 bcrypt。
+--
+-- 存量行无法反推原口令（无盐哈希不可逆），只能重置：
+--   把它们的 must_change_password 置 1 —— 复用平台既有的强制改密机制
+--   （enforcePasswordChanged 中间件 + 前端改密页）。
+--   顺带一提：staff 登录时 verifyPassword 命中旧 SHA-256 会**自动升级**为 bcrypt，
+--   因此这批账号在首次登录后即变成 bcrypt 摘要。
+--
+-- 判定条件：64 位纯小写十六进制（bcrypt 摘要以 $2 开头，天然不匹配）。
+UPDATE users
+   SET must_change_password = 1
+ WHERE password_hash IS NOT NULL
+   AND length(password_hash) = 64
+   AND password_hash NOT GLOB '*[^0-9a-f]*';
+
+-- DOWN
+-- 回滚只能把「看起来像 SHA-256 的行」的强制改密标记清掉 ——
+-- 但其中一部分在迁移前就已经是 must_change_password = 1（种子账号默认口令等），
+-- 因此本 DOWN 是**有损的**：无法区分「本次标记的」与「本来就有的」。
+-- 真正的回退口径应是重新设置这些账号的口令，而不是恢复标记位。
+UPDATE users
+   SET must_change_password = 0
+ WHERE password_hash IS NOT NULL
+   AND length(password_hash) = 64
+   AND password_hash NOT GLOB '*[^0-9a-f]*';

package/migrations/README.md

@@ -0,0 +1,61 @@
+# Database Migrations
+
+本目录包含 OpenLearnV2 的版本化数据库迁移文件。
+
+## 约定
+
+- 文件名格式：`NNN_description.sql`（NNN 为三位序号）
+- 每个文件包含 `-- UP`（应用迁移）和 `-- DOWN`（回滚迁移）两部分
+- 迁移由 `server/utils/migrate.ts` 在服务启动时自动执行
+- 已应用的迁移记录在 `_migrations` 表中
+- 已应用的迁移**不可改名/修改**（checksum 台账会检出漂移）；台账条目在目录中不存在时启动直接 FATAL（代码降级或文件被删，可用 `MIGRATION_ALLOW_UNKNOWN_LEDGER=true` 显式放行降级运维）
+- `schema-golden.json`：结构金样（空库跑完全部迁移后的表→列快照，自动生成勿手改）。启动终检实际库必须覆盖金样全部结构，缺表/缺列即拒绝服务——改迁移后必须跑 `pnpm db:gen-golden` 再生成，`server/__tests__/schema-golden.test.ts` 会对账
+
+## 当前迁移列表
+
+| 序号 | 文件                                          | 描述                                                                                                                                                                                                                                                           |
+| ---- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 000  | 000_initial_schema.sql                        | 初始完整 Schema（30+ 表与核心索引）                                                                                                                                                                                                                            |
+| 001  | 001_add_execution_mode.sql                    | plugins 表添加 execution_mode                                                                                                                                                                                                                                  |
+| 002  | 002_add_client_session_expiry.sql             | client_sessions 添加 expires_at                                                                                                                                                                                                                                |
+| 003  | 003_classroom_runtime.sql                     | 课堂工具与 AI 对话记忆表（student_rollcalls, site_settings, agent_conversations）                                                                                                                                                                              |
+| 004  | 004_courseware_score_config.sql               | 互动课件成绩归集策略表（courseware_score_config，宿主侧按策略从样本历史算最终分）                                                                                                                                                                              |
+| 005  | 005_assignment_hub.sql                        | 作业中心（plugin_assignments / plugin_submission_versions / plugin_assignment_files / plugin_peer_review_tasks，并重建 plugin_submissions 支持按作业唯一）                                                                                                     |
+| 006  | 006_classroom_event_bus.sql                   | `events` 审计表补课堂维度：`lesson_id` 列与 (type,timestamp) / correlationId / (lesson_id,timestamp) 索引，让课堂事件可按时间窗口、业务流串联与课节重放查询                                                                                                    |
+| 007  | 007_interactive_classroom.sql                 | 互动课堂与课节生命周期（lesson_quiz_submissions / classroom_sessions / classroom_quick_polls / classroom_poll_votes / classroom_buzzers / classroom_exit_tickets / classroom_pacing_signals）                                                                  |
+| 008  | 008_teaching_modes.sql                        | 教学模式表 teaching_modes 与 classroom_sessions.teaching_mode_id（课堂启动门户的模式选择器数据源）                                                                                                                                                             |
+| 009  | 009_classroom_peer_review.sql                 | 课中互评（classroom_peer_review_groups / classroom_peer_review_submissions）                                                                                                                                                                                   |
+| 010  | 010_class_groups.sql                          | 小组（class_groups）                                                                                                                                                                                                                                           |
+| 011  | 011_classroom_feed.sql                        | 课堂动态流（classroom_feed）                                                                                                                                                                                                                                   |
+| 012  | 012_auto_record_score.sql                     | `courseware_score_config` 补自动录入规则列（auto_record_enabled / auto_record_min_completion），把「学生提交数据」页的逐条手动「录入成绩」升级为按规则自动录入                                                                                                 |
+| 013  | 013_score_source_strategy.sql                 | `assignment_submissions` 补 source 列（manual/auto 来源分流，自动路径遇 manual/缺考行受保护）+ `courseware_score_config` 补 auto_record_strategy（latest/highest 更新策略）                                                                                    |
+| 014  | 014_performance_indexes.sql                   | 五个高频查询索引（vfs_nodes.parent_id、plugin_submissions.lesson_id、student_point_logs.student_id、student_rollcalls.class_id/student_id）                                                                                                                    |
+| 015  | 015_demo_data_registry.sql                    | `demo_data_registry`：演示数据精确登记，清理时只删登记行                                                                                                                                                                                                       |
+| 016  | 016_preset_polls_and_passcode_expiry.sql      | 课程预设投票 `lesson_preset_polls`、班级口令有效期与点名奖赏字段                                                                                                                                                                                               |
+| 017  | 017_pacing_signals_segment.sql                | `classroom_pacing_signals.segment_id` 及会话分段索引                                                                                                                                                                                                           |
+| 018  | 018_processes_plugin_owner.sql                | `processes.plugin_id`，后台任务可判定归属                                                                                                                                                                                                                      |
+| 019  | 019_plugins_version.sql                       | `plugins.version`，版本可在 SQL 层查询                                                                                                                                                                                                                         |
+| 020  | 020_upload_max_file_mb.sql                    | `site_settings.upload_max_file_mb`，课件上传上限改为管理员可配置                                                                                                                                                                                               |
+| 021  | 021_class_owner_and_password_gate.sql         | `classes.owner_user_id`（教师仅能管理自己的班；空值仅管理员可见）与 `users.must_change_password`。空归属用 `node scripts/backfill-class-owners.mjs --assign <教师用户名>`，或 `UPDATE classes SET owner_user_id = '<教师用户 id>' WHERE owner_user_id IS NULL` |
+| 022  | 022_plugin_public_routes.sql                  | `plugin_public_routes`：管理员显式批准的插件公开路由。`auth: false` 本身不再匿名放行。升级后需重新批准                                                                                                                                                         |
+| 023  | 023_encrypt_class_passcodes.sql               | 标记班级临时口令改为 AES-256-GCM 密文。启动时 `encryptStoredClassPasscodes()` 把仍是明文的行加密，已带 `olenc1:` 的行跳过                                                                                                                                      |
+| 024  | 024_segment_gates.sql                         | 教学环节门槛：`segment_visits`（停留）、`segment_gate_overrides`（教师放行）、`lesson_checkins`（无排课时的签到）                                                                                                                                              |
+| 025  | 025_assignment_lookup_indexes.sql             | `assignment_submissions(student_id)` 与 `assignments(lesson_id)` 索引，供课节进度聚合作业最高分和学生提交查询。可重复执行                                                                                                                                      |
+| 026  | 026_plugin_grants.sql                         | 第三方插件能力授权与出站网络白名单表（`plugin_capability_grants` / `plugin_network_grants`）                                                                                                                                                                   |
+| 027  | 027_academic_year.sql                         | 学年维度：为 schedules/assignments/attendance/exams/semester reports 等表增加 `academic_year` 字段与索引；site_settings 增加当前学年配置                                                                                                                       |
+| 028  | 028_classroom_indexes.sql                     | 补齐课堂互动与会话高频查询/级联删除索引（`classroom_buzzers`、`classroom_sessions`）                                                                                                                                                                           |
+| 029  | 029_clean_lesson_think_artifacts.sql          | 课程大纲模型思维链残留 (<think>...</think>) 清洗标记与启动期幂等清理                                                                                                                                                                                           |
+| 030  | 030_backfill_academic_year.sql                | 学年历史数据回填：为老数据库中 NULL 学年的排课/作业/考勤等按日期与父级关联平滑补齐                                                                                                                                                                             |
+| 031  | 031_assessment_core.sql                       | 测评子系统核心数据结构（试卷、考试、题库、题目等）                                                                                                                                                                                                             |
+| 032  | 032_progress_verification.sql                 | 学习进度区分「学生自报」与「已验证」：新增 `verified` / `verified_progress_percent`，成绩只计入已验证进度；历史进度回填为已验证以保持既有成绩口径                                                                                                              |
+| 033  | 033_student_lock_mode.sql                     | 学生端锁定模式 (lock_mode) 与锁定目标 (lock_target)                                                                                                                                                                                                            |
+| 034  | 034_plugin_orphan_data.sql                    | 插件卸载数据语义：孤立插件数据登记表（`plugin_orphan_data`，keep 保留登记 / purge 归档后可清除）                                                                                                                                                               |
+| 035  | 035_icebreaker_checkins.sql                   | 课前破冰心情打卡持久化与去重（`icebreaker_checkins` 表与按学生去重唯一索引）                                                                                                                                                                                   |
+| 036  | 036_student_read_notifications_created_at.sql | 保留策略：为 `student_read_notifications` 补齐 `created_at` 以便按 30 天窗口清理                                                                                                                                                                               |
+| 037  | 037_plugin_config_scopes.sql                  | 插件配置分层：`plugin_config` 表（平台/学校/班级），旧 `plugin_storage` 的 `config:*` 值迁移到平台层                                                                                                                                                           |
+| 038  | 038_assessment_ai_grading_suggestion.sql      | AI 辅助批改建议：`assessment_answers.ai_suggestion_json` 存「建议分 + 理由 + 置信度」，与正式分数分开                                                                                                                                                          |
+| 039  | 039_question_bank_sharing_and_papers.sql      | 题库共享与按规则随机抽题（每人一卷）：`question_bank_items.visibility` 区分 private / school                                                                                                                                                                   |
+| 040  | 040_assignment_grade_history.sql              | 成绩审计与手动分保护：`assignment_grade_history` 记录每次成绩变更的旧/新分数、状态、来源与操作者                                                                                                                                                               |
+| 041  | 041_course_package_idempotency.sql            | 课程包导入幂等（G-06）：同一包重复导入不再产生重复课程                                                                                                                                                                                                         |
+| 042  | 042_assignment_grade_resubmit_audit.sql       | 学生重交审计：`assignment_grade_history` 补 `old_content`，可追溯「这份分数是针对哪份内容给的」                                                                                                                                                                |
+| 043  | 043_mark_sha256_passwords.sql                 | Issue #227：把仍是无盐 SHA-256 摘要的存量账号标记为 `must_change_password = 1`，强制走既有改密流程（SHA-256 不可逆，无法反推原口令）                                                                                                                           |