Modelando el dominio

Entidades

Una entidad es un objeto definido principalmente por su identidad y no solo por sus atributos. Aunque los atributos cambien con el tiempo, la identidad de una entidad permanece igual.

Características principales:

• Tiene una identidad única (generalmente un Id).
• Lo que importa es quién es la entidad, no solo qué contiene.
• Sus atributos pueden cambiar con el tiempo.

Creando una entidad con Lino

Para crear una nueva entidad utilizando Lino, ejecute:

lino entity new

El asistente del CLI solicitará:

• Servicio – Servicio en el que se creará la entidad.
• Módulo – Módulo donde se creará la entidad (solo en servicios modulares).
• Nombre de la entidad – Nombre usado en el dominio y en la tabla de la base de datos.

Luego, definirás los campos que componen la entidad configurando cada uno de ellos.

Tipos de campos disponibles

Ejemplo

Creando la entidad Person:

┌────┬────┬───────────────┬────────┬────────┬───────────┬────────────────┐
│ PK │ FK │ Property name │ Type   │ Length │ Required  │ Auto-increment │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│ x  │    │ Id            │ int    │        │     x     │       x        │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│    │    │ Name          │ string │  100   │     x     │                │
└────┴────┴───────────────┴────────┴────────┴───────────┴────────────────┘

Estructura generada por Lino:

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Errors/
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

Después de definir tus entidades, usa Lino para gestionar las Migrations y mantener la base de datos sincronizada. Este proceso se abordará en detalle en la sección Capa de Persistencia.

Flujo actual de evolución

Además del flujo interactivo con lino entity new, la CLI también permite dejar explícita la intención en el comando cuando el servicio, el módulo y el nombre ya se conocen:

lino entity new --name <EntityName> --service <ServiceName> --module <ModuleName>
lino entity edit --service <ServiceName> --module <ModuleName> --entity <EntityName>
lino entity list --service <ServiceName> --module <ModuleName>

Use entity list antes de crear nuevos conceptos en módulos grandes. Durante la edición, revise identificador, propiedades, obligatoriedad, longitud, relaciones, índices, ownership, tenant e impacto en migrations.

Strongly Typed IDs, ownership e invariantes

Cuando Strongly Typed IDs están habilitados, el identificador pasa a ser un tipo dedicado, como ProductId, reduciendo intercambios accidentales entre IDs de entidades diferentes. Las relaciones deben reflejar el ownership real del dominio: no toda referencia necesita convertirse en navegación directa; en muchos casos, un identificador, shadow entity, evento de integración o consulta explícita protege mejor el límite entre módulos.

Coloque las invariantes en el dominio, no solo en la UI, en la base de datos o en validators. Después de cambiar entidades, ejecute un build, revise el diff y genere o actualice migrations.

Value Objects

Un Value Object representa un concepto del dominio definido únicamente por sus atributos – no posee identidad propia. Dos Value Objects se consideran iguales si todos sus valores son iguales.

Características principales:

• Inmutables después de la creación.
• No poseen Id.

Creando un Value Object con Lino

Ejecute:

lino value-object new

El CLI solicitará:

• Servicio – Servicio en el que se creará el objeto.
• Módulo – Módulo en el que se creará el objeto (solo en servicios modulares).
• Ubicación – Raíz del dominio o agregado específico.
• Nombre del Value Object.

Luego, defina los campos que componen el objeto.

Tipos de campos disponibles

Ejemplo

Value Object Address:

┌───────────────┬────────┬────────┬───────────┐
│ Property name │ Type   │ Length │ Required  │
├───────────────┼────────┼────────┼───────────┤
│ Street        │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Number        │ string │   10   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Neighborhood  │ string │   50   │           │
├───────────────┼────────┼────────┼───────────┤
│ City          │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ State         │ string │   2    │     x     │
├───────────────┼────────┼────────┼───────────┤
│ PostalCode    │ string │   20   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Country       │ string │  100   │     x     │
└───────────────┴────────┴────────┴───────────┘

Estructura de archivos generada (agregado Person):

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

Así como en las entidades, las Migrations pueden ser gestionadas por Lino para mantener el modelo de datos sincronizado.

