Merge branch 'main' of https://github.com/uwblueprint/website-bp-be into INTF25-review-status-mutator

Author: ericahan22

backend/typescript/graphql/resolvers/applicantRecordResolvers.ts

@@ -1,13 +1,41 @@
 import ApplicantRecordService from "../../services/implementations/applicantRecordService";
 import IApplicantRecordService from "../../services/interfaces/applicantRecordService";
-import { ApplicantRecordDTO } from "../../types";
+import { ApplicantRecordDTO, ApplicationStatus } from "../../types";
 import { getErrorMessage } from "../../utilities/errorUtils";
 
 const applicantRecordService: IApplicantRecordService =
   new ApplicantRecordService();
 
 const applicantRecordResolvers = {
   Mutation: {
+    updateApplicantStatus: async (
+      _parent: undefined,
+      {
+        applicantRecordId,
+        status,
+      }: { applicantRecordId: string; status: ApplicationStatus },
+    ): Promise<ApplicantRecordDTO> => {
+      const applicantRecord =
+        await applicantRecordService.updateApplicantStatus(
+          applicantRecordId,
+          status,
+        );
+      return applicantRecord;
+    },
+    bulkUpdateApplicantStatus: async (
+      _parent: undefined,
+      {
+        applicantRecordIds,
+        status,
+      }: { applicantRecordIds: string[]; status: ApplicationStatus },
+    ): Promise<ApplicantRecordDTO[]> => {
+      const applicantRecords =
+        await applicantRecordService.bulkUpdateApplicantStatus(
+          applicantRecordIds,
+          status,
+        );
+      return applicantRecords;
+    },
     setApplicantRecordFlag: async (
       _parent: undefined,
       {

backend/typescript/graphql/resolvers/reviewDashboardResolvers.ts

@@ -1,5 +1,8 @@
 import ReviewDashboardService from "../../services/implementations/reviewDashboardService";
-import { ReviewDashboardRowDTO } from "../../types";
+import {
+  ReviewDashboardRowDTO,
+  ReviewDashboardSidePanelDTO,
+} from "../../types";
 import { getErrorMessage } from "../../utilities/errorUtils";
 
 const reviewDashboardService = new ReviewDashboardService();
@@ -19,6 +22,18 @@ const reviewDashboardResolvers = {
         throw new Error(getErrorMessage(error));
       }
     },
+    reviewDashboardSidePanel: async (
+      _parent: undefined,
+      args: { applicantId: string },
+    ): Promise<ReviewDashboardSidePanelDTO> => {
+      try {
+        return await reviewDashboardService.getReviewDashboardSidePanel(
+          args.applicantId,
+        );
+      } catch (error) {
+        throw new Error(getErrorMessage(error));
+      }
+    },
   },
 };
 

backend/typescript/graphql/types/applicantRecordType.ts

@@ -1,19 +1,37 @@
 import { gql } from "apollo-server-express";
 
 const applicantRecordType = gql`
+  enum ApplicationStatus {
+    Applied
+    InReview
+    Reviewed
+    Selected
+    Interviewed
+    Offer
+    Rejected
+  }
+
   type ApplicantRecordDTO {
     id: String!
     applicantId: String!
     position: String!
     roleSpecificQuestions: [String!]!
     choice: Int!
-    status: String!
+    status: ApplicationStatus!
     skillCategory: String
     combined_score: Int
     isApplicantFlagged: Boolean!
   }
 
   extend type Mutation {
+    updateApplicantStatus(
+      applicantRecordId: String!
+      status: ApplicationStatus!
+    ): ApplicantRecordDTO!
+    bulkUpdateApplicantStatus(
+      applicantRecordIds: [String!]!
+      status: ApplicationStatus!
+    ): [ApplicantRecordDTO!]!
     setApplicantRecordFlag(
       applicantRecordId: String!
       flagValue: Boolean!

backend/typescript/graphql/types/reviewDashboardType.ts

@@ -17,11 +17,30 @@ const reviewDashboardType = gql`
     totalScore: Int
   }
 
