Arquitectura
Explora la estructura completa del sistema, sus capas, responsabilidades, relaciones y decisiones principales.
Una arquitectura no es solo un diagrama bonito. Es una forma de organizar responsabilidades, limitar el acoplamiento y preparar el sistema para evolucionar con mayor control.
En esta sección verás cómo se distribuyen las capacidades entre frontend, gateway, BFF, microservicios, eventos, integraciones y sistemas de datos.
En vidéo
Guía Completa de Arquitectura Limpia: SOLID y software robusto
Qué encontrarás aquí
Visión general
Una lectura global de la arquitectura, sus objetivos y la relación entre capas.
Capas
Una explicación individual de cada capa: Frontend, API Gateway, BFF, Microservicios, Event Bus, ACL y Data / External Systems.
Shared Kernel y contratos
Qué se puede compartir, qué no conviene compartir y cómo evitar acoplamiento innecesario.
Repositorios
Cómo se organiza la solución en un modelo multi-repo y qué responsabilidades tiene cada repositorio.
¿Por qué esta arquitectura?
A medida que un sistema crece, también crecen:
- la cantidad de reglas de negocio
- el número de integraciones externas
- la necesidad de escalar partes concretas
- la complejidad operativa
- la cantidad de equipos involucrados
Una arquitectura por capas y por dominios ayuda a manejar esa complejidad separando responsabilidades y haciendo explícitos los límites del sistema.
Navegación por capas
Visión general de la arquitectura
Resumen de una arquitectura multi-repositorio organizada en capas para separar responsabilidades, facilitar evolución y escalar con mayor control.
Frontend
La capa donde vive la interfaz de usuario, la interacción con el cliente y el consumo inicial del sistema.
API Gateway
La puerta de entrada del sistema, encargada de preocupaciones transversales como autenticación, routing y control del tráfico.
BFF
Una capa que adapta el backend a las necesidades del frontend, agregando y transformando datos para mejorar la experiencia del cliente.
Microservicios
Servicios independientes organizados por dominio, responsables de la lógica de negocio, la persistencia y los eventos principales del sistema.
Event Bus
La infraestructura que permite comunicación asíncrona entre servicios mediante eventos.
ACL
La Anti-Corruption Layer protege el dominio frente a sistemas externos, modelos legacy y contratos que no deberían filtrarse al core del negocio.
Data / External Systems
La capa donde viven las bases de datos, cachés, sistemas heredados y proveedores externos que sostienen o complementan la operación del sistema.
Shared Kernel y contratos
Qué elementos conviene compartir entre repositorios y servicios, y cómo evitar que lo compartido se convierta en una fuente de acoplamiento.
Repositorios
Cómo se distribuyen las responsabilidades de la solución en múltiples repositorios y por qué esa separación puede ser útil.