feat(tatakforms): implement dynamic tatakform pdf generation

Author: mavyfaby

assets/tatakform/colleges/cas.png

@@ -17,6 +17,7 @@
     "mariadb": "^3.3.0",
     "nodemailer": "^6.9.13",
     "p-queue": "^8.0.1",
+    "pdf-lib": "^1.17.1",
     "pug": "^3.0.2",
     "xlsx-template": "^1.4.4"
   },

assets/tatakform/colleges/cba.png

@@ -5,8 +5,9 @@ import { status501 } from "../../routes";
 import TatakFormStudent from "../../db/models/tatakform/student";
 import response from "../../utils/response";
 import Strings from "../../config/strings";
-import Attendance from "../../db/models/tatakform/attendance";
+import TatakFormAttendance from "../../db/models/tatakform/attendance";
 import Tatakform from "../../db/models/tatakform";
+import { setHeader } from "../../utils/security";
 
 /**
  * Tatakform Attendance API
@@ -42,7 +43,7 @@ async function postAttendance(context: ElysiaContext) {
       const student = await TatakFormStudent.getByStudentId(context.body.student_id);
 
       if (tatak_event) {
-        await Attendance.attendStudent(context.body.student_id, tatak_event);
+        await TatakFormAttendance.attendStudent(context.body.student_id, tatak_event);
       }
 
       return response.success("Attended successfully", { student_id: context.body.student_id });
@@ -70,8 +71,9 @@ async function postAttendance(context: ElysiaContext) {
  * 
  * GET /tatakforms/attendance/:slug
  * Fetches the attedance history of a student in an event
- * @param context
  * 
+ * GET /tatakforms/attendance/:slug/download
+ * Download tatakform attendance
  */
 async function getAttendance(context: ElysiaContext) {
   try {
@@ -80,17 +82,29 @@ async function getAttendance(context: ElysiaContext) {
 
     // If slug is specified
     if (slug) {
+      // If path ends with "download"
+      if (context.path.endsWith("download")) {
+        // Generate PDF
+        const image = await Tatakform.generatePDF(context.user?.student_id, slug);
+        // Set content disposition
+        setHeader(context, 'Content-Disposition', `attachment; filename="${image.name}"`);
+        // Set response content type
+        setHeader(context, 'Content-Type', 'application/pdf');
+        // Return image
+        return image;
+      }
+
       // Get event by slug
       const tatakform = await Tatakform.getBySlug(slug);
       // Get attendance history by event
-      const attendance = await Attendance.getAttendanceByEvent(context.user?.student_id, tatakform.id);
+      const attendance = await TatakFormAttendance.getAttendanceByEvent(context.user?.student_id, tatakform.id);
 
       // Return response
       return response.success("Fetch Successful", attendance);
     }
 
     // Otherwise, get all attendance history
-    const history = await Attendance.getAttendance(context.user?.student_id);
+    const history = await TatakFormAttendance.getAttendance(context.user?.student_id);
     return response.success("Fetch Successful", history);
   }
 
@@ -123,7 +137,7 @@ async function getAllStudentsAttended(context: ElysiaContext) {
     // If event id is specified
     if (eventId) {
       // Get all students attended by event and college
-      const attendance = await Attendance.getStudentsAttendedByEventAndCollege(eventId, context.user.college_id);
+      const attendance = await TatakFormAttendance.getStudentsAttendedByEventAndCollege(eventId, context.user.college_id);
       return response.success("Success", attendance)
     }
   }

assets/tatakform/colleges/cca.png

@@ -86,6 +86,49 @@ class College {
       }
     });
   }
