Add student name formatting utilities and refactor team student name handling

This commit introduces two new utility classes: StudentNameFormatter and TeamStudentNameFormatter, which provide methods for formatting student names with options for indicating absence and overlaps. The Team class has been updated to remove the StudentsFirstNames property, and various components across the WebApp have been refactored to utilize the new formatting utilities. This enhances the maintainability and readability of the code while improving the presentation of student names in the UI.

WebApp/Components/Features/MeetingSchedule/Index.razor

@@ -4,6 +4,7 @@
 @using Core.Calculation
 @using Microsoft.EntityFrameworkCore
 @using WebApp.Components.Shared.Components
+@using Core.Utility
 @inject IConfiguration Configuration
 @inject AppDbContext Context
 @inject ClipboardService ClipboardService
@@ -380,21 +381,44 @@
 
     private string FormatStudentList(Team team, TeamScheduleTimeSlot timeslot)
     {
-        return string.Join(", ",
-            team.Students
-                .OrderBy(e => e == team.Captain)
-                .ThenBy(e => e.FirstName)
-                .Select(e => FormatStudentName(e, timeslot)));
+        return TeamStudentNameFormatter.FormatStudentList(
+            team,
+            new TeamStudentNameFormatter.FormatOptions
+            {
+                Ordering = TeamStudentNameFormatter.OrderingStyle.CaptainFirst,
+                MarkOverlaps = true,
+                HasOverlaps = timeslot.StudentHasOverlaps,
+                MarkAbsent = true,
+                AbsentStudents = _absentStudents.ToList()
+            });
     }
 
     private string FormatStudentName(Student student, TeamScheduleTimeSlot timeslot)
     {
-        var name = student.FirstName;
-        if (timeslot.StudentHasOverlaps(student))
-            name += "*";
-        if (_absentStudents.Contains(student))
-            name += " (absent)";
-        return name;
+        // Find the team this student belongs to for formatting context
+        var team = _teams.FirstOrDefault(t => t.Students.Contains(student));
+        if (team == null)
+        {
+            // No team context, use StudentNameFormatter directly
+            return StudentNameFormatter.FormatStudentName(
+                student,
+                new StudentNameFormatter.FormatOptions
+                {
+                    HasOverlap = timeslot.StudentHasOverlaps(student),
+                    IsAbsent = _absentStudents.Contains(student)
+                });
+        }
+
+        return TeamStudentNameFormatter.FormatStudentName(
+            student,
+            team,
+            new TeamStudentNameFormatter.FormatOptions
+            {
+                MarkOverlaps = true,
+                HasOverlaps = timeslot.StudentHasOverlaps,
+                MarkAbsent = true,
+                AbsentStudents = _absentStudents.ToList()
+            });
     }
 
     private void AppendUnscheduledStudents(StringBuilder sb, TeamScheduleTimeSlot timeslot)
@@ -407,9 +431,12 @@
 
         foreach (var student in timeslot.UnscheduledStudents)
         {
-            var studentName = student.FirstName;
-            if (_absentStudents.Contains(student))
-                studentName += " (absent)";
+            var studentName = StudentNameFormatter.FormatStudentName(
+                student,
+                new StudentNameFormatter.FormatOptions
+                {
+                    IsAbsent = _absentStudents.Contains(student)
+                });
 
             var unassignedTeams = _solution.StudentUnassignedTeams(student);
             var teamsList = string.Join(", ", unassignedTeams.Select(e => e.ToString()));