feat: Add NHS number search functionality for exceptions and reports

application/CohortManager/src/Functions/Shared/Common/Pagination/IPaginationService.cs

@@ -1,6 +1,7 @@
 namespace Common;
 
 using Microsoft.Azure.Functions.Worker.Http;
+using Model.Pagination;
 
 public interface IPaginationService<T>
 {

application/CohortManager/src/Functions/Shared/Common/Pagination/PaginationService.cs

@@ -1,6 +1,7 @@
 namespace Common;
 
 using Microsoft.Azure.Functions.Worker.Http;
+using Model.Pagination;
 
 public class PaginationService<T> : IPaginationService<T>
 {

application/CohortManager/src/Functions/Shared/Data/Database/IValidationExceptionData.cs

@@ -1,15 +1,21 @@
 namespace Data.Database;
 
+using System;
+using System.Linq.Expressions;
+using System.Threading.Tasks;
 using Common;
 using Model;
+using Model.DTO;
 using Model.Enums;
 
 public interface IValidationExceptionData
 {
     Task<bool> Create(ValidationException exception);
-    Task<List<ValidationException>?> GetFilteredExceptions(ExceptionStatus? exceptionStatus, SortOrder? sortOrder, ExceptionCategory exceptionCategory);
+    Task<List<ValidationException>> GetFilteredExceptions(ExceptionStatus? exceptionStatus, SortOrder? sortOrder, ExceptionCategory exceptionCategory);
     Task<ValidationException?> GetExceptionById(int exceptionId);
     Task<bool> RemoveOldException(string nhsNumber, string screeningName);
     Task<ServiceResponseModel> UpdateExceptionServiceNowId(int exceptionId, string serviceNowId);
-    Task<List<ValidationException>?> GetReportExceptions(DateTime? reportDate, ExceptionCategory exceptionCategory);
+    Task<List<ValidationException>> GetReportExceptions(DateTime? reportDate, ExceptionCategory exceptionCategory);
+    Task<List<ExceptionManagement>> GetByFilter(Expression<Func<ExceptionManagement, bool>> filter);
+    Task<ValidationExceptionsByNhsNumberResponse> GetExceptionsWithReportsByNhsNumber(string nhsNumber);
 }

application/CohortManager/src/Functions/Shared/Data/Database/ValidationExceptionData.cs

@@ -2,6 +2,7 @@ namespace Data.Database;
 
 using System;
 using System.Data;
+using System.Linq.Expressions;
 using System.Net;
 using System.Text.Json;
 using System.Threading.Tasks;
@@ -17,17 +18,17 @@ public class ValidationExceptionData : IValidationExceptionData
 {
     private readonly ILogger<ValidationExceptionData> _logger;
     private readonly IDataServiceClient<ExceptionManagement> _validationExceptionDataServiceClient;
+
     public ValidationExceptionData(
         ILogger<ValidationExceptionData> logger,
-        IDataServiceClient<ExceptionManagement> validationExceptionDataServiceClient,
-        IDataServiceClient<ParticipantDemographic> demographicDataServiceClient
+        IDataServiceClient<ExceptionManagement> validationExceptionDataServiceClient
     )
     {
         _logger = logger;
         _validationExceptionDataServiceClient = validationExceptionDataServiceClient;
     }
 
-    public async Task<List<ValidationException>?> GetFilteredExceptions(ExceptionStatus? exceptionStatus, SortOrder? sortOrder, ExceptionCategory exceptionCategory)
+    public async Task<List<ValidationException>> GetFilteredExceptions(ExceptionStatus? exceptionStatus, SortOrder? sortOrder, ExceptionCategory exceptionCategory)
     {
         var category = (int)exceptionCategory;
         var exceptions = await _validationExceptionDataServiceClient.GetByFilter(x => x.Category != null && x.Category.Value == category);
@@ -49,12 +50,12 @@ IDataServiceClient<ParticipantDemographic> demographicDataServiceClient
         return GetValidationExceptionWithDetails(exception);
     }
 
-
     public async Task<bool> Create(ValidationException exception)
     {
         var exceptionToUpdate = new ExceptionManagement().FromValidationException(exception);
         return await _validationExceptionDataServiceClient.Add(exceptionToUpdate);
     }
+
     public async Task<bool> RemoveOldException(string nhsNumber, string screeningName)
     {
         var exceptions = await GetExceptionRecords(nhsNumber, screeningName);
@@ -63,7 +64,6 @@ public async Task<bool> RemoveOldException(string nhsNumber, string screeningNam
             return false;
         }
 
-        // we only need to get the last unresolved exception for the nhs number and screening service
         var validationExceptionToUpdate = exceptions.Where(x => DateToString(x.DateResolved) == "9999-12-31")
         .OrderByDescending(x => x.DateCreated).FirstOrDefault();
 
@@ -117,7 +117,7 @@ public async Task<ServiceResponseModel> UpdateExceptionServiceNowId(int exceptio
         }
     }
 
-    public async Task<List<ValidationException>?> GetReportExceptions(DateTime? reportDate, ExceptionCategory exceptionCategory)
+    public async Task<List<ValidationException>> GetReportExceptions(DateTime? reportDate, ExceptionCategory exceptionCategory)
     {
         if (exceptionCategory is not (ExceptionCategory.Confusion or ExceptionCategory.Superseded or ExceptionCategory.NBO))
         {
@@ -129,8 +129,41 @@ public async Task<ServiceResponseModel> UpdateExceptionServiceNowId(int exceptio
         if (filteredExceptions == null || !filteredExceptions.Any())
             return [];
 
-        var results = filteredExceptions.Select(GetValidationExceptionWithDetails);
-        return results.Where(x => x != null).ToList()!;
+        return MapToValidationExceptions(filteredExceptions);
+    }
+
+    public async Task<List<ExceptionManagement>> GetByFilter(Expression<Func<ExceptionManagement, bool>> filter)
+    {
+        var result = await _validationExceptionDataServiceClient.GetByFilter(filter) ?? Enumerable.Empty<ExceptionManagement>();
+        return result.ToList();
+    }
+
+    public async Task<ValidationExceptionsByNhsNumberResponse> GetExceptionsWithReportsByNhsNumber(string nhsNumber)
+    {
+        var validationExceptions = await GetValidationExceptionsByNhsNumber(nhsNumber);
+
+        if (validationExceptions.Count == 0)
+        {
+            return new ValidationExceptionsByNhsNumberResponse
+            {
+                Exceptions = [],
+                Reports = [],
+                NhsNumber = nhsNumber
+            };
+        }
+
+        var reports = GenerateExceptionReports(validationExceptions);
+        return new ValidationExceptionsByNhsNumberResponse
+        {
+            Exceptions = validationExceptions,
+            Reports = reports,
+            NhsNumber = nhsNumber
+        };
+    }
+
+    private List<ValidationException> MapToValidationExceptions(IEnumerable<ExceptionManagement> exceptions)
+    {
+        return exceptions.Select(GetValidationExceptionWithDetails).Where(x => x != null).ToList()!;
     }
 
     private ServiceResponseModel CreateSuccessResponse(string message) => CreateResponse(true, HttpStatusCode.OK, message);
@@ -183,7 +216,7 @@ public async Task<ServiceResponseModel> UpdateExceptionServiceNowId(int exceptio
                 NhsNumber = long.TryParse(errorRecordData.NhsNumber, out long nhsNumber) ? nhsNumber : 0,
                 GivenName = errorRecordData.FirstName,
                 FamilyName = errorRecordData.FamilyName,
-                DateOfBirth = MappingUtilities.FormatDateTime(MappingUtilities.ParseDates(errorRecordData.DateOfBirth)),
+                DateOfBirth = MappingUtilities.FormatDateTime(MappingUtilities.ParseDates(errorRecordData.DateOfBirth ?? string.Empty)),
                 SupersededByNhsNumber = long.TryParse(errorRecordData.SupersededByNhsNumber, out long superseded) ? superseded : null,
                 Gender = errorRecordData.Gender,
                 AddressLine1 = errorRecordData.AddressLine1,
@@ -277,10 +310,8 @@ private ServiceResponseModel CreateResponse(bool success, HttpStatusCode statusC
 
     private async Task<List<ExceptionManagement>?> GetExceptionRecords(string nhsNumber, string screeningName)
     {
-
         var exceptions = await _validationExceptionDataServiceClient.GetByFilter(x => x.NhsNumber == nhsNumber && x.ScreeningName == screeningName);
         return exceptions?.ToList();
-
     }
 
     private static string DateToString(DateTime? datetime)
@@ -311,4 +342,39 @@ private static List<ValidationException> SortExceptions(SortOrder? sortOrder, IE
             ? [.. filteredList.OrderBy(dateProperty)]
             : [.. filteredList.OrderByDescending(dateProperty)];
     }
+
+
+
+    private async Task<List<ValidationException>> GetValidationExceptionsByNhsNumber(string nhsNumber)
+    {
+        var exceptions = await _validationExceptionDataServiceClient.GetByFilter(x => x.NhsNumber == nhsNumber);
+        if (exceptions == null || !exceptions.Any())
+        {
+            return [];
+        }
+
+        return [.. exceptions
+            .Select(GetValidationExceptionWithDetails)
+            .Where(x => x != null)
+            .Cast<ValidationException>()
+            .OrderByDescending(x => x.DateCreated)];
+    }
+
+    private static List<ValidationExceptionReport> GenerateExceptionReports(List<ValidationException> validationExceptions)
+    {
+        return [.. validationExceptions
+            .Where(x => x.Category.HasValue && (x.Category.Value == 12 || x.Category.Value == 13))
+            .GroupBy(x => new
+            {
+                Date = x.DateCreated?.Date ?? DateTime.Now.Date,
+                Category = x.Category
+            })
+            .Select(g => new ValidationExceptionReport
+            {
+                ReportDate = g.Key.Date,
+                Category = g.Key.Category,
+                ExceptionCount = g.Count()
+            })
+            .OrderByDescending(r => r.ReportDate)];
+    }
 }

application/CohortManager/src/Functions/Shared/Common/Pagination/PaginationResult.cs → application/CohortManager/src/Functions/Shared/Model/DTO/PaginationResult.cs

@@ -1,8 +1,8 @@
-namespace Common;
+namespace Model.Pagination;
 
 public class PaginationResult<T>
 {
-    public IEnumerable<T> Items { get; set; }
+    public required IEnumerable<T> Items { get; set; }
     public bool IsFirstPage { get; set; }
     public bool HasNextPage { get; set; }
     public bool HasPreviousPage { get; set; }

application/CohortManager/src/Functions/Shared/Model/DTO/ValidationExceptionsByNhsNumberResponse.cs

@@ -0,0 +1,21 @@
+namespace Model.DTO;
+
+using Model.Pagination;
+
+/// <summary>
+/// Response model for NHS number search containing paginated exceptions and associated reports
+/// </summary>
+public class ValidationExceptionsByNhsNumberResponse
+{
+    public string NhsNumber { get; set; } = string.Empty;
+    public List<ValidationException> Exceptions { get; set; } = [];
+    public List<ValidationExceptionReport> Reports { get; set; } = [];
+    public PaginationResult<ValidationException> PaginatedExceptions { get; set; } = new() { Items = [] };
+}
+
+public class ValidationExceptionReport
+{
+    public DateTime ReportDate { get; set; }
+    public int? Category { get; set; }
+    public int ExceptionCount { get; set; }
+}

application/CohortManager/src/Functions/screeningDataServices/GetValidationExceptions/GetValidationExceptions.cs

@@ -10,7 +10,9 @@ namespace NHS.CohortManager.ScreeningDataServices;
 using Microsoft.Azure.Functions.Worker.Http;
 using Microsoft.Extensions.Logging;
 using Model;
+using Model.DTO;
 using Model.Enums;
+using Model.Pagination;
 
 /// <summary>
 /// Azure Function for retrieving and managing validation exceptions.
@@ -129,4 +131,53 @@ public async Task<HttpResponseData> UpdateExceptionServiceNowId([HttpTrigger(Aut
             return _createResponse.CreateHttpResponse(HttpStatusCode.InternalServerError, req);
         }
     }
+
+    /// <summary>
+    /// Retrieves validation exceptions and reports for a specific NHS number.
+    /// </summary>
+    [Function(nameof(GetValidationExceptionsByNhsNumber))]
+    public async Task<HttpResponseData> GetValidationExceptionsByNhsNumber([HttpTrigger(AuthorizationLevel.Anonymous, "get")] HttpRequestData req)
+    {
+        var nhsNumber = req.Query["nhsNumber"];
+        var page = _httpParserHelper.GetQueryParameterAsInt(req, "page", 1);
+        var pageSize = _httpParserHelper.GetQueryParameterAsInt(req, "pageSize", 10);
+
+        if (string.IsNullOrWhiteSpace(nhsNumber))
+        {
+            return _createResponse.CreateHttpResponse(HttpStatusCode.BadRequest, req, "NHS number is required.");
+        }
+
+        var cleanedNhsNumber = nhsNumber.Replace(" ", "");
+        if (!ValidationHelper.ValidateNHSNumber(cleanedNhsNumber))
+        {
+            return _createResponse.CreateHttpResponse(HttpStatusCode.BadRequest, req, "Invalid NHS number format.");
+        }
+
+        try
+        {
+            var result = await _validationData.GetExceptionsWithReportsByNhsNumber(cleanedNhsNumber);
+
+            if (result.Exceptions.Count == 0)
+            {
+                return _createResponse.CreateHttpResponse(HttpStatusCode.NoContent, req);
+            }
+
+            var paginatedExceptions = _paginationService.GetPaginatedResult(result.Exceptions.AsQueryable(), page, pageSize);
+            var headers = _paginationService.AddNavigationHeaders(req, paginatedExceptions);
+
+            var response = new ValidationExceptionsByNhsNumberResponse
+            {
+                NhsNumber = result.NhsNumber,
+                PaginatedExceptions = paginatedExceptions,
+                Reports = result.Reports
+            };
+
+            return _createResponse.CreateHttpResponseWithHeaders(HttpStatusCode.OK, req, JsonSerializer.Serialize(response), headers);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving validation exceptions for provided NHS number");
+            return _createResponse.CreateHttpResponse(HttpStatusCode.InternalServerError, req);
+        }
+    }
 }

application/CohortManager/src/Web/app/components/conditionalHeaderSearch.tsx

@@ -0,0 +1,18 @@
+interface ConditionalHeaderSearchProps {
+  readonly children: React.ReactNode;
+  readonly pathname: string;
+}
+
+export function ConditionalHeaderSearch({
+  children,
+  pathname,
+}: ConditionalHeaderSearchProps) {
+  const isNoResultsPage = pathname === "/exceptions/noResults";
+
+  // Don't render the header search if we're on the no results page
+  if (isNoResultsPage) {
+    return null;
+  }
+
+  return <>{children}</>;
+}