@studious-lms/server 1.4.6 → 1.4.9

package/dist/services/worksheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"worksheet.js","sources":["services/worksheet.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worksheet service – CRUD for worksheets, questions, submissions, and AI grading.\n * Integrates with gradeWorksheet pipeline for auto-grading.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { GenerationStatus, type WorksheetQuestionType } from \"@prisma/client\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { getFileUrl } from \"../lib/fileUpload.js\";\nimport { cancelGradePipeline, regradeWorksheetPipeline } from \"../pipelines/gradeWorksheet.js\";\nimport { pdfToWorksheet } from \"../pipelines/pdfToWorksheet.js\";\nimport {\n  findWorksheetByIdMinimal,\n  findWorksheetByIdForClassMember,\n  findWorksheetByIdForTeacher,\n  findWorksheetsByClassId,\n  createWorksheet,\n  updateWorksheet,\n  deleteWorksheet,\n  findQuestionsByWorksheetId,\n  createWorksheetQuestion,\n  updateWorksheetQuestion,\n  deleteWorksheetQuestion,\n  findSubmissionByIdForWorksheetAccess,\n  findOrCreateWorksheetResponse,\n  findWorksheetResponseByIdForTeacher,\n  findWorksheetResponseWithResponsesForStudent,\n  findWorksheetQuestionByIdForTeacher,\n  findWorksheetQuestionByIdInWorksheet,\n  updateStudentQuestionProgress,\n  createStudentQuestionProgress,\n  findStudentQuestionProgress,\n  updateStudentQuestionProgressForGrading,\n  createStudentQuestionProgressForGrading,\n  createComment,\n  findStudentQuestionProgressByIdForTeacher,\n  findStudentQuestionProgressByIdForTeacherAndResponse,\n} from \"../models/worksheet.js\";\n\ntype MCQOptions = { id: string; text: string; isCorrect: boolean }[];\n\nconst sanitizeQuestionOptionsForStudent = (options: unknown) => {\n  if (!Array.isArray(options)) return options;\n\n  return options.map((option) => {\n    if (!option || typeof option !== \"object\") return option;\n\n    const { isCorrect: _isCorrect, ...rest } = option as Record<string, unknown>;\n    return rest;\n  });\n};\n\nconst sanitizeWorksheetForStudent = <T extends {\n  questions: Array<Record<string, unknown>>;\n}>(worksheet: T) => ({\n  ...worksheet,\n  questions: worksheet.questions.map((question) => ({\n    ...question,\n    answer: \"\",\n    markScheme: null,\n    options: sanitizeQuestionOptionsForStudent(question.options),\n  })),\n});\n\n/** Get worksheet with questions and mark schemes. */\nexport async function getWorksheet(worksheetId: string, userId: string) {\n  const teacherWorksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (teacherWorksheet) {\n    return teacherWorksheet;\n  }\n\n  const studentWorksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!studentWorksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  return sanitizeWorksheetForStudent(studentWorksheet);\n}\n\n/** Check if worksheet exists. */\nexport async function worksheetExists(id: string) {\n  const worksheet = await findWorksheetByIdMinimal(id);\n  return !!worksheet;\n}\n\nexport async function listWorksheets(classId: string) {\n  const worksheets = await findWorksheetsByClassId(classId);\n  return worksheets.map((w) => ({\n    ...w,\n    questionCount: w.questions.length,\n  }));\n}\n\nexport async function updateWorksheetRecord(\n  worksheetId: string,\n  userId: string,\n  data: { name?: string }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheets\",\n    });\n  }\n  return updateWorksheet(worksheetId, data);\n}\n\nexport async function deleteWorksheetRecord(worksheetId: string, userId: string) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheets\",\n    });\n  }\n  return deleteWorksheet(worksheetId);\n}\n\nexport async function createWorksheetRecord(classId: string, name: string) {\n  return createWorksheet({ classId, name });\n}\n\n/**\n * Create a worksheet by converting a PDF (URL) into structured questions.\n * Uses the `pdfToWorksheet` pipeline to do inference + persistence.\n */\nexport async function createWorksheetFromPdf(\n  classId: string,\n  url: string\n) {\n  const created = await pdfToWorksheet(url, classId);\n  if (!created) {\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to create worksheet from PDF\",\n    });\n  }\n  return created;\n}\n\n/**\n * Create a worksheet from a PDF that was uploaded through the direct-upload flow.\n */\nexport async function createWorksheetFromUploadedPdf(\n  classId: string,\n  fileId: string,\n  userId: string\n) {\n  const file = await prisma.file.findFirst({\n    where: {\n      id: fileId,\n      userId,\n      uploadStatus: \"COMPLETED\",\n    },\n    select: {\n      id: true,\n      path: true,\n      type: true,\n    },\n  });\n\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Uploaded file not found or not ready\",\n    });\n  }\n\n  const isPdf =\n    file.type === \"application/pdf\" || file.path.toLowerCase().endsWith(\".pdf\");\n  if (!isPdf) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Only PDF files can be converted into worksheets\",\n    });\n  }\n\n  const signedUrl = await getFileUrl(file.path);\n  return createWorksheetFromPdf(classId, signedUrl);\n}\n\nexport async function addQuestionToWorksheet(\n  worksheetId: string,\n  userId: string,\n  data: {\n    question: string;\n    answer: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type: WorksheetQuestionType;\n  }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can modify worksheet questions\",\n    });\n  }\n  return createWorksheetQuestion({\n    worksheetId,\n    ...data,\n  });\n}\n\nexport async function reorderWorksheetQuestions(\n  worksheetId: string,\n  userId: string,\n  movedId: string,\n  position: \"before\" | \"after\",\n  targetId: string\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can reorder worksheet questions\",\n    });\n  }\n\n  const questions = await findQuestionsByWorksheetId(worksheetId);\n  const movedIdx = questions.findIndex((q) => q.id === movedId);\n  if (movedIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Moved question not found\",\n    });\n  }\n  const targetIdx = questions.findIndex((q) => q.id === targetId);\n  if (targetIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target question not found\",\n    });\n  }\n\n  const withoutMoved = questions.filter((q) => q.id !== movedId);\n  const next =\n    position === \"before\"\n      ? [\n          ...withoutMoved.slice(0, targetIdx).map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved.slice(targetIdx).map((item) => ({ id: item.id })),\n        ]\n      : [\n          ...withoutMoved\n            .slice(0, targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved\n            .slice(targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n        ];\n\n  await prisma.$transaction(\n    next.map((item, index) =>\n      prisma.worksheetQuestion.update({\n        where: { id: item.id },\n        data: { order: index },\n      })\n    )\n  );\n  return next;\n}\n\nexport async function updateWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string,\n  data: {\n    question?: string;\n    answer?: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type?: WorksheetQuestionType;\n  }\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheet questions\",\n    });\n  }\n  return updateWorksheetQuestion(questionId, data);\n}\n\nexport async function deleteWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheet questions\",\n    });\n  }\n  return deleteWorksheetQuestion(questionId);\n}\n\nexport async function getWorksheetSubmission(\n  worksheetId: string,\n  submissionId: string,\n  userId: string\n) {\n  const worksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  const submission = await findSubmissionByIdForWorksheetAccess(\n    submissionId,\n    worksheetId,\n    worksheet.classId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet submission\",\n    });\n  }\n  return findOrCreateWorksheetResponse(\n    submissionId,\n    worksheetId,\n    submission.studentId\n  );\n}\n\nexport async function answerWorksheetQuestion(\n  worksheetResponseId: string,\n  questionId: string,\n  response: string,\n  userId: string\n) {\n  const worksheetResponse = await findWorksheetResponseWithResponsesForStudent(\n    worksheetResponseId,\n    userId,\n    questionId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You can only answer your own worksheet responses\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  const isMarkableByAlgo =\n    question.type === \"MULTIPLE_CHOICE\" || question.type === \"TRUE_FALSE\";\n  const marksAwardedIfCorrect = question.points || 0;\n  const correctAnswer = isMarkableByAlgo\n    ? question.type === \"MULTIPLE_CHOICE\"\n      ? (question.options as MCQOptions)?.find((o) => o.isCorrect)?.id\n      : question.answer?.toString()\n    : null;\n\n  const existingResponse = worksheetResponse.responses[0];\n\n  if (existingResponse) {\n    await updateStudentQuestionProgress(existingResponse.id, {\n      response,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n      status: GenerationStatus.NOT_STARTED,\n    });\n  } else {\n    await createStudentQuestionProgress({\n      studentId: worksheetResponse.studentId,\n      questionId,\n      response,\n      studentWorksheetResponseId: worksheetResponseId,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n    });\n  }\n\n  const updated = await prisma.studentWorksheetResponse.findUnique({\n    where: { id: worksheetResponseId },\n    include: { responses: true },\n  });\n  return updated!;\n}\n\nexport async function cancelGrading(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can cancel worksheet grading\",\n    });\n  }\n  return cancelGradePipeline(worksheetResponseId, progressId);\n}\n\nexport async function regradeQuestion(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can regrade worksheet answers\",\n    });\n  }\n  return regradeWorksheetPipeline(worksheetResponseId, progressId);\n}\n\nexport async function gradeAnswer(\n  questionId: string,\n  studentWorksheetResponseId: string,\n  userId: string,\n  data: {\n    responseId?: string;\n    response?: string;\n    isCorrect: boolean;\n    feedback?: string;\n    markschemeState?: object;\n    points?: number;\n  }\n) {\n  const worksheetResponse = await findWorksheetResponseByIdForTeacher(\n    studentWorksheetResponseId,\n    userId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can grade worksheet answers\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  if (data.responseId) {\n    const existingProgress = await findStudentQuestionProgressByIdForTeacher(\n      data.responseId,\n      userId\n    );\n    if (\n      !existingProgress ||\n      existingProgress.studentWorksheetResponseId !== studentWorksheetResponseId ||\n      existingProgress.questionId !== questionId\n    ) {\n      throw new TRPCError({\n        code: \"FORBIDDEN\",\n        message: \"Only class teachers can grade worksheet answers\",\n      });\n    }\n\n    return updateStudentQuestionProgressForGrading(data.responseId, {\n      isCorrect: data.isCorrect,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  const existing = await findStudentQuestionProgress(\n    worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId\n  );\n\n  if (existing) {\n    return updateStudentQuestionProgressForGrading(existing.id, {\n      isCorrect: data.isCorrect,\n      response: data.response,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  return createStudentQuestionProgressForGrading({\n    studentId: worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId,\n    response: data.response || \"\",\n    isCorrect: data.isCorrect,\n    feedback: data.feedback,\n    markschemeState: data.markschemeState,\n    points: data.points || 0,\n  });\n}\n\nexport async function addCommentToResponse(\n  responseId: string,\n  comment: string,\n  authorId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacher(\n    responseId,\n    authorId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can comment on worksheet responses\",\n    });\n  }\n\n  return createComment({\n    studentQuestionProgressId: responseId,\n    content: comment,\n    authorId,\n  });\n}\n"],"names":[],"mappings":"AAAA;;;GAGG;;;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAA8B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,4CAA4C,EAC5C,mCAAmC,EACnC,oCAAoC,EACpC,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,uCAAuC,EACvC,uCAAuC,EACvC,aAAa,EACb,yCAAyC,EACzC,oDAAoD,GACrD,MAAM,wBAAwB,CAAC;AAIhC,MAAM,iCAAiC,GAAG,CAAC,OAAgB,EAAE,EAAE;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE5C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAEzD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAiC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAEjC,SAAY,EAAE,EAAE,CAAC,CAAC;IACnB,GAAG,SAAS;IACZ,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,GAAG,QAAQ;QACX,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC;KAC7D,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,MAAc;IACpE,MAAM,gBAAgB,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAChF,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,+BAA+B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAC9C,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,GAAG,CAAC;QACJ,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;KAClC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,MAAc,EACd,IAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB,EAAE,MAAc;IAC7E,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAe,EAAE,IAAY;IACvE,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,GAAW;IAEX,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,qCAAqC;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAe,EACf,MAAc,EACd,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACvC,KAAK,EAAE;YACL,EAAE,EAAE,MAAM;YACV,MAAM;YACN,YAAY,EAAE,WAAW;SAC1B;QACD,MAAM,EAAE;YACN,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;SACX;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,iDAAiD;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,MAAc,EACd,IAOC;IAED,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC;QAC7B,WAAW;QACX,GAAG,IAAI;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,MAAc,EACd,OAAe,EACf,QAA4B,EAC5B,QAAgB;IAEhB,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC9D,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0BAA0B;SACpC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAChE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC/D,MAAM,IAAI,GACR,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC;YACE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACpE,EAAE,EAAE,EAAE,OAAO,EAAE;YACf,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;SAClE;QACH,CAAC,CAAC;YACE,GAAG,YAAY;iBACZ,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC;iBACvB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,EAAE,EAAE,EAAE,OAAO,EAAE;YACf,GAAG,YAAY;iBACZ,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;iBACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;SACpC,CAAC;IAER,MAAM,MAAM,CAAC,YAAY,CACvB,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACvB,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC9B,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;QACtB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KACvB,CAAC,CACH,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAAmB,EACnB,UAAkB,EAClB,MAAc,EACd,IAOC;IAED,MAAM,QAAQ,GAAG,MAAM,mCAAmC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAAmB,EACnB,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,mCAAmC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,YAAoB,EACpB,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,+BAA+B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,oCAAoC,CAC3D,YAAY,EACZ,WAAW,EACX,SAAS,CAAC,OAAO,EACjB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,6BAA6B,CAClC,YAAY,EACZ,WAAW,EACX,UAAU,CAAC,SAAS,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,mBAA2B,EAC3B,UAAkB,EAClB,QAAgB,EAChB,MAAc;IAEd,MAAM,iBAAiB,GAAG,MAAM,4CAA4C,CAC1E,mBAAmB,EACnB,MAAM,EACN,UAAU,CACX,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oCAAoC,CACzD,UAAU,EACV,iBAAiB,CAAC,WAAW,CAC9B,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,gBAAgB,GACpB,QAAQ,CAAC,IAAI,KAAK,iBAAiB,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC;IACxE,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,gBAAgB;QACpC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,iBAAiB;YACnC,CAAC,CAAE,QAAQ,CAAC,OAAsB,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE;YAChE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAExD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,6BAA6B,CAAC,gBAAgB,CAAC,EAAE,EAAE;YACvD,QAAQ;YACR,GAAG,CAAC,gBAAgB,IAAI;gBACtB,SAAS,EAAE,QAAQ,KAAK,aAAa;aACtC,CAAC;YACF,GAAG,CAAC,gBAAgB,IAAI;gBACtB,MAAM,EAAE,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAC/D,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,WAAW;SACrC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,6BAA6B,CAAC;YAClC,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,UAAU;YACV,QAAQ;YACR,0BAA0B,EAAE,mBAAmB;YAC/C,GAAG,CAAC,gBAAgB,IAAI;gBACtB,SAAS,EAAE,QAAQ,KAAK,aAAa;aACtC,CAAC;YACF,GAAG,CAAC,gBAAgB,IAAI;gBACtB,MAAM,EAAE,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,UAAU,CAAC;QAC/D,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE;QAClC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAC7B,CAAC,CAAC;IACH,OAAO,OAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,mBAA2B,EAC3B,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,oDAAoD,CACzE,UAAU,EACV,mBAAmB,EACnB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,mBAA2B,EAC3B,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,oDAAoD,CACzE,UAAU,EACV,mBAAmB,EACnB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,mDAAmD;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,wBAAwB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,0BAAkC,EAClC,MAAc,EACd,IAOC;IAED,MAAM,iBAAiB,GAAG,MAAM,mCAAmC,CACjE,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,iDAAiD;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oCAAoC,CACzD,UAAU,EACV,iBAAiB,CAAC,WAAW,CAC9B,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,gBAAgB,GAAG,MAAM,yCAAyC,CACtE,IAAI,CAAC,UAAU,EACf,MAAM,CACP,CAAC;QACF,IACE,CAAC,gBAAgB;YACjB,gBAAgB,CAAC,0BAA0B,KAAK,0BAA0B;YAC1E,gBAAgB,CAAC,UAAU,KAAK,UAAU,EAC1C,CAAC;YACD,MAAM,IAAI,SAAS,CAAC;gBAClB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,uCAAuC,CAAC,IAAI,CAAC,UAAU,EAAE;YAC9D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAChD,iBAAiB,CAAC,SAAS,EAC3B,UAAU,EACV,0BAA0B,CAC3B,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,uCAAuC,CAAC,QAAQ,CAAC,EAAE,EAAE;YAC1D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,uCAAuC,CAAC;QAC7C,SAAS,EAAE,iBAAiB,CAAC,SAAS;QACtC,UAAU;QACV,0BAA0B;QAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,OAAe,EACf,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,yCAAyC,CAC9D,UAAU,EACV,QAAQ,CACT,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,wDAAwD;SAClE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,aAAa,CAAC;QACnB,yBAAyB,EAAE,UAAU;QACrC,OAAO,EAAE,OAAO;QAChB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC","debug_id":"2fcbad58-5215-5f4a-a912-82db38a85645"}
+{"version":3,"file":"worksheet.js","sources":["services/worksheet.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worksheet service – CRUD for worksheets, questions, submissions, and AI grading.\n * Integrates with gradeWorksheet pipeline for auto-grading.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { GenerationStatus, type WorksheetQuestionType } from \"@prisma/client\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { getFileUrl } from \"../lib/fileUpload.js\";\nimport { cancelGradePipeline, regradeWorksheetPipeline } from \"../pipelines/gradeWorksheet.js\";\nimport { pdfToWorksheet } from \"../pipelines/pdfToWorksheet.js\";\nimport {\n  findWorksheetByIdMinimal,\n  findWorksheetByIdForClassMember,\n  findWorksheetByIdForTeacher,\n  findWorksheetsByClassId,\n  createWorksheet,\n  duplicateWorksheet,\n  updateWorksheet,\n  deleteWorksheet,\n  findQuestionsByWorksheetId,\n  createWorksheetQuestion,\n  updateWorksheetQuestion,\n  deleteWorksheetQuestion,\n  findSubmissionByIdForWorksheetAccess,\n  findOrCreateWorksheetResponse,\n  findWorksheetResponseByIdForTeacher,\n  findWorksheetResponseWithResponsesForStudent,\n  findWorksheetQuestionByIdForTeacher,\n  findWorksheetQuestionByIdInWorksheet,\n  updateStudentQuestionProgress,\n  createStudentQuestionProgress,\n  findStudentQuestionProgress,\n  updateStudentQuestionProgressForGrading,\n  createStudentQuestionProgressForGrading,\n  createComment,\n  findStudentQuestionProgressByIdForTeacher,\n  findStudentQuestionProgressByIdForTeacherAndResponse,\n} from \"../models/worksheet.js\";\n\ntype MCQOptions = { id: string; text: string; isCorrect: boolean }[];\n\nconst sanitizeQuestionOptionsForStudent = (options: unknown) => {\n  if (!Array.isArray(options)) return options;\n\n  return options.map((option) => {\n    if (!option || typeof option !== \"object\") return option;\n\n    const { isCorrect: _isCorrect, ...rest } = option as Record<string, unknown>;\n    return rest;\n  });\n};\n\nconst sanitizeWorksheetForStudent = <T extends {\n  questions: Array<Record<string, unknown>>;\n}>(worksheet: T) => ({\n  ...worksheet,\n  questions: worksheet.questions.map((question) => ({\n    ...question,\n    answer: \"\",\n    markScheme: null,\n    options: sanitizeQuestionOptionsForStudent(question.options),\n  })),\n});\n\n/** Get worksheet with questions and mark schemes. */\nexport async function getWorksheet(worksheetId: string, userId: string) {\n  const teacherWorksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (teacherWorksheet) {\n    return teacherWorksheet;\n  }\n\n  const studentWorksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!studentWorksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  return sanitizeWorksheetForStudent(studentWorksheet);\n}\n\n/** Check if worksheet exists. */\nexport async function worksheetExists(id: string) {\n  const worksheet = await findWorksheetByIdMinimal(id);\n  return !!worksheet;\n}\n\nexport async function listWorksheets(classId: string) {\n  const worksheets = await findWorksheetsByClassId(classId);\n  return worksheets.map((w) => ({\n    ...w,\n    questionCount: w.questions.length,\n  }));\n}\n\nexport async function updateWorksheetRecord(\n  worksheetId: string,\n  userId: string,\n  data: { name?: string }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheets\",\n    });\n  }\n  return updateWorksheet(worksheetId, data);\n}\n\nexport async function deleteWorksheetRecord(worksheetId: string, userId: string) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheets\",\n    });\n  }\n  return deleteWorksheet(worksheetId);\n}\n\nexport async function createWorksheetRecord(classId: string, name: string) {\n  return createWorksheet({ classId, name });\n}\n\n/**\n * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class\n * and the target class.\n */\nexport async function duplicateWorksheetRecord(\n  worksheetId: string,\n  classId: string,\n  name: string,\n  userId: string\n) {\n  const source = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!source) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message:\n        \"Worksheet not found or you are not a teacher of the class it belongs to\",\n    });\n  }\n\n  const targetOk = await prisma.class.findFirst({\n    where: {\n      id: classId,\n      teachers: { some: { id: userId } },\n    },\n    select: { id: true },\n  });\n\n  if (!targetOk) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You are not a teacher of the target class\",\n    });\n  }\n\n  const created = await duplicateWorksheet(worksheetId, classId, name);\n  if (!created) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet not found\",\n    });\n  }\n\n  return created;\n}\n\n/**\n * Create a worksheet by converting a PDF (URL) into structured questions.\n * Uses the `pdfToWorksheet` pipeline to do inference + persistence.\n */\nexport async function createWorksheetFromPdf(\n  classId: string,\n  url: string\n) {\n  const created = await pdfToWorksheet(url, classId);\n  if (!created) {\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to create worksheet from PDF\",\n    });\n  }\n  return created;\n}\n\n/**\n * Create a worksheet from a PDF that was uploaded through the direct-upload flow.\n */\nexport async function createWorksheetFromUploadedPdf(\n  classId: string,\n  fileId: string,\n  userId: string\n) {\n  const file = await prisma.file.findFirst({\n    where: {\n      id: fileId,\n      userId,\n      uploadStatus: \"COMPLETED\",\n    },\n    select: {\n      id: true,\n      path: true,\n      type: true,\n    },\n  });\n\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Uploaded file not found or not ready\",\n    });\n  }\n\n  const isPdf =\n    file.type === \"application/pdf\" || file.path.toLowerCase().endsWith(\".pdf\");\n  if (!isPdf) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Only PDF files can be converted into worksheets\",\n    });\n  }\n\n  const signedUrl = await getFileUrl(file.path);\n  return createWorksheetFromPdf(classId, signedUrl);\n}\n\nexport async function addQuestionToWorksheet(\n  worksheetId: string,\n  userId: string,\n  data: {\n    question: string;\n    answer: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type: WorksheetQuestionType;\n  }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can modify worksheet questions\",\n    });\n  }\n  return createWorksheetQuestion({\n    worksheetId,\n    ...data,\n  });\n}\n\nexport async function reorderWorksheetQuestions(\n  worksheetId: string,\n  userId: string,\n  movedId: string,\n  position: \"before\" | \"after\",\n  targetId: string\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can reorder worksheet questions\",\n    });\n  }\n\n  const questions = await findQuestionsByWorksheetId(worksheetId);\n  const movedIdx = questions.findIndex((q) => q.id === movedId);\n  if (movedIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Moved question not found\",\n    });\n  }\n  const targetIdx = questions.findIndex((q) => q.id === targetId);\n  if (targetIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target question not found\",\n    });\n  }\n\n  const withoutMoved = questions.filter((q) => q.id !== movedId);\n  const next =\n    position === \"before\"\n      ? [\n          ...withoutMoved.slice(0, targetIdx).map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved.slice(targetIdx).map((item) => ({ id: item.id })),\n        ]\n      : [\n          ...withoutMoved\n            .slice(0, targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved\n            .slice(targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n        ];\n\n  await prisma.$transaction(\n    next.map((item, index) =>\n      prisma.worksheetQuestion.update({\n        where: { id: item.id },\n        data: { order: index },\n      })\n    )\n  );\n  return next;\n}\n\nexport async function updateWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string,\n  data: {\n    question?: string;\n    answer?: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type?: WorksheetQuestionType;\n  }\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheet questions\",\n    });\n  }\n  return updateWorksheetQuestion(questionId, data);\n}\n\nexport async function deleteWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheet questions\",\n    });\n  }\n  return deleteWorksheetQuestion(questionId);\n}\n\nexport async function getWorksheetSubmission(\n  worksheetId: string,\n  submissionId: string,\n  userId: string\n) {\n  const worksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  const submission = await findSubmissionByIdForWorksheetAccess(\n    submissionId,\n    worksheetId,\n    worksheet.classId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet submission\",\n    });\n  }\n  return findOrCreateWorksheetResponse(\n    submissionId,\n    worksheetId,\n    submission.studentId\n  );\n}\n\nexport async function answerWorksheetQuestion(\n  worksheetResponseId: string,\n  questionId: string,\n  response: string,\n  userId: string\n) {\n  const worksheetResponse = await findWorksheetResponseWithResponsesForStudent(\n    worksheetResponseId,\n    userId,\n    questionId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You can only answer your own worksheet responses\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  const isMarkableByAlgo =\n    question.type === \"MULTIPLE_CHOICE\" || question.type === \"TRUE_FALSE\";\n  const marksAwardedIfCorrect = question.points || 0;\n  const correctAnswer = isMarkableByAlgo\n    ? question.type === \"MULTIPLE_CHOICE\"\n      ? (question.options as MCQOptions)?.find((o) => o.isCorrect)?.id\n      : question.answer?.toString()\n    : null;\n\n  const existingResponse = worksheetResponse.responses[0];\n\n  if (existingResponse) {\n    await updateStudentQuestionProgress(existingResponse.id, {\n      response,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n      status: GenerationStatus.NOT_STARTED,\n    });\n  } else {\n    await createStudentQuestionProgress({\n      studentId: worksheetResponse.studentId,\n      questionId,\n      response,\n      studentWorksheetResponseId: worksheetResponseId,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n    });\n  }\n\n  const updated = await prisma.studentWorksheetResponse.findUnique({\n    where: { id: worksheetResponseId },\n    include: { responses: true },\n  });\n  return updated!;\n}\n\nexport async function cancelGrading(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can cancel worksheet grading\",\n    });\n  }\n  return cancelGradePipeline(worksheetResponseId, progressId);\n}\n\nexport async function regradeQuestion(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can regrade worksheet answers\",\n    });\n  }\n  return regradeWorksheetPipeline(worksheetResponseId, progressId);\n}\n\nexport async function gradeAnswer(\n  questionId: string,\n  studentWorksheetResponseId: string,\n  userId: string,\n  data: {\n    responseId?: string;\n    response?: string;\n    isCorrect: boolean;\n    feedback?: string;\n    markschemeState?: object;\n    points?: number;\n  }\n) {\n  const worksheetResponse = await findWorksheetResponseByIdForTeacher(\n    studentWorksheetResponseId,\n    userId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can grade worksheet answers\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  if (data.responseId) {\n    const existingProgress = await findStudentQuestionProgressByIdForTeacher(\n      data.responseId,\n      userId\n    );\n    if (\n      !existingProgress ||\n      existingProgress.studentWorksheetResponseId !== studentWorksheetResponseId ||\n      existingProgress.questionId !== questionId\n    ) {\n      throw new TRPCError({\n        code: \"FORBIDDEN\",\n        message: \"Only class teachers can grade worksheet answers\",\n      });\n    }\n\n    return updateStudentQuestionProgressForGrading(data.responseId, {\n      isCorrect: data.isCorrect,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  const existing = await findStudentQuestionProgress(\n    worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId\n  );\n\n  if (existing) {\n    return updateStudentQuestionProgressForGrading(existing.id, {\n      isCorrect: data.isCorrect,\n      response: data.response,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  return createStudentQuestionProgressForGrading({\n    studentId: worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId,\n    response: data.response || \"\",\n    isCorrect: data.isCorrect,\n    feedback: data.feedback,\n    markschemeState: data.markschemeState,\n    points: data.points || 0,\n  });\n}\n\nexport async function addCommentToResponse(\n  responseId: string,\n  comment: string,\n  authorId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacher(\n    responseId,\n    authorId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can comment on worksheet responses\",\n    });\n  }\n\n  return createComment({\n    studentQuestionProgressId: responseId,\n    content: comment,\n    authorId,\n  });\n}\n"],"names":[],"mappings":"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","debug_id":"d15dc113-0231-5e3c-b956-9b5c549c4073"}

