/** * 维护脚本:给"已有数据库"补齐结构性新增列(不依赖安装程序升级)。 * * 为什么需要它:安装版服务端只在**库为空**时执行随包迁移 SQL(首次启动建表); * 用安装程序覆盖升级时,升级逻辑会自动补齐新迁移。若像本地联调那样**手工覆盖 dist** * 部署,就需要显式跑一次本脚本。 * * 用法(用安装目录自带的 node 即可,无需 SDK):传入**已编译的 `lib/db.js`**, * 直接复用服务端自己配置好的 Prisma 客户端(Prisma 7 需要 driver adapter,不能裸 new): * * node apply-column-migrations.cjs "<安装目录>/server/dist/lib/db.js" * * 环境变量(与服务端一致): * DATABASE_PROVIDER=sqlite * DATABASE_URL="file:<绝对路径>/classhelper.db" * * 幂等:已存在的列会跳过。 */ const { pathToFileURL } = require('node:url'); const dbEntry = process.argv[2]; if (!dbEntry) { console.error('用法:node apply-column-migrations.cjs <已编译的 lib/db.js 绝对路径>'); process.exit(2); } /** 需要保证存在的列(新增迁移时在这里追加一行) */ const COLUMNS = [ { table: 'Schedule', column: 'weekParity', sql: `ALTER TABLE "Schedule" ADD COLUMN "weekParity" TEXT NOT NULL DEFAULT 'ALL'`, note: '课表单双周(ALL/ODD/EVEN)', }, { table: 'Class', column: 'termWeeks', sql: `ALTER TABLE "Class" ADD COLUMN "termWeeks" INTEGER NOT NULL DEFAULT 20`, note: '班级教学周数(班主任可调,默认 20)', }, { table: 'Class', column: 'studentGradeQueryEnabled', sql: `ALTER TABLE "Class" ADD COLUMN "studentGradeQueryEnabled" BOOLEAN NOT NULL DEFAULT true`, note: 'ClassHelper 班级端按学号查成绩的开关(默认开启)', }, { table: 'Grade', column: 'levelType', sql: `ALTER TABLE "Grade" ADD COLUMN "levelType" TEXT NOT NULL DEFAULT 'percent'`, note: '成绩等级口径:percent / letter / custom', }, { table: 'Grade', column: 'level', sql: `ALTER TABLE "Grade" ADD COLUMN "level" TEXT NOT NULL DEFAULT ''`, note: '成绩等级文本(percent 下由得分率换算,可手改)', }, { table: 'IntegrationDevice', column: 'lastHeartbeatAt', sql: `ALTER TABLE "IntegrationDevice" ADD COLUMN "lastHeartbeatAt" DATETIME`, note: 'ClassHelper 班级端最后一次心跳(在线判定看它)', }, { table: 'User', column: 'phone', sql: `ALTER TABLE "User" ADD COLUMN "phone" TEXT NOT NULL DEFAULT ''`, note: '教师手机号', }, { table: 'User', column: 'careMode', sql: `ALTER TABLE "User" ADD COLUMN "careMode" BOOLEAN NOT NULL DEFAULT false`, note: '关怀模式(大字版界面)', }, { table: 'Notification', column: 'assignDate', sql: `ALTER TABLE "Notification" ADD COLUMN "assignDate" TEXT NOT NULL DEFAULT ''`, note: '通知所属日期(本地日期 YYYY-MM-DD,按天归档用)', }, ]; /** * ⚠ 本脚本只能补**新增的列**,补不了结构变化。 * * 2026-10-06 那版「学生从账号变成名单记录」(`prisma/migrations/20261006120000_add_student_table`) * 是一次真正的表重构:新建 `Student` / `StudentClassTransfer`、把 `Grade`/`HomeworkStatus`/ * `NotificationRead` 的外键从 `userId` 换到 `studentId`、删掉 `Enrollment` 与 `ClassTeacher`。 * 这些**必须走正式的迁移链路**(`prisma migrate deploy`,安装程序升级时自动执行): * * node apply-column-migrations.cjs "<安装目录>/server/dist/lib/db.js" # 只补列 * pnpm --filter @classhelper/server db:deploy # 结构变化走这条 * * 只跑本脚本、不跑迁移的库会停在"列有了但表没换"的中间态 —— 下面的列已经能把 * 界面撑起来不报错,但学生数据仍留在 `User` 里,属于不可用状态。 */ (async () => { let prisma; try { const module = await import(pathToFileURL(dbEntry).href); prisma = module.prisma ?? module.default?.prisma; } catch (error) { console.error( '[migrate] 无法加载服务端的 Prisma 客户端:', error && error.message ? error.message : error, ); process.exitCode = 1; return; } if (!prisma) { console.error('[migrate] lib/db.js 里没有导出 prisma'); process.exitCode = 1; return; } try { for (const item of COLUMNS) { const columns = await prisma.$queryRawUnsafe(`PRAGMA table_info("${item.table}")`); if (columns.some((column) => column.name === item.column)) { console.log(`[migrate] ${item.table}.${item.column} 已存在(跳过)`); continue; } await prisma.$executeRawUnsafe(item.sql); console.log(`[migrate] 已新增 ${item.table}.${item.column} —— ${item.note}`); } for (const table of [...new Set(COLUMNS.map((item) => item.table))]) { const after = await prisma.$queryRawUnsafe(`PRAGMA table_info("${table}")`); console.log(`[migrate] ${table} 列:${after.map((column) => column.name).join(', ')}`); } } catch (error) { console.error('[migrate] 失败:', error && error.message ? error.message : error); process.exitCode = 1; } finally { await prisma.$disconnect?.(); } })();