+  type ReviewDetails {
+    reviewerFirstName: String!
+    reviewerLastName: String!
+    review: Review!
+  }
+
+  type ReviewDashboardSidePanelDTO {
+    firstName: String!
+    lastName: String!
+    positionTitle: String!
+    program: String!
+    resumeUrl: String!
+    applicationStatus: String!
+    skillCategory: String
+    reviewDetails: [ReviewDetails!]!
+  }
+
   extend type Query {
     reviewDashboard(
       pageNumber: Int!
       resultsPerPage: Int!
     ): [ReviewDashboardRowDTO!]!
+
+    reviewDashboardSidePanel(applicantId: String!): ReviewDashboardSidePanelDTO!
   }
 `;
 

backend/typescript/graphql/types/reviewPageType.ts

@@ -2,7 +2,7 @@ import { gql } from "apollo-server-express";
 
 const reviewPageType = gql`
   type ApplicationDTO {
-    id: Int!
+    id: String!
     academicOrCoop: String!
     academicYear: String!
     email: String!

backend/typescript/graphql/types/reviewedApplicantRecordTypes.ts

@@ -20,6 +20,7 @@ const reviewedApplicantRecordTypes = gql`
     desireToLearn: Int
     skill: Int
     skillCategory: SkillCategory
+    comments: String
   }
 
   input ReviewInput {

backend/typescript/models/applicant.model.ts

@@ -7,12 +7,11 @@ import ApplicantRecord from "./applicantRecord.model";
 @Table({ tableName: "applicants" })
 export default class Applicant extends Model {
   @Column({
-    type: DataType.INTEGER,
+    type: DataType.UUIDV4,
     primaryKey: true,
     unique: true,
-    autoIncrement: true,
   })
-  id!: number;
+  id!: string;
 
   @Column({ type: DataType.STRING })
   academicOrCoop!: string;

backend/typescript/models/applicantRecord.model.ts

@@ -30,8 +30,8 @@ export default class ApplicantRecord extends Model {
   id!: string;
 
   @ForeignKey(() => Applicant)
-  @Column({ type: DataType.INTEGER })
-  applicantId!: number;
+  @Column({ type: DataType.UUIDV4 })
+  applicantId!: string;
 
   @ForeignKey(() => Position)
   @Column({ type: DataType.STRING })

backend/typescript/services/implementations/applicantRecordService.ts

@@ -1,37 +1,98 @@
-import { ApplicantRecordDTO, PositionTitle } from "../../types";
+import {
+  ApplicantRecordDTO,
+  PositionTitle,
+  ApplicationStatus,
+} from "../../types";
 import { getErrorMessage } from "../../utilities/errorUtils";
 import logger from "../../utilities/logger";
 import ApplicantRecord from "../../models/applicantRecord.model";
 import IApplicantRecordService from "../interfaces/applicantRecordService";
+import { sequelize } from "../../models";
 
 const Logger = logger(__filename);
 
+function toDTO(applicantRecord: ApplicantRecord): ApplicantRecordDTO {
+  return {
+    id: String(applicantRecord.id),
+    applicantId: String(applicantRecord.applicantId),
+    position: applicantRecord.position as PositionTitle,
+    roleSpecificQuestions: applicantRecord.roleSpecificQuestions,
+    choice: applicantRecord.choice,
+    status: applicantRecord.status,
+    skillCategory: applicantRecord.skillCategory,
+    combined_score: applicantRecord.combined_score,
+    isApplicantFlagged: applicantRecord.isApplicantFlagged,
+  };
+}
+
+export const getApplicantRecord = async (
+  applicantRecordId: string,
+): Promise<ApplicantRecord> => {
+  const applicantRecord = await ApplicantRecord.findByPk(applicantRecordId);
+  if (!applicantRecord) {
+    throw new Error(`ApplicantRecord with id ${applicantRecordId} not found.`);
+  }
+  return applicantRecord;
+};
+
 class ApplicantRecordService implements IApplicantRecordService {
   /* eslint-disable class-methods-use-this */
+
+  async updateApplicantStatus(
+    applicantRecordId: string,
+    status: ApplicationStatus,
+  ): Promise<ApplicantRecordDTO> {
+    try {
+      const applicantRecord = await getApplicantRecord(applicantRecordId);
+      applicantRecord.status = status;
+      await applicantRecord.save();
+      return toDTO(applicantRecord);
+    } catch (error: unknown) {
+      Logger.error(
+        `Failed to update applicant record status. Reason = ${getErrorMessage(
+          error,
+        )}`,
+      );
+      throw error;
+    }
+  }
+
+  async bulkUpdateApplicantStatus(
+    applicantRecordIds: string[],
+    status: ApplicationStatus,
+  ): Promise<ApplicantRecordDTO[]> {
+    const transaction = await sequelize.transaction();
+    try {
+      const updatedRecords = await Promise.all(
+        applicantRecordIds.map(async (id) => {
+          const applicantRecord = await getApplicantRecord(id);
+          applicantRecord.status = status;
+          await applicantRecord.save({ transaction });
+          return toDTO(applicantRecord);
+        }),
+      );
+      await transaction.commit();
+      return updatedRecords;
+    } catch (error: unknown) {
+      await transaction.rollback();
+      Logger.error(
+        `Failed to update applicant record statuses. Reason = ${getErrorMessage(
+          error,
+        )}`,
+      );
+      throw error;
+    }
+  }
+
   async setApplicantRecordFlag(
     applicantRecordId: string,
     flagValue: boolean,
   ): Promise<ApplicantRecordDTO> {
     try {
-      const applicantRecord = await ApplicantRecord.findByPk(applicantRecordId);
-      if (!applicantRecord) {
-        throw new Error(
-          `ApplicantRecord with id ${applicantRecordId} not found.`,
-        );
-      }
+      const applicantRecord = await getApplicantRecord(applicantRecordId);
       applicantRecord.isApplicantFlagged = flagValue;
       await applicantRecord.save();
-      return {
-        id: String(applicantRecord.id),
-        applicantId: String(applicantRecord.applicantId),
-        position: applicantRecord.position as PositionTitle,
-        roleSpecificQuestions: applicantRecord.roleSpecificQuestions,
-        choice: applicantRecord.choice,
-        status: applicantRecord.status,
-        skillCategory: applicantRecord.skillCategory,
-        combined_score: applicantRecord.combined_score,
-        isApplicantFlagged: applicantRecord.isApplicantFlagged,
-      };
+      return toDTO(applicantRecord);
     } catch (error: unknown) {
       Logger.error(
         `Failed to set applicant record flag. Reason = ${getErrorMessage(

backend/typescript/services/implementations/reviewDashboardService.ts

@@ -1,4 +1,8 @@
-import { ReviewDashboardRowDTO } from "../../types";
+import {
+  PositionTitle,
+  ReviewDashboardRowDTO,
+  ReviewDashboardSidePanelDTO,
+} from "../../types";
 import IReviewDashboardService from "../interfaces/IReviewDashboardService";
 import { getErrorMessage } from "../../utilities/errorUtils";
 import logger from "../../utilities/logger";
@@ -22,6 +26,26 @@ function toDTO(model: ApplicantRecord): ReviewDashboardRowDTO {
   };
 }
 
+function toSidePanelDTO(model: ApplicantRecord): ReviewDashboardSidePanelDTO {
+  const reviewDetails =
+    model.reviewedApplicantRecords?.map((reviewRecord) => ({
+      reviewerFirstName: reviewRecord.user?.first_name || "",
+      reviewerLastName: reviewRecord.user?.last_name || "",
+      review: reviewRecord.review,
+    })) || [];
+
+  return {
+    firstName: model.applicant!.firstName,
+    lastName: model.applicant!.lastName,
+    positionTitle: model.position as PositionTitle,
+    program: model.applicant!.program,
+    resumeUrl: model.applicant!.resumeUrl,
+    applicationStatus: model.status,
+    skillCategory: model.skillCategory,
+    reviewDetails,
+  };
+}
+
 class ReviewDashboardService implements IReviewDashboardService {
   /* eslint-disable class-methods-use-this */
   async getReviewDashboard(
@@ -72,6 +96,47 @@ class ReviewDashboardService implements IReviewDashboardService {
       throw error;
     }
   }
+
+  async getReviewDashboardSidePanel(
+    applicantId: string,
+  ): Promise<ReviewDashboardSidePanelDTO> {
+    try {
+      const applicantRecord: ApplicantRecord | null =
+        await ApplicantRecord.findOne({
+          where: { applicantId },
+          attributes: { exclude: ["createdAt", "updatedAt"] },
+          include: [
+            {
+              attributes: { exclude: ["createdAt", "updatedAt"] },
+              association: "reviewedApplicantRecords",
+              include: [
+                {
+                  attributes: { exclude: ["createdAt", "updatedAt"] },
+                  association: "user",
+                },
+              ],
+            },
+            {
+              attributes: { exclude: ["createdAt", "updatedAt"] },
+              association: "applicant",
+            },
+          ],
+        });
+
+      if (!applicantRecord || !applicantRecord.applicant) {
+        throw new Error(`Applicant with ID ${applicantId} not found`);
+      }
+
+      return toSidePanelDTO(applicantRecord);
+    } catch (error: unknown) {
+      Logger.error(
+        `Failed to get review dashboard side panel for applicant ${applicantId}. Reason = ${getErrorMessage(
+          error,
+        )}`,
+      );
+      throw error;
+    }
+  }
 }
 
 export default ReviewDashboardService;