Guía de despliegue del worker MasterGantt Sync

Arquitectura

El worker utiliza Cloudflare Durable Objects para el WebSocket en tiempo real. Cada «sala» de colaboración = 1 Durable Object con conexiones WebSocket persistentes. Los cambios se transmiten al instante (<1 segundo) a todos los colaboradores.

El servidor solo ve blobs cifrados con AES-256-GCM — sin conocimiento de los datos.

Requisitos previos

• Una cuenta de Cloudflare con Workers Paid (5 $/mes) — necesaria para los Durable Objects
• Node.js instalado

Despliegue inicial (10 minutos)

1. Instalar Wrangler (CLI de Cloudflare)

npm install -g wrangler

2. Iniciar sesión

wrangler login

→ Abre el navegador, haz clic en «Allow»

3. Crear el namespace KV (almacenamiento de respaldo)

cd worker/
wrangler kv namespace create ROOMS

→ El comando muestra un ID. Actualiza wrangler.toml:

[[kv_namespaces]]
binding = "ROOMS"
id = "TU_ID_AQUI"

4. Desplegar el worker

wrangler deploy

→ Muestra la URL del worker: https://mg-sync.TU-SUBDOMINIO.workers.dev

5. Probar

curl "https://mg-sync.TU-SUBDOMINIO.workers.dev/room/test/presence?client=test1"
# Debe devolver: {"count":0}

6. Configurar MasterGantt

La URL del worker ya está rellenada en MasterGantt (Configuración → Colaboración → Servidor). Para utilizar tu propio worker, sustituye la URL.

Actualización del worker

Tras modificar sync-worker.js:

cd worker/
wrangler deploy

Eso es todo — el despliegue tarda unos 15 segundos.

Configuración actual (referencia)

Cuenta Cloudflare  : steevebecker
Subdominio         : mastergantt.workers.dev
URL del worker     : https://mg-sync.mastergantt.workers.dev
ID namespace KV    : c2fe1889c94b4d55ad68f9d244bd812f
Plan               : Workers Paid ($5/mes)

Archivos

Arquitectura técnica

Cliente A (navegador)        Cloudflare Worker         Cliente B (navegador)
     |                            |                          |
     |-- WebSocket connect ------>|                          |
     |                            |<-- WebSocket connect ----|
     |                            |                          |
     |-- WS: blob cifrado ------->|                          |
     |                       DO broadcast                    |
     |                            |---> WS: blob cifrado --->|
     |                            |         descifra + merge
     |                            |                          |

• Cada sala = 1 Durable Object (instancia persistente)
• Los blobs transitan a través de WebSocket (sin polling)
• El DO mantiene un conjunto de WebSockets y realiza broadcast a todos excepto al remitente
• Reconexión automática en el cliente tras 3 s de desconexión
• Fallback HTTP GET/POST si WebSocket no está disponible

Costes

Estimación realista: 10 usuarios activos × 8 h = ~0,05 $/día = ~1,50 $/mes de coste adicional.

Dominio personalizado (opcional)

Para utilizar sync.mastergantt.com:

1. Panel de Cloudflare → Workers → mg-sync → Triggers
2. Añadir Custom Domain: sync.mastergantt.com
3. Cloudflare gestiona DNS y SSL automáticamente

Para clientes que quieren su propia instancia

Proporciona la carpeta worker/ — ellos la despliegan en su propia cuenta de Cloudflare. El worker solo ve blobs cifrados, ningún dato en claro.

Solución de problemas