Feature: add ks4 core subjects to schools

.gitignore

@@ -506,3 +506,4 @@ wwwroot/**/*.min.js
 **/wwwroot/*
 **/wwwroot/*
 /coveragereport
+/SAPData/Sql

SAPSec.Core/Features/Ks4CoreSubjects/UseCases/GetFilteredSchoolKs4CoreSubject.cs

@@ -0,0 +1,50 @@
+using SAPSec.Core.Features.Ks4HeadlineMeasures;
+using SAPSec.Core.Features.SimilarSchools;
+using SAPSec.Core.Interfaces.Repositories;
+
+namespace SAPSec.Core.Features.Ks4CoreSubjects.UseCases;
+
+public class GetFilteredSchoolKs4CoreSubject(
+    IKs4PerformanceRepository repository,
+    IEstablishmentRepository establishmentRepository,
+    ISimilarSchoolsSecondaryRepository similarSchoolsRepository)
+{
+    public async Task<GetFilteredSchoolKs4CoreSubjectResponse> Execute(GetFilteredSchoolKs4CoreSubjectRequest request)
+    {
+        var gradeFilter = SchoolKs4CoreSubjectExtensions.ParseFilter(request.Grade);
+        var subjectFilter = SchoolKs4CoreSubjectExtensions.ParseSubject(request.Subject);
+        var schoolData = await repository.GetByUrnAsync(request.Urn);
+        var similarSchoolUrns = (await similarSchoolsRepository.GetSimilarSchoolUrnsAsync(request.Urn))
+            .Where(urn => !string.IsNullOrWhiteSpace(urn))
+            .Distinct(StringComparer.Ordinal)
+            .ToArray();
+        var similarSchoolData = ((await repository.GetByUrnsAsync(similarSchoolUrns)) ?? [])
+            .ToDictionary(x => x.Urn, x => x, StringComparer.Ordinal);
+        var similarSchoolDetails = ((await establishmentRepository.GetEstablishmentsAsync(similarSchoolUrns))
+                ?? Array.Empty<SAPSec.Core.Model.Generated.Establishment>())
+            .Where(x => !string.IsNullOrWhiteSpace(x.URN))
+            .ToDictionary(x => x.URN, StringComparer.Ordinal);
+        var similarSchools = similarSchoolUrns
+            .Where(similarSchoolDetails.ContainsKey)
+            .Select(urn => new SimilarSchoolMeasure(
+                urn,
+                similarSchoolDetails[urn].EstablishmentName,
+                similarSchoolData.GetValueOrDefault(urn)))
+            .ToArray();
+
+        return new(
+            SchoolKs4CoreSubjectSelectionBuilder.BuildSelection(schoolData, similarSchools, subjectFilter, gradeFilter),
+            subjectFilter,
+            gradeFilter);
+    }
+}
+
+public record GetFilteredSchoolKs4CoreSubjectRequest(
+    string Urn,
+    string? Subject,
+    string? Grade);
+
+public record GetFilteredSchoolKs4CoreSubjectResponse(
+    SchoolKs4CoreSubjectSelection Selection,
+    SchoolKs4CoreSubject Subject,
+    SchoolKs4CoreSubjectGradeFilter Grade);

SAPSec.Core/Features/Ks4CoreSubjects/UseCases/SchoolKs4CoreSubjectExtensions.cs

@@ -0,0 +1,47 @@
+namespace SAPSec.Core.Features.Ks4CoreSubjects.UseCases;
+
+public static class SchoolKs4CoreSubjectExtensions
+{
+    public static SchoolKs4CoreSubjectGradeFilter ParseFilter(string? grade) =>
+        grade switch
+        {
+            "5" => SchoolKs4CoreSubjectGradeFilter.Grade5,
+            "7" => SchoolKs4CoreSubjectGradeFilter.Grade7,
+            "4" => SchoolKs4CoreSubjectGradeFilter.Grade4,
+            _ => throw new ArgumentOutOfRangeException(nameof(grade), grade, "Unsupported KS4 core subject grade filter.")
+        };
+
+    public static SchoolKs4CoreSubject ParseSubject(string? subject) =>
+        subject?.ToLowerInvariant() switch
+        {
+            "english-language" => SchoolKs4CoreSubject.EnglishLanguage,
+            "english-literature" => SchoolKs4CoreSubject.EnglishLiterature,
+            "biology" => SchoolKs4CoreSubject.Biology,
+            "chemistry" => SchoolKs4CoreSubject.Chemistry,
+            "physics" => SchoolKs4CoreSubject.Physics,
+            "maths" => SchoolKs4CoreSubject.Maths,
+            "combined-science-double-award" => SchoolKs4CoreSubject.CombinedScienceDoubleAward,
+            _ => throw new ArgumentOutOfRangeException(nameof(subject), subject, "Unsupported KS4 core subject.")
+        };
+
+    public static string ToFilterValue(this SchoolKs4CoreSubjectGradeFilter filter) =>
+        filter switch
+        {
+            SchoolKs4CoreSubjectGradeFilter.Grade5 => "5",
+            SchoolKs4CoreSubjectGradeFilter.Grade7 => "7",
+            _ => "4"
+        };
+
+    public static string ToSubjectValue(this SchoolKs4CoreSubject subject) =>
+        subject switch
+        {
+            SchoolKs4CoreSubject.EnglishLanguage => "english-language",
+            SchoolKs4CoreSubject.EnglishLiterature => "english-literature",
+            SchoolKs4CoreSubject.Biology => "biology",
+            SchoolKs4CoreSubject.Chemistry => "chemistry",
+            SchoolKs4CoreSubject.Physics => "physics",
+            SchoolKs4CoreSubject.Maths => "maths",
+            SchoolKs4CoreSubject.CombinedScienceDoubleAward => "combined-science-double-award",
+            _ => throw new ArgumentOutOfRangeException(nameof(subject), subject, "Unsupported KS4 core subject.")
+        };
+}