@studious-lms/server 1.23.0 → 1.25.0

package/src/services/idCard.ts

@@ -0,0 +1,147 @@
+/**
+ * School admin ID card generation — bulk PDF for selected student members.
+ */
+import { TRPCError } from "@trpc/server";
+import { prisma } from "../lib/prisma.js";
+import {
+  buildIdCardsPdf,
+  DEFAULT_BRAND_COLOR,
+  type IdCardStudent,
+} from "../lib/idCardPdf.js";
+import { findActiveSchoolAdminMembership } from "../models/school.js";
+
+const MAX_STUDENTS = 100;
+
+async function requireSchoolAdmin(schoolId: string, userId: string) {
+  const membership = await findActiveSchoolAdminMembership(schoolId, userId);
+  if (!membership) {
+    throw new TRPCError({
+      code: "FORBIDDEN",
+      message: "Only school admins can generate ID cards",
+    });
+  }
+  return membership;
+}
+
+function formatClassLabel(cls: {
+  name: string;
+  section: string;
+  subject: string;
+}): string {
+  const parts = [cls.name, cls.section].filter(
+    (p) => p && p.trim().length > 0
+  );
+  if (parts.length === 0) return cls.subject || "—";
+  return parts.join(" · ");
+}
+
+export async function generateStudentIdCards(
+  userId: string,
+  input: { schoolId: string; studentUserIds: string[] }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+
+  const uniqueIds = [...new Set(input.studentUserIds)].slice(0, MAX_STUDENTS);
+  if (uniqueIds.length === 0) {
+    throw new TRPCError({
+      code: "BAD_REQUEST",
+      message: "Select at least one student",
+    });
+  }
+
+  const school = await prisma.school.findUnique({
+    where: { id: input.schoolId },
+    select: {
+      id: true,
+      name: true,
+      logo: { select: { path: true } },
+    },
+  });
+  if (!school) {
+    throw new TRPCError({ code: "NOT_FOUND", message: "School not found" });
+  }
+
+  const memberships = await prisma.schoolMembership.findMany({
+    where: {
+      schoolId: input.schoolId,
+      userId: { in: uniqueIds },
+      role: "STUDENT",
+      status: "ACTIVE",
+    },
+    select: {
+      user: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+            },
+          },
+          studentIn: {
+            where: { schoolId: input.schoolId },
+            select: {
+              name: true,
+              section: true,
+              subject: true,
+              color: true,
+              department: { select: { color: true } },
+            },
+            orderBy: { name: "asc" },
+            take: 1,
+          },
+        },
+      },
+    },
+  });
+
+  if (memberships.length === 0) {
+    throw new TRPCError({
+      code: "NOT_FOUND",
+      message: "No active student members found for the given IDs",
+    });
+  }
+
+  const byId = new Map(memberships.map((m) => [m.user.id, m.user]));
+  const students: IdCardStudent[] = [];
+  for (const id of uniqueIds) {
+    const user = byId.get(id);
+    if (!user) continue;
+    const primaryClass = user.studentIn[0] ?? null;
+    const brandColor =
+      primaryClass?.color ??
+      primaryClass?.department?.color ??
+      DEFAULT_BRAND_COLOR;
+
+    students.push({
+      displayName: user.profile?.displayName?.trim() || user.username,
+      username: user.username,
+      classLabel: primaryClass ? formatClassLabel(primaryClass) : null,
+      brandColor,
+      profilePictureUrl: user.profile?.profilePicture ?? null,
+    });
+  }
+
+  const pdfBytes = await buildIdCardsPdf(
+    {
+      name: school.name,
+      logoPath: school.logo?.path ?? null,
+    },
+    students
+  );
+
+  const dateStamp = new Date().toISOString().slice(0, 10);
+  const fileName =
+    students.length === 1
+      ? `id-card-${students[0].username}-${dateStamp}.pdf`
+      : `id-cards-${school.name.replace(/[^\w\-]+/g, "_").slice(0, 40)}-${dateStamp}.pdf`;
+
+  return {
+    pdfBase64: Buffer.from(pdfBytes).toString("base64"),
+    fileName,
+    mimeType: "application/pdf" as const,
+    studentCount: students.length,
+    skippedCount: uniqueIds.length - students.length,
+  };
+}