Organización por responsabilidad
La instalación actual usa /srv/stt como raíz. La herramienta de preparación consume una raíz, un identificador de proyecto y un entorno explícitos; esas rutas no forman parte de la lógica de los sistemas.
| Directorio relativo | Contenido |
|---|---|
servicios/ |
Fuentes y recursos de cada servicio |
configuraciones/ |
Perfiles por servicio y entorno |
datos/ |
Persistencia por servicio |
respaldos/ |
Copias y material de recuperación |
secretos/ |
Credenciales privadas cuando corresponda |
infraestructura/ |
Integración con Nginx y Docker |
operaciones/ |
Herramientas y registros de operación |
documentacion/ |
Artefactos publicados de documentación |
Instancia de documentación
Docsite mantiene su checkout privado en servicios/docsite/repositorio. Su perfil reside en configuraciones/docsite/prod/.
Los archivos públicos se copian a documentacion/docsite/releases/<commit>/. El enlace documentacion/docsite/public selecciona la versión activa. Nginx sirve únicamente ese compilado; no expone fuentes, historial Git, configuración ni credenciales.
Los registros privados de publicación están en operaciones/docsite/prod/. Las credenciales SSH pertenecen al usuario de despliegue y tienen acceso restringido.
Precarga local
01-ProyectoSTT organiza los sistemas que se preparan antes de su despliegue. Documentacion/docsite es un repositorio independiente. Las áreas LMS y LRS no son dependencias de compilación del sitio.
Reutilizar un sistema no implica trasladar datos o secretos de otra instalación.
Respaldos
La estructura reserva un área de respaldos. Esto no equivale a una política programada o a una restauración probada.
La documentación puede reconstruirse desde Git y conserva versiones publicadas para retorno rápido. Las configuraciones privadas y las credenciales necesitan su propio respaldo protegido antes de poder declarar una recuperación completa de la VPS.