Tutorial: Restauración Plena del Ecosistema

Guía visual paso a paso (One-Click) ante un escenario de desastre.

Regla 1 indispensable antes de empezar

Túneles y WhatsApp se prenden siempre al final y con el servidor viejo apagado. Si dos máquinas compartieran el túnel partirían el tráfico al azar; dos instancias de WhatsApp con la misma sesión enviarían mensajes duplicados a los clientes. La activación requiere escribir exactamente «el servidor viejo está apagado».

flowchart TD A[Catástrofe: Servidor Afectado] --> B(Conectar Disco BACKUP OFF LINE) B --> C[Ejecutar RECUPERACION_TOTAL_1_CLIC.bat] C --> D[Instala: PostgreSQL 18, Python, Node desde Kit] C --> E[Restaura: Base Física, Código y .env] C --> F[Levanta: Servicios en Modo Restauración] D & E & F --> G((Servidor en Contingencia Local)) G --> H[Paso Final: ACTIVAR_TUNELES_Y_WHATSAPP.bat] H --> I((Producción en Línea))
1

Conectar el Hardware

Conseguí una PC de reemplazo (con Windows 10/11 de 64 bits o Windows Server). Conectá el disco externo etiquetado como BACKUP OFF LINE (desbloqueá BitLocker con la clave guardada en papel). Si Windows le asigna una letra distinta a E:, usá esa letra asignada.

2

Localizar el Asistente One-Click

Abrí el Explorador de Archivos y navegá a la carpeta de la caja versionada más reciente:

VEKTRA_OFFLINE\<fecha>\03_caja_instalacion

No hace falta descomprimir manualmente nada: la caja contiene todo listo para ejecutar.

3

Ejecutar el Asistente

Hacé clic derecho sobre RECUPERACION_TOTAL_1_CLIC.bat y seleccioná "Ejecutar como Administrador". Confirmá los permisos de Control de Cuentas de Usuario de Windows.

4

Restauración 100% Offline (Sin Conexión a Internet)

El asistente trabaja completamente sin internet. Instala PostgreSQL 18, Python 3.14/3.12 y Node 24 desde 04_kit_instalacion\instaladores y las dependencias compiladas desde wheelhouse\. Restaura la base física y los repositorios, y registra los servicios NSSM con VEKTRA_MODO_RESTAURACION=1 (sin cobros, avisos automáticos, IA ni respaldos externos).

5

Verificar en Local

Abrí el navegador en la misma máquina e ingresá a http://127.0.0.1:8005 (Hub) y http://127.0.0.1:8002 (ERP). En /api/ping y /health confirmá que figure "modo_restauracion": true y comprobá los datos del día del respaldo.

6

Paso Final: Conmutar Tráfico y WhatsApp

Una vez confirmado fehacientemente que el servidor anterior está apagado, ejecutá en la carpeta de la caja el script ACTIVAR_TUNELES_Y_WHATSAPP.bat. Al escribir «el servidor viejo está apagado» se iniciarán los túneles Cloudflare y el bot de WhatsApp para recibir a los clientes.

¿El servidor original fue reparado? (Failback)

Para volver al servidor definitivo sin perder los datos operados durante la contingencia, ejecutá EMPAQUETAR_PARA_SERVIDOR_DEFINITIVO.bat en la PC temporal, mové el disco al servidor reparado y ahí ejecutá MIGRAR_A_SERVIDOR_DEFINITIVO.bat.