Guide de deploiement du worker MasterGantt Sync

Architecture

Le worker utilise Cloudflare Durable Objects pour le WebSocket temps reel. Chaque "room" de collaboration = 1 Durable Object avec connexions WebSocket persistantes. Les modifications sont broadcastees instantanement (<1 seconde) a tous les collaborateurs.

Le serveur ne voit que des blobs chiffres AES-256-GCM — zero connaissance des donnees.

Prerequis

• Un compte Cloudflare avec Workers Paid ($5/mois) — necessaire pour les Durable Objects
• Node.js installe

Deploiement initial (10 minutes)

1. Installer Wrangler (CLI Cloudflare)

npm install -g wrangler

2. Se connecter

wrangler login

→ Ouvre le navigateur, cliquer "Allow"

3. Creer le KV namespace (stockage fallback)

cd worker/
wrangler kv namespace create ROOMS

→ La commande affiche un ID. Mettre a jour wrangler.toml :

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

4. Deployer le worker

wrangler deploy

→ Affiche l'URL du worker : https://mg-sync.VOTRE-SOUS-DOMAINE.workers.dev

5. Tester

curl "https://mg-sync.VOTRE-SOUS-DOMAINE.workers.dev/room/test/presence?client=test1"
# Doit retourner : {"count":0}

6. Configurer MasterGantt

L'URL du worker est pre-remplie dans MasterGantt (Parametres → Collaboration → Serveur). Pour utiliser votre propre worker, remplacer l'URL.

Mise a jour du worker

Apres modification de sync-worker.js :

cd worker/
wrangler deploy

C'est tout — le deploiement prend ~15 secondes.

Configuration actuelle (reference)

Compte Cloudflare  : steevebecker
Sous-domaine       : mastergantt.workers.dev
Worker URL         : https://mg-sync.mastergantt.workers.dev
KV namespace ID    : c2fe1889c94b4d55ad68f9d244bd812f
Plan               : Workers Paid ($5/mois)

Fichiers

Architecture technique

Client A (navigateur)        Cloudflare Worker         Client B (navigateur)
     |                            |                          |
     |-- WebSocket connect ------>|                          |
     |                            |<-- WebSocket connect ----|
     |                            |                          |
     |-- WS: blob chiffre ------->|                          |
     |                       DO broadcast                    |
     |                            |---> WS: blob chiffre --->|
     |                            |          dechiffre + merge
     |                            |                          |

• Chaque room = 1 Durable Object (instance persistante)
• Les blobs transitent via WebSocket (pas de polling)
• Le DO maintient un Set de WebSockets et broadcast a tous sauf l'expediteur
• Reconnexion auto cote client apres 3s de deconnexion
• Fallback HTTP GET/POST si WebSocket indisponible

Couts

Estimation realiste : 10 utilisateurs actifs × 8h = ~$0.05/jour = ~$1.50/mois de surcout.

Domaine custom (optionnel)

Pour utiliser sync.mastergantt.com :

1. Dashboard Cloudflare → Workers → mg-sync → Triggers
2. Ajouter Custom Domain : sync.mastergantt.com
3. Cloudflare gere DNS + SSL automatiquement

Pour les clients qui veulent leur propre instance

Fournir le dossier worker/ — ils deploient sur leur propre compte Cloudflare. Le worker ne voit que des blobs chiffres, aucune donnee en clair.

Troubleshooting