From d598303b5421783aff29d0a287241c0b8a40aac4 Mon Sep 17 00:00:00 2001
From: "victor.fraile" <victor.fraile@mesavault.es>
Date: Wed, 25 Mar 2026 16:15:49 +0000
Subject: [PATCH] =?UTF-8?q?A=C3=B1adir=20homelab/platform-40/README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 homelab/platform-40/README.md | 73 +++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 homelab/platform-40/README.md

diff --git a/homelab/platform-40/README.md b/homelab/platform-40/README.md
new file mode 100644
index 0000000..08e2c70
--- /dev/null
+++ b/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`
\ No newline at end of file