Cosmos.Types.Contactos 1.1.1

Cosmos.Types.Contactos

Contacto — Value Object de contacto para el ERP Cosmos: nombre, rol (catálogo embebido de 7 roles) y al menos un medio de comunicación (correos y/o teléfonos). Viaja dentro de eventos event-sourced (JSONB) aguas abajo, por lo que su forma serializada es un contrato estable.

Instalación

dotnet add package Cosmos.Types.Contactos

Construcción

Dos tipos, dos puertas distintas:

• Rol es un VO de catálogo: se obtiene con Rol.Obtener(codigo), que lanza ArgumentException si el código no existe/activo en el vocabulario. Su Crear es internal.
• Contacto es un VO compuesto: su factory pública Crear(...) : Result<Contacto> valida sin lanzar (EsExitoso / .Valor / .Errores).

using Cosmos.Types.Contactos;
using Cosmos.Types.CorreosElectronicos;
using Cosmos.Types.Telefonos;

var correo = CorreoElectronico.Crear("ventas@acme.co").Valor;
var telefono = Telefono.Crear("+57", "3001234567").Valor;
var rol = Rol.Obtener("comercial");   // VO de catálogo: Obtener (lanza)

var resultado = Contacto.Crear(        // VO compuesto: Crear (Result)
    nombre: "Acme S.A.S.",
    rol: rol,
    correos: [correo],
    telefonos: [telefono]);

if (resultado.EsExitoso)
    UsarContacto(resultado.Valor);
else
    foreach (var error in resultado.Errores)
        Console.WriteLine(error.Codigo);   // V01 (sin medios), V04 (nombre), V05 (duplicados)

El rol llega como Rol tipado (no un string): su obligatoriedad y validez quedan implícitas en el tipo. Los medios (correos/teléfonos) llegan ya válidos; Contacto los compone sin revalidar sus formatos. Un contacto sin ningún correo ni teléfono es inválido.

Forma serializada

{
  "nombre": "Acme S.A.S.",
  "rol": { "codigo": "comercial" },
  "correos": [ { "valor": "ventas@acme.co" } ],
  "telefonos": [ { "indicativoPais": "+57", "numero": "3001234567" } ]
}

Las claves son camelCase ancladas con [JsonPropertyName]; el rol anidado y los medios de las colecciones componen sus propias formas serializadas. El Nombre del rol es un accessor derivado [JsonIgnore]: no viaja.

Rehidratación (deserialización)

No requiere setup: ni JsonConverter ni JsonSerializerContext registrados; basta el STJ por defecto. Al deserializar un evento histórico el VO se rehidrata crudo ([JsonConstructor]), sin validar — un contacto que ya no cumple "al menos un medio", o cuyo rol fue retirado del vocabulario, igual se rehidrata.

Listado

Para poblar un selector de roles (frontends) usá Rol.Listar() — devuelve los mismos Rol que consume la escritura. El backend proyecta su propio DTO de API:

var rolesDto = Rol.Listar().Select(rol => new { rol.Codigo, rol.Nombre });

Dependencias

• Cosmos.Types.Abstractions (kernel: Result<T>)
• Cosmos.Types.CorreosElectronicos
• Cosmos.Types.Telefonos

Requiere net10.0.

Documentación

• Convenciones de los nuggets

Licencia

Uso interno del ERP Cosmos.