Judging system updates

* Change the max to 5 judges per team.
* Let us know the number of needed rounds.

Author: uellenberg

src/app/dashboard/judging/JudgingAdminClient.tsx

@@ -11,6 +11,7 @@ export default function JudgingAdminClient() {
     const [tableCount, setTableCount] = useState(0);
     const [judgeCount, setJudgeCount] = useState(0);
     const [collisionCount, setCollisionCount] = useState(0);
+    const [neededRounds, setNeededRounds] = useState(0);
     const [warnings, setWarnings] = useState<string[]>([]);
     const [errorMessage, setErrorMessage] = useState<string | null>(null);
 
@@ -26,6 +27,7 @@ export default function JudgingAdminClient() {
             setTableCount(result.tableAssignmentsCount ?? 0);
             setJudgeCount(result.judgeAssignmentsCount ?? 0);
             setCollisionCount(result.collisionCount ?? 0);
+            setNeededRounds(result.neededRounds ?? 0);
             setWarnings(result.warnings || []);
         } else {
             setStatus("error");
@@ -73,6 +75,9 @@ export default function JudgingAdminClient() {
                                 ✅ No round collisions.
                             </p>
                         )}
+                        <p className="text-green-600 font-bold mt-2">
+                            ✅ {neededRounds} round(s) needed.
+                        </p>
 
                         {warnings.length > 0 && (
                             <div className="mt-4 p-4 bg-orange-50 border-2 border-orange-200 rounded-md text-left">

src/util/actions/judge.ts

@@ -93,6 +93,11 @@ export interface AutoAssignResult {
      */
     collisionCount?: number;
 
+    /**
+     * The number of rounds needed for everyone to get judged.
+     */
+    neededRounds?: number;
+
     /**
      * Non-fatal warnings collected across all three phases.
      */
@@ -210,6 +215,7 @@ export async function actionAssignJudges(): Promise<AutoAssignResult> {
             tableAssignmentsCount: tableResult.placements.length,
             judgeAssignmentsCount: judgeResult.newAssignments.length,
             collisionCount: collisions.length,
+            neededRounds: judgeResult.neededRounds,
             warnings,
         };
     } catch (error) {

src/util/judging/judgeAssignment.ts

@@ -4,7 +4,7 @@ import { JudgeAssignment, Project, Track } from "@/src/util/dataTypes";
 /**
  * The number of judges that should score each (project, track) pair.
  */
-export const JUDGES_PER_TRACK = 2;
+export const JUDGES_PER_TRACK = 5;
 
 /**
  * The minimum count of judges simultaneously scheduled at the same
@@ -59,6 +59,13 @@ export interface JudgeAssignmentResult {
      */
     newAssignments: AssignJudgeAssignment[];
 
+    /**
+     * The number of rounds needed to handle judging.
+     * This is the maximum of the number of projects assigned
+     * to a single judge.
+     */
+    neededRounds: number;
+
     /**
      * Non-fatal issues (unknown track tags, empty tags, insufficient
      * judges for a track, etc.). Shown to the admin after the run.
@@ -100,6 +107,7 @@ export function computeJudgeAssignments(
     const trackMap = new Map(tracks.map((t) => [t.devpostTag, t]));
     const projectMap = new Map(projects.map((p) => [p.id, p]));
 
+    // Judge ID -> # of assigned projects.
     const judgeWorkload = new Map<number, number>();
     for (const j of judges) judgeWorkload.set(j.id, 0);
     for (const a of existing) {
@@ -245,7 +253,9 @@ export function computeJudgeAssignments(
         }
     }
 
-    return { newAssignments, warnings };
+    const neededRounds = Math.max(...judgeWorkload.values());
+
+    return { newAssignments, neededRounds, warnings };
 }
 
 /**