+
+  /**
+   * Get college by acronym
+   * @param acronym 
+   */
+  public static getByCourseId(courseId: number): Promise<CollegeModel> {
+    return new Promise(async (resolve, reject) => {
+      // Get database instance
+      const db = Database.getInstance();
+
+      try {
+        
+        // Get course
+        const courses = await db.query<CourseModel[]>(`SELECT * FROM colleges_courses WHERE id = ? LIMIT 1`, [ courseId ]);
+
+        // If no results
+        if (courses.length === 0) {
+          return reject(`Course with id #${courseId} not found`);
+        }
+
+        // Set the courses to the college
+        const college = await db.query<CollegeModel[]>(`SELECT * FROM colleges WHERE id = ? LIMIT 1`, [courses[0].college_id]);
+
+        // If no results
+        if (college.length === 0) {
+          Log.e(`College with course id #${courseId} not found`);
+          return reject(`College with course id #${courseId} not found`);
+        }
+
+        // Set the courses to the college
+        college[0].courses = courses;
+
+        // Return the college
+        resolve(college[0]);
+      }
+      
+      // Log error and reject promise
+      catch (e) {
+        Log.e(e);
+        reject(ErrorTypes.DB_ERROR);
+      }
+    });
+  }
 }
 
 export default College;

assets/tatakform/colleges/ccj.png

@@ -1,7 +1,13 @@
 import { ErrorTypes } from "../../types/enums";
 import { TatakformModel } from "../../types/models";
+import { PDFDocument, StandardFonts } from 'pdf-lib';
+import { getReadableDate } from "../../utils/date";
+import { join } from "path";
 
+import TatakFormAttendance from "./tatakform/attendance";
+import TatakFormStudent from "./tatakform/student";
 import Log from "../../utils/log";
