Merge pull request #81 from uwblueprint/INTF25-applicant-record-review-query

[INTF25] Adds applicant record and reviews query

Author: gavxue

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/reviewDashboardType.ts

@@ -17,11 +17,39 @@ const reviewDashboardType = gql`
     totalScore: Int
   }
 
+  type Review {
+    passionFSG: Int
+    teamPlayer: Int
+    desireToLearn: Int
+    skill: Int
+    skillCategory: String
+    comments: String
+  }
+
+  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/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;

backend/typescript/services/interfaces/IReviewDashboardService.ts

@@ -1,4 +1,7 @@
-import { ReviewDashboardRowDTO } from "../../types";
+import {
+  ReviewDashboardRowDTO,
+  ReviewDashboardSidePanelDTO,
+} from "../../types";
 
 interface IReviewDashboardService {
   /**
@@ -10,6 +13,14 @@ interface IReviewDashboardService {
     page: number,
     resultsPerPage: number,
   ): Promise<ReviewDashboardRowDTO[]>;
+
+  /**
+   * Fetch data that can fill out the review dashboard side panel for an applicant
+   * @Param applicantId the ID of the applicant
+   */
+  getReviewDashboardSidePanel(
+    applicantId: string,
+  ): Promise<ReviewDashboardSidePanelDTO>;
 }
 
 export default IReviewDashboardService;

backend/typescript/types.ts

@@ -198,6 +198,7 @@ export type Review = {
   desireToLearn?: number;
   skill?: number;
   skillCategory?: SkillCategory;
+  comments?: string;
 };
 
 export type ReviewedApplicantRecordDTO = {
@@ -221,6 +222,23 @@ export type DeleteReviewedApplicantRecordDTO = {
   reviewerId: number;
 };
 
+export type ReviewDetails = {
+  reviewerFirstName: string;
+  reviewerLastName: string;
+  review: Review;
+};
+
+export type ReviewDashboardSidePanelDTO = {
+  firstName: string;
+  lastName: string;
+  positionTitle: PositionTitle;
+  program: string;
+  resumeUrl: string;
+  applicationStatus: ApplicationStatus;
+  skillCategory: SkillCategory | null;
+  reviewDetails: ReviewDetails[];
+};
+
 export type AdminCommentDTO = {
   id: string;
   userId: number;