Version: 1.0
Fecha: 16 de Abril, 2026
Autor: Carlos Alberto Torres Camargo — Arquitecto de Software
Estado: EN VALIDACION (rama feature)
Documentacion completa de la migracion de infraestructura del backend DataVault: de conexion SSH/SFTP a servidor OAIS externo, hacia acceso local al filesystem compartido via volumenes Docker. Incluye diagnostico del problema, plan ejecutado, cambios realizados, informe tecnico de la solucion y guia de integracion para el equipo frontend.
| Aspecto |
Antes |
Despues |
| Conectividad OAIS |
SSH/SFTP via Paramiko a VM separada (192.168.0.33) |
Filesystem local via volumenes Docker compartidos |
| Gestion de daemons |
SSH exec_command a servidor remoto |
Docker API (docker-py) contra Docker Engine local |
| Patron de acceso |
SFTPClient acoplado en toda la aplicacion |
Facade RepositoryClient con factory STORAGE_MODE |
| Modelo ORM |
Tenant con 15 relationships huerfanas |
Tenant limpio, alineado a database-per-tenant |
| Despliegue |
Manual |
Scripts automatizados (deploy-centrica-dev.sh) |
| # |
Documento |
Descripcion |
| 1 |
Diagnostico del Problema |
Analisis forense del fallo de conectividad SSH/SFTP, hallazgos del modelo ORM roto y codigo muerto |
| 2 |
Plan de Migracion Ejecutado |
Plan de 4 ramas con inventario de archivos, cambios por rama y estrategia de merge |
| 3 |
Registro de Cambios Realizados |
Detalle tecnico de cada archivo modificado, creado o eliminado durante la migracion |
| 4 |
Informe Tecnico — Arquitectura Docker Integrada |
Documentacion de la arquitectura actual: patron facade, Docker API, volumenes compartidos, auditorias y validaciones |
| 5 |
Guia de Integracion Frontend |
Instrucciones para el equipo frontend: nueva URL base, endpoints disponibles, autenticacion JWT y ejemplos de consumo |
| 6 |
Guia Operativa Servidor OAIS |
Procedimientos de monitoreo, revision de logs, inspeccion de carpetas, scripts de diagnostico, volumen de preservacion y checklist diario |
1. Diagnostico (entender el problema)
|
v
2. Plan de Migracion (entender la estrategia)
|
v
3. Registro de Cambios (que se hizo exactamente)
|
v
4. Informe Tecnico (como funciona ahora)
|
v
5. Guia Frontend (como consumir la API)
|
v
6. Guia Operativa (como monitorear y diagnosticar en produccion)
| Item |
Estado |
| Codigo en rama feature |
Validado en entorno dev |
| Auditoria forense |
Completada — 0 bugs criticos pendientes |
| Merge a develop |
Pendiente aprobacion |
| Merge a main |
Pendiente post-validacion UAT |
Nota: Todos los cambios se encuentran actualmente en una rama feature/ que esta siendo validada antes de su merge a develop. Este documento se actualizara cuando se complete el merge.
| Version |
Fecha |
Autor |
Descripcion |
| 1.0.0 |
2026-04-16 |
Carlos Torres |
Creacion del indice de subseccion con 5 documentos |
| 1.1.0 |
2026-04-20 |
Carlos Torres |
Agregar documento 6: Guia Operativa Servidor OAIS (monitoreo, logs, volumen preservacion) |
Departamento de Arquitectura — Centrica Soluciones