+import College from "../../db/models/college";
 import Database from "../";
 
 /**
@@ -72,6 +78,149 @@ class Tatakform {
       }
     });
   }
+
+  /**
+   * Generate PDF file
+   */
+  public static generatePDF(studentId: string, slug: string): Promise<File> {
+    return new Promise(async (resolve, reject) => {
+      // Get event by slug
+      const tatakform = await Tatakform.getBySlug(slug);
+      // Get student
+      const student = await TatakFormStudent.getByStudentId(studentId);
+      // Get attendance history by event
+      const attendance = await TatakFormAttendance.getAttendanceByEvent(studentId, tatakform.id);
+      // Get college
+      const college = await College.getByCourseId(student.course_id);
+
+      try {
+        // Get tatakform template pdf file
+        const template = Bun.file(join(Bun.main, `../../assets/tatakform/${slug}.pdf`));
+        // Get logo file
+        const logoFile = Bun.file(join(Bun.main, `../../assets/tatakform/colleges/${college.acronym.toLowerCase()}.png`));
+        // Load pdf
+        const pdf = await PDFDocument.load(await template.arrayBuffer(), { updateMetadata: false });
+        // Load logo
+        const logo = await pdf.embedPng(await logoFile.arrayBuffer());
+        // Font
+        const font = await pdf.embedFont(StandardFonts.Courier);
+        // Get first page
+        const page = pdf.getPages()[0];
+
+        // Set metadata
+        pdf.setTitle(`Tatakform - ${college.acronym} - ${student.first_name} ${student.last_name} - ${studentId}`);
+        pdf.setAuthor("UC Main CSP-S");
+        pdf.setCreationDate(new Date());
+        pdf.setModificationDate(new Date());
+        pdf.setSubject(slug);
+
+        // Full name
+        page.drawText(`${student.first_name} ${student.last_name}`, {
+          x: 205, y: page.getHeight() - 365, size: 28, font
+        });
+
+        // Course and year
+        page.drawText(`${college.courses?.[0].acronym} - ${student.year_level}`, {
+          x: 1420, y: page.getHeight() - 365, size: 28, font
+        });
+        
+        // Date
+        page.drawText(getReadableDate(new Date()), {
+          x: 205, y: page.getHeight() - 416, size: 28, font
+        });
+
+        // Department
+        page.drawText(college.name, {
+          x: 1305, y: page.getHeight() - 416, size: 28, font
+        });
+
+        // Note
+        page.drawText("This tatakform was generated at https://ucmncsps.org/tatakforms", {
+          x: 170, y: 80, size: 20, font
+        });
+
+        // TODO: Make this more dynamic
+        if (attendance !== null) {
+          // Day 1 AM
+          if (attendance.day1_am) {
+            page.drawImage(logo, {
+              x: 250,
+              y: page.getHeight() - 790,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+
+          // Day 1 PM
+          if (attendance.day1_pm) {
+            page.drawImage(logo, {
+              x: 250,
+              y: page.getHeight() - 1090,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+
+          // Day 2 AM
+          if (attendance.day2_am) {
+            page.drawImage(logo, {
+              x: 875,
+              y: page.getHeight() - 790,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+
+          // Day 2 PM
+          if (attendance.day2_pm) {
+            page.drawImage(logo, {
+              x: 875,
+              y: page.getHeight() - 1090,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+
+          // Day 3 AM
+          if (attendance.day3_am) {
+            page.drawImage(logo, {
+              x: 1525,
+              y: page.getHeight() - 790,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+          
+          // Day 3 PM
+          if (attendance.day3_pm) {
+            page.drawImage(logo, {
+              x: 1525,
+              y: page.getHeight() - 1090,
+              width: 250, 
+              height: 250,
+              opacity: 0.7
+            });
+          }
+        }
+
+        // Save pdf
+        const buffer = await pdf.save();
+        // Resolve promise
+        resolve(new File([buffer], `tatakform_${college.acronym.toLowerCase()}_${studentId}.pdf`, { type: "application/pdf" }));
+      }
+      
+      // Log error
+      catch (error) {
+        Log.e(error);
+        reject(error);
+      }
+    });
+  }
 }
 
 export default Tatakform;

assets/tatakform/colleges/ccs.png

@@ -105,7 +105,7 @@ class TatakFormAttendance {
   /**
    * Get attendance history of student
    */
-  public static getAttendanceByEvent(studentId: string, eventId: number) {
+  public static getAttendanceByEvent(studentId: string, eventId: number): Promise<AttendanceModel | null> {
     return new Promise(async (resolve, reject) => {
       // Get database instance
       const db = Database.getInstance();

assets/tatakform/colleges/chm.png

@@ -39,9 +39,10 @@ const routes: AppRoutes[] = [
   { path: "/tatakforms/admin/login", methods: ["POST", "OPTIONS"], handler: tatakformAdminLogin },
   { path: "/tatakforms/:slug", methods: ["GET"], handler: tatakforms },
   { path: "/tatakforms", methods: ["GET"], handler: tatakforms },
-  { path: "/tatakforms/attendance/:slug" , methods: ['POST','GET'], handler: tatakformAttendance, auth: {POST: AuthType.COLLEGE_ADMIN} },
   { path: "/tatakforms/attendance/" , methods: ['GET'], handler: tatakformAttendance, auth: {GET: AuthType.UNIV_ACCOUNT} },
   { path: "/tatakforms/attendance/event/:eventId" , methods: ['GET'], handler: tatakformAttendance, auth: {GET: AuthType.COLLEGE_ADMIN}},
+  { path: "/tatakforms/attendance/:slug" , methods: ['POST','GET'], handler: tatakformAttendance, auth: {POST: AuthType.COLLEGE_ADMIN} },
+  { path: "/tatakforms/attendance/:slug/download" , methods: ['GET'], handler: tatakformAttendance, auth: {GET: AuthType.UNIV_ACCOUNT} },
 
   { path: "/announcements/:id", methods: ["PUT", "DELETE", "OPTIONS"], handler: announcements, auth: { PUT: AuthType.ADMIN, DELETE: AuthType.ADMIN }},
   { path: "/announcements", methods: ["GET","POST"], handler: announcements, auth: { POST: AuthType.ADMIN }},

assets/tatakform/colleges/coe.png

@@ -156,10 +156,10 @@ export type StudentModel = {
 export type UnivStudentModel = {
   id: number,
   student_id: string,
-  course_id: string,
+  course_id: number,
   last_name: string,
   first_name: string,
-  year_level: string,
+  year_level: number,
   email_address: string,
   password?: string,
   date_stamp: string,