Dashboard fuer Kollegen auf Cloudflare Pages

veroeffentlichen.sh baut mit werkzeuge/pages_bauen.py den Ordner .pages
und laedt ihn nach hivegrid-marketing.pages.dev. Die Middleware in
werkzeuge/pages/ uebernimmt Passwort, nur lesen und die Auskuenfte von
serve.py (Dokumente, Stand, Suche). Der Tunnel bleibt als Notloesung.
Anleitung in .docs/Freigabe.md, Hinweis fuer Agents in .claude/CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dejanandClaude Opus 5.5 committed 2026-10-20 14:31:57 +02:00
1 parent 64da152d53
commit e112597568
6 files changed
+265 -35

No files matched your search

+55 -33
View File
@@ -1,63 +1,85 @@
# Freigabe für Kollegen
**Stand:** 19.10.2026. Das Dashboard lässt sich über einen Cloudflare-Tunnel für Kollegen freigeben, mit Passwort und nur zum Lesen. Diese Datei sieht von außen niemand: Die Freigabe liefert nichts aus, was mit einem Punkt beginnt.
**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
- **Passwort:** `attiJia1GXxGeIKg`, der Name ist egal.
- Maßgeblich ist die Datei `.freigabe-passwort` (nicht in git). Wird sie gelöscht, erzeugt der nächste Start ein neues Passwort. Dann hier nachtragen.
- **Die Adresse ist bei jedem Start neu,** zum Beispiel `https://dock-texture-dna-reason.trycloudflare.com`. Kollegen brauchen also nach jedem Neustart den neuen Link.
- **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).
---
## Für Agents: Freigabe starten
## Weg 1: Cloudflare Pages (Standard)
Wenn Dejan sagt „starte die Freigabe“, „Session für die Kollegen“ oder Ähnliches:
Das Projekt `hivegrid-marketing` liegt im Cloudflare-Konto `dejancosic2003@gmail.com`. Es zeigt den Stand vom letzten
Hochladen, nicht live.
1. **Läuft sie schon?** `curl -s 127.0.0.1:20241/quicktunnel`. Kommt ein `hostname` zurück, läuft sie. Dann nur Adresse und Passwort nennen, nichts neu starten. Ist Port 4330 belegt (`lsof -iTCP:4330 -sTCP:LISTEN`), aber kein Tunnel da, zuerst beenden (siehe unten).
2. **Starten:** `./freigabe.sh` im Hub-Ordner im Hintergrund laufen lassen. Achtung, der Ordnername endet mit einem Leerzeichen: `"/Users/dejancosic/Documents/GitHub/HiveGrid Marketing "`.
3. **Adresse holen:** ein paar Sekunden warten, dann `curl -s 127.0.0.1:20241/quicktunnel`. In der Ausgabe von `freigabe.sh` steht vorher schon „Requesting new quick Tunnel on trycloudflare.com...“. Das ist noch nicht die Adresse.
4. **Prüfen,** nach weiteren paar Sekunden, bis der neue Name auflöst:
- `curl -s -o /dev/null -w '%{http_code}' https://<adresse>/` muss `401` sein
- `curl -s -o /dev/null -w '%{http_code}' -u x:$(cat .freigabe-passwort) https://<adresse>/` muss `200` sein
- `.../.git/config` mit Passwort muss `404` sein
5. **Dejan Adresse und Passwort nennen.**
### Für Agents: neuen Stand hochladen
**Wichtig:** Eine Freigabe, die ein Agent startet, endet mit dessen Sitzung. Soll sie länger laufen, startet Dejan selbst in einem Terminal:
**Immer nach „commit und push“ im Hub** auch hochladen, damit die Kollegen den neuen Stand sehen:
```
cd "/Users/dejancosic/Documents/GitHub/HiveGrid Marketing " && ./freigabe.sh
cd "/Users/dejancosic/Documents/GitHub/HiveGrid Marketing " && ./veroeffentlichen.sh
```
**Beenden:** die Hintergrund-Aufgabe stoppen oder Ctrl+C im Terminal. Wenn etwas hängen bleibt:
- 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.
```
pkill -f "cloudflared tunnel --no-autoupdate --url http://127.0.0.1:4330"; pkill -f freigabe.py
```
### 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.
---
## Was gesperrt ist
## 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): `.git`, `.docs`, `.claude`, `.freigabe-passwort`. Interne Dateien, die Kollegen nicht sehen sollen, gehören deshalb in einen solchen Ordner, zum Beispiel hierher.
- **Ordnerlisten** (404).
- **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, auch Dokumente und Daten, die nicht in git stehen.
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.
---
## Technik
- `freigabe.py`: derselbe Server wie `serve.py`, aber auf Port 4330, nur 127.0.0.1, mit Passwort und nur zum Lesen.
- `freigabe.sh`: startet `freigabe.py`, dazu `caffeinate` (der Mac schläft nicht ein, mit zugeklapptem Deckel trotzdem) und `cloudflared tunnel --url http://127.0.0.1:4330`.
- `cloudflared` ist über Homebrew installiert (19.10.2026, Version 2026.10.1). Ein Quick Tunnel braucht kein Konto, hat aber keine Garantie auf Erreichbarkeit.
- `127.0.0.1:20241` ist die Statusseite von `cloudflared`. Ist der Port belegt, nimmt es den nächsten bis 20245.