setup and pseudocode

# Conflicts:
#	backend/typescript/graphql/resolvers/reviewDashboardResolvers.ts
#	backend/typescript/services/implementations/reviewDashboardService.ts
#	backend/typescript/services/interfaces/IReviewDashboardService.ts

Author: ruiichen

backend/typescript/graphql/resolvers/reviewDashboardResolvers.ts

@@ -2,6 +2,7 @@ import ReviewDashboardService from "../../services/implementations/reviewDashboa
 import {
   ReviewDashboardRowDTO,
   ReviewDashboardSidePanelDTO,
+  ReviewedApplicantRecordDTO,
 } from "../../types";
 import { getErrorMessage } from "../../utilities/errorUtils";
 
@@ -35,6 +36,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,4 +1,12 @@
 import { gql } from "apollo-server-express";
+import {
+  ApplicationStatus,
+  PositionTitle,
+  Review,
+  ReviewerDTO,
+  ReviewStatus,
+  SkillCategory,
+} from "../../types";
 
 const reviewDashboardType = gql`
   type ReviewerDTO {
@@ -16,6 +24,15 @@ const reviewDashboardType = gql`
     reviewers: [ReviewerDTO!]!
     totalScore: Int
   }
+  
+  type ReviewedApplicantRecordDTO {
+    applicantRecordId: String!
+    reviewerId: Int!
+    review: Review
+    status: String!
+    score: Int
+    reviewerHasConflict: Boolean!
+  }
 
   type Review {
     passionFSG: Int
@@ -51,6 +68,10 @@ const reviewDashboardType = gql`
 
     reviewDashboardSidePanel(applicantId: String!): ReviewDashboardSidePanelDTO!
   }
+
+  extend type Mutation {
+    delegateReviewers: [ReviewedApplicantRecordDTO!]!
+  }
 `;
 
 export default reviewDashboardType;

backend/typescript/services/implementations/reviewDashboardService.ts

@@ -1,6 +1,7 @@
 import {
   PositionTitle,
   ReviewDashboardRowDTO,
+  ReviewedApplicantRecordDTO,
   ReviewDashboardSidePanelDTO,
 } from "../../types";
 import IReviewDashboardService from "../interfaces/IReviewDashboardService";
@@ -137,6 +138,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,6 +1,7 @@
 import {
   ReviewDashboardRowDTO,
   ReviewDashboardSidePanelDTO,
+  ReviewedApplicantRecordDTO,
 } from "../../types";
 
 interface IReviewDashboardService {
@@ -14,6 +15,12 @@ interface IReviewDashboardService {
     resultsPerPage: number,
   ): Promise<ReviewDashboardRowDTO[]>;
 
+  /**
+   * Assigns each user to an applicant record to review, and
+   * returns the newly created ReviewedApplicantRecords
+   */
+  delegateReviewers(): Promise<ReviewedApplicantRecordDTO[]>;
+
   /**
    * Fetch data that can fill out the review dashboard side panel for an applicant
    * @Param applicantId the ID of the applicant