@studious-lms/server 1.2.53 → 1.4.0

package/src/models/assignment.ts

@@ -0,0 +1,322 @@
+/**
+ * Assignment model – assignments, submissions, attachments.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const assignmentGetInclude = {
+  submissions: {
+    select: {
+      student: { select: { id: true, username: true } },
+    },
+  },
+  attachments: {
+    select: {
+      id: true,
+      name: true,
+      type: true,
+      size: true,
+      path: true,
+      uploadedAt: true,
+      thumbnailId: true,
+    },
+  },
+  section: { select: { id: true, name: true } },
+  teacher: { select: { id: true, username: true } },
+  worksheets: { select: { id: true, name: true } },
+  class: { select: { id: true, name: true } },
+  eventAttached: {
+    select: {
+      id: true,
+      name: true,
+      startTime: true,
+      endTime: true,
+      location: true,
+      remarks: true,
+      color: true,
+    },
+  },
+  markScheme: { select: { id: true, structured: true } },
+  gradingBoundary: { select: { id: true, structured: true } },
+} as const;
+
+/** @returns Assignment by ID. */
+export function findAssignmentById(id: string) {
+  return prisma.assignment.findUnique({
+    where: { id },
+  });
+}
+
+/** @returns Assignment with full details for get. */
+export function findAssignmentWithDetails(id: string) {
+  return prisma.assignment.findUnique({
+    where: { id },
+    include: assignmentGetInclude,
+  });
+}
+
+/** @returns Assignment with attachments for delete. */
+export function findAssignmentForDelete(id: string, teacherId: string) {
+  return prisma.assignment.findFirst({
+    where: { id, teacherId },
+    include: {
+      attachments: { include: { thumbnail: true } },
+      submissions: {
+        include: {
+          attachments: { include: { thumbnail: true } },
+          annotations: { include: { thumbnail: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Assignments due today. */
+export function findAssignmentsDueToday() {
+  return prisma.assignment.findMany({
+    where: {
+      dueDate: { equals: new Date() },
+    },
+    select: {
+      id: true,
+      title: true,
+      dueDate: true,
+      type: true,
+      graded: true,
+      maxGrade: true,
+      class: { select: { id: true, name: true } },
+    },
+  });
+}
+
+/** @returns Submission by assignment and student. */
+export function findSubmissionByAssignmentAndStudent(assignmentId: string, studentId: string) {
+  return prisma.submission.findFirst({
+    where: { assignmentId, studentId },
+    include: {
+      attachments: true,
+      student: { select: { id: true, username: true, profile: true } },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          worksheets: { select: { id: true, name: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+      annotations: true,
+    },
+  });
+}
+
+/** @returns Submission by ID for class member. */
+export function findSubmissionByIdForClassMember(submissionId: string, classId: string, userId: string) {
+  return prisma.submission.findFirst({
+    where: {
+      id: submissionId,
+      assignment: {
+        classId,
+        class: {
+          OR: [
+            { teachers: { some: { id: userId } } },
+            { students: { some: { id: userId } } },
+          ],
+        },
+      },
+    },
+    include: {
+      attachments: true,
+      annotations: true,
+      student: { select: { id: true, username: true, profile: true } },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          worksheets: { select: { id: true, name: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Submission by ID for update (student or teacher). */
+export function findSubmissionForUpdate(submissionId: string, userId: string) {
+  return prisma.submission.findFirst({
+    where: {
+      id: submissionId,
+      OR: [
+        { studentId: userId },
+        {
+          assignment: {
+            class: {
+              teachers: { some: { id: userId } },
+            },
+          },
+        },
+      ],
+    },
+    include: {
+      attachments: { include: { thumbnail: true } },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+    },
+  });
+}
+
+/** Create a submission. */
+export function createSubmission(assignmentId: string, studentId: string) {
+  return prisma.submission.create({
+    data: {
+      assignment: { connect: { id: assignmentId } },
+      student: { connect: { id: studentId } },
+    },
+    include: {
+      attachments: true,
+      annotations: true,
+      student: { select: { id: true, username: true } },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          worksheets: { select: { id: true, name: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Sections for a class. */
+export function findSectionsByClassId(classId: string) {
+  return prisma.section.findMany({
+    where: { classId },
+    select: { id: true, name: true },
+  });
+}
+
+/** @returns Assignment with class for teacher (auth check). */
+export function findAssignmentWithClassForTeacher(assignmentId: string, teacherId: string) {
+  return prisma.assignment.findFirst({
+    where: {
+      id: assignmentId,
+      class: { teachers: { some: { id: teacherId } } },
+    },
+    include: { class: true },
+  });
+}
+
+/** @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 } } },
+      },
+    },
+    include: {
+      attachments: { include: { thumbnail: true } },
+      student: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+              profilePictureThumbnail: true,
+            },
+          },
+        },
+      },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Submission by ID for teacher update. */
+export function findSubmissionForTeacherUpdate(submissionId: string, teacherId: string) {
+  return prisma.submission.findFirst({
+    where: {
+      id: submissionId,
+      assignment: {
+        class: { teachers: { some: { id: teacherId } } },
+      },
+    },
+    include: {
+      attachments: { include: { thumbnail: true } },
+      annotations: { include: { thumbnail: true } },
+      assignment: {
+        include: {
+          class: true,
+          markScheme: { select: { id: true, structured: true } },
+          gradingBoundary: { select: { id: true, structured: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Events in class that don't have this assignment attached. */
+export function findAvailableEventsForAssignment(classId: string, assignmentId: string) {
+  return prisma.event.findMany({
+    where: {
+      classId,
+      assignmentsAttached: { none: { id: assignmentId } },
+    },
+    select: {
+      id: true,
+      name: true,
+      startTime: true,
+      endTime: true,
+      location: true,
+      remarks: true,
+      color: true,
+    },
+    orderBy: { startTime: "asc" },
+  });
+}
+
+const assignmentAttachEventInclude = {
+  attachments: { select: { id: true, name: true, type: true } },
+  section: { select: { id: true, name: true } },
+  teacher: { select: { id: true, username: true } },
+  eventAttached: {
+    select: {
+      id: true,
+      name: true,
+      startTime: true,
+      endTime: true,
+      color: true,
+    },
+  },
+};
+
+/** Attach assignment to event. */
+export function attachAssignmentToEvent(assignmentId: string, eventId: string) {
+  return prisma.assignment.update({
+    where: { id: assignmentId },
+    data: { eventAttached: { connect: { id: eventId } } },
+    include: assignmentAttachEventInclude,
+  });
+}
+
+/** Detach assignment from event. */
+export function detachAssignmentFromEvent(assignmentId: string) {
+  return prisma.assignment.update({
+    where: { id: assignmentId },
+    data: { eventAttached: { disconnect: true } },
+    include: assignmentAttachEventInclude,
+  });
+}

package/src/models/attendance.ts

@@ -0,0 +1,208 @@
+/**
+ * Attendance model – attendance records, present/late/absent students per event.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const attendanceInclude = {
+  event: {
+    select: {
+      id: true,
+      name: true,
+      startTime: true,
+      endTime: true,
+      location: true,
+      color: true,
+    },
+  },
+  present: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+          profilePictureThumbnail: true,
+          bio: true,
+          location: true,
+          website: true,
+        },
+      },
+    },
+  },
+  late: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+          profilePictureThumbnail: true,
+          bio: true,
+          location: true,
+          website: true,
+        },
+      },
+    },
+  },
+  absent: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+          profilePictureThumbnail: true,
+          bio: true,
+          location: true,
+          website: true,
+        },
+      },
+    },
+  },
+} as const;
+
+const attendanceUpdateInclude = {
+  event: {
+    select: {
+      id: true,
+      name: true,
+      startTime: true,
+      endTime: true,
+      location: true,
+    },
+  },
+  present: { select: { id: true, username: true } },
+  late: { select: { id: true, username: true } },
+  absent: { select: { id: true, username: true } },
+} as const;
+
+/** @returns Class with students for attendance. */
+export function findClassWithStudents(classId: string) {
+  return prisma.class.findUnique({
+    where: { id: classId },
+    select: {
+      id: true,
+      students: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+              profilePictureThumbnail: true,
+              bio: true,
+              location: true,
+              website: true,
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Class if user is a teacher. */
+export function findClassWithTeacher(classId: string, teacherId: string) {
+  return prisma.class.findUnique({
+    where: {
+      id: classId,
+      teachers: { some: { id: teacherId } },
+    },
+  });
+}
+
+/** @returns Events for a class. */
+export function findEventsByClassId(classId: string) {
+  return prisma.event.findMany({
+    where: { classId },
+  });
+}
+
+/** @returns Attendance record for an event. */
+export function findAttendanceByEventId(eventId: string) {
+  return prisma.attendance.findFirst({
+    where: { eventId },
+  });
+}
+
+/** @returns Attendance for class and event (eventId null = class-level). */
+export function findAttendanceByClassAndEvent(classId: string, eventId: string | null) {
+  return prisma.attendance.findFirst({
+    where: {
+      classId,
+      eventId,
+    },
+  });
+}
+
+/** @returns Attendance records for class, optionally filtered by event. */
+export function findManyAttendance(classId: string, eventId?: string) {
+  return prisma.attendance.findMany({
+    where: {
+      classId,
+      ...(eventId ? { eventId } : {}),
+    },
+    include: attendanceInclude,
+    orderBy: { date: "desc" },
+  });
+}
+
+/** Create an attendance record. */
+export function createAttendance(data: {
+  classId: string;
+  eventId?: string | null;
+  presentIds: string[];
+  lateIds?: string[];
+  absentIds?: string[];
+}) {
+  return prisma.attendance.create({
+    data: {
+      classId: data.classId,
+      eventId: data.eventId ?? undefined,
+      date: new Date(),
+      present: { connect: data.presentIds.map((id) => ({ id })) },
+      late: data.lateIds?.length
+        ? { connect: data.lateIds.map((id) => ({ id })) }
+        : undefined,
+      absent: data.absentIds?.length
+        ? { connect: data.absentIds.map((id) => ({ id })) }
+        : undefined,
+    },
+    include: attendanceUpdateInclude,
+  });
+}
+
+/** Create attendance for a specific event. */
+export function createAttendanceForEvent(data: {
+  classId: string;
+  eventId: string;
+  presentIds: string[];
+}) {
+  return prisma.attendance.create({
+    data: {
+      class: { connect: { id: data.classId } },
+      event: { connect: { id: data.eventId } },
+      present: { connect: data.presentIds.map((id) => ({ id })) },
+    },
+  });
+}
+
+/** Update attendance present/late/absent lists. */
+export function updateAttendance(
+  id: string,
+  data: { presentIds: string[]; lateIds: string[]; absentIds: string[] }
+) {
+  return prisma.attendance.update({
+    where: { id },
+    data: {
+      present: { set: data.presentIds.map((id) => ({ id })) },
+      late: { set: data.lateIds.map((id) => ({ id })) },
+      absent: { set: data.absentIds.map((id) => ({ id })) },
+    },
+    include: attendanceUpdateInclude,
+  });
+}