Add comprehensive validation system with runtime configuration

Implements a flexible validation framework for student rankings, team assignments, and team composition with administrator-configurable rules and thresholds. Validation System: - Reflection-based rule discovery eliminates manual registration - Base classes (RequiredEventTypeRuleBase, EventCountThresholdRuleBase) reduce code duplication by ~250 lines - 12 validation rules covering event requirements, counts, and team constraints - Configurable severity levels (Warning/Error) per rule type - ValidationService with caching for optimal performance - Rules apply contextually (StudentRanking, StudentAssignment, TeamComposition) Configuration & Admin UI: - ValidationSettings admin page for editing thresholds and severity levels - ChapterSettings admin page for editing chapter information - Settings stored in Data/appsettings.json for runtime configuration - JSON config works in both development and production environments - Auto-creates Data directory and config template on first run User Experience: - ValidationWarnings component displays inline warnings/errors - Integrated in Event Ranking, Registration, and Team Assignment pages - Color-coded severity indicators (warning yellow, error red) - Includes "Too Many Regional Events" rule (max 3 recommended) Technical Improvements: - Template Method pattern for rule base classes - Singleton rule instances with lazy initialization - Configuration loaded via IConfiguration with fallback to defaults - Safe JSON updates preserve other appsettings sections
2025-12-13 22:15:16 -05:00
parent 215b9dccca
commit 1c7e704ad3
36 changed files with 1839 additions and 83 deletions
@@ -1,6 +1,12 @@
@using WebApp.Models

+<span style=""></span>
+@if (EventDefinition.LevelOfEffort.HasValue)
+{
+    <span class="numberCircle">@EventDefinition.LevelOfEffort</span>
+}
 <MudText Style="font-family: monospace; white-space: pre;">
