02. Arquitectura¶
La arquitectura describe cómo fue construida la plataforma. Contiene una descripción de todos los componentes de la solución a diferentes escalas y puntos de vista.
Esta sección sigue las guías del Modelo C4 (Brown, 2018) para definir la arquitectura de los sistemas en diferentes niveles:
- Nivel 1: Contexto del Sistema — En el nivel más alto, el Diagrama de Contexto representa el sistema como una caja rodeada por sus entidades externas.
- Nivel 2: Contenedores — Los Diagramas de Contenedores se enfocan en las principales aplicaciones de software dentro del sistema.
- Nivel 3: Componentes — Proporciona una vista detallada de los elementos internos dentro de cada contenedor.
Principios de Arquitectura¶
| Principio | Descripción |
|---|---|
| Modularidad | Cada capacidad es un repositorio separado con límites claros. |
| Separación de Responsabilidades | Frontend, API, ORM y ETLs tienen roles distintos. |
| Fuente de Verdad | El paquete ORM es la definición autoritaria del modelo de datos. |
| API-First | Todo acceso a datos se media a través de la WebAPI. |
| Aislamiento de Tuberías | Los ETLs operan independientemente y se comunican via BD. |