Add state schedule handout feature and configuration options

This commit introduces a new StateScheduleHandout component for generating printable schedules for students, including a combined master list of events. It adds configuration options in appsettings.json for state abbreviations and special event filters, enhancing the scheduling functionality. The Program.cs file is updated to register the new StateScheduleHandoutOptions, and the Calendar and Teams components are modified to include links to the new handout feature. Additionally, utility methods for filtering event occurrences are implemented to support the new functionality, improving the overall user experience in managing state schedules.
2026-04-06 23:33:57 -04:00
parent 4dcd9e5aab
commit a9036d5d04
10 changed files with 513 additions and 12 deletions
@@ -0,0 +1,79 @@
+using Core.Entities;
+using WebApp.Models;
+
+namespace WebApp.Utility;
+
+/// <summary>
+/// Determines which special <see cref="EventOccurrence"/> rows belong on a per-student handout.
+/// </summary>
+public static class StateScheduleOccurrenceFilter
+{
+    public static bool NameMatchesStudentExclude(string? name, StateScheduleHandoutOptions options)
+    {
+        if (string.IsNullOrEmpty(name)) return false;
+        foreach (var sub in options.StudentExcludeOccurrenceNameSubstrings ?? [])
+        {
+            if (string.IsNullOrWhiteSpace(sub)) continue;
+            if (name.Contains(sub.Trim(), StringComparison.OrdinalIgnoreCase))
+                return true;
+        }
+
+        return false;
+    }
+
+    /// <summary>
+    /// True when the occurrence name refers to Meet the Candidates (covers General Schedule lines duplicated under another type).
+    /// </summary>
+    public static bool NameLooksLikeMeetTheCandidates(string? name) =>
+        !string.IsNullOrEmpty(name) &&
+        name.Contains("Meet the Candidate", StringComparison.OrdinalIgnoreCase);
+
+    public static bool NameLooksLikeChapterOfficerMeeting(string? name) =>
+        !string.IsNullOrEmpty(name) &&
+        name.Contains("Chapter Officer Meeting", StringComparison.OrdinalIgnoreCase);
+
+    /// <summary>
+    /// Special rows have <see cref="EventOccurrence.EventDefinitionId"/> null and <see cref="EventOccurrence.SpecialEventType"/> set.
+    /// </summary>
+    public static bool IncludeSpecialOccurrenceForStudent(
+        EventOccurrence occurrence,
+        Student student,
+        StateScheduleHandoutOptions options)
+    {
+        if (string.IsNullOrEmpty(occurrence.SpecialEventType))
+            return false;
+
+        if (NameMatchesStudentExclude(occurrence.Name, options))
+            return false;
+
+        if (occurrence.SpecialEventType == "VotingDelegateMeeting")
+            return student.VotingDelegate;
+
+        if (occurrence.SpecialEventType == "MeetTheCandidates")
+            return student.VotingDelegate;
+
+        if (occurrence.SpecialEventType == "ChapterOfficerMeeting")
+            return student.OfficerRole.HasValue;
+
+        // Same event often appears once as MeetTheCandidates and again under GeneralSchedule; non-delegates should see neither.
+        if (!student.VotingDelegate && NameLooksLikeMeetTheCandidates(occurrence.Name))
+            return false;
+
+        // Chapter Officer Meeting lines under GeneralSchedule for non-officers
+        if (!student.OfficerRole.HasValue && NameLooksLikeChapterOfficerMeeting(occurrence.Name))
+            return false;
+
+        var allowed = options.StudentSpecialEventTypes ?? [];
+        return allowed.Contains(occurrence.SpecialEventType);
+    }
+
+    /// <summary>
+    /// Competition rows: optional name-based exclusion on student pages.
+    /// </summary>
+    public static bool IncludeCompetitionOccurrenceForStudent(EventOccurrence occurrence, StateScheduleHandoutOptions options)
+    {
+        if (occurrence.EventDefinitionId == null)
+            return false;
+        return !NameMatchesStudentExclude(occurrence.Name, options);
+    }
+}