Update Brain.md documentation to describe public/admin dashboard split
Some checks failed
Build & Push Docker Image to Gitea Registry / build-and-push (push) Failing after 1m2s

This commit is contained in:
Kroonk
2026-07-01 17:37:21 +02:00
parent 285280fa01
commit 1cb1661374

View File

@@ -198,14 +198,14 @@ volumes:
- **Premium Header-User-Badge:** In der Kopfzeile von `admin.html` wurde ein neues Element `<span class="admin-user-badge" id="headerUserBadge" hidden></span>` implementiert, welches bei einer erfolgreichen Authentifizierung in `admin.js` mit dem Text `"Angemeldet als [Nutzername]"` befüllt und stilvoll eingeblendet wird. Der Badge wurde mit einem eleganten Glassmorphismus, dezenter Randlinie und einem 👤-Emoji modern und hochwertig designt. - **Premium Header-User-Badge:** In der Kopfzeile von `admin.html` wurde ein neues Element `<span class="admin-user-badge" id="headerUserBadge" hidden></span>` implementiert, welches bei einer erfolgreichen Authentifizierung in `admin.js` mit dem Text `"Angemeldet als [Nutzername]"` befüllt und stilvoll eingeblendet wird. Der Badge wurde mit einem eleganten Glassmorphismus, dezenter Randlinie und einem 👤-Emoji modern und hochwertig designt.
- **Cache-Buster & PWA Cache Update:** Die Cache-Busting-Parameter für `style.css` wurden in `index.html`, `admin.html` und `favorites.html` auf `v=34` hochgestuft. Im Service-Worker (`sw.js`) wurde der Cache-Name auf `mischlabs-pwa-v27` erhöht, um ein sofortiges Update der App-Shell im Browser aller Anwender zu erzwingen. In `admin.html` wurde der Script-Buster von `admin.js` auf `v=30` erhöht. - **Cache-Buster & PWA Cache Update:** Die Cache-Busting-Parameter für `style.css` wurden in `index.html`, `admin.html` und `favorites.html` auf `v=34` hochgestuft. Im Service-Worker (`sw.js`) wurde der Cache-Name auf `mischlabs-pwa-v27` erhöht, um ein sofortiges Update der App-Shell im Browser aller Anwender zu erzwingen. In `admin.html` wurde der Script-Buster von `admin.js` auf `v=30` erhöht.
- **Migration zu Homepage (gethomepage.dev) (Stand: 2026-07-01):** - **Migration zu Homepage (gethomepage.dev) & Aufteilung in Public/Admin (Stand: 2026-07-01):**
- **Ablösung des Custom Dashboards:** Das selbstgebaute Node.js-basierte Dashboard (mischlabs.de) wurde vollständig durch die professionelle, open-source Dashboard-Lösung **Homepage (gethomepage.dev)** abgelöst. - **Ablösung des Custom Dashboards:** Das selbstgebaute Node.js-basierte Dashboard (mischlabs.de) wurde vollständig durch die professionelle, open-source Dashboard-Lösung **Homepage (gethomepage.dev)** abgelöst.
- **Erstellung der Homepage-Konfigurationen:** - **Trennung in öffentliche und administrative Ansicht:**
- `config/settings.yaml`: Definiert globale Einstellungen (Dark Theme, Sprache "de", Titel "MischLabs Dashboard"). - Aus Sicherheitsgründen wurde das Dashboard in zwei separate Homepage-Instanzen aufgeteilt.
- `config/docker.yaml`: Verbindet Homepage mit dem lokalen Docker-Socket, um Echtzeit-Statusüberwachung der Container zu ermöglichen. - **Öffentliches Dashboard (`mischlabs` / Port 8085):** Verwendet das Konfigurationsverzeichnis `config-public/`. Zeigt nur öffentliche Dienste (Drive, Movies, Audiobooks, Books, MiChess, Tom) ohne sensible Server-Statuswerte oder Administrationslinks.
- `config/widgets.yaml`: Bindet Systemressourcen (CPU, RAM und Speicherplatzüberwachung für volume1 und volume2) sowie eine Suchfunktion (DuckDuckGo) ein. - **Admin-Dashboard (`mischlabs-admin` / Port 8086):** Verwendet das Konfigurationsverzeichnis `config-admin/`. Zeigt alle 9 Dienste (inkl. Keycloak SSO, Passwords und Git), verfügt über eine Anbindung an den Docker-Socket für Live-Statusanzeigen und liest die NAS-Hardware-Ressourcen (CPU, RAM, Disks) aus.
- `config/services.yaml`: Migriert alle 9 vorhandenen Dienste (Single Sign-On, Passwords, Drive, Movies, Audiobooks, Books, Git, MiChess, Tom) in passende Kategorien und verknüpft sie mit ihren jeweiligen Docker-Containern für ein Live-Monitoring.
- **Aktualisierung des Docker-Compose Setups:** - **Aktualisierung des Docker-Compose Setups:**
- `docker-compose.yml` (lokal) / `docker-compose.override.yml` (NAS): Aktualisiert auf das offizielle Image `ghcr.io/gethomepage/homepage:latest` auf Host-Port 8085 (Container-Port 3000) und bindet die Konfigurationen sowie Volumes für Docker-Socket und NAS-Pfade ein. - `docker-compose.yml` (lokal) / `docker-compose.override.yml` (NAS): Definiert beide Homepage-Services und bindet ihre jeweiligen Konfigurationspfade (`./config-public` und `./config-admin`) ein.
- **Deployment-Ergebnis & Hotfix:** Alle Änderungen wurden erfolgreich in das Gitea-Repository gepusht und direkt auf dem NAS via SSH deployt. Nach anfänglichem "Host validation failed" Fehler bei externem Zugriff wurde `HOMEPAGE_ALLOWED_HOSTS` in der Compose-Konfiguration hinzugefügt, um `mischlabs.de` und lokale IPs zu autorisieren. Der bunte Hintergrundverlauf wurde auf Wunsch des Nutzers entfernt, um den schlichten Standard-Darkmode von Homepage zu nutzen. Der Container läuft stabil und die Homepage lädt fehlerfrei. - **Deployment-Ergebnis & Hotfix:** Alle Änderungen wurden erfolgreich in das Gitea-Repository gepusht und direkt auf dem NAS via SSH deployt. Die Host-Validierung wurde mittels `HOMEPAGE_ALLOWED_HOSTS` für beide Instanzen so konfiguriert, dass Zugriffe über Domains (z. B. `mischlabs.de`, `admin.mischlabs.de`) und IP-Adressen autorisiert sind. Beide Instanzen laufen stabil.