@studious-lms/server 1.12.0 → 1.14.0

package/prisma/migrations/20251109122857_annuoncements_comments/migration.sql

@@ -1,30 +0,0 @@
--- AlterTable
-ALTER TABLE "public"."Announcement" ADD COLUMN     "modifiedAt" TIMESTAMP(3);
-
--- AlterTable
-ALTER TABLE "public"."File" ADD COLUMN     "announcementId" TEXT;
-
--- CreateTable
-CREATE TABLE "public"."AnnouncementComment" (
-    "id" TEXT NOT NULL,
-    "content" TEXT NOT NULL,
-    "authorId" TEXT NOT NULL,
-    "announcementId" TEXT NOT NULL,
-    "parentCommentId" TEXT,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "modifiedAt" TIMESTAMP(3),
-
-    CONSTRAINT "AnnouncementComment_pkey" PRIMARY KEY ("id")
-);
-
--- AddForeignKey
-ALTER TABLE "public"."File" ADD CONSTRAINT "File_announcementId_fkey" FOREIGN KEY ("announcementId") REFERENCES "public"."Announcement"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "public"."AnnouncementComment" ADD CONSTRAINT "AnnouncementComment_authorId_fkey" FOREIGN KEY ("authorId") REFERENCES "public"."User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "public"."AnnouncementComment" ADD CONSTRAINT "AnnouncementComment_announcementId_fkey" FOREIGN KEY ("announcementId") REFERENCES "public"."Announcement"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "public"."AnnouncementComment" ADD CONSTRAINT "AnnouncementComment_parentCommentId_fkey" FOREIGN KEY ("parentCommentId") REFERENCES "public"."AnnouncementComment"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/migrations/20251109135555_reactions_announcements_comments/migration.sql

@@ -1,35 +0,0 @@
--- CreateEnum
-CREATE TYPE "public"."ReactionType" AS ENUM ('THUMBSUP', 'CELEBRATE', 'CARE', 'HEART', 'IDEA', 'HAPPY');
-
--- CreateTable
-CREATE TABLE "public"."Reaction" (
-    "id" TEXT NOT NULL,
-    "type" "public"."ReactionType" NOT NULL,
-    "userId" TEXT NOT NULL,
-    "announcementId" TEXT,
-    "commentId" TEXT,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-    CONSTRAINT "Reaction_pkey" PRIMARY KEY ("id")
-);
-
--- CreateIndex
-CREATE INDEX "Reaction_announcementId_idx" ON "public"."Reaction"("announcementId");
-
--- CreateIndex
-CREATE INDEX "Reaction_commentId_idx" ON "public"."Reaction"("commentId");
-
--- CreateIndex
-CREATE UNIQUE INDEX "Reaction_userId_announcementId_key" ON "public"."Reaction"("userId", "announcementId");
-
--- CreateIndex
-CREATE UNIQUE INDEX "Reaction_userId_commentId_key" ON "public"."Reaction"("userId", "commentId");
-
--- AddForeignKey
-ALTER TABLE "public"."Reaction" ADD CONSTRAINT "Reaction_userId_fkey" FOREIGN KEY ("userId") REFERENCES "public"."User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "public"."Reaction" ADD CONSTRAINT "Reaction_announcementId_fkey" FOREIGN KEY ("announcementId") REFERENCES "public"."Announcement"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "public"."Reaction" ADD CONSTRAINT "Reaction_commentId_fkey" FOREIGN KEY ("commentId") REFERENCES "public"."AnnouncementComment"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/migrations/20260410124000_add_submission_recommendation_state/migration.sql