package/package.json

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

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

@@ -0,0 +1,81 @@
+-- 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/schema.prisma

@@ -81,15 +81,38 @@ enum SubmissionRecommendationState {
   DISMISSED
 }
 
+enum SchoolMembershipRole {
+  ADMIN
+  TEACHER
+  STUDENT
+}
+
+enum SchoolMembershipStatus {
+  ACTIVE
+  INVITED
+  SUSPENDED
+}
+
+enum SchoolInviteStatus {
+  PENDING
+  ACCEPTED
+  REVOKED
+  EXPIRED
+}
+
 model School {
   id          String      @id @default(uuid())
   name        String
-  logo        File        @relation(references: [id], fields: [logoId])
-  logoId      String
+  logo        File?       @relation(references: [id], fields: [logoId])
+  logoId      String?
   subdomain   String?     @unique
+  createdAt   DateTime    @default(now())
+  updatedAt   DateTime    @updatedAt
   
   
   users       User[]
+  memberships SchoolMembership[]
+  invites     SchoolInvite[]
   classes     Class[]
 }
 
@@ -123,6 +146,8 @@ model User {
 
   school School? @relation(fields: [schoolId], references: [id])
   schoolId String?
+  schoolMemberships SchoolMembership[]
+  sentSchoolInvites SchoolInvite[] @relation("SchoolInviteInvitedBy")
 
   // Chat relations
   conversationMemberships ConversationMember[]
@@ -134,6 +159,45 @@ model User {
 
 }
 
+model SchoolMembership {
+  id        String                 @id @default(uuid())
+  schoolId  String
+  userId    String
+  role      SchoolMembershipRole
+  status    SchoolMembershipStatus @default(ACTIVE)
+  createdAt DateTime               @default(now())
+  updatedAt DateTime               @updatedAt
+
+  school School @relation(fields: [schoolId], references: [id], onDelete: Cascade)
+  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([schoolId, userId])
+  @@index([userId])
+  @@index([schoolId, role])
+  @@index([schoolId, status])
+}
+
+model SchoolInvite {
+  id          String               @id @default(uuid())
+  token       String               @unique
+  email       String
+  role        SchoolMembershipRole
+  status      SchoolInviteStatus   @default(PENDING)
+  expiresAt   DateTime
+  acceptedAt  DateTime?
+  revokedAt   DateTime?
+  createdAt   DateTime             @default(now())
+  updatedAt   DateTime             @updatedAt
+
+  schoolId    String
+  school      School               @relation(fields: [schoolId], references: [id], onDelete: Cascade)
+  invitedById String
+  invitedBy   User                 @relation("SchoolInviteInvitedBy", fields: [invitedById], references: [id], onDelete: Cascade)
+
+  @@index([schoolId, status])
+  @@index([email])
+}
+
 model UserProfile {
   id String @id @default(uuid())
   userId String @unique

package/src/models/access.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared class access filters.
+ */
+
+export const schoolAdminForClassWhere = (userId: string) => ({
+  OR: [
+    {
+      school: {
+        is: {
+          memberships: {
+            some: {
+              userId,
+              role: "ADMIN" as const,
+              status: "ACTIVE" as const,
+            },
+          },
+        },
+      },
+    },
+    {
+      school: {
+        is: {
+          users: {
+            some: {
+              id: userId,
+              role: "ADMIN" as const,
+            },
+          },
+        },
+      },
+    },
+  ],
+});
+
+export const classTeacherOrSchoolAdminWhere = (userId: string) => ({
+  OR: [
+    { teachers: { some: { id: userId } } },
+    schoolAdminForClassWhere(userId),
+  ],
+});
+
+export const classMemberOrSchoolAdminWhere = (userId: string) => ({
+  OR: [
+    { teachers: { some: { id: userId } } },
+    { students: { some: { id: userId } } },
+    schoolAdminForClassWhere(userId),
+  ],
+});

package/src/models/announcement.ts

@@ -56,13 +56,30 @@ export function findAnnouncementByIdAndClass(id: string, classId: string) {
   });
 }
 
