setup and pseudocode

Author: ruiichen

backend/typescript/graphql/resolvers/reviewDashboardResolvers.ts

@@ -1,5 +1,5 @@
 import ReviewDashboardService from "../../services/implementations/reviewDashboardService";
-import { ReviewDashboardRowDTO } from "../../types";
+import { ReviewDashboardRowDTO, ReviewedApplicantRecordDTO } from "../../types";
 import { getErrorMessage } from "../../utilities/errorUtils";
 
 const reviewDashboardService = new ReviewDashboardService();
@@ -20,6 +20,15 @@ const reviewDashboardResolvers = {
       }
     },
   },
+  Mutation: {
+    delegateReviewers: async (): Promise<ReviewedApplicantRecordDTO[]> => {
+      try {
+        return await reviewDashboardService.delegateReviewers();
+      } catch (error) {
+        throw new Error(getErrorMessage(error));
+      }
+    },
+  },
 };
 
 export default reviewDashboardResolvers;

backend/typescript/graphql/types/reviewDashboardType.ts

@@ -1,5 +1,12 @@
 import { gql } from "apollo-server-express";
-import { ApplicationStatus, PositionTitle, ReviewerDTO } from "../../types";
+import {
+  ApplicationStatus,
+  PositionTitle,
+  Review,
+  ReviewerDTO,
+  ReviewStatus,
+  SkillCategory,
+} from "../../types";
 
 const reviewDashboardType = gql`
   type ReviewerDTO {
@@ -18,12 +25,33 @@ const reviewDashboardType = gql`
     totalScore: Int
   }
 
+  type Review {
+    passionFSG: Int
+    teamPlayer: Int
+    desireToLearn: Int
+    skill: Int
+    skillCategory: String
+  }
+
+  type ReviewedApplicantRecordDTO {
+    applicantRecordId: String!
+    reviewerId: Int!
+    review: Review
+    status: String!
+    score: Int
+    reviewerHasConflict: Boolean!
+  }
+
   extend type Query {
     reviewDashboard(
       pageNumber: Int!
       resultsPerPage: Int!
     ): [ReviewDashboardRowDTO!]!
   }
+
+  extend type Mutation {
+    delegateReviewers: [ReviewedApplicantRecordDTO!]!
+  }
 `;
 
 export default reviewDashboardType;

backend/typescript/services/implementations/reviewDashboardService.ts

@@ -1,4 +1,8 @@
-import { PositionTitle, ReviewDashboardRowDTO } from "../../types";
+import {
+  PositionTitle,
+  ReviewDashboardRowDTO,
+  ReviewedApplicantRecordDTO,
+} from "../../types";
 import IReviewDashboardService from "../interfaces/IReviewDashboardService";
 import { getErrorMessage } from "../../utilities/errorUtils";
 import logger from "../../utilities/logger";
@@ -72,6 +76,47 @@ class ReviewDashboardService implements IReviewDashboardService {
       throw error;
     }
   }
+
+  async delegateReviewers(): Promise<ReviewedApplicantRecordDTO[]> {
+    // NOTE: We do not have to concern ourselves with locality. That is, each user can be
+    //       assigned to the same parter every time.
+
+    const FSM = new Map<string, [number, string[]]>();
+    // maps (position title) => (current index of list, list of users with position_title)
+    const delegations = new Map<string, [string, string]>();
+    // maps (applicant_record_id) => pair of user_ids assigned to it
+
+    // STEP 1:
+    //   Populate the FSM
+    //   NOTE: need to add a sentinel value at the end of the list if the number of user is odd.
+    //         The last 'real' user will bear the burden of solo reviewing.
+
+    // STEP 2:
+    //   Round robin with the FSM
+    /*
+    for (auto& a : applicant_records) {
+      pair<int,vector<string>>& position_entry = FSM[a.position];
+
+      // get first user
+      string id1 = position_entry.second[position_entry.first];
+      position_entry.first++;
+      position_entry.first %= position_entry.second.size();
+
+      // get second user
+      string id2 = position_entry.second[position_entry.first];
+      position_entry.first++;
+      position_entry.first %= position_entry.second.size();
+
+      delegations[a.id] = make_pair(id1, id2);
+    }
+     */
+
+    // STEP 3:
+    //   Batch the delegations into ReviewedApplicantRecords
+    //   NOTE: do not add the sentinel value we inserted earlier.
+
+    return [];
+  }
 }
 
 export default ReviewDashboardService;

backend/typescript/services/interfaces/IReviewDashboardService.ts

@@ -1,4 +1,4 @@
-import { ReviewDashboardRowDTO } from "../../types";
+import { ReviewDashboardRowDTO, ReviewedApplicantRecordDTO } from "../../types";
 
 interface IReviewDashboardService {
   /**
@@ -10,6 +10,12 @@ interface IReviewDashboardService {
     page: number,
     resultsPerPage: number,
   ): Promise<ReviewDashboardRowDTO[]>;
+
+  /**
+   * Assigns each user to an applicant record to review, and
+   * returns the newly created ReviewedApplicantRecords
+   */
+  delegateReviewers(): Promise<ReviewedApplicantRecordDTO[]>;
 }
 
 export default IReviewDashboardService;