EverestConfig 3.4.1

EverestConfig — .NET

Librería .NET para gestionar parametrización genérica de formularios y secciones. Permite consultar desde una API centralizada qué campos son visibles, requeridos, su tipo y propiedades personalizadas — sin hardcodear configuración en cada proyecto.

Inicialmente diseñada para Historia Clínica (HC), aplicable a cualquier dominio.

Instalación

dotnet add package EverestConfig --version 2.1.0

Registro en DI

En Startup.cs (o Program.cs), registrá el servicio pasando la URL completa del endpoint de configuración:

services.AddEverestConfig("http://localhost:5000/api/Configuracion/GetConfig");

La librería agrega ?key=, &epsId= y &contratoId= a esa URL según los parámetros de cada llamada. El timeout del HttpClient está configurado en 30 segundos.

Endpoint que consume

GET /api/Configuracion/GetConfig?key={key}&epsId={epsId}&contratoId={contratoId}

El backend filtra los campos por epsId y contratoId antes de responder — la librería recibe la lista ya resuelta, sin duplicados. Si no hay configuración el endpoint responde [].

Interfaz del servicio

public interface IEverestConfigService
{
    Task<SectionConfig> GetConfigAsync(string key, int? epsId = null, int? contratoId = null);

    bool IsVisible(SectionConfig config, string fieldId);
    bool IsRequired(SectionConfig config, string fieldId);
    FieldType? GetFieldType(SectionConfig config, string fieldId);
    object GetCustomProperty(SectionConfig config, string fieldId, string property);
}

Modelos públicos

public class SectionConfig
{
    public string Key { get; set; }
    public string Version { get; set; }
    public List<FieldConfig> Fields { get; set; }
}

public class FieldConfig
{
    public string Id { get; set; }
    public bool Visible { get; set; }
    public bool Required { get; set; }
    public bool? Readonly { get; set; }
    public string Label { get; set; }
    public string Description { get; set; }
    public string Section { get; set; }
    public string ValidationRegex { get; set; }
    public FieldType? Type { get; set; }
    public Dictionary<string, object> CustomProperties { get; set; }
}

public enum FieldType
{
    String, Number, Boolean, Date, DateTime, Select, Card, Custom
}

Ejemplo de uso en un controller

using EverestConfig.Services;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class MorbilidadController : ControllerBase
{
    private readonly IEverestConfigService _config;

    public MorbilidadController(IEverestConfigService config)
    {
        _config = config;
    }

    [HttpGet("formulario")]
    public async Task<IActionResult> GetFormulario([FromQuery] int epsId, [FromQuery] int contratoId)
    {
        var config = await _config.GetConfigAsync("hc.morbilidad", epsId, contratoId);

        if (config == null)
            return NotFound("No se encontró configuración.");

        return Ok(new
        {
            mostrarOrdenamientos = _config.IsVisible(config, "ordenamientos"),
            mostrarDiagnosticos  = _config.IsVisible(config, "diagnosticos"),
            tiposOrdenamiento    = _config.GetCustomProperty(config, "ordenamientos", "types")
        });
    }
}

Validar un campo antes de guardar

using EverestConfig.Validators;

[HttpPost("guardar")]
public async Task<IActionResult> Guardar([FromBody] MorbilidadRequest request, [FromQuery] int epsId, [FromQuery] int contratoId)
{
    var config = await _config.GetConfigAsync("hc.morbilidad", epsId, contratoId);

    if (config == null)
        return NotFound("Configuración no encontrada.");

    var campoOrdenamientos = config.Fields.FirstOrDefault(f => f.Id == "ordenamientos");

    if (campoOrdenamientos != null)
    {
        var resultado = FieldValidator.Validate(request.Ordenamientos, campoOrdenamientos);

        if (!resultado.Valid)
            return BadRequest(resultado.Message);
    }

    // lógica de guardado...
    return Ok();
}

Leer propiedades personalizadas (CustomProperties)

var types = _config.GetCustomProperty(config, "ordenamientos", "types");

// Castear según la estructura conocida
var lista = types as Newtonsoft.Json.Linq.JArray;

Caché en memoria

GetConfigAsync almacena la respuesta en memoria con clave {key}_{epsId}_{contratoId}. Las llamadas siguientes con los mismos parámetros no hacen petición HTTP. Automático, sin configuración adicional.

Logs

El servicio loguea automáticamente usando ILogger. Todos los mensajes tienen el prefijo [EverestConfig]:

[EverestConfig] GetConfigAsync: configuración no encontrada | key: "hc.morbilidad" | epsId: 21 | contratoId: 1
[EverestConfig] IsVisible: campo no encontrado | key: "hc.morbilidad" | fieldId: "ordenamientos"
[EverestConfig] GetCustomProperty: propiedad no definida | fieldId: "ordenamientos" | property: "tipos"

JSON de respuesta esperado

[
  {
    "key": "hc.morbilidad",
    "version": "1.0",
    "fields": [
      {
        "id": "ordenamientos",
        "section": "conducta.ordenamientos",
        "label": "Laboratorios",
        "visible": true,
        "required": false,
        "readonly": false,
        "type": "select",
        "validationRegex": null,
        "customProperties": {
          "types": [
            { "name": "laboratorio",  "posfechado": true, "nota": false, "cantidad": false },
            { "name": "consulta",     "posfechado": true, "nota": true,  "cantidad": true  },
            { "name": "imagenologia", "posfechado": true, "nota": true,  "cantidad": true  }
          ]
        }
      },
      {
        "id": "diagnosticos",
        "section": "conducta.diagnosticos",
        "label": "Diagnósticos",
        "visible": true,
        "required": false,
        "type": "select",
        "customProperties": {}
      }
    ]
  }
]

Tipos de campo

Estructura del proyecto

EverestConfig/
├── Models/
│   ├── FieldType.cs
│   ├── FieldConfig.cs
│   ├── FieldConfigRaw.cs          — internal, incluye epsId/contratoId para deserialización
│   ├── SectionConfig.cs
│   └── EverestConfigEntry.cs      — internal
├── Converters/
│   └── IntOrArrayConverter.cs     — deserializa null/1/[1,21] → int[]?
├── Services/
│   ├── IEverestConfigService.cs
│   └── EverestConfigService.cs
├── Validators/
│   ├── ValidationResult.cs
│   └── FieldValidator.cs
└── Extensions/
    └── ServiceCollectionExtensions.cs

Licencia

MIT