Documentation modifications

adas-core.Domain/Utils/MappingUtils.cs

@@ -13,6 +13,11 @@ public sealed class MappingUtils : IMappingUtils
     private readonly List<MappingInterventions>? _cccData;
     private bool _isTransformedValue;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MappingUtils"/> class by loading the CCC mapping interventions from the supplied <see cref="ApiSettings"/> and resetting the transformed-value flag.
+    /// </summary>
+    /// <param name="apiSettings">The <see cref="IOptions{TOptions}"/> wrapper whose <see cref="IOptions{TOptions}.Value"/> provides the <see cref="ApiSettings"/> whose <see cref="ApiSettings.MappingInterventions"/> data is stored in this instance.</param>
+    /// <!-- aidoc:v1 sig=396ced4 body=2be44b9 -->
     public MappingUtils(IOptions<ApiSettings> apiSettings)
     {
         var cccMappingData = apiSettings.Value.MappingInterventions;
@@ -46,6 +51,13 @@ public sealed class MappingUtils : IMappingUtils
 
         return null; // No se encontro el code
     }*/
+    /// <summary>
+    /// Searches for an entry matching the supplied <paramref name="code"/> within the given <paramref name="category"/> and returns its associated type, name, and group. The <paramref name="code"/> may be a <see cref="double"/> (matched as an exact value or within a numeric range) or a <see cref="string"/> (parsed as a <see cref="double"/> when possible, otherwise compared as text). Returns <see langword="null"/> when no matching entry is found.
+    /// </summary>
+    /// <param name="code">The code to look up. Accepts a <see cref="double"/> for numeric matching and a <see cref="string"/> for text matching or numeric parsing.</param>
+    /// <param name="category">The category used to filter the entries; only entries whose category matches this value are considered.</param>
+    /// <returns>A tuple containing the <c>type</c>, <c>name</c>, and <c>group</c> of the matching entry, or <see langword="null"/> when no match is found.</returns>
+    /// <!-- aidoc:v1 sig=b69e7ef body=e42117e -->
     public (string type, string name, string group)? SearchByCode(object code, string category)
     {
         // esta funcion conviete a double los string que permitan conversion si no se puede los deja como string