-/** @returns Announcement by ID with class and teachers. */
+/** @returns Announcement by ID with class teachers and school admins. */
 export function findAnnouncementWithClass(id: string) {
   return prisma.announcement.findUnique({
     where: { id },
     include: {
       class: {
-        include: { teachers: true },
+        include: {
+          teachers: true,
+          school: {
+            include: {
+              users: {
+                where: { role: "ADMIN" as const },
+                select: { id: true },
+              },
+              memberships: {
+                where: {
+                  role: "ADMIN" as const,
+                  status: "ACTIVE" as const,
+                },
+                select: { userId: true },
+              },
+            },
+          },
+        },
       },
       attachments: {
         select: {

package/src/models/assignment.ts

@@ -2,6 +2,12 @@
  * Assignment model – assignments, submissions, attachments.
  */
 import { prisma } from "../lib/prisma.js";
+import { duplicateWorksheetWithClient } from "./worksheet.js";
+import {
+  classMemberOrSchoolAdminWhere,
+  classTeacherOrSchoolAdminWhere,
+  schoolAdminForClassWhere,
+} from "./access.js";
 
 const assignmentGetInclude = {
   submissions: {
@@ -57,7 +63,13 @@ export function findAssignmentWithDetails(id: string) {
 /** @returns Assignment with attachments for delete. */
 export function findAssignmentForDelete(id: string, teacherId: string) {
   return prisma.assignment.findFirst({
-    where: { id, teacherId },
+    where: {
+      id,
+      OR: [
+        { teacherId },
+        { class: schoolAdminForClassWhere(teacherId) },
+      ],
+    },
     include: {
       attachments: { include: { thumbnail: true } },
       submissions: {
@@ -115,12 +127,7 @@ export function findSubmissionByIdForClassMember(submissionId: string, classId:
       id: submissionId,
       assignment: {
         classId,
-        class: {
-          OR: [
-            { teachers: { some: { id: userId } } },
-            { students: { some: { id: userId } } },
-          ],
-        },
+        class: classMemberOrSchoolAdminWhere(userId),
       },
     },
     include: {
@@ -148,9 +155,7 @@ export function findSubmissionForUpdate(submissionId: string, userId: string) {
         { studentId: userId },
         {
           assignment: {
-            class: {
-              teachers: { some: { id: userId } },
-            },
+            class: classTeacherOrSchoolAdminWhere(userId),
           },
         },
       ],
@@ -204,19 +209,150 @@ export function findAssignmentWithClassForTeacher(assignmentId: string, teacherI
   return prisma.assignment.findFirst({
     where: {
       id: assignmentId,
-      class: { teachers: { some: { id: teacherId } } },
+      class: classTeacherOrSchoolAdminWhere(teacherId),
     },
     include: { class: true },
   });
 }
 
+/**
+ * Clone an assignment into another class with a new title: copies settings, duplicates linked
+ * worksheets into the target class, clones attachment file records (same storage path),
+ * creates empty submissions for all students in the target class, and does not copy the
+ * calendar event link or per-student “assigned to” overrides.
+ */
+export async function duplicateAssignment(
+  sourceAssignmentId: string,
+  targetClassId: string,
+  title: string,
+  duplicatingUserId: string
+) {
+  return prisma.$transaction(
+    async (tx) => {
+      const source = await tx.assignment.findUnique({
+        where: { id: sourceAssignmentId },
+        include: {
+          worksheets: { select: { id: true, name: true } },
+          attachments: {
+            select: { name: true, type: true, size: true, path: true },
+          },
+          section: { select: { id: true, name: true } },
+        },
+      });
+
+      if (!source) {
+        return null;
+      }
+
+      let targetSectionId: string | undefined;
+      if (source.sectionId && source.section) {
+        const match = await tx.section.findFirst({
+          where: { classId: targetClassId, name: source.section.name },
+          select: { id: true },
+        });
+        targetSectionId = match?.id;
+      }
+
+      const newWorksheetIds: string[] = [];
+      for (const ws of source.worksheets) {
+        const dup = await duplicateWorksheetWithClient(
+          tx,
+          ws.id,
+          targetClassId,
+          ws.name
+        );
+        if (dup) {
+          newWorksheetIds.push(dup.id);
+        }
+      }
+
+      const classData = await tx.class.findUnique({
+        where: { id: targetClassId },
+        include: { students: { select: { id: true } } },
+      });
+      if (!classData) {
+        return null;
+      }
+
+      const submissionData = classData.students.map((s) => ({
+        student: { connect: { id: s.id } },
+      }));
+
+      const created = await tx.assignment.create({
+        data: {
+          title,
+          instructions: source.instructions,
+          dueDate: source.dueDate,
+          teacher: { connect: { id: duplicatingUserId } },
+          class: { connect: { id: targetClassId } },
+          acceptFiles: source.acceptFiles,
+          acceptExtendedResponse: source.acceptExtendedResponse,
+          acceptWorksheet: source.acceptWorksheet,
+          gradeWithAI: source.gradeWithAI,
+          aiPolicyLevel: source.aiPolicyLevel,
+          graded: source.graded,
+          maxGrade: source.maxGrade,
+          weight: source.weight,
+          type: source.type,
+          inProgress: source.inProgress,
+          template: source.template,
+          ...(source.markSchemeId && {
+            markScheme: { connect: { id: source.markSchemeId } },
+          }),
+          ...(source.gradingBoundaryId && {
+            gradingBoundary: { connect: { id: source.gradingBoundaryId } },
+          }),
+          ...(targetSectionId && {
+            section: { connect: { id: targetSectionId } },
+          }),
+          ...(newWorksheetIds.length > 0 && {
+            worksheets: { connect: newWorksheetIds.map((id) => ({ id })) },
+          }),
+          submissions: { create: submissionData },
+          order: 0,
+        },
+      });
+
+      await tx.assignment.updateMany({
+        where: { classId: targetClassId, id: { not: created.id } },
+        data: { order: { increment: 1 } },
+      });
+      await tx.section.updateMany({
+        where: { classId: targetClassId },
+        data: { order: { increment: 1 } },
+      });
+      await tx.assignment.update({
+        where: { id: created.id },
+        data: { order: 1 },
+      });
+
+      for (const file of source.attachments) {
+        await tx.file.create({
+          data: {
+            name: file.name,
+            type: file.type,
+            size: file.size ?? 0,
+            path: file.path,
+            uploadStatus: "COMPLETED",
+            user: { connect: { id: duplicatingUserId } },
+            assignment: { connect: { id: created.id } },
+          },
+        });
+      }
+
+      return created;
+    },
+    { maxWait: 10000, timeout: 60000 }
+  );
+}
+
 /** @returns Submissions for assignment (teacher view). */
 export function findSubmissionsByAssignmentForTeacher(assignmentId: string, teacherId: string) {
   return prisma.submission.findMany({
     where: {
       assignment: {
         id: assignmentId,
-        class: { teachers: { some: { id: teacherId } } },
+        class: classTeacherOrSchoolAdminWhere(teacherId),
       },
     },
     include: {
@@ -251,7 +387,7 @@ export function findSubmissionForTeacherUpdate(submissionId: string, teacherId:
     where: {
       id: submissionId,
       assignment: {
-        class: { teachers: { some: { id: teacherId } } },
+        class: classTeacherOrSchoolAdminWhere(teacherId),
       },
     },
     include: {

package/src/models/attendance.ts

@@ -2,6 +2,7 @@
  * Attendance model – attendance records, present/late/absent students per event.
  */
 import { prisma } from "../lib/prisma.js";
+import { classTeacherOrSchoolAdminWhere } from "./access.js";
 
 const attendanceInclude = {
   event: {
@@ -105,12 +106,12 @@ export function findClassWithStudents(classId: string) {
   });
 }
 
-/** @returns Class if user is a teacher. */
+/** @returns Class if user is a teacher or school admin. */
 export function findClassWithTeacher(classId: string, teacherId: string) {
-  return prisma.class.findUnique({
+  return prisma.class.findFirst({
     where: {
       id: classId,
-      teachers: { some: { id: teacherId } },
+      ...classTeacherOrSchoolAdminWhere(teacherId),
     },
   });
 }