@@ -1,14 +0,0 @@
--- CreateEnum
-CREATE TYPE "SubmissionRecommendationState" AS ENUM ('NONE', 'OPEN', 'ASSIGNED', 'DISMISSED');
-
--- AlterTable
-ALTER TABLE "Submission"
-  ADD COLUMN "recommendationState" "SubmissionRecommendationState" NOT NULL DEFAULT 'NONE',
-  ADD COLUMN "recommendationUpdatedAt" TIMESTAMP(3),
-  ADD COLUMN "targetedAssignmentId" TEXT;
-
--- CreateIndex
-CREATE INDEX "Submission_studentId_recommendationState_idx" ON "Submission"("studentId", "recommendationState");
-
--- AddForeignKey
-ALTER TABLE "Submission" ADD CONSTRAINT "Submission_targetedAssignmentId_fkey" FOREIGN KEY ("targetedAssignmentId") REFERENCES "Assignment"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/migrations/20260415103500_add_session_type/migration.sql

@@ -1,33 +0,0 @@
--- CreateEnum
-CREATE TYPE "SessionType" AS ENUM ('AUTH', 'EMAIL_VERIFICATION', 'PASSWORD_RESET', 'CLASS_INVITE');
-
--- AlterTable
-ALTER TABLE "Session"
-  ADD COLUMN "type" "SessionType" NOT NULL DEFAULT 'AUTH';
-
--- Backfill existing non-auth session records when they can be inferred safely.
-UPDATE "Session"
-SET "type" = 'CLASS_INVITE'
-WHERE "classId" IS NOT NULL;
-
--- This Session.type backfill uses the expiresAt <= NOW() + INTERVAL '2 hours'
--- heuristic to identify password reset tokens. It may misclassify rare short-lived
--- AUTH sessions, but this one-time migration safely fails those sessions until users re-login.
-UPDATE "Session"
-SET "type" = 'PASSWORD_RESET'
-WHERE "userId" IS NOT NULL
-  AND "classId" IS NULL
-  AND "expiresAt" IS NOT NULL
-  AND "expiresAt" <= NOW() + INTERVAL '2 hours';
-
-UPDATE "Session"
-SET "type" = 'EMAIL_VERIFICATION'
-WHERE "userId" IS NOT NULL
-  AND "classId" IS NULL
-  AND "type" = 'AUTH'
-  AND EXISTS (
-    SELECT 1
-    FROM "User"
-    WHERE "User"."id" = "Session"."userId"
-      AND "User"."verified" = false
-  );

package/prisma/migrations/20260415133000_add_ai_usage_logs/migration.sql

@@ -1,19 +0,0 @@
-CREATE TABLE "AiUsageLog" (
-    "id" TEXT NOT NULL,
-    "reason" TEXT NOT NULL,
-    "provider" TEXT NOT NULL DEFAULT 'openai',
-    "model" TEXT NOT NULL,
-    "operation" TEXT NOT NULL,
-    "success" BOOLEAN NOT NULL DEFAULT true,
-    "promptTokens" INTEGER,
-    "completionTokens" INTEGER,
-    "totalTokens" INTEGER,
-    "estimatedInputTokens" INTEGER,
-    "metadata" JSONB DEFAULT '{}'::jsonb,
-    "error" TEXT,
-    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-    CONSTRAINT "AiUsageLog_pkey" PRIMARY KEY ("id")
-);
-
-CREATE INDEX "AiUsageLog_reason_createdAt_idx" ON "AiUsageLog"("reason", "createdAt");

package/prisma/migrations/20260417083000_add_conversation_member_hidden_at/migration.sql

@@ -1,2 +0,0 @@
-ALTER TABLE "ConversationMember"
-ADD COLUMN "hiddenAt" TIMESTAMP(3);

package/prisma/migrations/20260502230500_assignment_submission_comments/migration.sql

