Leitfaden zur Bereitstellung des MasterGantt Sync-Workers

Architektur

Der Worker nutzt Cloudflare Durable Objects für den Echtzeit-WebSocket. Jeder „Raum" für die Zusammenarbeit entspricht einem Durable Object mit persistenten WebSocket-Verbindungen. Änderungen werden sofort (<1 Sekunde) an alle Mitarbeiter übertragen.

Der Server sieht nur AES-256-GCM-verschlüsselte Blobs — keine Kenntnis der Daten.

Voraussetzungen

• Ein Cloudflare-Konto mit Workers Paid (5 $/Monat) — erforderlich für Durable Objects
• Node.js installiert

Erstinstallation (10 Minuten)

1. Wrangler (Cloudflare-CLI) installieren

npm install -g wrangler

2. Anmelden

wrangler login

→ Öffne den Browser und klicke auf „Allow"

3. KV-Namespace erstellen (Fallback-Speicher)

cd worker/
wrangler kv namespace create ROOMS

→ Der Befehl zeigt eine ID an. Aktualisieren Sie wrangler.toml:

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

4. Den Worker bereitstellen

wrangler deploy

→ Zeigt die URL des Workers an: https://mg-sync.IHR-SUBDOMAIN.workers.dev

5. Testen

curl "https://mg-sync.IHR-SUBDOMAIN.workers.dev/room/test/presence?client=test1"
# Sollte zurückgeben: {"count":0}

6. MasterGantt konfigurieren

Die URL des Workers ist in MasterGantt bereits vorausgefüllt (Einstellungen → Zusammenarbeit → Server). Um Ihren eigenen Worker zu verwenden, ersetzen Sie die URL.

Worker aktualisieren

Nach der Änderung von sync-worker.js:

cd worker/
wrangler deploy

Das war's schon — die Bereitstellung dauert ca. 15 Sekunden.

Aktuelle Konfiguration (Referenz)

Cloudflare-Konto   : steevebecker
Subdomain          : mastergantt.workers.dev
Worker-URL         : https://mg-sync.mastergantt.workers.dev
KV-Namespace-ID    : c2fe1889c94b4d55ad68f9d244bd812f
Tarif              : Workers Paid ($5/Monat)

Dateien

Technische Architektur

Client A (Browser)           Cloudflare Worker         Client B (Browser)
     |                            |                          |
     |-- WebSocket connect ------>|                          |
     |                            |<-- WebSocket connect ----|
     |                            |                          |
     |-- WS: encrypted blob ----->|                          |
     |                       DO broadcast                    |
     |                            |---> WS: encrypted blob ->|
     |                            |     entschlüsseln + merge
     |                            |                          |

• Jeder Raum = 1 Durable Object (persistente Instanz)
• Die Blobs werden über WebSocket übertragen (kein Polling)
• Das DO verwaltet eine Gruppe von WebSockets und sendet an alle außer den Absender
• Automatische Wiederverbindung auf der Client-Seite nach 3 Sekunden Unterbrechung
• Fallback auf HTTP GET/POST, wenn WebSocket nicht verfügbar ist

Kosten

Realistische Schätzung: 10 aktive Nutzer × 8 Std. = ~0,05 $/Tag = ~1,50 $/Monat an zusätzlichen Kosten.

Benutzerdefinierte Domain (optional)

Um sync.mastergantt.com zu verwenden:

1. Cloudflare-Dashboard → Workers → mg-sync → Triggers
2. Custom Domain hinzufügen: sync.mastergantt.com
3. Cloudflare verwaltet DNS + SSL automatisch

Für Kunden, die eine eigene Instanz wünschen

Stellen Sie den Ordner worker/ bereit — sie stellen ihn auf ihrem eigenen Cloudflare-Konto bereit. Der Worker sieht nur verschlüsselte Blobs, keine unverschlüsselten Daten.

Fehlerbehebung