Feature/ilr submission

src/Earnings/SFA.DAS.Earnings.Api/Controllers/LearnerDataController.cs

@@ -0,0 +1,62 @@
+using Microsoft.AspNetCore.Mvc;
+using SFA.DAS.Earnings.Api.Learnerdata;
+
+namespace SFA.DAS.Earnings.Api.Controllers;
+
+[ApiController]
+[Route("leanerdata")]
+public class LearnerDataController : Controller
+{
+    private readonly ILearnerDataSearchService _service;
+
+    public LearnerDataController(ILearnerDataSearchService service)
+    {
+        _service = service;
+    }
+
+    [HttpGet]
+    [Route("/providers/{ukprn}/academicyears/{academicyear}/apprenticeships")]
+    public IActionResult Search(uint ukprn, uint academicyear, [FromQuery] uint page, [FromQuery] uint pageSize)
+    {
+        if (pageSize < 1 || pageSize > 100)
+        {
+            return BadRequest("Page size must be between 1 and 100");
+        }
+
+        if (page < 1)
+        {
+            return BadRequest("Invalid page requested");
+        }
+
+        var result = _service.Search(ukprn, academicyear, page==0?1:page, pageSize==0?20:pageSize);
+
+        // Add Link headers for pagination
+        var baseUrl = $"{Request.Scheme}://{Request.Host}{Request.PathBase}{Request.Path}";
+        var nextPage = page * pageSize < result.TotalRecords ? page + 1 : page;
+        var prevPage = page > 1 ? page - 1 : 1;
+
+        var header = "";
+
+        if (prevPage != page)
+        {
+            header += $"<{baseUrl}?page={prevPage}&pageSize={pageSize}>; rel=\"prev\", ";
+        } 
+
+        if (nextPage != page)
+        {
+            if (header.Length > 0)
+            {
+                header += ", ";
+            }
+
+            header += $"<{baseUrl}?page={nextPage}&pageSize={pageSize}>; rel=\"next\"";
+        }
+
+        if (header.Length > 0)
+        {
+            Response.Headers["Link"] = header;
+        }
+
+        return Ok(result);
+    }   
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/Apprenticeship.cs

@@ -0,0 +1,5 @@
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public class Apprenticeship {
+    public uint Uln { get; set; }
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/ILearnerDataSearchService.cs

@@ -0,0 +1,6 @@
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public interface ILearnerDataSearchService
+{
+    PagedResult Search(uint ukprn, uint academicYear, uint page, uint pageSize);
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/ILearnerDataStore.cs

@@ -0,0 +1,9 @@
+using SFA.DAS.Earnings.Api.Controllers;
+
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public interface ILearnerDataStore
+{
+    List<Apprenticeship> Search(uint ukprn, uint academicYear, uint page, uint pageSize);
+    int Count(uint ukprn, uint academicYear);
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/LearnerDataSearchService.cs

@@ -0,0 +1,28 @@
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public class LearnerDataSearchService : ILearnerDataSearchService
+{
+    private readonly ILearnerDataStore _datastore;
+
+    public LearnerDataSearchService(ILearnerDataStore datastore)
+    {
+        _datastore = datastore;
+    }
+
+    public PagedResult Search(uint ukprn, uint academicYear, uint page, uint pageSize)
+    {
+        var results = _datastore.Search(ukprn, academicYear,  page, pageSize);
+
+        var totalRecords = _datastore.Count(ukprn, academicYear);
+
+        return new PagedResult
+        {
+            Page = page,
+            PageSize = pageSize,
+            TotalRecords = (uint)totalRecords,
+            Apprenticeships = results,
+            TotalPages = (uint)Math.Ceiling((double)totalRecords / pageSize)
+        };
+    }
+
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/LearnerDataStore.cs

@@ -0,0 +1,61 @@
+using System.Reflection;
+using SFA.DAS.Earnings.Api.Controllers;
+
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public class LearnerDataStore : ILearnerDataStore
+{
+    private readonly List<Tuple<uint, uint, uint, uint>> _data = new();
+
+    public LearnerDataStore(string resourcePath)
+    {
+        var loader = new ResourceLoader();
+
+        try
+        {
+            using (var stream = Assembly.GetAssembly(typeof(LearnerDataStore)).GetManifestResourceStream(resourcePath))
+            {
+                using (StreamReader reader = new StreamReader(stream))
+                {
+                    string line;
+                    uint count = 0;
+
+                    while ((line = reader.ReadLine()) != null)
+                    {
+                        var entries = line.Split(',');
+                        _data.Add(new Tuple<uint, uint, uint, uint>(++count,uint.Parse(entries[0]), uint.Parse(entries[1]), uint.Parse(entries[2])));
+                    }
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"Error loading resource: {ex.Message}");
+        }
+    }
+    public LearnerDataStore(List<Tuple<uint, uint, uint>> data)
+    {
+        for (int c = 0; c < data.Count; c++)
+        {
+            _data.Add(new Tuple<uint, uint, uint, uint>((uint)c, data[c].Item1, data[c].Item2, data[c].Item3));
+        }
+    }
+
+    public List<Apprenticeship> Search(uint ukprn, uint academicYear, uint page, uint pageSize)
+    {
+        return _data
+            .Where(s => s.Item2 == ukprn & s.Item3 == academicYear)
+            .OrderBy(l => l.Item1)
+            .Skip((int)(pageSize * (page-1)))
+            .Take((int)pageSize)
+            .Select(s => new Apprenticeship
+            {
+                Uln = s.Item4
+            }).ToList();
+    }
+
+    public int Count(uint ukprn, uint academicYear)
+    {
+        return _data.Count(s => s.Item3 == academicYear & s.Item2 == ukprn);
+    }
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/PagedResult.cs

@@ -0,0 +1,16 @@
+using SFA.DAS.Earnings.Api.Controllers;
+
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public class PagedResult {
+    public IList<Apprenticeship> Apprenticeships { get; set; }
+    public uint TotalRecords { get; set; }   
+    public uint Page { get; set; }   
+    public uint PageSize { get; set; }   
+    public uint TotalPages { get; set; }
+
+    public PagedResult()
+    {
+        Apprenticeships = new List<Apprenticeship>();
+    }
+}

src/Earnings/SFA.DAS.Earnings.Api/Learnerdata/ResourceLoader.cs

@@ -0,0 +1,26 @@
+using System.Reflection;
+
+namespace SFA.DAS.Earnings.Api.Learnerdata;
+
+public class ResourceLoader
+{
+    public string LoadEmbeddedResource(string resourcePath)
+    {
+        // Get the current assembly
+        var assembly = Assembly.GetExecutingAssembly();
+
+        // Ensure the resource exists in the assembly
+        using (Stream stream = assembly.GetManifestResourceStream(resourcePath))
+        {
+            if (stream == null)
+            {
+                throw new FileNotFoundException("Resource not found.", resourcePath);
+            }
+
+            using (StreamReader reader = new StreamReader(stream))
+            {
+                return reader.ReadToEnd();
+            }
+        }
+    }
+}

src/Earnings/SFA.DAS.Earnings.Api/SFA.DAS.Earnings.Api.csproj

@@ -21,4 +21,8 @@
     <ProjectReference Include="..\SFA.DAS.Earnings\SFA.DAS.Earnings.csproj" />
   </ItemGroup>
 
+  <ItemGroup>
+    <EmbeddedResource Include="cannedLearnerData.csv" />
+  </ItemGroup>
+
 </Project>

src/Earnings/SFA.DAS.Earnings.Api/Startup.cs

@@ -6,6 +6,8 @@
 using SFA.DAS.Api.Common.AppStart;
 using SFA.DAS.Api.Common.Configuration;
 using SFA.DAS.Earnings.Api.AppStart;
+using SFA.DAS.Earnings.Api.Controllers;
+using SFA.DAS.Earnings.Api.Learnerdata;
 using SFA.DAS.SharedOuterApi.AppStart;
 using SFA.DAS.SharedOuterApi.Infrastructure.HealthCheck;
 
@@ -30,7 +32,7 @@ public void ConfigureServices(IServiceCollection services)
         services.AddSingleton(_env);
 
         services.AddConfigurationOptions(_configuration);
-
+        
         if (!_configuration.IsLocalOrDev())
         {
             var azureAdConfiguration = _configuration
@@ -56,6 +58,8 @@ public void ConfigureServices(IServiceCollection services)
                 }
             });
 
+        services.AddSingleton<ILearnerDataSearchService>(new LearnerDataSearchService(new LearnerDataStore("SFA.DAS.Earnings.Api.cannedLearnerData.csv")));
+
         services.AddControllers().AddJsonOptions(options =>
             options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()));