@studious-lms/server 1.24.0 → 1.26.0

package/dist/services/transcript.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.js","sources":["services/transcript.ts"],"sourceRoot":"/","sourcesContent":["/**\n * School-admin branded transcripts / progress reports (A4 — Nepal pilot).\n *\n * Aggregates per-class gradebook grades + grading boundaries + attendance %\n * into a pdf-lib PDF. Branding: school name + logo (letterhead optional when\n * present on School; schema does not include it yet — do not block).\n *\n * AcademicTerm (C1) is not modelled yet — accept `from`/`to` date range and/or\n * a free-text `schoolYear` string for the report header.\n *\n * Attendance is read via the existing present/late/absent M2M lists only\n * (same shaping as getStudentTimeline). Do not conflict with A1 Attendance\n * refactor — rate math lives in attendanceRate.ts.\n */\n\nimport { TRPCError } from \"@trpc/server\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { bucket } from \"../lib/googleCloudStorage.js\";\nimport {\n  buildTranscriptPdf,\n  isLevelBasedBoundary,\n  type TranscriptClassRow,\n  type TranscriptReportVariant,\n} from \"../lib/transcriptPdf.js\";\nimport {\n  findActiveSchoolAdminMembership,\n  getSchoolById,\n} from \"../models/school.js\";\nimport { computeAttendanceRate } from \"./attendanceRate.js\";\nimport { computeStudentGradeInClass } from \"./gradebook.js\";\n\nconst MAX_BULK = 50;\n\nexport interface GenerateTranscriptInput {\n  schoolId: string;\n  studentId: string;\n  from?: Date;\n  to?: Date;\n  /**\n   * Free-text school year label (e.g. \"2082 BS\", \"2025–2026\").\n   * Prefer AcademicTerm (C1) once available.\n   */\n  schoolYear?: string;\n}\n\nasync function requireSchoolAdmin(schoolId: string, userId: string) {\n  const membership = await findActiveSchoolAdminMembership(schoolId, userId);\n  if (!membership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only school admins can generate transcripts\",\n    });\n  }\n  return membership;\n}\n\nasync function loadFileBytes(\n  path: string | null | undefined\n): Promise<Uint8Array | null> {\n  if (!path) return null;\n  try {\n    const [bytes] = await bucket.file(path).download();\n    return new Uint8Array(bytes);\n  } catch {\n    return null;\n  }\n}\n\nfunction formatPeriodLabel(from?: Date, to?: Date): string | null {\n  if (!from && !to) return null;\n  const fmt = (d: Date) => d.toISOString().slice(0, 10);\n  if (from && to) return `${fmt(from)} – ${fmt(to)}`;\n  if (from) return `From ${fmt(from)}`;\n  return `Through ${fmt(to!)}`;\n}\n\nfunction slugify(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .slice(0, 48);\n}\n\nasync function fetchStudentAttendance(\n  studentId: string,\n  from?: Date,\n  to?: Date\n) {\n  const range = {\n    ...(from ? { gte: from } : {}),\n    ...(to ? { lte: to } : {}),\n  };\n  const hasRange = Object.keys(range).length > 0;\n\n  // Same M2M present/late/absent read path as getStudentTimeline (A1-safe).\n  const attendance = await prisma.attendance.findMany({\n    where: {\n      OR: [\n        { present: { some: { id: studentId } } },\n        { late: { some: { id: studentId } } },\n        { absent: { some: { id: studentId } } },\n      ],\n      ...(hasRange ? { date: range } : {}),\n    },\n    select: {\n      id: true,\n      present: { where: { id: studentId }, select: { id: true } },\n      late: { where: { id: studentId }, select: { id: true } },\n      absent: { where: { id: studentId }, select: { id: true } },\n    },\n  });\n\n  return attendance.map((record) => ({\n    status: record.present.length\n      ? (\"PRESENT\" as const)\n      : record.late.length\n        ? (\"LATE\" as const)\n        : (\"ABSENT\" as const),\n  }));\n}\n\nasync function buildClassRows(\n  schoolId: string,\n  studentId: string\n): Promise<{ rows: TranscriptClassRow[]; variant: TranscriptReportVariant }> {\n  const classes = await prisma.class.findMany({\n    where: {\n      schoolId,\n      students: { some: { id: studentId } },\n    },\n    select: {\n      id: true,\n      name: true,\n      subject: true,\n      section: true,\n    },\n    orderBy: [{ subject: \"asc\" }, { name: \"asc\" }],\n  });\n\n  const rows: TranscriptClassRow[] = [];\n  let levelVotes = 0;\n  let letterVotes = 0;\n\n  for (const cls of classes) {\n    const grade = await computeStudentGradeInClass(cls.id, studentId);\n    if (!grade) continue;\n\n    if (isLevelBasedBoundary(grade.gradingBoundary?.structured)) {\n      levelVotes += 1;\n    } else if (grade.gradingBoundary) {\n      letterVotes += 1;\n    }\n\n    rows.push({\n      className: cls.name,\n      subject: cls.subject,\n      section: cls.section,\n      percentage: grade.result.percentage,\n      gradeLabel: grade.letterGrade,\n      categorySummaries: grade.result.categories.map((c) => ({\n        name: c.name,\n        average: c.average,\n      })),\n    });\n  }\n\n  const variant: TranscriptReportVariant =\n    levelVotes > 0 && levelVotes >= letterVotes ? \"level\" : \"letter\";\n\n  return { rows, variant };\n}\n\nexport async function generateTranscript(\n  userId: string,\n  input: GenerateTranscriptInput\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const school = await getSchoolById(input.schoolId);\n  if (!school) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"School not found\" });\n  }\n\n  const membership = await prisma.schoolMembership.findFirst({\n    where: {\n      schoolId: input.schoolId,\n      userId: input.studentId,\n      status: \"ACTIVE\",\n      role: \"STUDENT\",\n    },\n    select: {\n      user: {\n        select: {\n          id: true,\n          username: true,\n          profile: { select: { displayName: true } },\n        },\n      },\n    },\n  });\n  if (!membership) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Student is not an active student in this school\",\n    });\n  }\n\n  const studentName =\n    membership.user.profile?.displayName || membership.user.username;\n\n  const [{ rows, variant }, attendanceStatuses, logoBytes] = await Promise.all([\n    buildClassRows(input.schoolId, input.studentId),\n    fetchStudentAttendance(input.studentId, input.from, input.to),\n    loadFileBytes(school.logo?.path),\n  ]);\n\n  // Soft letterhead support when schema later adds it — never required.\n  const schoolAny = school as {\n    letterhead?: { path?: string | null; type?: string | null } | null;\n    letterheadPath?: string | null;\n    letterheadType?: string | null;\n  };\n  const letterheadPath =\n    schoolAny.letterhead?.path ?? schoolAny.letterheadPath ?? null;\n  const letterheadType =\n    schoolAny.letterhead?.type ?? schoolAny.letterheadType ?? null;\n  const letterheadBytes = await loadFileBytes(letterheadPath);\n\n  const attendance = computeAttendanceRate(attendanceStatuses);\n  const generatedAt = new Date();\n\n  const pdfBytes = await buildTranscriptPdf({\n    schoolName: school.name,\n    studentName,\n    studentUsername: membership.user.username,\n    schoolYear: input.schoolYear ?? null,\n    periodLabel: formatPeriodLabel(input.from, input.to),\n    variant,\n    classes: rows,\n    attendance,\n    logoBytes,\n    logoContentType: school.logo?.type ?? null,\n    letterheadBytes,\n    letterheadContentType: letterheadType,\n    generatedAt,\n  });\n\n  const yearSlug = input.schoolYear\n    ? slugify(input.schoolYear)\n    : generatedAt.toISOString().slice(0, 10);\n  const fileName = `progress-report-${slugify(studentName) || membership.user.username}-${yearSlug}.pdf`;\n\n  return {\n    pdfBase64: Buffer.from(pdfBytes).toString(\"base64\"),\n    fileName,\n    variant,\n    studentId: input.studentId,\n    studentName,\n    /** C1 blocker: AcademicTerm model does not exist yet. */\n    academicTermSupported: false as const,\n    attendance,\n    classCount: rows.length,\n  };\n}\n\nexport async function generateTranscripts(\n  userId: string,\n  input: {\n    schoolId: string;\n    studentIds: string[];\n    from?: Date;\n    to?: Date;\n    schoolYear?: string;\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const uniqueIds = [...new Set(input.studentIds)].slice(0, MAX_BULK);\n  if (uniqueIds.length === 0) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Select at least one student\",\n    });\n  }\n\n  type TranscriptResult = Awaited<ReturnType<typeof generateTranscript>>;\n  const results: TranscriptResult[] = [];\n  const errors: { studentId: string; message: string }[] = [];\n\n  for (const studentId of uniqueIds) {\n    try {\n      const result = await generateTranscript(userId, {\n        schoolId: input.schoolId,\n        studentId,\n        from: input.from,\n        to: input.to,\n        schoolYear: input.schoolYear,\n      });\n      results.push(result);\n    } catch (error) {\n      const message =\n        error instanceof TRPCError\n          ? error.message\n          : error instanceof Error\n            ? error.message\n            : \"Failed to generate transcript\";\n      errors.push({ studentId, message });\n    }\n  }\n\n  return { transcripts: results, errors };\n}\n"],"names":[],"mappings":"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","debug_id":"c7eb65fe-e18f-5b5b-9897-ce16dc61c93d"}
+{"version":3,"file":"transcript.js","sources":["services/transcript.ts"],"sourceRoot":"/","sourcesContent":["/**\n * School-admin branded transcripts / progress reports (A4 — Nepal pilot).\n *\n * Aggregates per-class gradebook grades + grading boundaries + attendance %\n * into a pdf-lib PDF. Branding: school name + logo (letterhead optional when\n * present on School; schema does not include it yet — do not block).\n *\n * AcademicTerm (C1) is not modelled yet — accept `from`/`to` date range and/or\n * a free-text `schoolYear` string for the report header.\n *\n * Attendance is read from AttendanceRecord (EXCUSED excluded from the rate\n * denominator) — rate math lives in attendanceRate.ts.\n */\n\nimport { TRPCError } from \"@trpc/server\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { bucket } from \"../lib/googleCloudStorage.js\";\nimport {\n  buildTranscriptPdf,\n  isLevelBasedBoundary,\n  type TranscriptClassRow,\n  type TranscriptReportVariant,\n} from \"../lib/transcriptPdf.js\";\nimport {\n  findActiveSchoolAdminMembership,\n  getSchoolById,\n} from \"../models/school.js\";\nimport { computeAttendanceRate } from \"./attendanceRate.js\";\nimport { computeStudentGradeInClass } from \"./gradebook.js\";\n\nconst MAX_BULK = 50;\n\nexport interface GenerateTranscriptInput {\n  schoolId: string;\n  studentId: string;\n  from?: Date;\n  to?: Date;\n  /**\n   * Free-text school year label (e.g. \"2082 BS\", \"2025–2026\").\n   * Prefer AcademicTerm (C1) once available.\n   */\n  schoolYear?: string;\n}\n\nasync function requireSchoolAdmin(schoolId: string, userId: string) {\n  const membership = await findActiveSchoolAdminMembership(schoolId, userId);\n  if (!membership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only school admins can generate transcripts\",\n    });\n  }\n  return membership;\n}\n\nasync function loadFileBytes(\n  path: string | null | undefined\n): Promise<Uint8Array | null> {\n  if (!path) return null;\n  try {\n    const [bytes] = await bucket.file(path).download();\n    return new Uint8Array(bytes);\n  } catch {\n    return null;\n  }\n}\n\nfunction formatPeriodLabel(from?: Date, to?: Date): string | null {\n  if (!from && !to) return null;\n  const fmt = (d: Date) => d.toISOString().slice(0, 10);\n  if (from && to) return `${fmt(from)} – ${fmt(to)}`;\n  if (from) return `From ${fmt(from)}`;\n  return `Through ${fmt(to!)}`;\n}\n\nfunction slugify(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .slice(0, 48);\n}\n\nasync function fetchStudentAttendance(\n  studentId: string,\n  from?: Date,\n  to?: Date\n) {\n  const range = {\n    ...(from ? { gte: from } : {}),\n    ...(to ? { lte: to } : {}),\n  };\n  const hasRange = Object.keys(range).length > 0;\n\n  // Read AttendanceRecord so EXCUSED records are excluded from the rate\n  // denominator (computeAttendanceRate ignores non-PRESENT/LATE/ABSENT).\n  const records = await prisma.attendanceRecord.findMany({\n    where: {\n      studentId,\n      status: { in: [\"PRESENT\", \"LATE\", \"ABSENT\"] },\n      ...(hasRange ? { attendance: { date: range } } : {}),\n    },\n    select: { status: true },\n  });\n\n  return records.map((record) => ({\n    status: record.status as \"PRESENT\" | \"LATE\" | \"ABSENT\",\n  }));\n}\n\nasync function buildClassRows(\n  schoolId: string,\n  studentId: string\n): Promise<{ rows: TranscriptClassRow[]; variant: TranscriptReportVariant }> {\n  const classes = await prisma.class.findMany({\n    where: {\n      schoolId,\n      students: { some: { id: studentId } },\n    },\n    select: {\n      id: true,\n      name: true,\n      subject: true,\n      section: true,\n    },\n    orderBy: [{ subject: \"asc\" }, { name: \"asc\" }],\n  });\n\n  const rows: TranscriptClassRow[] = [];\n  let levelVotes = 0;\n  let letterVotes = 0;\n\n  for (const cls of classes) {\n    const grade = await computeStudentGradeInClass(cls.id, studentId);\n    if (!grade) continue;\n\n    if (isLevelBasedBoundary(grade.gradingBoundary?.structured)) {\n      levelVotes += 1;\n    } else if (grade.gradingBoundary) {\n      letterVotes += 1;\n    }\n\n    rows.push({\n      className: cls.name,\n      subject: cls.subject,\n      section: cls.section,\n      percentage: grade.result.percentage,\n      gradeLabel: grade.letterGrade,\n      categorySummaries: grade.result.categories.map((c) => ({\n        name: c.name,\n        average: c.average,\n      })),\n    });\n  }\n\n  const variant: TranscriptReportVariant =\n    levelVotes > 0 && levelVotes >= letterVotes ? \"level\" : \"letter\";\n\n  return { rows, variant };\n}\n\nexport async function generateTranscript(\n  userId: string,\n  input: GenerateTranscriptInput\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const school = await getSchoolById(input.schoolId);\n  if (!school) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"School not found\" });\n  }\n\n  const membership = await prisma.schoolMembership.findFirst({\n    where: {\n      schoolId: input.schoolId,\n      userId: input.studentId,\n      status: \"ACTIVE\",\n      role: \"STUDENT\",\n    },\n    select: {\n      user: {\n        select: {\n          id: true,\n          username: true,\n          profile: { select: { displayName: true } },\n        },\n      },\n    },\n  });\n  if (!membership) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Student is not an active student in this school\",\n    });\n  }\n\n  const studentName =\n    membership.user.profile?.displayName || membership.user.username;\n\n  const [{ rows, variant }, attendanceStatuses, logoBytes] = await Promise.all([\n    buildClassRows(input.schoolId, input.studentId),\n    fetchStudentAttendance(input.studentId, input.from, input.to),\n    loadFileBytes(school.logo?.path),\n  ]);\n\n  // Soft letterhead support when schema later adds it — never required.\n  const schoolAny = school as {\n    letterhead?: { path?: string | null; type?: string | null } | null;\n    letterheadPath?: string | null;\n    letterheadType?: string | null;\n  };\n  const letterheadPath =\n    schoolAny.letterhead?.path ?? schoolAny.letterheadPath ?? null;\n  const letterheadType =\n    schoolAny.letterhead?.type ?? schoolAny.letterheadType ?? null;\n  const letterheadBytes = await loadFileBytes(letterheadPath);\n\n  const attendance = computeAttendanceRate(attendanceStatuses);\n  const generatedAt = new Date();\n\n  const pdfBytes = await buildTranscriptPdf({\n    schoolName: school.name,\n    studentName,\n    studentUsername: membership.user.username,\n    schoolYear: input.schoolYear ?? null,\n    periodLabel: formatPeriodLabel(input.from, input.to),\n    variant,\n    classes: rows,\n    attendance,\n    logoBytes,\n    logoContentType: school.logo?.type ?? null,\n    letterheadBytes,\n    letterheadContentType: letterheadType,\n    generatedAt,\n  });\n\n  const yearSlug = input.schoolYear\n    ? slugify(input.schoolYear)\n    : generatedAt.toISOString().slice(0, 10);\n  const fileName = `progress-report-${slugify(studentName) || membership.user.username}-${yearSlug}.pdf`;\n\n  return {\n    pdfBase64: Buffer.from(pdfBytes).toString(\"base64\"),\n    fileName,\n    variant,\n    studentId: input.studentId,\n    studentName,\n    /** C1 blocker: AcademicTerm model does not exist yet. */\n    academicTermSupported: false as const,\n    attendance,\n    classCount: rows.length,\n  };\n}\n\nexport async function generateTranscripts(\n  userId: string,\n  input: {\n    schoolId: string;\n    studentIds: string[];\n    from?: Date;\n    to?: Date;\n    schoolYear?: string;\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const uniqueIds = [...new Set(input.studentIds)].slice(0, MAX_BULK);\n  if (uniqueIds.length === 0) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Select at least one student\",\n    });\n  }\n\n  type TranscriptResult = Awaited<ReturnType<typeof generateTranscript>>;\n  const results: TranscriptResult[] = [];\n  const errors: { studentId: string; message: string }[] = [];\n\n  for (const studentId of uniqueIds) {\n    try {\n      const result = await generateTranscript(userId, {\n        schoolId: input.schoolId,\n        studentId,\n        from: input.from,\n        to: input.to,\n        schoolYear: input.schoolYear,\n      });\n      results.push(result);\n    } catch (error) {\n      const message =\n        error instanceof TRPCError\n          ? error.message\n          : error instanceof Error\n            ? error.message\n            : \"Failed to generate transcript\";\n      errors.push({ studentId, message });\n    }\n  }\n\n  return { transcripts: results, errors };\n}\n"],"names":[],"mappings":"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","debug_id":"186437e2-1c14-52c2-94d5-09ccd8035936"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.24.0",
+  "version": "1.26.0",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",

package/prisma/migrations/20260708013000_add_modules/migration.sql

@@ -0,0 +1,100 @@
+-- CreateEnum
+CREATE TYPE "CourseModuleItemType" AS ENUM ('ASSIGNMENT', 'WORKSHEET', 'FILE', 'ANNOUNCEMENT', 'DISCUSSION', 'EXTERNAL_URL', 'SUB_HEADER');
+
+-- CreateEnum
+CREATE TYPE "ModuleItemRequirementType" AS ENUM ('VIEW', 'SUBMIT', 'SCORE_AT_LEAST');
+
+-- CreateEnum
+CREATE TYPE "ModuleItemProgressStatus" AS ENUM ('INCOMPLETE', 'COMPLETE');
+
+-- CreateTable
+CREATE TABLE "Module" (
+    "id" TEXT NOT NULL,
+    "classId" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "position" INTEGER NOT NULL,
+    "unlockAt" TIMESTAMP(3),
+    "requireSequential" BOOLEAN NOT NULL DEFAULT false,
+    "published" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Module_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ModulePrerequisite" (
+    "id" TEXT NOT NULL,
+    "moduleId" TEXT NOT NULL,
+    "prerequisiteId" TEXT NOT NULL,
+
+    CONSTRAINT "ModulePrerequisite_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CourseModuleItem" (
+    "id" TEXT NOT NULL,
+    "moduleId" TEXT NOT NULL,
+    "position" INTEGER NOT NULL,
+    "indent" INTEGER NOT NULL DEFAULT 0,
+    "itemType" "CourseModuleItemType" NOT NULL,
+    "itemId" TEXT,
+    "externalUrl" TEXT,
+    "title" TEXT,
+    "requirementType" "ModuleItemRequirementType",
+    "requiredScore" DOUBLE PRECISION,
+
+    CONSTRAINT "CourseModuleItem_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ModuleItemProgress" (
+    "id" TEXT NOT NULL,
+    "moduleItemId" TEXT NOT NULL,
+    "studentId" TEXT NOT NULL,
+    "status" "ModuleItemProgressStatus" NOT NULL DEFAULT 'INCOMPLETE',
+    "completedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ModuleItemProgress_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "Module_classId_position_idx" ON "Module"("classId", "position");
+
+-- CreateIndex
+CREATE INDEX "ModulePrerequisite_prerequisiteId_idx" ON "ModulePrerequisite"("prerequisiteId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ModulePrerequisite_moduleId_prerequisiteId_key" ON "ModulePrerequisite"("moduleId", "prerequisiteId");
+
+-- CreateIndex
+CREATE INDEX "CourseModuleItem_moduleId_position_idx" ON "CourseModuleItem"("moduleId", "position");
+
+-- CreateIndex
+CREATE INDEX "CourseModuleItem_itemType_itemId_idx" ON "CourseModuleItem"("itemType", "itemId");
+
+-- CreateIndex
+CREATE INDEX "ModuleItemProgress_studentId_idx" ON "ModuleItemProgress"("studentId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ModuleItemProgress_moduleItemId_studentId_key" ON "ModuleItemProgress"("moduleItemId", "studentId");
+
+-- AddForeignKey
+ALTER TABLE "Module" ADD CONSTRAINT "Module_classId_fkey" FOREIGN KEY ("classId") REFERENCES "Class"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModulePrerequisite" ADD CONSTRAINT "ModulePrerequisite_moduleId_fkey" FOREIGN KEY ("moduleId") REFERENCES "Module"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModulePrerequisite" ADD CONSTRAINT "ModulePrerequisite_prerequisiteId_fkey" FOREIGN KEY ("prerequisiteId") REFERENCES "Module"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CourseModuleItem" ADD CONSTRAINT "CourseModuleItem_moduleId_fkey" FOREIGN KEY ("moduleId") REFERENCES "Module"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModuleItemProgress" ADD CONSTRAINT "ModuleItemProgress_moduleItemId_fkey" FOREIGN KEY ("moduleItemId") REFERENCES "CourseModuleItem"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModuleItemProgress" ADD CONSTRAINT "ModuleItemProgress_studentId_fkey" FOREIGN KEY ("studentId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/schema.prisma

@@ -328,6 +328,7 @@ model User {
   discussions             Discussion[]
   discussionReplies       DiscussionReply[]
   discussionReads         DiscussionRead[]
+  moduleItemProgress      ModuleItemProgress[]
   customGradeEntries      CustomGradeEntry[]   @relation("UserCustomGradeEntries")
   fileAnnotations         FileAnnotation[]     @relation("AuthoredFileAnnotations")
   marketplaceListings     MarketplaceListing[] @relation("MarketplaceListingAuthor")
@@ -428,6 +429,8 @@ model Class {
   studentsCanCreateDiscussions Boolean @default(true)
   studentsCanReply             Boolean @default(true)
 
+  modules Module[]
+
   /// Teacher-controlled ClassSidebar visibility. Keys match nav hrefs
   /// without leading slash (e.g. "assignments", "quizzes"). Null = all defaults on.
   sidebarFeatures Json?
@@ -1478,6 +1481,96 @@ model Permission {
   @@index([schoolId])
 }
 
+enum CourseModuleItemType {
+  ASSIGNMENT
+  WORKSHEET
+  FILE
+  ANNOUNCEMENT
+  DISCUSSION
+  EXTERNAL_URL
+  SUB_HEADER
+}
+
+enum ModuleItemRequirementType {
+  VIEW
+  SUBMIT
+  SCORE_AT_LEAST
+}
+
+enum ModuleItemProgressStatus {
+  INCOMPLETE
+  COMPLETE
+}
+
+/// Canvas-style course module: an ordered group of content items with
+/// optional prerequisites, unlock date and sequential progression.
+model Module {
+  id                String   @id @default(uuid())
+  classId           String
+  class             Class    @relation(fields: [classId], references: [id], onDelete: Cascade)
+  title             String
+  position          Int
+  unlockAt          DateTime?
+  requireSequential Boolean  @default(false)
+  published         Boolean  @default(false)
+  createdAt         DateTime @default(now())
+  updatedAt         DateTime @updatedAt
+
+  items         CourseModuleItem[]
+  prerequisites ModulePrerequisite[] @relation("ModulePrerequisites")
+  requiredBy    ModulePrerequisite[] @relation("ModuleRequiredBy")
+
+  @@index([classId, position])
+}
+
+model ModulePrerequisite {
+  id             String @id @default(uuid())
+  moduleId       String
+  module         Module @relation("ModulePrerequisites", fields: [moduleId], references: [id], onDelete: Cascade)
+  prerequisiteId String
+  prerequisite   Module @relation("ModuleRequiredBy", fields: [prerequisiteId], references: [id], onDelete: Cascade)
+
+  @@unique([moduleId, prerequisiteId])
+  @@index([prerequisiteId])
+}
+
+model CourseModuleItem {
+  id              String                     @id @default(uuid())
+  moduleId        String
+  module          Module                     @relation(fields: [moduleId], references: [id], onDelete: Cascade)
+  position        Int
+  indent          Int                        @default(0)
+  itemType        CourseModuleItemType
+  /// ID of the referenced assignment / worksheet / file / announcement /
+  /// discussion. Null for EXTERNAL_URL and SUB_HEADER items.
+  itemId          String?
+  externalUrl     String?
+  /// Display title override; required for EXTERNAL_URL and SUB_HEADER.
+  title           String?
+  requirementType ModuleItemRequirementType?
+  requiredScore   Float?
+
+  progress ModuleItemProgress[]
+
+  @@index([moduleId, position])
+  @@index([itemType, itemId])
+}
+
+model ModuleItemProgress {
+  id           String                   @id @default(uuid())
+  moduleItemId String
+  moduleItem   CourseModuleItem               @relation(fields: [moduleItemId], references: [id], onDelete: Cascade)
+  studentId    String
+  student      User                     @relation(fields: [studentId], references: [id], onDelete: Cascade)
+  status       ModuleItemProgressStatus @default(INCOMPLETE)
+  completedAt  DateTime?
+  createdAt    DateTime                 @default(now())
+  updatedAt    DateTime                 @updatedAt
+
+  @@unique([moduleItemId, studentId])
+  @@index([studentId])
+}
+
 // ---------------------------------------------------------------------------
 // A2 — Monthly student fees + manual payment ledger (Nepal pilot)
 // Billing period = FeeInvoice.year + FeeInvoice.month (no separate term table;

package/scripts/import-nepal-cdc-curriculum.ts

@@ -93,6 +93,12 @@ function parseArgs(argv: string[]) {
   return out;
 }
 
+function parseBool(value: string | boolean | undefined): boolean {
+  if (value === undefined) return false;
+  if (typeof value === "boolean") return value;
+  return !["false", "0", "no"].includes(value.trim().toLowerCase());
+}
+
 function loadJson<T>(path: string): T {
   return JSON.parse(readFileSync(path, "utf8")) as T;
 }
@@ -174,13 +180,19 @@ async function main() {
     process.exit(1);
   }
 
-  const dryRun = Boolean(args["dry-run"]);
-  const force = Boolean(args.force);
-  const skipBoundary = Boolean(args["skip-boundary"]);
-  const grades = String(args.grades ?? "4,5")
+  const dryRun = parseBool(args["dry-run"]);
+  const force = parseBool(args.force);
+  const skipBoundary = parseBool(args["skip-boundary"]);
+  const rawGrades = String(args.grades ?? "4,5")
     .split(",")
-    .map((g) => Number(g.trim()))
-    .filter((g): g is 4 | 5 => g === 4 || g === 5);
+    .map((g) => Number(g.trim()));
+  const grades = rawGrades.filter((g): g is 4 | 5 => g === 4 || g === 5);
+  if (grades.length === 0 || grades.length !== rawGrades.length) {
+    console.error(
+      `Invalid --grades value: ${String(args.grades)}. Use 4, 5, or 4,5.`
+    );
+    process.exit(1);
+  }
   const subjectFilter = args.subjects
     ? String(args.subjects)
         .split(",")
@@ -219,6 +231,17 @@ async function main() {
     loadJson<SubjectFile>(join(PACK_DIR, "subjects", f))
   );
 
+  if (subjectFilter) {
+    const knownKeys = new Set(subjects.map((s) => s.key));
+    const unknown = subjectFilter.filter((key) => !knownKeys.has(key));
+    if (unknown.length > 0) {
+      console.error(
+        `Unknown --subjects value(s): ${unknown.join(", ")}. Known: ${[...knownKeys].join(", ")}`
+      );
+      process.exit(1);
+    }
+  }
+
   const units = subjects
     .filter((s) => !subjectFilter || subjectFilter.includes(s.key))
     .flatMap((s) => s.units)

package/src/models/attendance.ts

@@ -370,18 +370,16 @@ function buildRecordsFromLists(input: {
     status: AttendanceStatus;
     updatedById?: string | null;
   }> = [];
-  for (const studentId of input.presentIds) {
-    records.push({ studentId, status: "PRESENT", updatedById: input.updatedById });
-  }
-  for (const studentId of input.lateIds) {
-    records.push({ studentId, status: "LATE", updatedById: input.updatedById });
-  }
-  for (const studentId of input.absentIds) {
-    records.push({ studentId, status: "ABSENT", updatedById: input.updatedById });
-  }
-  for (const studentId of input.excusedIds) {
-    records.push({ studentId, status: "EXCUSED", updatedById: input.updatedById });
-  }
+  const seen = new Set<string>();
+  const pushUnique = (studentId: string, status: AttendanceStatus) => {
+    if (seen.has(studentId)) return;
+    seen.add(studentId);
+    records.push({ studentId, status, updatedById: input.updatedById });
+  };
+  for (const studentId of input.presentIds) pushUnique(studentId, "PRESENT");
+  for (const studentId of input.lateIds) pushUnique(studentId, "LATE");
+  for (const studentId of input.absentIds) pushUnique(studentId, "ABSENT");
+  for (const studentId of input.excusedIds) pushUnique(studentId, "EXCUSED");
   return records;
 }
 

package/src/models/marketplace.ts

@@ -71,10 +71,13 @@ export async function searchMarketplaceListings(input: {
   limit: number;
   /** When true, include the caller's own hidden listings (for authors). */
   authorId?: string;
+  /** When set, restrict the entire result set (including PUBLIC listings) to this school. */
+  scopeSchoolId?: string;
 }) {
   const search = input.search?.trim();
   const where: Prisma.MarketplaceListingWhereInput = {
     AND: [
+      ...(input.scopeSchoolId ? [{ schoolId: input.scopeSchoolId }] : []),
       {
         OR: [
           { visibility: "PUBLIC", isHidden: false },
@@ -132,6 +135,22 @@ export async function searchMarketplaceListings(input: {
   return { items: rows, nextCursor };
 }
 
+export async function updateMarketplaceListing(
+  id: string,
+  data: {
+    title?: string;
+    description?: string | null;
+    visibility?: MarketplaceVisibility;
+    tags?: string[];
+  }
+) {
+  return prisma.marketplaceListing.update({
+    where: { id },
+    data,
+    include: marketplaceListingInclude,
+  });
+}
+
 export async function incrementMarketplaceReportCount(id: string) {
   return prisma.marketplaceListing.update({
     where: { id },

package/src/models/module.ts

@@ -0,0 +1,77 @@
+/**
+ * Module model – Canvas-style class modules, items and student progress.
+ */
+import { prisma } from "../lib/prisma.js";
+import { classTeacherOrSchoolAdminWhere } from "./access.js";
+
+/** @returns Class if user is a teacher or school admin. */
+export function findClassWithTeacher(classId: string, teacherId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      ...classTeacherOrSchoolAdminWhere(teacherId),
+    },
+  });
+}
+
+export const moduleInclude = {
+  items: {
+    orderBy: { position: "asc" as const },
+  },
+  prerequisites: {
+    select: { prerequisiteId: true },
+  },
+} as const;
+
+/** @returns All modules of a class ordered by position. */
+export function findModulesByClassId(classId: string, publishedOnly = false) {
+  return prisma.module.findMany({
+    where: { classId, ...(publishedOnly && { published: true }) },
+    orderBy: { position: "asc" },
+    include: moduleInclude,
+  });
+}
+
+/** @returns Module by ID scoped to a class. */
+export function findModuleByClassAndId(id: string, classId: string) {
+  return prisma.module.findFirst({
+    where: { id, classId },
+    include: moduleInclude,
+  });
+}
+
+/** @returns Module item with its module, scoped to a class. */
+export function findModuleItemInClass(itemId: string, classId: string) {
+  return prisma.courseModuleItem.findFirst({
+    where: { id: itemId, module: { classId } },
+    include: { module: true },
+  });
+}
+
+/** @returns Progress rows of a student for all items of a class. */
+export function findStudentProgressForClass(classId: string, studentId: string) {
+  return prisma.moduleItemProgress.findMany({
+    where: { studentId, moduleItem: { module: { classId } } },
+  });
+}
+
+/** Upsert a progress row for a student and item. */
+export function upsertItemProgress(
+  moduleItemId: string,
+  studentId: string,
+  status: "INCOMPLETE" | "COMPLETE"
+) {
+  return prisma.moduleItemProgress.upsert({
+    where: { moduleItemId_studentId: { moduleItemId, studentId } },
+    create: {
+      moduleItemId,
+      studentId,
+      status,
+      ...(status === "COMPLETE" && { completedAt: new Date() }),
+    },
+    update:
+      status === "COMPLETE"
+        ? { status, completedAt: new Date() }
+        : {},
+  });
+}

package/src/models/moduleItem.ts

@@ -96,12 +96,30 @@ export function deleteModuleItem(id: string) {
   return prisma.moduleItem.delete({ where: { id } });
 }
 
+function fileAccessibleToUserWhere(userId: string) {
+  return {
+    OR: [
+      { userId },
+      { folder: { personalOwnerId: userId } },
+      { folder: { class: { is: classTeacherOrSchoolAdminWhere(userId) } } },
+    ],
+  };
+}
+
+export function findAccessibleFilesByIds(fileIds: string[], userId: string) {
+  return prisma.file.findMany({
+    where: { id: { in: fileIds }, ...fileAccessibleToUserWhere(userId) },
+    select: { id: true, type: true },
+  });
+}
+
 export function attachFilesToModuleItem(
   moduleItemId: string,
-  fileIds: string[]
+  fileIds: string[],
+  userId: string
 ) {
   return prisma.file.updateMany({
-    where: { id: { in: fileIds } },
+    where: { id: { in: fileIds }, ...fileAccessibleToUserWhere(userId) },
     data: { moduleItemId },
   });
 }

package/src/pipelines/gradeWorksheet.ts

@@ -9,6 +9,7 @@ import z from "zod";
 import { inference } from "../utils/inference.js";
 import { getAIUserId } from "../utils/aiUser.js";
 import { pusher, worksheetChannel } from "../lib/pusher.js";
+import { syncWorksheetModuleProgress } from "../services/module.js";
 
 
 const removeAllPreviousAIComments = async (worksheetQuestionProgressId: string) => {
@@ -369,6 +370,11 @@ export const gradeWorksheetPipeline = async (
         }
 
     };
+
+    await syncWorksheetModuleProgress(
+        worksheetResponse.studentId,
+        worksheetResponse.worksheetId,
+    );
 };
 
 export const cancelGradePipeline = async (worksheetResponseId: string, worksheetQuestionProgressId: string) => {

package/src/routers/_app.ts

@@ -29,6 +29,7 @@ import { permissionsRouter } from "./permissions.js";
 import { discussionRouter } from "./discussion.js";
 import { adminRouter } from "./admin.js";
 import { embeddingRouter } from "./embedding.js";
+import { moduleRouter } from "./module.js";
 import { gradebookRouter } from "./gradebook.js";
 import { feesRouter } from "./fees.js";
 import { marketplaceRouter } from "./marketplace.js";
@@ -65,6 +66,7 @@ export const appRouter = createTRPCRouter({
   discussion: discussionRouter,
   admin: adminRouter,
   embedding: embeddingRouter,
+  module: moduleRouter,
   gradebook: gradebookRouter,
   fees: feesRouter,
   marketplace: marketplaceRouter,

package/src/routers/marketplace.ts

@@ -15,6 +15,7 @@ import {
   publishWorksheetListing,
   reportMarketplaceListing,
   unpublishMarketplaceListing,
+  updateMarketplaceListingDetails,
 } from "../services/marketplace.js";
 
 const listingTypeSchema = z.enum(["MARKSCHEME", "WORKSHEET", "FILE"]);
@@ -109,6 +110,21 @@ export const marketplaceRouter = createTRPCRouter({
       importMarketplaceListing(ctx.user!.id, input)
     ),
 
+  /** Edit listing metadata (author or school admin). */
+  update: protectedProcedure
+    .input(
+      z.object({
+        listingId: z.string(),
+        title: z.string().trim().min(1).max(160).optional(),
+        description: z.string().trim().max(2000).nullable().optional(),
+        visibility: visibilitySchema.optional(),
+        tags: tagsSchema,
+      })
+    )
+    .mutation(({ ctx, input }) =>
+      updateMarketplaceListingDetails(ctx.user!.id, input)
+    ),
+
   report: protectedProcedure
     .input(z.object({ listingId: z.string() }))
     .mutation(({ ctx, input }) =>