Arquitectura¶
Diagramas y mapas de cómo se relacionan los servicios de SmallCountry. Dependencias, flujos de datos, topologías de red y decisiones registradas.
-
:material-diagram:{ .lg .middle } Diagramas
Todos los diagramas de la arquitectura en un solo lugar.
¿Qué tipo de diagramas hay?
Mapas del ecosistema general, dependencias entre servicios, flujos de datos, topologías física y lógica de la red. Cada uno con su propósito y audiencia. -
Mapa completo de dependencias entre servicios. Quién necesita a quién para funcionar.
¿Por qué es importante saber las dependencias?
Para saber qué servicios críticos hay que recuperar primero si algo falla. Authentik es la puerta de entrada — sin él, casi nada funciona. -
Cómo viajan los datos por el sistema: autenticación, telemetría, IoT, backups.
¿Qué flujos están documentados?
Autenticación OIDC, telemetría de sensores IoT, pipeline de observabilidad, backups entre nodos. Cada flujo con su diagrama y descripción paso a paso. -
Mapas físicos y lógicos de la red. Bridges, VLANs y conectividad entre nodos.
¿Cómo está segmentada la red?
Cuatro bridges de Proxmox en Ra y dos en Horus. Cada bridge define una zona de confianza distinta. El dominio.scunifica el direccionamiento independientemente del nodo físico. -
Decisiones arquitectónicas registradas. Por qué elegimos cada tecnología y cómo.
¿Qué decisiones están documentadas?
35 ADRs que cubren desde la elección de MQTT como bus de sensores hasta la separación de repositorios. Cada ADR explica el contexto, la decisión y las alternativas descartadas.