@studious-lms/server 1.2.53 → 1.4.0

package/src/models/notification.ts

@@ -0,0 +1,54 @@
+/**
+ * Notification model – in-app notifications, create, mark read.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const notificationInclude = {
+  sender: { select: { username: true } },
+  receiver: { select: { username: true } },
+};
+
+/** @returns Notifications for a receiver, newest first. */
+export function findNotificationsByReceiverId(receiverId: string) {
+  return prisma.notification.findMany({
+    where: { receiverId },
+    orderBy: { createdAt: "desc" },
+    include: notificationInclude,
+  });
+}
+
+/** @returns Notification by ID. */
+export function findNotificationById(id: string) {
+  return prisma.notification.findUnique({
+    where: { id },
+    include: notificationInclude,
+  });
+}
+
+/** Create a notification for one receiver. */
+export function createNotification(data: {
+  receiverId: string;
+  title: string;
+  content: string;
+}) {
+  return prisma.notification.create({
+    data,
+  });
+}
+
+/** Create multiple notifications in one call. */
+export function createManyNotifications(
+  data: Array<{ receiverId: string; title: string; content: string }>
+) {
+  return prisma.notification.createMany({
+    data,
+  });
+}
+
+/** Mark a notification as read. */
+export function markNotificationAsRead(id: string) {
+  return prisma.notification.update({
+    where: { id },
+    data: { read: true },
+  });
+}

package/src/models/section.ts

