new domain models lookup range result and lookup range bracket

payroll controller: new endpoint to get the payroll lookup ranges
action parser: added text alternative for logical opertator &&/AND and operator ||/OR
updated third-party nugets
updated version to 0.9.0-beta.16

Author: Jani Giannoudis

Api/Api.Controller/PayrollController.cs

@@ -1455,6 +1455,63 @@ await caseValueTool.GetTimeCaseValuesAsync(caseValueDate, caseType, caseFieldNam
         return new LookupValueDataMap().ToApi(valueData);
     }
 
+    protected async Task<ActionResult<ApiObject.LookupRangeResult[]>> GetPayrollLookupRangesAsync(
+        DomainObject.PayrollQuery query, string[] lookupNames, decimal? rangeValue, string culture)
+    {
+        try
+        {
+            // tenant
+            var authResult = await TenantRequestAsync(query.TenantId);
+            if (authResult != null)
+            {
+                return authResult;
+            }
+
+            // validate lookup names
+            if (lookupNames == null || lookupNames.Length == 0)
+            {
+                return BadRequest("Missing lookup names");
+            }
+
+            // query setup
+            var setupQuery = await SetupQuery(query);
+            if (setupQuery.Item2 != null)
+            {
+                // invalid setup response
+                return setupQuery.Item2;
+            }
+            var querySetup = setupQuery.Item1;
+
+            query.RegulationDate ??= CurrentEvaluationDate;
+            query.EvaluationDate ??= CurrentEvaluationDate;
+
+            // lookup provider
+            var lookupProvider = this.NewRegulationLookupProvider(Runtime.DbContext, querySetup.Tenant,
+                querySetup.Payroll, query.RegulationDate, query.EvaluationDate);
+
+            // build range brackets for each lookup
+            var results = new List<DomainObject.LookupRangeResult>();
+            foreach (var lookupName in lookupNames)
+            {
+                var lookupSet = await lookupProvider.GetLookupAsync(Runtime.DbContext, lookupName);
+                if (lookupSet == null)
+                {
+                    return BadRequest($"Unknown lookup {lookupName}");
+                }
+
+                var result = DomainObject.LookupSetExtensions.BuildRangeBrackets(lookupSet, rangeValue);
+                result.LookupName = lookupName;
+                results.Add(result);
+            }
+
+            return new LookupRangeResultMap().ToApi(results);
+        }
+        catch (Exception exception)
+        {
+            return InternalServerError(exception);
+        }
+    }
+
     protected async Task<ActionResult<ApiObject.ReportSet[]>> GetPayrollReportsAsync(
         DomainObject.PayrollQuery query, string[] reportNames, 
         OverrideType? overrideType, UserType? userType, string clusterSetName)

Api/Api.Core/PayrollEngine.Api.Core.csproj

@@ -9,8 +9,8 @@
 	<ItemGroup>
 		<PackageReference Include="Asp.Versioning.Mvc" Version="8.1.1" />
 		<PackageReference Include="Microsoft.NETCore.Platforms" Version="7.0.4" />
-		<PackageReference Include="Swashbuckle.AspNetCore" Version="10.1.0" />
-		<PackageReference Include="System.Configuration.ConfigurationManager" Version="10.0.1" />
+		<PackageReference Include="Swashbuckle.AspNetCore" Version="10.1.2" />
+		<PackageReference Include="System.Configuration.ConfigurationManager" Version="10.0.3" />
 		<PackageReference Include="Serilog.AspNetCore" Version="10.0.0" />
 	</ItemGroup>
 

Api/Api.Map/LookupRangeBracketMap.cs

@@ -0,0 +1,15 @@
+using DomainObject = PayrollEngine.Domain.Model;
+using ApiObject = PayrollEngine.Api.Model;
+using Riok.Mapperly.Abstractions;
+
+namespace PayrollEngine.Api.Map;
+
+/// <summary>
+/// Map a domain object with an api object
+/// </summary>
+[Mapper(EnumMappingStrategy = EnumMappingStrategy.ByName, EnumMappingIgnoreCase = true)]
+public partial class LookupRangeBracketMap : ApiMapBase<DomainObject.LookupRangeBracket, ApiObject.LookupRangeBracket>
+{
+    public override partial ApiObject.LookupRangeBracket ToApi(DomainObject.LookupRangeBracket domainObject);
+    public override partial DomainObject.LookupRangeBracket ToDomain(ApiObject.LookupRangeBracket apiObject);
+}

Api/Api.Map/LookupRangeResultMap.cs

@@ -0,0 +1,15 @@
+using DomainObject = PayrollEngine.Domain.Model;
+using ApiObject = PayrollEngine.Api.Model;
+using Riok.Mapperly.Abstractions;
+
+namespace PayrollEngine.Api.Map;
+
+/// <summary>
+/// Map a domain object with an api object
+/// </summary>
+[Mapper(EnumMappingStrategy = EnumMappingStrategy.ByName, EnumMappingIgnoreCase = true)]
+public partial class LookupRangeResultMap : ApiMapBase<DomainObject.LookupRangeResult, ApiObject.LookupRangeResult>
+{
+    public override partial ApiObject.LookupRangeResult ToApi(DomainObject.LookupRangeResult domainObject);
+    public override partial DomainObject.LookupRangeResult ToDomain(ApiObject.LookupRangeResult apiObject);
+}

