DDD en Web: Bounded Contexts y Entidades con TypeScript
1. Introducción al Problema Técnico
En el desarrollo de aplicaciones web complejas, el crecimiento del modelo de datos suele derivar en una “gran bola de barro” (Big Ball of Mud). Un síntoma común es la creación de modelos omnipresentes. Por ejemplo, una entidad User o Order que acumula campos y lógica de negocio pertenecientes a autenticación, facturación, envíos y soporte al cliente dentro de un mismo esquema de base de datos y modelo de objetos.
Este acoplamiento estructural genera efectos secundarios imprevistos al modificar lógica de negocio, dificulta el escalado del equipo y penaliza el rendimiento. Domain-Driven Design (DDD) resuelve este problema mediante la segmentación del dominio en modelos conceptuales delimitados (Bounded Contexts) y el aislamiento de la lógica de negocio en modelos ricos (Entidades).
2. Conceptos Clave & Arquitectura
Para aplicar DDD en entornos web modernos con lenguajes como TypeScript 5+, es fundamental diferenciar los límites del contexto y el rol de las entidades dentro de la arquitectura en capas.
Bounded Contexts (Contextos Delimitados)
Un Bounded Context es la frontera explícita dentro de la cual existe un modelo de dominio específico. El término “Usuario” no significa lo mismo en todos los contextos:
- Contexto de Autenticación: Representa credenciales, roles y tokens de sesión.
- Contexto de Facturación: Representa un cliente con dirección fiscal, historial de pagos y método de cobro.
- Contexto de Envíos: Representa un destinatario con dirección física e instrucciones de entrega.
Intentar unificar estas visiones en un solo modelo destruye la mantenibilidad. Cada Bounded Context define su propio lenguaje ubicuo (Ubiquitous Language) y sus propios modelos de datos.
Entidades y Modelos Ricos
A diferencia de los modelos anémicos (simples estructuras de datos con getters y setters procesadas por servicios externos), una Entidad en DDD encapsula identidad, estado y reglas de negocio.
- Identidad: Una entidad se define por un identificador único que permanece inmutable a lo largo del tiempo, no por sus atributos.
- Invariantes de Negocio: La entidad es responsable de garantizar que su estado sea siempre válido. Ninguna modificación de estado debe ocurrir sin validar las reglas de dominio dentro del límite de la entidad.
Flujo de Ejecución en una Arquitectura Hexagonal
Para mantener los Bounded Contexts limpios, la interacción entre capas sigue este flujo estructurado:
- Recepción de Solicitud: Un controlador HTTP (API Gateway o Router) recibe el DTO de entrada.
- Orquestación de Aplicación: Un servicio de aplicación (Use Case) traduce la petición y consulta la entidad a través de un puerto de repositorio.
- Ejecución del Dominio: La entidad de dominio ejecuta el método de negocio, validando sus invariantes internamente.
- Persistencia: El servicio de aplicación utiliza la implementación concreta del repositorio (infraestructura) para guardar el nuevo estado.
- Respuesta: El caso de uso devuelve un DTO purgado hacia la capa de presentación.
3. Ejemplos de Código Real
A continuación se muestra la implementación de un Bounded Context de ventas utilizando TypeScript 5.x. Se implementa un Value Object para la identidad fuertemente tipada y una Entidad rica que protege sus invariantes.
Definición del Identificador Único (Value Object)
export class OrderId {
private readonly value: string;
constructor(value: string) {
if (!value || value.trim().length === 0) {
throw new Error('OrderId no puede estar vacío.');
}
this.value = value;
}
public toString(): string {
return this.value;
}
}
Entidad de Dominio Rica (Bounded Context de Ventas)
export enum OrderStatus {
DRAFT = 'DRAFT',
CONFIRMED = 'CONFIRMED',
CANCELLED = 'CANCELLED',
}
export class Order {
private readonly id: OrderId;
private status: OrderStatus;
private items: Array<{ productId: string; price: number }>;
constructor(id: OrderId) {
this.id = id;
this.status = OrderStatus.DRAFT;
this.items = [];
}
public addItem(productId: string, price: number): void {
if (this.status !== OrderStatus.DRAFT) {
throw new Error(
'No se pueden añadir items a un pedido confirmado o cancelado.'
);
}
if (price <= 0) throw new Error('El precio debe ser mayor a cero.');
this.items.push({ productId, price });
}
public confirm(): void {
if (this.items.length === 0) {
throw new Error('No se puede confirmar un pedido sin elementos.');
}
this.status = OrderStatus.CONFIRMED;
}
public getStatus(): OrderStatus {
return this.status;
}
public getId(): OrderId {
return this.id;
}
}
En este snippet, la entidad Order no permite mutaciones directas de sus atributos. Las transiciones de estado (addItem, confirm) están protegidas por reglas explícitas de negocio.
4. Ventajas, Desafíos y Trade-offs Técnicos
Ventajas
- Desacoplamiento Operativo: Modificar el esquema de datos del contexto de Facturación no rompe el modelo del contexto de Envíos.
- Código Self-Documenting: La lógica de negocio está centralizada en las entidades y no dispersa en controladores o servicios de base de datos.
- Refactorización Segura: Los test unitarios se enfocan en las reglas de dominio sin necesidad de simular bases de datos o llamadas I/O.
Desafíos y Trade-offs
- Sobrecarga de Código (Boilerplate): Requiere traducir objetos entre capas (DTOs, Entidades de Dominio, Modelos de ORM como Prisma o TypeORM).
- Curva de Aprendizaje: Exige al equipo alinear la jerga técnica con la jerga del negocio, lo que requiere disciplina en las revisiones de código.
- Complejidad Inicial: En proyectos sencillos o aplicaciones puramente CRUD, DDD introduce abstracciones innecesarias que reducen la velocidad de entrega inicial.
Matriz de Decisión
- Utilizar DDD y Bounded Contexts cuando: La aplicación cuenta con múltiples flujos de trabajo complejos, reglas de negocio cambiantes y equipos interdisciplinarios trabajando en paralelo sobre el mismo dominio.
- Evitar DDD cuando: Se trata de una interfaz administrativa básica, un microservicio de paso de datos, o una API donde las operaciones son 100% lectura/escritura sin validaciones cruzadas.
5. Conclusión y Perspectivas Futuras
Domain-Driven Design no es una arquitectura de software en sí misma, sino un enfoque metodológico para gestionar la complejidad del dominio. La separación en Bounded Contexts y el uso de Entidades ricas permiten construir aplicaciones web preparadas para escalar tanto en volumen de código como en organización de equipos.
Con la evolución del desarrollo web hacia sistemas distribuidos, arquitecturas impulsadas por eventos (Event-Driven Architecture) y microfrontends, los Bounded Contexts sirven como el límite natural para definir microservicios o módulos independientes. Implementar DDD en la capa de backend con TypeScript garantiza un tipado estricto y un dominio protegido contra regresiones operativas en el tiempo.