Añadir homelab/platform-40/docs/arquitectura.md

homelab/platform-40/docs/arquitectura.md

@@ -0,0 +1,79 @@
+# Arquitectura
+
+## Papel de platform-40
+
+`platform-40` es la pieza central del plano de datos de MESAVAULT.
+
+No debe tratarse como frontal web de cliente.
+
+Su papel es alojar:
+
+- stack base de datos y servicios
+- broker MQTT interno
+- ChirpStack core
+- PostgreSQL
+- verticales activas
+- servicios auxiliares de control y persistencia
+
+## Separación correcta con OVH
+
+La arquitectura consolidada separa claramente dos planos:
+
+### OVH
+- frontera pública
+- publicación web
+- identidad
+- Traefik
+- Authentik
+- tenant Grafana del cliente
+- ingress LoRaWAN
+
+### platform-40
+- backend real
+- plano de datos
+- servicios internos
+- persistencia
+- control
+- telemetría
+- verticales MESAVAULT
+
+## Flujo LoRaWAN final consolidado
+
+Patrón final documentado:
+
+DLOS8N  
+→ `lora.mesavault.es`  
+→ VPS OVH UDP 1700  
+→ ChirpStack Gateway Bridge  
+→ MQTT hacia `platform-40` por Tailscale  
+→ broker interno / ChirpStack core en `platform-40`
+
+## Arquitectura interna base
+
+### `/srv/platform`
+Stack base:
+- Grafana
+- MinIO
+- Mosquitto
+- Portainer
+
+### `/srv/chirpstack`
+Stack ChirpStack:
+- `cs_chirpstack`
+- `cs_postgres`
+- `cs_redis`
+
+### `/srv/verticals`
+Patrón de verticales:
+- una carpeta por vertical
+- compose propio
+- template base disponible
+
+## Caso drenaje
+
+En la vertical de drenaje:
+- OVH publica y autentica
+- `platform-40` ejecuta y persiste
+- el dashboard del cliente vive en OVH
+- la lógica real vive aquí
+- `drain-control` se publica localmente en `192.168.40.100:8088`