Saltar a contenido

VPS Governance Platform v1

Esto es el mapa vivo del VPS.

Su objetivo es dejar una autoridad documental simple, mantenible y trazable para todo el servidor, no solo para OpenClaw.

Sirve para cuatro cosas:

  • que Gabi pueda entender que corre en el VPS
  • que una IA pueda consultar el estado documental sin adivinar
  • que un admin pueda operar, mantener y restaurar servicios
  • que ningun servicio nuevo se considere terminado sin quedar documentado aqui
  • que exista una lectura por niveles para pasar de vista general a detalle

Alcance

Esta carpeta gobierna:

  • servicios
  • aplicaciones
  • bases de datos
  • redes
  • volumenes
  • dominios
  • puertos
  • backups
  • tests
  • usuarios operativos
  • runbooks
  • auditorias
  • matriz de regresion
  • estado de validacion
  • control tower ejecutivo
  • operacion diaria
  • monitoreo operativo
  • mantenimiento
  • updates
  • seguridad
  • preguntas de administracion asistida por IA
  • plataforma documental viva O6 para infraestructura y drill-down

Regla madre

Ningun servicio nuevo se considera terminado si no actualiza Governance.

Como usar esta carpeta

  1. Empezar por INDEX.md.
  2. Revisar el catalogo maestro en CATALOG.md.
  3. Abrir el servicio correspondiente en services/.
  4. Si el cambio afecta operacion, validar las preguntas de CHANGE-GATES.md.
  5. Si el cambio afecta validacion o riesgo, revisar REGRESSION-MATRIX.md y catalog/TESTS.md.
  6. Si el cambio afecta operacion o seguridad, revisar operations/ y security/.
  7. Si se incorpora algo nuevo, usar las plantillas de esta carpeta.
  8. Si hace falta entender la infraestructura real por niveles, entrar a knowledge/.

Regla de despliegue futuro

La estructura esta preparada para poder copiarse o sincronizarse mas adelante en /opt/governance, pero en esta etapa no se copia nada al VPS.

Limites

  • No documentar secretos.
  • No guardar tokens, claves, passwords ni .env reales.
  • Cuando falte evidencia, declarar pendiente de validar en vez de inventar.
  • Toda respuesta para admin debe estar escrita en lenguaje claro, amable y simple.