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:
1 parent
64da152d53
commit
e112597568
6 files changed
+265
-35
No files matched your search
+55
-33
@@ -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.
|
||||
Reference in new issue
Block a user