Cayaqui.MPS.Metadata 0.1.0

Cayaqui.MPS.Metadata

Zero-dependency attributes + resolver para decorar DTOs con metadata consumida por web grids, Cayaqui.MPS.Reports y Cayaqui.MPS.ExcelImport. Un solo decorado → tres usos consistentes.

Distribución propietaria — requiere contrato comercial con Cayaqui. Ver LICENSE.txt.

Instalación

dotnet add package Cayaqui.MPS.Metadata

builder.Services.AddMpsMetadata();  // registra IExtendedPropertyResolver singleton

Ejemplo

public sealed class ControlAccountDto
{
    [Label("Código CA")] [Wbs] [UpperCase]
    [NotEmpty] [MaxLength(20)] [RegularExpression(@"^[A-Z]{2,3}-\d{3,}$")]
    [ImportAlias("Code", "Control Account")]
    public string Code { get; set; } = "";

    [Currency("USD", 2)] [Money] [Align(TextAlign.Right)] [ColumnWidth(140)]
    public decimal Bac { get; set; }

    [Percentage(1)] [EvmIndicator(EvmKind.Cpi)] [EvmBand(green: 0.97, yellow: 0.90)]
    public decimal Cpi { get; set; }

    [Date("dd-MMM-yy")] [Schedule]
    public DateTime ControlDate { get; set; }

    [Badge]   // reads colors from BadgeEnum values
    public ProjectStatus Status { get; set; }

    [Mask(MaskKind.Email, visibleChars: 1)] [Tooltip("Owner email (masked)")]
    public string Owner { get; set; } = "";

    [Hidden]
    public Guid InternalId { get; set; }

    [ImportAlias("SPI", "Schedule Performance Index")]
    [ImportCulture("es-CL")]
    public decimal Spi { get; set; }
}

public enum ProjectStatus
{
    [BadgeColor(BadgeKind.Neutral)]  Draft,
    [BadgeColor(BadgeKind.Info)]     InReview,
    [BadgeColor(BadgeKind.Success)]  Approved,
    [BadgeColor(BadgeKind.Warning)]  OnHold,
    [BadgeColor(BadgeKind.Error)]    Cancelled
}

Los 37 atributos

Display

• [Label("text")] — override (reuse [Display(Name)] si existe)
• [Tooltip("text")] — tooltip específico
• [Placeholder("text")] — placeholder input Blazor
• Reusar [Display(Name, Description, Order, GroupName)] de DataAnnotations

Format

• [Currency("USD", 2)] — "USD 1,234.56"
• [Percentage(1)] — 0.756 → "75.6%"
• [Date("dd-MMM-yy")] — formato custom
• [Integer(thousands: true)] — "1,234,567"
• [DecimalFormat(decimals: 4)]
• [Duration(DurationUnit.Days)] — "5d", "3h", "15m"

Transform (no mutan el valor, sólo el display)

• [UpperCase] · [LowerCase] · [TitleCase]
• [Mask(MaskKind.Email, visibleChars: 1)] → "a********@cayaqui.com"
• [Mask(MaskKind.Email, visibleChars: 3)] → "ale******@cayaqui.com"
• [Mask(MaskKind.LastChars, visibleChars: 4)] → "******7890"
• [Truncate(30)]

Layout / Visibility

• [Align(TextAlign.Right)]
• [ColumnWidth(150)]
• [VisibleIn(RenderTargets.Web | RenderTargets.Report)]
• [Hidden] — shortcut de [VisibleIn(None)]
• [ReadOnlyDisplay]

Badge

• [Badge(BadgeKind.Success)] — fijo
• [Badge] + [BadgeColor(...)] en cada valor del enum — mapeado por valor

Validation (custom shortcuts — reuse DataAnnotations para el resto)

• [NotEmpty] — [Required(AllowEmptyStrings = false)]
• [Min(0)] / [Max(100)] — sugar sobre [Range]
• Reusar [Required], [MaxLength], [MinLength], [Range], [RegularExpression], [EmailAddress], [Phone], [Url]

EPC dominio

• [EvmIndicator(EvmKind.Cpi)] — renderer aplica íconos/colores contextuales
• [EvmBand(green: 0.95, yellow: 0.85)] — thresholds semaforo configurables
• [Wbs] · [Cbs] · [Schedule] · [Money] — markers semánticos

Import

• [ImportAlias("CPI", "Cost Performance Index")] — multi-header match
• [ImportIgnore]
• [ImportDefault(0)]
• [ImportCulture("es-CL")] — parsing locale
• [ImportColumn(3)] — opt-in por posición
• [ImportTrim(false)] — default true
• [ImportRegex(@"^[A-Z]+-\d+$")]

API del resolver

public interface IExtendedPropertyResolver
{
    PropertyMetadata? Get(Type dtoType, string propertyName);
    IReadOnlyList<PropertyMetadata> GetAll(Type dtoType);
    string? Format(object? value, Type dtoType, string propertyName, CultureInfo? culture = null);
    bool TryParse(string? text, Type dtoType, string propertyName, CultureInfo? culture, out object? value);
}

Cache por Type en primer acceso, thread-safe.

Requisitos

• .NET 10.0 o superior
• Zero dependencies externas (sólo Microsoft.Extensions.DependencyInjection.Abstractions para el extension method, que es BCL+)