HiveGrid-Marketing/.docs/Freigabe.md

Freigabe für Kollegen

Stand: 20.10.2026. Das Dashboard ist für Kollegen freigegeben, mit Passwort und nur zum Lesen. Diese Datei sieht von außen niemand: Beide Wege liefern nichts aus, was mit einem Punkt beginnt.

Es gibt zwei Wege. Standard ist Cloudflare Pages, der läuft ohne Dejans Laptop. Der Tunnel ist nur noch die Notlösung, zum Beispiel wenn ein Stand sofort und ohne Hochladen sichtbar sein soll.

---

Zugang

• Adresse: https://hivegrid-marketing.pages.dev
• Passwort: attiJia1GXxGeIKg, der Name ist egal. Gleiches Passwort für Pages und Tunnel.
• Maßgeblich ist die Datei .freigabe-passwort (nicht in git). Bei Pages liegt es zusätzlich als Secret PASSWORT im Projekt. Wer es ändert, muss beides ändern und neu hochladen (siehe unten).

---

Weg 1: Cloudflare Pages (Standard)

Das Projekt hivegrid-marketing liegt im Cloudflare-Konto dejancosic2003@gmail.com. Es zeigt den Stand vom letzten Hochladen, nicht live.

Für Agents: neuen Stand hochladen

Immer nach „commit und push“ im Hub auch hochladen, damit die Kollegen den neuen Stand sehen:

cd "/Users/dejancosic/Documents/GitHub/HiveGrid Marketing " && ./veroeffentlichen.sh

• Hochgeladen wird, was git kennt, im Stand der Arbeitskopie. Neue Dateien erst committen, sonst fehlen sie.
• Am Ende steht „Deployment complete!“. Die neue Version braucht danach bis zu einer Minute, bis sie überall ankommt. In dieser Zeit kann die Adresse noch die alte Version zeigen.
• Prüfen:
  • curl -s -o /dev/null -w '%{http_code}' https://hivegrid-marketing.pages.dev/ muss 401 sein
  • mit -u x:$(cat .freigabe-passwort) muss es 200 sein
• Nicht angemeldet? Dann meldet wrangler einen Fehler zur Anmeldung. npx --yes wrangler@4 login öffnet ein Browserfenster, dort muss Dejan auf „Allow“ klicken.
• --force im Skript ist nötig: Neuere wrangler-Versionen wollen Pages sonst als Worker anlegen und scheitern am Ordnernamen mit Leerzeichen.

Was hochgeladen wird

• Alle Dateien, die git kennt, außer: alles mit Punkt am Anfang (.git, .docs, .claude), die Server-Skripte oben im Hub (serve.py, freigabe.*, veroeffentlichen.sh) und Dateien über 25 MB. Derzeit fehlt deshalb nur produktionsvorgaben/gestaltung/outro-e120/E120-Alpha.mov.
• Dazu in pages-daten/ die Dokumentenliste, der Stand und der Suchindex. Die erzeugt werkzeuge/pages_bauen.py.
• werkzeuge/pages/_middleware.js läuft bei Cloudflare vor jeder Anfrage: Passwort, nur lesen, Suche, „/“ zeigt das Dashboard.

---

Weg 2: Tunnel vom Laptop (Notlösung)

Zeigt den Stand live von Dejans Laptop. Endet, sobald der Laptop schläft, die Sitzung oder das Terminal zu ist.

1. Läuft er schon? curl -s 127.0.0.1:20241/quicktunnel. Kommt ein hostname, läuft er. Dann nur Adresse und Passwort nennen.
2. Starten: ./freigabe.sh im Hub-Ordner im Hintergrund. Der Ordnername endet mit einem Leerzeichen.
3. Adresse holen: ein paar Sekunden warten, dann curl -s 127.0.0.1:20241/quicktunnel. Die Adresse ist bei jedem Start neu.
4. Prüfen: ohne Passwort 401, mit Passwort 200, .../.git/config mit Passwort 404.
5. Beenden: Hintergrund-Aufgabe stoppen oder Ctrl+C. Wenn etwas hängt: pkill -f "cloudflared tunnel --no-autoupdate --url http://127.0.0.1:4330"; pkill -f freigabe.py

freigabe.py ist derselbe Server wie serve.py, auf Port 4330, nur 127.0.0.1, mit Passwort und nur zum Lesen. freigabe.sh startet dazu caffeinate und cloudflared tunnel --url http://127.0.0.1:4330.

---

Was gesperrt ist (beide Wege)

• Ohne Passwort alles (401).
• Alles mit Punkt am Anfang (404). Interne Dateien, die Kollegen nicht sehen sollen, gehören deshalb in einen solchen Ordner, zum Beispiel hierher.
• Status setzen, Export, Öffnen (403). Das Dashboard zeigt dann unten „In der Freigabe lässt sich nichts ändern.“

Alles andere im Hub ist für Kollegen sichtbar. Beim Tunnel auch Dateien, die nicht in git stehen.

Was bei Kollegen nicht geht

• PostGrid, das läuft nur auf Dejans Mac.
• Das Online-Deck und andere claude.ai-Links, die sind privat.