Api/Api.Model/LookupRangeBracket.cs

@@ -0,0 +1,43 @@
+namespace PayrollEngine.Api.Model;
+
+/// <summary>
+/// A lookup range bracket with computed bounds
+/// </summary>
+// ReSharper disable UnusedAutoPropertyAccessor.Global
+// ReSharper disable PropertyCanBeMadeInitOnly.Global
+public class LookupRangeBracket
+{
+    /// <summary>
+    /// The lookup value key
+    /// </summary>
+    public string Key { get; set; }
+
+    /// <summary>
+    /// The lookup value as JSON
+    /// </summary>
+    public string Value { get; set; }
+
+    /// <summary>
+    /// The range start value
+    /// </summary>
+    public decimal RangeStart { get; set; }
+
+    /// <summary>
+    /// The range end value (unbound bracket: Decimal.MaxValue)
+    /// </summary>
+    public decimal RangeEnd { get; set; }
+
+    /// <summary>
+    /// The brackets range value
+    /// </summary>
+    /// <remarks>
+    /// Threshold lookup: value within the matching bracket.
+    /// Progressive lookup: matching bracket value range, except the last one which the value within his range.
+    /// Other: null.
+    /// </remarks>
+    public decimal? RangeValue { get; set; }
+
+    /// <inheritdoc/>
+    public override string ToString() =>
+        $"{Key}: {RangeStart} - {RangeEnd}";
+}

Api/Api.Model/LookupRangeResult.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+
+namespace PayrollEngine.Api.Model;
+
+/// <summary>
+/// Result of a lookup range bracket computation
+/// </summary>
+// ReSharper disable UnusedAutoPropertyAccessor.Global
+// ReSharper disable PropertyCanBeMadeInitOnly.Global
+public class LookupRangeResult
+{
+    /// <summary>
+    /// The lookup name
+    /// </summary>
+    public string LookupName { get; set; }
+
+    /// <summary>
+    /// The lookup range mode
+    /// </summary>
+    public LookupRangeMode RangeMode { get; set; }
+
+    /// <summary>
+    /// The lookup range size
+    /// </summary>
+    public decimal? RangeSize { get; set; }
+
+    /// <summary>
+    /// Range brackets
+    /// </summary>
+    public List<LookupRangeBracket> Brackets { get; set; }
+
+    /// <inheritdoc/>
+    public override string ToString() =>
+        LookupName;
+}

Api/Api.Model/PayrollEngine.Api.Model.csproj

@@ -11,7 +11,7 @@
 	</PropertyGroup>
 
 	<ItemGroup>
-		<PackageReference Include="PayrollEngine.Core" Version="0.9.0-beta.15" />
+		<PackageReference Include="PayrollEngine.Core" Version="0.9.0-beta.16" />
 	</ItemGroup>
 
 	<ItemGroup>

Api/Api.Model/PayrollEngine.Api.Model.xml

@@ -1,13 +1,13 @@
 using System;
-using System.Collections.Generic;
-using System.ComponentModel.DataAnnotations;
 using System.Linq;
 using System.Threading.Tasks;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
 using Microsoft.AspNetCore.Mvc;
 using PayrollEngine.Api.Core;
-using PayrollEngine.Domain.Application.Service;
 using PayrollEngine.Domain.Model;
 using ApiObject = PayrollEngine.Api.Model;
+using PayrollEngine.Domain.Application.Service;
 
 namespace PayrollEngine.Backend.Controller;
 
@@ -739,6 +739,42 @@ public override async Task<ActionResult> QueryPayrollCaseChangeValuesAsync(int t
             lookupName, lookupKey, rangeValue, culture);
     }
 
+    /// <summary>
+    /// Get payroll lookup range brackets
+    /// </summary>
+    /// <param name="tenantId">The tenant id</param>
+    /// <param name="payrollId">The payroll id</param>
+    /// <param name="lookupNames">The lookup names (case-insensitive)</param>
+    /// <param name="rangeValue">Optional value to find matching brackets (supported by threshold and progressive lookups)</param>
+    /// <param name="regulationDate">The regulation date (default: UTC now)</param>
+    /// <param name="evaluationDate">The evaluation date (default: UTC now)</param>
+    /// <param name="culture">The content culture</param>
+    /// <returns>The lookup range results</returns>
+    [HttpGet("{payrollId}/lookups/ranges")]
+    [OkResponse]
+    [NotFoundResponse]
+    [ApiOperationId("GetPayrollLookupRanges")]
+    public async Task<ActionResult<ApiObject.LookupRangeResult[]>> GetPayrollLookupRangesAsync(int tenantId, int payrollId,
+        [FromQuery][Required] string[] lookupNames, [FromQuery] decimal? rangeValue,
+        [FromQuery] DateTime? regulationDate, [FromQuery] DateTime? evaluationDate, [FromQuery] string culture)
+    {
+        // authorization
+        var authResult = await TenantRequestAsync(tenantId);
+        if (authResult != null)
+        {
+            return authResult;
+        }
+        return await base.GetPayrollLookupRangesAsync(
+            new()
+            {
+                TenantId = tenantId,
+                PayrollId = payrollId,
+                RegulationDate = regulationDate,
+                EvaluationDate = evaluationDate
+            },
+            lookupNames, rangeValue, culture);
+    }
+
     /// <summary>
     /// Get payroll report sets
     /// </summary>