Flujo actual de evolución

Además del comando interactivo, use parámetros cuando ya sepa dónde debe nacer el concepto:

lino value-object new --name <ValueObjectName> --service <ServiceName> --module <ModuleName>
lino value-object edit --service <ServiceName> --module <ModuleName> --value-object <ValueObjectName>
lino value-object list --service <ServiceName> --module <ModuleName>

Cuando una propiedad de entidad se declara como ValueObject, Lino puede reutilizar un Value Object existente o crear uno nuevo durante el modelado de la entidad. Prefiera esta opción cuando el conjunto de campos represente un único concepto, como dinero, dirección, dimensiones, período o documento.

Persistencia, UI y localización

Lino mapea propiedades de Value Objects mediante la capa de persistencia del módulo y lleva metadatos de visualización a resources. Esto permite labels y mensajes localizados para valores anidados. El Value Object pertenece al módulo donde fue generado; no se convierte en un contrato compartido entre módulos sin una integración explícita.

Proteja las invariantes en el propio tipo: valores negativos, moneda inválida, períodos invertidos o documentos mal formados no deben nacer válidos.

Enumeraciones

Las enumeraciones en DDD pueden ir más allá de los enum tradicionales de C#. Pueden ser objetos ricos que representan estados fijos, conteniendo validaciones, métodos auxiliares e incluso comportamiento.

Motivación:

• Los enum de C# están limitados a un valor entero o cadena.
• Modelar una Enumeración como clase ofrece mayor flexibilidad y expresividad.

Características principales:

• Son clases que heredan de una base común y encapsulan Id y Nombre.
• Permiten agregar validaciones, métodos auxiliares y comportamiento.

Creando una enumeración con Lino

Ejecute:

lino enumeration new

El asistente solicitará:

• Servicio.
• Módulo (si aplica).
• Ubicación – raíz del dominio o agregado.
• Nombre de la enumeración.
• Tipo – enum tradicional o Smart Enum (class).
• Almacenamiento – int o string en la base de datos.

Ejemplo

Enumeración PersonStatus:

┌───────┬───────────┬──────────────┐
│ Value │ Name      │ Display Name │
├───────┼───────────┼──────────────┤
│ 1     │ Active    │ Active       │
├───────┼───────────┼──────────────┤
│ 2     │ Inactive  │ Inactive     │
├───────┼───────────┼──────────────┤
│ 3     │ Suspended │ Suspended    │
├───────┼───────────┼──────────────┤
│ 4     │ Deleted   │ Deleted      │
└───────┴───────────┴──────────────┘

Estructura generada:

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Enums/
                        │   └── PersonStatus.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            ├── Person/
                            │   ├── PersonResources.resx
                            │   ├── PersonResources.en.resx
                            │   └── PersonResources.pt-BR.resx
                            └── PersonStatus/
                                ├── PersonStatusResources.resx
                                ├── PersonStatusResources.en.resx
                                └── PersonStatusResources.pt-BR.resx

Almacenar el valor de una enumeración como string es válido y puede mejorar la legibilidad, pero suele ser menos eficiente en términos de rendimiento y almacenamiento. Por eso recomendamos almacenar el valor como int, y para mantener la integridad referencial y facilitar el mantenimiento, crear una entidad (tabla) auxiliar donde la clave primaria corresponda al valor de la enumeración.

Después de definir las enumeraciones, use Lino para generar y aplicar las Migrations, asegurando que la base de datos refleje el modelo de dominio. Vea detalles en la sección Capa de Persistencia.

Flujo actual de evolución

Además del comando interactivo, use parámetros cuando la ubicación y el nombre ya estén definidos:

lino enumeration new --name <EnumerationName> --service <ServiceName> --module <ModuleName>
lino enumeration edit --service <ServiceName> --module <ModuleName> --enumeration <EnumerationName>
lino enumeration list --service <ServiceName> --module <ModuleName>

Enumeration, entidad o configuración

Si la enumeration expone un nombre de visualización, Lino puede generar resources para labels localizados. Si se persiste o se usa como seed data, revise migrations después de agregar, eliminar o renombrar valores. La consistencia entre código, base de datos y UI forma parte del cambio de dominio.