+    
    @foreach (var charStr in _attributes.Select(c => c.ToString()))
    {
        if (AppIcons.IconTooltips.TryGetValue(charStr, out var tooltip))
@@ -23,9 +29,7 @@

    protected override void OnParametersSet()
    {
-        _attributes = AppIcons.LevelOfEffortIcon(EventDefinition.LevelOfEffort);
-        _attributes += " ";
-        _attributes += EventDefinition.EventFormat == EventFormat.Individual ? AppIcons.IndividualEvent : " ";
+        _attributes = EventDefinition.EventFormat == EventFormat.Individual ? AppIcons.IndividualEvent : " ";
        _attributes += EventDefinition.OnSiteActivity ? AppIcons.OnSiteActivity : " ";
        _attributes += EventDefinition.RegionalEvent ? AppIcons.RegionalEvent : " ";
        _attributes += EventDefinition.InterviewOrPresentation ? AppIcons.PresentationEvent : " ";
@@ -2,7 +2,9 @@
@attribute [Authorize]
@using Microsoft.EntityFrameworkCore
@using WebApp.Models
+@using Core.Validation
@inject AppDbContext Context
+@inject ValidationService ValidationService
@rendermode InteractiveServer

 <PageTitle>Student Event Ranks - TSA Chapter Organizer</PageTitle>
@@ -37,25 +39,7 @@ else
            <MudTh>@context.TsaYear</MudTh>
            <MudTd><MudButton StartIcon="@Icons.Material.Filled.TableChart" Href="@($"students/event-ranking-edit/{context.Id}")">Edit</MudButton></MudTd>
            <MudTd>
-                @if (!context.RankedEvents.Any(re => re.OnSiteActivity))
-                {
-                    <MudTooltip Text="No On-Site Activity">
-                        <MudText Style="font-weight:bolder" Color="Color.Warning">@AppIcons.OnSiteActivity</MudText>
-                    </MudTooltip>
-                }
-                @if (!context.RankedEvents.Any(re => re.RegionalEvent))
-                {
-                    <MudTooltip Text="No Regional Event">
-                        <MudText Style="font-weight:bolder" Color="Color.Warning">@AppIcons.RegionalEvent</MudText>
-                    </MudTooltip>
-                }
-
-                @if (context.RankedEvents.All(re => re.EventFormat != EventFormat.Individual))
-                {
-                    <MudTooltip Text="No Individual Event">
-                        <MudText Style="font-weight:bolder" Color="Color.Warning">@AppIcons.IndividualEvent</MudText>
-                    </MudTooltip>
-                }
+                <ValidationWarnings Warnings="@GetStudentWarnings(context)" />
            </MudTd>
            @for (var i = 1; i <= 10; i++)
            {
@@ -154,4 +138,9 @@ else

        _maxEventStudentRankings = _eventStudentRankings.Max(esr => esr.StudentRanking.Length);
    }
+
+    private List<ValidationWarning> GetStudentWarnings(Student student)
+    {
+        return ValidationService.ValidateStudentRankings(student, ValidationContext.StudentRanking);
+    }
 }
@@ -2,8 +2,10 @@
@attribute [Authorize]
@using Microsoft.EntityFrameworkCore
@using WebApp.Models
+@using Core.Validation
@inject AppDbContext Context
@inject WebApp.LocalStorageService LocalStorage
+@inject ValidationService ValidationService

 <PageTitle>Registration - TSA Chapter Organizer</PageTitle>

@@ -43,6 +45,11 @@
                </MudTooltip>
            </CellTemplate>
        </PropertyColumn>
+        <TemplateColumn Title="Warnings" Sortable="false">
+            <CellTemplate>
+                <ValidationWarnings Warnings="@GetRegistrationWarnings(context.Item.Student)" />
+            </CellTemplate>
+        </TemplateColumn>
        @if (_showGrade)
        {
            <PropertyColumn Property="@(e => e.Student.Grade)" Title="Grade" Sortable="true" />
@@ -239,6 +246,20 @@
            : data.OrderBy(sortExpression);
    }

+    private List<ValidationWarning> GetRegistrationWarnings(Student student)
+    {
+        // Create StudentEventStatistics from the student's teams
+        var stats = new StudentEventStatistics
+        {
+            Student = student,
+            Events = student.Teams?.Where(t => t?.Event != null)
+                                  .Select(t => t.Event)
+                                  .ToList() ?? new List<EventDefinition>()
+        };
+
+        return ValidationService.ValidateStudentStatistics(stats, ValidationContext.StudentRegistration);
+    }
+
    public class StudentTeamInfo
    {
        public required Student Student { get; init; }
@@ -1,12 +1,14 @@
@page "/teams/assignment"
@attribute [Authorize]
@using Core.Calculation
+@using Core.Validation
@using Microsoft.EntityFrameworkCore
@using WebApp.Models
@using EventAssignment = Core.Calculation.EventAssignment
@inject AppDbContext Context
@inject IDialogService DialogService
@inject NavigationManager NavigationManager
+@inject ValidationService ValidationService

 <PageTitle>Event Assignment - TSA Chapter Organizer</PageTitle>

@@ -134,18 +136,8 @@
                <MudTd><b>@context.Student.FirstName</b></MudTd>
                <MudTd>@context.EventCount</MudTd>
                <MudTd>@context.TotalLevelOfEffort</MudTd>
-                <MudTd>@if (!context.HasOnSiteActivity)
-                       {
-                           <MudTooltip Text="No On-Site Activity">
-                            <MudText Style="font-weight:bolder" Color="Color.Warning">@AppIcons.OnSiteActivity</MudText>
-                           </MudTooltip>
-                       }
-                    @if (!context.HasRegionalEvent)
-                    {
-                        <MudTooltip Text="No Regional Event">
-                            <MudText Style="font-weight:bolder" Color="Color.Warning">@AppIcons.RegionalEvent</MudText>
-                        </MudTooltip>
-                    }
+                <MudTd>
+                    <ValidationWarnings Warnings="@GetStatisticsWarnings(context)" />
                </MudTd>
            </RowTemplate>
            <ChildRowContent>
@@ -313,6 +305,7 @@
    public bool TestSwitch { get; set; } = false;

    private readonly AssignmentParameters _parameters = new() { RequireOnSite = false, RequireRegional = false };
+    private ValidationService _validationService = new ValidationService(ValidationConfiguration.Default);

    private List<EventDefinition>? _events;
    private List<Student>? _students;
@@ -367,6 +360,7 @@
    private async Task<TableData<Team>> SolveAssignments(TableState arg1, CancellationToken arg2)
    {
        _isSolving = true;
+        UpdateValidationConfig();
        var eventAssignment = new EventAssignment(_events, _students, _parameters);
        foreach (var requirement in _assignmentRequirements)
        {
@@ -396,6 +390,17 @@
        return new TableData<StudentEventStatistics> {Items = _statistics};
    }

+    private void UpdateValidationConfig()
+    {
+        var config = ValidationConfiguration.FromAssignmentParameters(_parameters);
+        _validationService = new ValidationService(config);
+    }
+
+    private List<ValidationWarning> GetStatisticsWarnings(StudentEventStatistics stats)
+    {
+        return _validationService.ValidateStudentStatistics(stats, ValidationContext.StudentAssignment);
+    }
+
    private async Task<TableData<AssignmentRequirement>> ReloadAssignmentRequirements(TableState arg1, CancellationToken arg2)
    {
        return new TableData<AssignmentRequirement> { Items = _assignmentRequirements };
@@ -0,0 +1,186 @@
+@page "/settings/chapter"
+@attribute [Authorize(Roles = AuthRoles.Administrator)]
+@using WebApp.Authentication
+@using WebApp.Models
+@using System.Text.Json
+@inject IWebHostEnvironment Environment
+@inject IConfiguration Configuration
+
+@rendermode InteractiveServer
+
+<PageTitle>Chapter Settings</PageTitle>
+
+<MudContainer MaxWidth="MaxWidth.Large" Class="mt-4">
+    <MudText Typo="Typo.h3" Class="mb-4">Chapter Settings</MudText>
+    <MudText Typo="Typo.body1" Class="mb-6">Configure chapter information. Changes take effect on next application restart.</MudText>
+
+    @if (_settings != null)
+    {
+        <MudPaper Class="pa-6 mb-4">
+            <MudText Typo="Typo.h5" Class="mb-4">Basic Information</MudText>
+            <MudGrid>
+                <MudItem xs="12" md="8">
+                    <MudTextField @bind-Value="_settings.Name"
+                                Label="Chapter Name"
+                                Variant="Variant.Outlined"
+                                HelperText="Full chapter name"
+                                Required="true" />
+                </MudItem>
+                <MudItem xs="12" md="4">
+                    <MudTextField @bind-Value="_settings.ShortName"
+                                Label="Short Name"
+                                Variant="Variant.Outlined"
+                                HelperText="Abbreviation (e.g., YCN)"
+                                MaxLength="10"
+                                Required="true" />
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudTextField @bind-Value="_settings.CompetitionYear"
+                                Label="Competition Year"
+                                Variant="Variant.Outlined"
+                                HelperText="Year of competition (e.g., 2026)"
+                                MaxLength="4"
+                                Required="true" />
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        <MudPaper Class="pa-6 mb-4">
+            <MudText Typo="Typo.h5" Class="mb-4">Chapter IDs</MudText>
+            <MudGrid>
+                <MudItem xs="12" md="4">
+                    <MudTextField @bind-Value="_settings.NationalId"
+                                Label="National ID"
+                                Variant="Variant.Outlined"
+                                HelperText="4-digit national chapter ID"
+                                MaxLength="4" />
+                </MudItem>
+                <MudItem xs="12" md="4">
+                    <MudTextField @bind-Value="_settings.StateId"
+                                Label="State ID"
+                                Variant="Variant.Outlined"
+                                HelperText="5-digit state chapter ID"
+                                MaxLength="5" />
+                </MudItem>
+                <MudItem xs="12" md="4">
+                    <MudTextField @bind-Value="_settings.RegionalId"
+                                Label="Regional ID"
+                                Variant="Variant.Outlined"
+                                HelperText="5-digit regional chapter ID"
+                                MaxLength="5" />
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        <MudPaper Class="pa-6">
+            <MudGrid>
+                <MudItem xs="12">
+                    <MudButton Variant="Variant.Filled"
+                             Color="Color.Primary"
+                             StartIcon="@Icons.Material.Filled.Save"
+                             OnClick="SaveSettings"
+                             Disabled="_isSaving">
+                        @if (_isSaving)
+                        {
+                            <MudProgressCircular Class="mr-2" Size="Size.Small" Indeterminate="true" />
+                            <span>Saving...</span>
+                        }
+                        else
+                        {
+                            <span>Save Settings</span>
+                        }
+                    </MudButton>
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        @if (!string.IsNullOrEmpty(_statusMessage))
+        {
+            <MudAlert Severity="@_statusSeverity" Class="mt-4">@_statusMessage</MudAlert>
+        }
+    }
+    else
+    {
+        <MudProgressCircular Indeterminate="true" />
+    }
+</MudContainer>
+
+@code {
+    private Models.ChapterSettings? _settings;
+    private bool _isSaving;
+    private string? _statusMessage;
+    private Severity _statusSeverity = Severity.Success;
+
+    protected override void OnInitialized()
+    {
+        // Load from IConfiguration
+        _settings = Configuration.GetSection("ChapterSettings").Get<Models.ChapterSettings>()
+                  ?? new Models.ChapterSettings();
+    }
+
+    private string GetAppSettingsPath()
+    {
+        return Path.Combine(
+            Environment.ContentRootPath,
+            "Data",
+            "appsettings.json");
+    }
+
+    private async Task SaveSettings()
+    {
+        if (_settings == null) return;
+
+        _isSaving = true;
+        _statusMessage = null;
+
+        try
+        {
+            var appSettingsPath = GetAppSettingsPath();
+
+            // Ensure Data directory exists
+            var dataDir = Path.GetDirectoryName(appSettingsPath);
+            if (dataDir != null && !Directory.Exists(dataDir))
+            {
+                Directory.CreateDirectory(dataDir);
+            }
+
+            // Read existing appsettings or create new
+            JsonDocument? existingDoc = null;
+            Dictionary<string, object?> settings;
+
+            if (File.Exists(appSettingsPath))
+            {
+                var existingJson = await File.ReadAllTextAsync(appSettingsPath);
+                existingDoc = JsonDocument.Parse(existingJson);
+                settings = JsonSerializer.Deserialize<Dictionary<string, object?>>(existingJson)
+                          ?? new Dictionary<string, object?>();
+            }
+            else
+            {
+                settings = new Dictionary<string, object?>();
+            }
+
+            // Update ChapterSettings section
+            settings["ChapterSettings"] = _settings;
+
+            // Write back to file
+            var options = new JsonSerializerOptions { WriteIndented = true };
+            var json = JsonSerializer.Serialize(settings, options);
+            await File.WriteAllTextAsync(appSettingsPath, json);
+
+            existingDoc?.Dispose();
+
+            _statusMessage = "Settings saved successfully! Changes will take effect on next application restart.";
+            _statusSeverity = Severity.Success;
+        }
+        catch (Exception ex)
+        {
+            _statusMessage = $"Error saving settings: {ex.Message}";
+            _statusSeverity = Severity.Error;
+        }
+        finally
+        {
+            _isSaving = false;
+        }
+    }
+}
@@ -26,6 +26,9 @@
    </div>
 </MudPaper>

+<MudPaper Elevation="0" Class="mb-6">
+<MudText Typo="Typo.h4" Class="mb-2">Data</MudText>
+</MudPaper>
 <MudGrid>
    <!-- Events Card -->
    <DashboardCard Icon="@AppIcons.Events"
@@ -60,13 +63,19 @@
                   Subtitle="Total Teams"
                   Caption="@($"{_groupTeamsCount} Team | {_individualTeamsCount} Individual")"
                   NavigateUrl="/teams" />
-
-    <!-- Meeting Schedule Card -->
-    <DashboardCard Icon="@AppIcons.Scheduler"
-                   Title="Schedule"
-                   Caption="Optimize meeting times"
-                   NavigateUrl="/meeting-schedule" />
 </MudGrid>
+<MudPaper Elevation="0" Class="my-6">
+    <MudText Typo="Typo.h4">Tools</MudText>
+</MudPaper>
+
+    <MudGrid>
+
+        <!-- Meeting Schedule Card -->
+        <DashboardCard Icon="@AppIcons.Scheduler"
+                       Title="Schedule"
+                       Caption="Optimize meeting times"
+                       NavigateUrl="/meeting-schedule"/>
+    </MudGrid>

@code {
    private int _eventCount;
@@ -0,0 +1,284 @@
+@page "/settings/validation"
+@attribute [Authorize(Roles = AuthRoles.Administrator)]
+@using Core.Validation
+@using WebApp.Authentication
+@using System.Text.Json
+@inject IWebHostEnvironment Environment
+@inject IConfiguration Configuration
+
+@rendermode InteractiveServer
+
+<PageTitle>Validation Settings</PageTitle>
+
+<MudContainer MaxWidth="MaxWidth.Large" Class="mt-4">
+    <MudText Typo="Typo.h3" Class="mb-4">Validation Settings</MudText>
+    <MudText Typo="Typo.body1" Class="mb-6">Configure validation rules and thresholds. Changes take effect on next application restart.</MudText>
+
+    @if (_config != null)
+    {
+        <MudPaper Class="pa-6 mb-4">
+            <MudText Typo="Typo.h5" Class="mb-4">Event Count Thresholds</MudText>
+            <MudGrid>
+                <MudItem xs="12" md="6">
+                    <MudNumericField @bind-Value="_config.MinRecommendedEvents"
+                                   Label="Minimum Recommended Events"
+                                   Variant="Variant.Outlined"
+                                   HelperText="Warning if student has fewer events"
+                                   Min="0" Max="10" />
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudNumericField @bind-Value="_config.MaxRecommendedEvents"
+                                   Label="Maximum Recommended Events"
+                                   Variant="Variant.Outlined"
+                                   HelperText="Warning if student has more events"
+                                   Min="0" Max="10" />
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudNumericField @bind-Value="_config.MinCriticalEvents"
+                                   Label="Minimum Critical Events"
+                                   Variant="Variant.Outlined"
+                                   HelperText="Error if student has fewer events"
+                                   Min="0" Max="10" />
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudNumericField @bind-Value="_config.MaxCriticalEvents"
+                                   Label="Maximum Critical Events"
+                                   Variant="Variant.Outlined"
+                                   HelperText="Error if student has more events"
+                                   Min="0" Max="10" />
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudNumericField @bind-Value="_config.MaxRegionalEvents"
+                                   Label="Maximum Regional Events"
+                                   Variant="Variant.Outlined"
+                                   HelperText="Warning if student has more regional events"
+                                   Min="0" Max="10" />
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        <MudPaper Class="pa-6 mb-4">
+            <MudText Typo="Typo.h5" Class="mb-4">Required Event Types</MudText>
+            <MudGrid>
+                <MudItem xs="12" md="6">
+                    <MudSwitch @bind-Value="_config.RequireRegionalEvent"
+                             Label="Require Regional Event"
+                             Color="Color.Primary" />
+                    <MudText Typo="Typo.body2" Class="mud-text-secondary ml-10">
+                        Students must have at least one regional event
+                    </MudText>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSwitch @bind-Value="_config.RequireOnSiteActivity"
+                             Label="Require On-Site Activity"
+                             Color="Color.Primary" />
+                    <MudText Typo="Typo.body2" Class="mud-text-secondary ml-10">
+                        Students must have at least one on-site activity
+                    </MudText>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSwitch @bind-Value="_config.RequireIndividualEvent"
+                             Label="Require Individual Event"
+                             Color="Color.Primary" />
+                    <MudText Typo="Typo.body2" Class="mud-text-secondary ml-10">
+                        Students must have at least one individual event
+                    </MudText>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSwitch @bind-Value="_config.RequireTeamCaptain"
+                             Label="Require Team Captain"
+                             Color="Color.Primary" />
+                    <MudText Typo="Typo.body2" Class="mud-text-secondary ml-10">
+                        Team events must have an assigned captain
+                    </MudText>
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        <MudPaper Class="pa-6 mb-4">
+            <MudText Typo="Typo.h5" Class="mb-4">Validation Severity Levels</MudText>
+            <MudGrid>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.NoRegionalEventSeverity"
+                             Label="No Regional Event"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.NoOnSiteActivitySeverity"
+                             Label="No On-Site Activity"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.NoIndividualEventSeverity"
+                             Label="No Individual Event"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.TeamSizeSeverity"
+                             Label="Team Size Issues"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.EventCountSeverity"
+                             Label="Event Count Issues"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.MissingCaptainSeverity"
+                             Label="Missing Team Captain"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+                <MudItem xs="12" md="6">
+                    <MudSelect @bind-Value="_config.TooManyRegionalEventsSeverity"
+                             Label="Too Many Regional Events"
+                             Variant="Variant.Outlined">
+                        <MudSelectItem Value="ValidationSeverity.Warning">Warning</MudSelectItem>
+                        <MudSelectItem Value="ValidationSeverity.Error">Error</MudSelectItem>
+                    </MudSelect>
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        <MudPaper Class="pa-6">
+            <MudGrid>
+                <MudItem xs="12">
+                    <MudButton Variant="Variant.Filled"
+                             Color="Color.Primary"
+                             StartIcon="@Icons.Material.Filled.Save"
+                             OnClick="SaveConfiguration"
+                             Disabled="_isSaving">
+                        @if (_isSaving)
+                        {
+                            <MudProgressCircular Class="mr-2" Size="Size.Small" Indeterminate="true" />
+                            <span>Saving...</span>
+                        }
+                        else
+                        {
+                            <span>Save Configuration</span>
+                        }
+                    </MudButton>
+                    <MudButton Variant="Variant.Outlined"
+                             Class="ml-2"
+                             OnClick="ResetToDefaults"
+                             Disabled="_isSaving">
+                        Reset to Defaults
+                    </MudButton>
+                </MudItem>
+            </MudGrid>
+        </MudPaper>
+
+        @if (!string.IsNullOrEmpty(_statusMessage))
+        {
+            <MudAlert Severity="@_statusSeverity" Class="mt-4">@_statusMessage</MudAlert>
+        }
+    }
+    else
+    {
+        <MudProgressCircular Indeterminate="true" />
+    }
+</MudContainer>
+
+@code {
+    private ValidationConfiguration? _config;
+    private bool _isSaving;
+    private string? _statusMessage;
+    private Severity _statusSeverity = Severity.Success;
+
+    protected override void OnInitialized()
+    {
+        // Load from IConfiguration
+        _config = Configuration.GetSection("ValidationSettings").Get<ValidationConfiguration>()
+                  ?? ValidationConfiguration.Default;
+    }
+
+    private string GetAppSettingsPath()
+    {
+        return Path.Combine(
+            Environment.ContentRootPath,
+            "Data",
+            "appsettings.json");
+    }
+
+    private async Task SaveConfiguration()
+    {
+        if (_config == null) return;
+
+        _isSaving = true;
+        _statusMessage = null;
+
+        try
+        {
+            var appSettingsPath = GetAppSettingsPath();
+
+            // Ensure Data directory exists
+            var dataDir = Path.GetDirectoryName(appSettingsPath);
+            if (dataDir != null && !Directory.Exists(dataDir))
+            {
+                Directory.CreateDirectory(dataDir);
+            }
+
+            // Read existing appsettings or create new
+            JsonDocument? existingDoc = null;
+            Dictionary<string, object?> settings;
+
+            if (File.Exists(appSettingsPath))
+            {
+                var existingJson = await File.ReadAllTextAsync(appSettingsPath);
+                existingDoc = JsonDocument.Parse(existingJson);
+                settings = JsonSerializer.Deserialize<Dictionary<string, object?>>(existingJson)
+                          ?? new Dictionary<string, object?>();
+            }
+            else
+            {
+                settings = new Dictionary<string, object?>();
+            }
+
+            // Update ValidationSettings section
+            settings["ValidationSettings"] = _config;
+
+            // Write back to file
+            var options = new JsonSerializerOptions { WriteIndented = true };
+            var json = JsonSerializer.Serialize(settings, options);
+            await File.WriteAllTextAsync(appSettingsPath, json);
+
+            existingDoc?.Dispose();
+
+            _statusMessage = "Configuration saved successfully! Changes will take effect on next application restart.";
+            _statusSeverity = Severity.Success;
+        }
+        catch (Exception ex)
+        {
+            _statusMessage = $"Error saving configuration: {ex.Message}";
+            _statusSeverity = Severity.Error;
+        }
+        finally
+        {
+            _isSaving = false;
+        }
+    }
+
+    private void ResetToDefaults()
+    {
+        _config = ValidationConfiguration.Default;
+        _statusMessage = "Configuration reset to defaults. Click Save to apply.";
+        _statusSeverity = Severity.Info;
+    }
+}
@@ -1,4 +1,5 @@
@using WebApp.Models
+@using WebApp.Authentication
@inject IConfiguration Configuration

 <MudPaper Width="250px" Class="d-inline-flex py-3" Elevation="0">
@@ -20,5 +21,10 @@
            <MudNavLink Href="/students/event-ranking" Icon="@AppIcons.EventRank">Event Ranking</MudNavLink>
            <MudNavLink Href="/teams/assignment" Icon="@AppIcons.TeamAssignment">Team Assignment</MudNavLink>
        </MudNavGroup>
+        <AuthorizeView Roles="Administrator">
+            <MudDivider Class="my-2"/>
+            <MudNavLink Href="/settings/chapter" Icon="@Icons.Material.Filled.School">Chapter Settings</MudNavLink>
+            <MudNavLink Href="/settings/validation" Icon="@Icons.Material.Filled.Settings">Validation Settings</MudNavLink>
+        </AuthorizeView>
    </MudNavMenu>
 </MudPaper>
@@ -0,0 +1,37 @@
+@using Core.Validation
+@using WebApp.Models
+
+@if (Warnings != null && Warnings.Any())
+{
+    <MudText Style="display: inline-flex; gap: 4px;">
+        @foreach (var warning in Warnings)
+        {
+            var color = warning.Severity == ValidationSeverity.Error ? Color.Error : Color.Warning;
+            var icon = GetIconFromIdentifier(warning.IconIdentifier);
+
+            <MudTooltip Text="@warning.Message">
+                <MudText Style="font-weight:bolder" Color="@color">@icon</MudText>
+            </MudTooltip>
+        }
+    </MudText>
+}
+
+@code {
+    [Parameter]
+    public List<ValidationWarning>? Warnings { get; set; }
+
+    private string GetIconFromIdentifier(string? identifier)
+    {
+        if (string.IsNullOrEmpty(identifier))
+            return "";
+
+        return identifier switch
+        {
+            "RegionalEvent" => AppIcons.RegionalEvent,
+            "OnSiteActivity" => AppIcons.OnSiteActivity,
+            "IndividualEvent" => AppIcons.IndividualEvent,
+            "Captain" => AppIcons.Captain,
+            _ => ""
+        };
+    }
+}
@@ -17,9 +17,9 @@ namespace WebApp.Models
            
            return loe switch
            {
-                1 => "‧",
-                2 => "⁚",
-                3 => "⁝",
+                1 => "1",
+                2 => "2",
+                3 => "3",
                _ => Icons.Material.Filled.QuestionMark
            };
        }
@@ -0,0 +1,37 @@
+namespace WebApp.Models;
+
+/// <summary>
+/// Configuration for chapter-specific information
+/// </summary>
+public class ChapterSettings
+{
+    /// <summary>
+    /// Full chapter name (e.g., "Your Chapter Name")
+    /// </summary>
+    public string Name { get; set; } = "Your Chapter Name";
+
+    /// <summary>
+    /// Short chapter name abbreviation (e.g., "YCN")
+    /// </summary>
+    public string ShortName { get; set; } = "YCN";
+
+    /// <summary>
+    /// National chapter ID (4 digits, e.g., "0000")
+    /// </summary>
+    public string NationalId { get; set; } = "0000";
+
+    /// <summary>
+    /// State chapter ID (5 digits, e.g., "00000")
+    /// </summary>
+    public string StateId { get; set; } = "00000";
+
+    /// <summary>
+    /// Regional chapter ID (5 digits, e.g., "00000")
+    /// </summary>
+    public string RegionalId { get; set; } = "00000";
+
+    /// <summary>
+    /// Competition year (e.g., "2026")
+    /// </summary>
+    public string CompetitionYear { get; set; } = "2026";
+}
@@ -11,62 +11,66 @@ using WebApp.Logging;

 var builder = WebApplication.CreateBuilder(args);

-// Load optional appsettings from Data directory in production (overrides defaults)
-// In development, use appsettings.Development.json instead
-if (builder.Environment.IsProduction())
+// Load appsettings from Data directory (works in both development and production)
+// This allows runtime configuration changes without touching the codebase
+var dataAppSettingsPath = Path.Combine(builder.Environment.ContentRootPath, "Data", "appsettings.json");
+if (!File.Exists(dataAppSettingsPath))
 {
-    var dataAppSettingsPath = Path.Combine(builder.Environment.ContentRootPath, "Data", "appsettings.json");
-    if (!File.Exists(dataAppSettingsPath))
+    Console.WriteLine($"appsettings.json not found at {dataAppSettingsPath}. Creating from template...");
+
+    try
    {
-        Console.WriteLine($"appsettings.json not found at {dataAppSettingsPath}. Creating from template...");
+        // Ensure Data directory exists
+        Directory.CreateDirectory(Path.Combine(builder.Environment.ContentRootPath, "Data"));

-        try
+        // Copy ChapterSettings and ValidationSettings from the base appsettings.json
+        var baseAppSettingsPath = Path.Combine(builder.Environment.ContentRootPath, "appsettings.json");
+        if (File.Exists(baseAppSettingsPath))
        {
-            // Ensure Data directory exists
-            Directory.CreateDirectory(Path.Combine(builder.Environment.ContentRootPath, "Data"));
+            var baseConfig = File.ReadAllText(baseAppSettingsPath);
+            var baseDoc = JsonDocument.Parse(baseConfig);

-            // Copy ChapterSettings from the base appsettings.json
-            var baseAppSettingsPath = Path.Combine(builder.Environment.ContentRootPath, "appsettings.json");
-            if (File.Exists(baseAppSettingsPath))
+            var templateSettings = new Dictionary<string, object?>();
+
+            if (baseDoc.RootElement.TryGetProperty("ChapterSettings", out var chapterSettings))
            {
-                var baseConfig = File.ReadAllText(baseAppSettingsPath);
-                var baseDoc = JsonDocument.Parse(baseConfig);
+                templateSettings["ChapterSettings"] = JsonSerializer.Deserialize<object>(chapterSettings.GetRawText());
+            }

-                if (baseDoc.RootElement.TryGetProperty("ChapterSettings", out var chapterSettings))
+            if (baseDoc.RootElement.TryGetProperty("ValidationSettings", out var validationSettings))
+            {
+                templateSettings["ValidationSettings"] = JsonSerializer.Deserialize<object>(validationSettings.GetRawText());
+            }
+
+            if (templateSettings.Any())
+            {
+                var json = JsonSerializer.Serialize(templateSettings, new JsonSerializerOptions
                {
-                    var templateSettings = new
-                    {
-                        ChapterSettings = JsonSerializer.Deserialize<object>(chapterSettings.GetRawText())
-                    };
+                    WriteIndented = true
+                });

-                    var json = JsonSerializer.Serialize(templateSettings, new JsonSerializerOptions
-                    {
-                        WriteIndented = true
-                    });
-
-                    File.WriteAllText(dataAppSettingsPath, json);
-                    Console.WriteLine("appsettings.json created in Data directory. Please update ChapterSettings with your chapter information.");
-                }
-                else
-                {
-                    Console.WriteLine("WARNING: ChapterSettings not found in base appsettings.json");
-                }
+                File.WriteAllText(dataAppSettingsPath, json);
+                Console.WriteLine("appsettings.json created in Data directory.");
+            }
+            else
+            {
+                Console.WriteLine("WARNING: No settings to copy from base appsettings.json");
            }
        }
-        catch (Exception ex)
-        {
-            Console.WriteLine($"WARNING: Unable to create appsettings.json: {ex.Message}");
-        }
    }
-
-    // Add Data/appsettings.json as additional configuration source
-    if (File.Exists(dataAppSettingsPath))
+    catch (Exception ex)
    {
-        builder.Configuration.AddJsonFile(dataAppSettingsPath, optional: true, reloadOnChange: true);
-        Console.WriteLine($"Loaded configuration from {dataAppSettingsPath}");
+        Console.WriteLine($"WARNING: Unable to create appsettings.json: {ex.Message}");
    }
 }

+// Add Data/appsettings.json as additional configuration source (all environments)
+if (File.Exists(dataAppSettingsPath))
+{
+    builder.Configuration.AddJsonFile(dataAppSettingsPath, optional: true, reloadOnChange: true);
+    Console.WriteLine($"Loaded configuration from {dataAppSettingsPath}");
+}
+
 // Configure Serilog with custom handling for antiforgery errors
 builder.Host.UseSerilog((context, configuration) =>
 {
@@ -172,6 +176,15 @@ builder.Services.AddScoped<WebApp.LocalStorageService>();
 // State container for maintaining state per user connection (Blazor Server)
 builder.Services.AddScoped<StateContainer>();

+// Load validation configuration from appsettings (or use default if not found)
+var validationConfig = builder.Configuration
+    .GetSection("ValidationSettings")
+    .Get<Core.Validation.ValidationConfiguration>() ?? Core.Validation.ValidationConfiguration.Default;
+
+// Validation service with loaded configuration
+builder.Services.AddScoped<Core.Validation.ValidationService>(sp =>
+    new Core.Validation.ValidationService(validationConfig));
+
 // Add authentication services
 builder.Services.AddHttpContextAccessor();
 builder.Services.AddScoped<AuthenticationService>();
@@ -17,5 +17,23 @@
    "StateId": "00000",
    "RegionalId": "00000",
    "CompetitionYear": "2026"
+  },
+  "ValidationSettings": {
+    "MinRecommendedEvents": 2,
+    "MaxRecommendedEvents": 4,
+    "MinCriticalEvents": 1,
+    "MaxCriticalEvents": 6,
+    "MaxRegionalEvents": 3,
+    "RequireRegionalEvent": true,
+    "RequireOnSiteActivity": true,
+    "RequireIndividualEvent": false,
+    "RequireTeamCaptain": true,
+    "NoRegionalEventSeverity": "Warning",
+    "NoOnSiteActivitySeverity": "Warning",
+    "NoIndividualEventSeverity": "Warning",
+    "TeamSizeSeverity": "Warning",
+    "EventCountSeverity": "Warning",
+    "MissingCaptainSeverity": "Warning",
+    "TooManyRegionalEventsSeverity": "Warning"
  }
 }
@@ -93,3 +93,15 @@ h1:focus {
 .event-rank-4 { background-color: #ffe599; }
 .event-rank-5 { background-color: #fff2cc; }
 .event-rank-6 { background-color: #fffaea; }
+
+.numberCircle {
+    display: flex;
+    width: fit-content;
+    /* min-width: .2rem; */
+    padding: 0;
+    align-items: center;
+    justify-content: center;
+    aspect-ratio: 10/1;
+    border-radius: 50%;
+    border: 1px solid;
+}