Añadir homelab/platform-40/README.md

homelab/platform-40/README.md

@@ -0,0 +1,73 @@
+# Plataforma: platform-40
+
+## Qué es
+
+`platform-40` es la pieza central del plano de datos de MESAVAULT.
+
+No es una VM más ni un simple servidor Docker. Es la plataforma backend donde viven:
+
+- el stack base de datos y servicios
+- Grafana
+- MinIO
+- Mosquitto
+- Portainer
+- ChirpStack core
+- las verticales de procesamiento
+- la lógica backend de soluciones como drenaje NGS
+
+## Papel dentro de la arquitectura
+
+La arquitectura consolidada separa claramente:
+
+- **OVH** como frontera pública, identidad y publicación web
+- **platform-40** como backend real, plano de datos y servicios internos
+
+En el caso del drenaje, esta separación quedó cerrada así:
+
+- dashboard del cliente en OVH
+- control, datos y lógica en `platform-40`
+- nodo físico aguas abajo vía ChirpStack
+
+## Estructura base del host
+
+### Stack base
+- `/srv/platform`
+
+### ChirpStack
+- `/srv/chirpstack`
+
+### Verticales
+- `/srv/verticals`
+
+## Filosofía de uso
+
+`platform-40` debe tratarse como base reproducible del plano de datos.
+
+No debe convertirse en frontal público de cliente.
+
+No debe exponerse alegremente en `0.0.0.0` si Tailscale está presente.
+
+## Qué sí pertenece a esta carpeta de Gitea
+
+- documentación técnica de la plataforma
+- inventario de servicios y puertos
+- rutas clave
+- forma correcta de operar y reiniciar
+- advertencias críticas
+- referencias cruzadas a verticales que viven sobre esta plataforma
+
+## Qué no pertenece aquí como elemento principal
+
+- dashboards de cliente en OVH
+- routing público de Traefik
+- Authentik
+- configuración singular de un tenant externo
+- secretos o credenciales reales
+
+## Referencias cruzadas
+
+- vertical de drenaje: `30-verticals/climate-drainage-ngs/`
+- kit físico de drenaje: `25-kits/lsn50-v2-xkc-y25-v-drainage/`
+- frontal público: `10-platforms/ovh-cloud/`
+- BookStack: `pendiente_de_crear`
+- Vaultwarden: `pendiente_de_crear`