@@ -0,0 +1,98 @@
+/**
+ * Section model – class sections, ordering, assignment grouping.
+ */
+import { prisma } from "../lib/prisma.js";
+
+/** @returns Section by ID. */
+export function findSectionById(id: string) {
+  return prisma.section.findUnique({
+    where: { id },
+  });
+}
+
+/** @returns Class if user is a teacher. */
+export function findClassWithTeacher(classId: string, teacherId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      teachers: { some: { id: teacherId } },
+    },
+  });
+}
+
+/** Create a section in a class. */
+export function createSection(data: {
+  id?: string;
+  name: string;
+  order: number;
+  classId: string;
+  color?: string;
+}) {
+  return prisma.section.create({
+    data: {
+      ...(data.id && { id: data.id }),
+      name: data.name,
+      order: data.order,
+      class: { connect: { id: data.classId } },
+      ...(data.color && { color: data.color }),
+    },
+  });
+}
+
+/** @returns Sections for a class (id, order only). */
+export function findSectionsByClassId(classId: string) {
+  return prisma.section.findMany({
+    where: { classId },
+    select: { id: true, order: true },
+  });
+}
+
+/** @returns Assignments for a class (id, order only). */
+export function findAssignmentsByClassId(classId: string) {
+  return prisma.assignment.findMany({
+    where: { classId },
+    select: { id: true, order: true },
+  });
+}
+
+/** Update section order. */
+export function updateSectionOrder(id: string, order: number) {
+  return prisma.section.update({
+    where: { id },
+    data: { order },
+  });
+}
+
+/** Update assignment order. */
+export function updateAssignmentOrder(id: string, order: number) {
+  return prisma.assignment.update({
+    where: { id },
+    data: { order },
+  });
+}
+
+/** Update section name and color. */
+export function updateSection(
+  id: string,
+  data: { name: string; color?: string }
+) {
+  return prisma.section.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Delete a section. */
+export function deleteSectionById(id: string) {
+  return prisma.section.delete({
+    where: { id },
+  });
+}
+
+/** @returns Section by ID and classId. */
+export function findSectionByClassAndId(sectionId: string, classId: string) {
+  return prisma.section.findFirst({
+    where: { id: sectionId, classId },
+    select: { id: true, classId: true },
+  });
+}

package/src/models/user.ts

@@ -0,0 +1,47 @@
+/**
+ * User model – user lookup, profile, profile upsert.
+ */
+import { prisma } from "../lib/prisma.js";
+
+/** @returns User by ID (id, username only). */
+export function findUserById(id: string) {
+  return prisma.user.findUnique({
+    where: { id },
+    select: {
+      id: true,
+      username: true,
+    },
+  });
+}
+
+/** @returns User profile by userId. */
+export function findUserProfileByUserId(userId: string) {
+  return prisma.userProfile.findUnique({
+    where: { userId },
+  });
+}
+
+/** Create or update user profile. */
+export function upsertUserProfile(
+  userId: string,
+  data: {
+    displayName?: string;
+    bio?: string;
+    location?: string;
+    website?: string;
+    profilePicture?: string;
+    profilePictureThumbnail?: string;
+  }
+) {
+  return prisma.userProfile.upsert({
+    where: { userId },
+    create: {
+      userId,
+      ...data,
+    },
+    update: {
+      ...data,
+      updatedAt: new Date(),
+    },
+  });
+}

package/src/models/worksheet.ts

@@ -0,0 +1,294 @@
+/**
+ * Worksheet model – worksheets, questions, submissions, student progress, grading.
+ */
+import { prisma } from "../lib/prisma.js";
+import type { WorksheetQuestionType, GenerationStatus } from "@prisma/client";
+
+/** @returns Worksheet with questions and class. */
+export function findWorksheetById(id: string) {
+  return prisma.worksheet.findUnique({
+    where: { id },
+    include: {
+      questions: { orderBy: { createdAt: "asc" as const } },
+      class: true,
+    },
+  });
+}
+
+/** @returns Worksheet by ID (minimal). */
+export function findWorksheetByIdMinimal(id: string) {
+  return prisma.worksheet.findUnique({
+    where: { id },
+  });
+}
+
+/** @returns Worksheets for a class. */
+export function findWorksheetsByClassId(classId: string) {
+  return prisma.worksheet.findMany({
+    where: { classId },
+    include: {
+      questions: { select: { id: true } },
+    },
+    orderBy: { createdAt: "desc" },
+  });
+}
+
+/** Create a worksheet. */
+export function createWorksheet(data: { classId: string; name: string }) {
+  return prisma.worksheet.create({
+    data,
+  });
+}
+
+/** Update worksheet name. */
+export function updateWorksheet(id: string, data: { name?: string }) {
+  return prisma.worksheet.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Delete a worksheet. */
+export function deleteWorksheet(id: string) {
+  return prisma.worksheet.delete({
+    where: { id },
+  });
+}
+
+/** @returns Questions for a worksheet. */
+export function findQuestionsByWorksheetId(worksheetId: string) {
+  return prisma.worksheetQuestion.findMany({
+    where: { worksheetId },
+    orderBy: { order: "asc" },
+  });
+}
+
+/** Create a worksheet question. */
+export function createWorksheetQuestion(data: {
+  worksheetId: string;
+  type: WorksheetQuestionType;
+  question: string;
+  answer: string;
+  points?: number;
+  options?: object;
+  markScheme?: object;
+}) {
+  return prisma.worksheetQuestion.create({
+    data,
+  });
+}
+
+/** Update question order. */
+export function updateWorksheetQuestionOrder(id: string, order: number) {
+  return prisma.worksheetQuestion.update({
+    where: { id },
+    data: { order },
+  });
+}
+
+/** Update a worksheet question. */
+export function updateWorksheetQuestion(
+  id: string,
+  data: {
+    question?: string;
+    answer?: string;
+    points?: number;
+    options?: object;
+    markScheme?: object;
+    type?: WorksheetQuestionType;
+  }
+) {
+  return prisma.worksheetQuestion.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Delete a worksheet question. */
+export function deleteWorksheetQuestion(id: string) {
+  return prisma.worksheetQuestion.delete({
+    where: { id },
+  });
+}
+
+/** @returns Submission by ID. */
+export function findSubmissionById(id: string) {
+  return prisma.submission.findUnique({
+    where: { id },
+  });
+}
+
+const worksheetResponseInclude = {
+  responses: {
+    include: {
+      comments: { select: { id: true } },
+    },
+  },
+};
+
+/** @returns Worksheet response for submission and worksheet. */
+export function findWorksheetResponseBySubmissionAndWorksheet(
+  submissionId: string,
+  worksheetId: string
+) {
+  return prisma.studentWorksheetResponse.findFirst({
+    where: { submissionId, worksheetId },
+    include: worksheetResponseInclude,
+  });
+}
+
+/** Get or create worksheet response for student. */
+export async function findOrCreateWorksheetResponse(
+  submissionId: string,
+  worksheetId: string,
+  studentId: string
+) {
+  return prisma.$transaction(async (tx) => {
+    const existing = await tx.studentWorksheetResponse.findFirst({
+      where: { submissionId, worksheetId },
+      include: worksheetResponseInclude,
+    });
+    if (existing) return existing;
+    return tx.studentWorksheetResponse.create({
+      data: { worksheetId, submissionId, studentId },
+      include: worksheetResponseInclude,
+    });
+  });
+}
+
+/** Create a worksheet response. */
+export function createWorksheetResponse(data: {
+  worksheetId: string;
+  submissionId: string;
+  studentId: string;
+}) {
+  return prisma.studentWorksheetResponse.create({
+    data,
+    include: {
+      responses: {
+        include: {
+          comments: { select: { id: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Worksheet response by ID. */
+export function findWorksheetResponseById(id: string) {
+  return prisma.studentWorksheetResponse.findUnique({
+    where: { id },
+    include: { responses: true },
+  });
+}
+
+/** @returns Worksheet response with question responses. */
+export function findWorksheetResponseWithResponses(
+  id: string,
+  questionId?: string
+) {
+  return prisma.studentWorksheetResponse.findUnique({
+    where: { id },
+    include: {
+      responses: questionId
+        ? { where: { questionId } }
+        : true,
+    },
+  });
+}
+
+/** @returns Worksheet question by ID. */
+export function findWorksheetQuestionById(id: string) {
+  return prisma.worksheetQuestion.findUnique({
+    where: { id },
+  });
+}
+
+/** Update student's question progress. */
+export function updateStudentQuestionProgress(
+  id: string,
+  data: {
+    response?: string;
+    isCorrect?: boolean;
+    points?: number;
+    status?: GenerationStatus;
+  }
+) {
+  return prisma.studentQuestionProgress.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Create student question progress. */
+export function createStudentQuestionProgress(data: {
+  studentId: string;
+  questionId: string;
+  studentWorksheetResponseId: string;
+  response: string;
+  isCorrect?: boolean;
+  points?: number;
+}) {
+  return prisma.studentQuestionProgress.create({
+    data,
+  });
+}
+
+/** @returns Student's progress for a question. */
+export function findStudentQuestionProgress(
+  studentId: string,
+  questionId: string,
+  studentWorksheetResponseId: string
+) {
+  return prisma.studentQuestionProgress.findFirst({
+    where: {
+      studentId,
+      questionId,
+      studentWorksheetResponseId,
+    },
+  });
+}
+
+/** Update progress for grading (AI feedback, marks). */
+export function updateStudentQuestionProgressForGrading(
+  id: string,
+  data: {
+    isCorrect?: boolean;
+    feedback?: string;
+    markschemeState?: object;
+    points?: number;
+    response?: string;
+  }
+) {
+  return prisma.studentQuestionProgress.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Create progress record for grading pipeline. */
+export function createStudentQuestionProgressForGrading(data: {
+  studentId: string;
+  questionId: string;
+  studentWorksheetResponseId: string;
+  response: string;
+  isCorrect: boolean;
+  feedback?: string;
+  markschemeState?: object;
+  points?: number;
+}) {
+  return prisma.studentQuestionProgress.create({
+    data,
+  });
+}
+
+/** Create a comment on a worksheet response. */
+export function createComment(data: {
+  studentQuestionProgressId: string;
+  content: string;
+  authorId: string;
+}) {
+  return prisma.comment.create({
+    data,
+  });
+}