@@ -1,60 +0,0 @@
-ALTER TABLE "public"."Comment" ADD COLUMN "assignmentId" TEXT;
-ALTER TABLE "public"."Comment" ADD COLUMN "submissionId" TEXT;
-
-CREATE INDEX "Comment_assignmentId_idx" ON "public"."Comment"("assignmentId");
-CREATE INDEX "Comment_submissionId_idx" ON "public"."Comment"("submissionId");
-
-ALTER TABLE "public"."Comment" ADD CONSTRAINT "Comment_assignmentId_fkey" FOREIGN KEY ("assignmentId") REFERENCES "public"."Assignment"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-ALTER TABLE "public"."Comment" ADD CONSTRAINT "Comment_submissionId_fkey" FOREIGN KEY ("submissionId") REFERENCES "public"."Submission"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-WITH RECURSIVE "CommentOwnerContext" AS (
-  SELECT
-    "id",
-    "parentCommentId",
-    "announcementId",
-    "assignmentId",
-    "submissionId",
-    "studentQuestionProgressId"
-  FROM "public"."Comment"
-  WHERE "parentCommentId" IS NULL
-
-  UNION ALL
-
-  SELECT
-    child."id",
-    child."parentCommentId",
-    COALESCE(child."announcementId", parent."announcementId"),
-    COALESCE(child."assignmentId", parent."assignmentId"),
-    COALESCE(child."submissionId", parent."submissionId"),
-    COALESCE(child."studentQuestionProgressId", parent."studentQuestionProgressId")
-  FROM "public"."Comment" child
-  INNER JOIN "CommentOwnerContext" parent ON child."parentCommentId" = parent."id"
-)
-UPDATE "public"."Comment" c
-SET
-  "announcementId" = owner."announcementId",
-  "assignmentId" = owner."assignmentId",
-  "submissionId" = owner."submissionId",
-  "studentQuestionProgressId" = owner."studentQuestionProgressId"
-FROM "CommentOwnerContext" owner
-WHERE c."id" = owner."id"
-  AND c."parentCommentId" IS NOT NULL
-  AND (
-    (CASE WHEN c."assignmentId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN c."submissionId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN c."announcementId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN c."studentQuestionProgressId" IS NOT NULL THEN 1 ELSE 0 END)
-  ) = 0
-  AND (
-    (CASE WHEN owner."assignmentId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN owner."submissionId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN owner."announcementId" IS NOT NULL THEN 1 ELSE 0 END) +
-    (CASE WHEN owner."studentQuestionProgressId" IS NOT NULL THEN 1 ELSE 0 END)
-  ) = 1;
-
-ALTER TABLE "public"."Comment" ADD CONSTRAINT "Comment_single_owner_check" CHECK (
-  (CASE WHEN "assignmentId" IS NOT NULL THEN 1 ELSE 0 END) +
-  (CASE WHEN "submissionId" IS NOT NULL THEN 1 ELSE 0 END) +
-  (CASE WHEN "announcementId" IS NOT NULL THEN 1 ELSE 0 END) +
-  (CASE WHEN "studentQuestionProgressId" IS NOT NULL THEN 1 ELSE 0 END) = 1
-);

package/prisma/migrations/20260504071500_school_memberships/migration.sql

@@ -1,81 +0,0 @@
--- Add durable multi-school membership and invite support.
-
-CREATE TYPE "SchoolMembershipRole" AS ENUM ('ADMIN', 'TEACHER', 'STUDENT');
-CREATE TYPE "SchoolMembershipStatus" AS ENUM ('ACTIVE', 'INVITED', 'SUSPENDED');
-CREATE TYPE "SchoolInviteStatus" AS ENUM ('PENDING', 'ACCEPTED', 'REVOKED', 'EXPIRED');
-
-ALTER TABLE "School"
-  ALTER COLUMN "logoId" DROP NOT NULL,
-  ADD COLUMN "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  ADD COLUMN "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP;
-
-CREATE TABLE "SchoolMembership" (
-  "id" TEXT NOT NULL,
-  "schoolId" TEXT NOT NULL,
-  "userId" TEXT NOT NULL,
-  "role" "SchoolMembershipRole" NOT NULL,
-  "status" "SchoolMembershipStatus" NOT NULL DEFAULT 'ACTIVE',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "SchoolMembership_pkey" PRIMARY KEY ("id")
-);
-
-CREATE TABLE "SchoolInvite" (
-  "id" TEXT NOT NULL,
-  "token" TEXT NOT NULL,
-  "email" TEXT NOT NULL,
-  "role" "SchoolMembershipRole" NOT NULL,
-  "status" "SchoolInviteStatus" NOT NULL DEFAULT 'PENDING',
-  "expiresAt" TIMESTAMP(3) NOT NULL,
-  "acceptedAt" TIMESTAMP(3),
-  "revokedAt" TIMESTAMP(3),
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-  "schoolId" TEXT NOT NULL,
-  "invitedById" TEXT NOT NULL,
-
-  CONSTRAINT "SchoolInvite_pkey" PRIMARY KEY ("id")
-);
-
-INSERT INTO "SchoolMembership" ("id", "schoolId", "userId", "role", "status", "createdAt", "updatedAt")
-SELECT
-  gen_random_uuid()::text,
-  "schoolId",
-  "id",
-  CASE
-    WHEN "role" = 'ADMIN' THEN 'ADMIN'::"SchoolMembershipRole"
-    WHEN "role" = 'TEACHER' THEN 'TEACHER'::"SchoolMembershipRole"
-    ELSE 'STUDENT'::"SchoolMembershipRole"
-  END,
-  'ACTIVE'::"SchoolMembershipStatus",
-  CURRENT_TIMESTAMP,
-  CURRENT_TIMESTAMP
-FROM "User"
-WHERE "schoolId" IS NOT NULL
-ON CONFLICT DO NOTHING;
-
-CREATE UNIQUE INDEX "SchoolMembership_schoolId_userId_key" ON "SchoolMembership"("schoolId", "userId");
-CREATE INDEX "SchoolMembership_userId_idx" ON "SchoolMembership"("userId");
-CREATE INDEX "SchoolMembership_schoolId_role_idx" ON "SchoolMembership"("schoolId", "role");
-CREATE INDEX "SchoolMembership_schoolId_status_idx" ON "SchoolMembership"("schoolId", "status");
-
-CREATE UNIQUE INDEX "SchoolInvite_token_key" ON "SchoolInvite"("token");
-CREATE INDEX "SchoolInvite_schoolId_status_idx" ON "SchoolInvite"("schoolId", "status");
-CREATE INDEX "SchoolInvite_email_idx" ON "SchoolInvite"("email");
-
-ALTER TABLE "SchoolMembership"
-  ADD CONSTRAINT "SchoolMembership_schoolId_fkey"
-  FOREIGN KEY ("schoolId") REFERENCES "School"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "SchoolMembership"
-  ADD CONSTRAINT "SchoolMembership_userId_fkey"
-  FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "SchoolInvite"
-  ADD CONSTRAINT "SchoolInvite_schoolId_fkey"
-  FOREIGN KEY ("schoolId") REFERENCES "School"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-ALTER TABLE "SchoolInvite"
-  ADD CONSTRAINT "SchoolInvite_invitedById_fkey"
-  FOREIGN KEY ("invitedById") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/migrations/20260506162500_consolidate_run_job_and_unify_job_status/migration.sql

@@ -1,166 +0,0 @@
--- Consolidate background-job tracking onto RunJob and unify domain status.
---
--- 1. Replace the bare-bones RunJob table with a fully-typed audit row that
---    carries job type, status, input/result, error, attempts, timestamps.
--- 2. Replace the catch-all GenerationStatus enum with a single shared
---    JobStatus enum used by every domain row that has a user-observable
---    async lifecycle (Message, StudentQuestionProgress).
--- 3. Add a nullable runJobId FK on Message and StudentQuestionProgress so we
---    can trace a domain row back to the job that produced it. Operational
---    state (retries, errors, attempts) lives on RunJob, not on the row.
--- 4. Drop the unused Comment.status column.
-
--- ---------------------------------------------------------------------------
--- 1. New enum types
--- ---------------------------------------------------------------------------
-
-CREATE TYPE "RunJobType" AS ENUM (
-  'PDF_TO_WORKSHEET',
-  'GRADE_WORKSHEET',
-  'AI_LAB_CHAT',
-  'AI_NEWTON_CHAT',
-  'STUDENT_PROGRESS_CHAT'
-);
-
--- Queue-internal lifecycle. Distinct from JobStatus because PENDING (queued
--- but not picked up) vs RUNNING (worker actively executing) is a real
--- operational distinction we want when debugging.
-CREATE TYPE "RunJobStatus" AS ENUM (
-  'PENDING',
-  'RUNNING',
-  'SUCCEEDED',
-  'FAILED',
-  'CANCELLED'
-);
-
--- Shared UI-shaped status for domain rows. Not every row uses every value
--- (e.g. Message never gets NOT_STARTED) but we keep one enum to avoid an
--- explosion of near-duplicate types.
-CREATE TYPE "JobStatus" AS ENUM (
-  'NOT_STARTED',
-  'PENDING',
-  'COMPLETED',
-  'FAILED',
-  'CANCELLED'
-);
-
--- ---------------------------------------------------------------------------
--- 2. Replace the legacy RunJob table.
---
--- The previous schema only had `id` and `createdAt`, and was applied via
--- `prisma db push` (no migration history) — so any rows in it are throwaway.
--- We DROP IF EXISTS to handle both fresh production DBs and dev DBs that have
--- the old shape.
--- ---------------------------------------------------------------------------
-
-DROP TABLE IF EXISTS "RunJob" CASCADE;
-
-CREATE TABLE "RunJob" (
-  "id"         TEXT NOT NULL,
-  "type"       "RunJobType" NOT NULL,
-  "status"     "RunJobStatus" NOT NULL DEFAULT 'PENDING',
-  "classId"    TEXT,
-  "userId"     TEXT,
-  "bullJobId"  TEXT,
-  "input"      JSONB NOT NULL,
-  "result"     JSONB,
-  "error"      TEXT,
-  "attempts"   INTEGER NOT NULL DEFAULT 0,
-  "startedAt"  TIMESTAMP(3),
-  "finishedAt" TIMESTAMP(3),
-  "createdAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt"  TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "RunJob_pkey" PRIMARY KEY ("id")
-);
-
-CREATE INDEX "RunJob_userId_type_status_idx" ON "RunJob"("userId", "type", "status");
-CREATE INDEX "RunJob_classId_status_idx"     ON "RunJob"("classId", "status");
-CREATE INDEX "RunJob_status_createdAt_idx"   ON "RunJob"("status", "createdAt");
-
--- ---------------------------------------------------------------------------
--- 2b. Track PDF source URLs on worksheets for idempotent PDF conversion.
--- ---------------------------------------------------------------------------
-
-ALTER TABLE "Worksheet" ADD COLUMN "sourceUrl" TEXT;
-
-CREATE UNIQUE INDEX "Worksheet_classId_sourceUrl_key"
-  ON "Worksheet"("classId", "sourceUrl");
-
--- ---------------------------------------------------------------------------
--- 3. Message.status: GenerationStatus -> JobStatus.
---
--- Old enum had NOT_STARTED / PENDING / GENERATING / COMPLETED / FAILED /
--- CANCELLED. New JobStatus drops GENERATING (never written). The old default
--- of NOT_STARTED is dropped: a row without an AI lifecycle now has NULL.
--- GENERATING is mapped to PENDING defensively in case any row carries it.
--- ---------------------------------------------------------------------------
-
-ALTER TABLE "Message" ALTER COLUMN "status" DROP DEFAULT;
-
-ALTER TABLE "Message"
-  ALTER COLUMN "status" TYPE "JobStatus"
-  USING (
-    CASE "status"::text
-      WHEN 'NOT_STARTED' THEN NULL
-      WHEN 'GENERATING'  THEN 'PENDING'::"JobStatus"
-      WHEN 'PENDING'     THEN 'PENDING'::"JobStatus"
-      WHEN 'COMPLETED'   THEN 'COMPLETED'::"JobStatus"
-      WHEN 'FAILED'      THEN 'FAILED'::"JobStatus"
-      WHEN 'CANCELLED'   THEN 'CANCELLED'::"JobStatus"
-      ELSE NULL
-    END
-  );
-
--- ---------------------------------------------------------------------------
--- 4. StudentQuestionProgress.status: GenerationStatus -> JobStatus.
---
--- Default kept at NOT_STARTED. GENERATING -> PENDING defensively.
--- ---------------------------------------------------------------------------
-
-ALTER TABLE "StudentQuestionProgress" ALTER COLUMN "status" DROP DEFAULT;
-
-ALTER TABLE "StudentQuestionProgress"
-  ALTER COLUMN "status" TYPE "JobStatus"
-  USING (
-    CASE "status"::text
-      WHEN 'NOT_STARTED' THEN 'NOT_STARTED'::"JobStatus"
-      WHEN 'PENDING'     THEN 'PENDING'::"JobStatus"
-      WHEN 'GENERATING'  THEN 'PENDING'::"JobStatus"
-      WHEN 'COMPLETED'   THEN 'COMPLETED'::"JobStatus"
-      WHEN 'FAILED'      THEN 'FAILED'::"JobStatus"
-      WHEN 'CANCELLED'   THEN 'CANCELLED'::"JobStatus"
-      ELSE NULL
-    END
-  );
-
-ALTER TABLE "StudentQuestionProgress"
-  ALTER COLUMN "status" SET DEFAULT 'NOT_STARTED';
-
--- ---------------------------------------------------------------------------
--- 5. Drop the unused Comment.status column and the legacy enum.
--- ---------------------------------------------------------------------------
-
-ALTER TABLE "Comment" DROP COLUMN "status";
-
-DROP TYPE "GenerationStatus";
-
--- ---------------------------------------------------------------------------
--- 6. Add runJobId FKs and supporting indexes.
--- ---------------------------------------------------------------------------
-
-ALTER TABLE "Message"
-  ADD COLUMN "runJobId" TEXT,
-  ADD CONSTRAINT "Message_runJobId_fkey"
-    FOREIGN KEY ("runJobId") REFERENCES "RunJob"("id")
-    ON DELETE SET NULL ON UPDATE CASCADE;
-
-CREATE INDEX "Message_runJobId_idx" ON "Message"("runJobId");
-
-ALTER TABLE "StudentQuestionProgress"
-  ADD COLUMN "runJobId" TEXT,
-  ADD CONSTRAINT "StudentQuestionProgress_runJobId_fkey"
-    FOREIGN KEY ("runJobId") REFERENCES "RunJob"("id")
-    ON DELETE SET NULL ON UPDATE CASCADE;
-
-CREATE INDEX "StudentQuestionProgress_runJobId_idx" ON "StudentQuestionProgress"("runJobId");

package/prisma/migrations/20260509220000_institution_overhaul/migration.sql

@@ -1,184 +0,0 @@
--- Institution overhaul: departments, tags, cloud storage, class affiliation,
--- and template grading artefacts.
-
-CREATE TYPE "TagTarget" AS ENUM ('USER', 'CLASS', 'RUBRIC', 'BOUNDARY');
-CREATE TYPE "FolderScope" AS ENUM ('CLASS', 'SCHOOL_STORAGE', 'PERSONAL', 'GENERIC');
-
--- School: optional description.
-ALTER TABLE "School"
-  ADD COLUMN "description" TEXT;
-
--- Folder: extend with scope + alternate root owners (school, personal user).
-ALTER TABLE "Folder"
-  ADD COLUMN "scope" "FolderScope" NOT NULL DEFAULT 'GENERIC',
-  ADD COLUMN "schoolStorageId" TEXT,
-  ADD COLUMN "personalOwnerId" TEXT;
-
--- Backfill existing class root folders to CLASS scope so the data layer can
--- distinguish roots from generic subfolders.
-UPDATE "Folder"
-SET "scope" = 'CLASS'
-WHERE "classId" IS NOT NULL AND "parentFolderId" IS NULL;
-
-CREATE UNIQUE INDEX "Folder_schoolStorageId_key" ON "Folder"("schoolStorageId");
-CREATE UNIQUE INDEX "Folder_personalOwnerId_key" ON "Folder"("personalOwnerId");
-
-ALTER TABLE "Folder"
-  ADD CONSTRAINT "Folder_schoolStorageId_fkey"
-    FOREIGN KEY ("schoolStorageId") REFERENCES "School"("id")
-    ON DELETE SET NULL ON UPDATE CASCADE,
-  ADD CONSTRAINT "Folder_personalOwnerId_fkey"
-    FOREIGN KEY ("personalOwnerId") REFERENCES "User"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE;
-
--- Department.
-CREATE TABLE "Department" (
-  "id" TEXT NOT NULL,
-  "schoolId" TEXT NOT NULL,
-  "name" TEXT NOT NULL,
-  "description" TEXT,
-  "color" TEXT DEFAULT '#3B82F6',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "Department_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "Department_schoolId_name_key" ON "Department"("schoolId", "name");
-CREATE INDEX "Department_schoolId_idx" ON "Department"("schoolId");
-
-ALTER TABLE "Department"
-  ADD CONSTRAINT "Department_schoolId_fkey"
-    FOREIGN KEY ("schoolId") REFERENCES "School"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE;
-
--- User <-> Department (M:N).
-CREATE TABLE "_UserDepartments" (
-  "A" TEXT NOT NULL,
-  "B" TEXT NOT NULL
-);
-CREATE UNIQUE INDEX "_UserDepartments_AB_unique" ON "_UserDepartments"("A", "B");
-CREATE INDEX "_UserDepartments_B_index" ON "_UserDepartments"("B");
-ALTER TABLE "_UserDepartments"
-  ADD CONSTRAINT "_UserDepartments_A_fkey"
-    FOREIGN KEY ("A") REFERENCES "Department"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "_UserDepartments_B_fkey"
-    FOREIGN KEY ("B") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- Tag.
-CREATE TABLE "Tag" (
-  "id" TEXT NOT NULL,
-  "schoolId" TEXT NOT NULL,
-  "departmentId" TEXT,
-  "name" TEXT NOT NULL,
-  "color" TEXT NOT NULL DEFAULT '#3B82F6',
-  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  "updatedAt" TIMESTAMP(3) NOT NULL,
-
-  CONSTRAINT "Tag_pkey" PRIMARY KEY ("id")
-);
-
-CREATE UNIQUE INDEX "Tag_schoolId_name_key" ON "Tag"("schoolId", "name");
-CREATE INDEX "Tag_schoolId_idx" ON "Tag"("schoolId");
-CREATE INDEX "Tag_departmentId_idx" ON "Tag"("departmentId");
-
-ALTER TABLE "Tag"
-  ADD CONSTRAINT "Tag_schoolId_fkey"
-    FOREIGN KEY ("schoolId") REFERENCES "School"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "Tag_departmentId_fkey"
-    FOREIGN KEY ("departmentId") REFERENCES "Department"("id")
-    ON DELETE SET NULL ON UPDATE CASCADE;
-
--- Tag join tables.
-CREATE TABLE "_UserTags" (
-  "A" TEXT NOT NULL,
-  "B" TEXT NOT NULL
-);
-CREATE UNIQUE INDEX "_UserTags_AB_unique" ON "_UserTags"("A", "B");
-CREATE INDEX "_UserTags_B_index" ON "_UserTags"("B");
-ALTER TABLE "_UserTags"
-  ADD CONSTRAINT "_UserTags_A_fkey" FOREIGN KEY ("A") REFERENCES "Tag"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "_UserTags_B_fkey" FOREIGN KEY ("B") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-CREATE TABLE "_ClassTags" (
-  "A" TEXT NOT NULL,
-  "B" TEXT NOT NULL
-);
-CREATE UNIQUE INDEX "_ClassTags_AB_unique" ON "_ClassTags"("A", "B");
-CREATE INDEX "_ClassTags_B_index" ON "_ClassTags"("B");
-ALTER TABLE "_ClassTags"
-  ADD CONSTRAINT "_ClassTags_A_fkey" FOREIGN KEY ("A") REFERENCES "Class"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "_ClassTags_B_fkey" FOREIGN KEY ("B") REFERENCES "Tag"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-CREATE TABLE "_MarkSchemeTags" (
-  "A" TEXT NOT NULL,
-  "B" TEXT NOT NULL
-);
-CREATE UNIQUE INDEX "_MarkSchemeTags_AB_unique" ON "_MarkSchemeTags"("A", "B");
-CREATE INDEX "_MarkSchemeTags_B_index" ON "_MarkSchemeTags"("B");
-ALTER TABLE "_MarkSchemeTags"
-  ADD CONSTRAINT "_MarkSchemeTags_A_fkey" FOREIGN KEY ("A") REFERENCES "MarkScheme"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "_MarkSchemeTags_B_fkey" FOREIGN KEY ("B") REFERENCES "Tag"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
-CREATE TABLE "_GradingBoundaryTags" (
-  "A" TEXT NOT NULL,
-  "B" TEXT NOT NULL
-);
-CREATE UNIQUE INDEX "_GradingBoundaryTags_AB_unique" ON "_GradingBoundaryTags"("A", "B");
-CREATE INDEX "_GradingBoundaryTags_B_index" ON "_GradingBoundaryTags"("B");
-ALTER TABLE "_GradingBoundaryTags"
-  ADD CONSTRAINT "_GradingBoundaryTags_A_fkey" FOREIGN KEY ("A") REFERENCES "GradingBoundary"("id") ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "_GradingBoundaryTags_B_fkey" FOREIGN KEY ("B") REFERENCES "Tag"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- Class: department + tags relations (tags are via _ClassTags above).
-ALTER TABLE "Class"
-  ADD COLUMN "departmentId" TEXT;
-
-CREATE INDEX "Class_schoolId_idx" ON "Class"("schoolId");
-CREATE INDEX "Class_departmentId_idx" ON "Class"("departmentId");
-
-ALTER TABLE "Class"
-  ADD CONSTRAINT "Class_departmentId_fkey"
-    FOREIGN KEY ("departmentId") REFERENCES "Department"("id")
-    ON DELETE SET NULL ON UPDATE CASCADE;
-
--- MarkScheme: optional class, departmentId, name.
-ALTER TABLE "MarkScheme"
-  DROP CONSTRAINT IF EXISTS "MarkScheme_classId_fkey";
-
-ALTER TABLE "MarkScheme"
-  ALTER COLUMN "classId" DROP NOT NULL,
-  ADD COLUMN "departmentId" TEXT,
-  ADD COLUMN "name" TEXT;
-
-ALTER TABLE "MarkScheme"
-  ADD CONSTRAINT "MarkScheme_classId_fkey"
-    FOREIGN KEY ("classId") REFERENCES "Class"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "MarkScheme_departmentId_fkey"
-    FOREIGN KEY ("departmentId") REFERENCES "Department"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE;
-
-CREATE INDEX "MarkScheme_classId_idx" ON "MarkScheme"("classId");
-CREATE INDEX "MarkScheme_departmentId_idx" ON "MarkScheme"("departmentId");
-
--- GradingBoundary: optional class, departmentId, name.
-ALTER TABLE "GradingBoundary"
-  DROP CONSTRAINT IF EXISTS "GradingBoundary_classId_fkey";
-
-ALTER TABLE "GradingBoundary"
-  ALTER COLUMN "classId" DROP NOT NULL,
-  ADD COLUMN "departmentId" TEXT,
-  ADD COLUMN "name" TEXT;
-
-ALTER TABLE "GradingBoundary"
-  ADD CONSTRAINT "GradingBoundary_classId_fkey"
-    FOREIGN KEY ("classId") REFERENCES "Class"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE,
-  ADD CONSTRAINT "GradingBoundary_departmentId_fkey"
-    FOREIGN KEY ("departmentId") REFERENCES "Department"("id")
-    ON DELETE CASCADE ON UPDATE CASCADE;
-
-CREATE INDEX "GradingBoundary_classId_idx" ON "GradingBoundary"("classId");
-CREATE INDEX "GradingBoundary_departmentId_idx" ON "GradingBoundary"("departmentId");