# 🦋 Wilkommen
# [hub.soeding.net](http://hub.soeding.net) — Benutzerhandbuch
> Internes Serviceportal der Soeding-Infrastruktur
---
# Übersicht
Das Portal unter [**https://hub.soeding.net**](https://hub.soeding.net) ist der zentrale Einstiegspunkt für alle internen Dienste der Soeding-Infrastruktur. Von hier aus erreicht man alle Webdienste mit einem einzigen Klick — ohne sich für jeden Dienst einzeln anmelden zu müssen (SSO).
Das Portal selbst erfordert ein einfaches Zugangspasswort. Die eigentliche Authentifizierung für die einzelnen Dienste läuft über **Zitadel** (Single Sign-On unter `auth.soeding.net`).
---
## Anmeldung am Portal
### Passwort eingeben
Beim Öffnen von `hub.soeding.net` erscheint ein Passwort-Dialog. Es gibt je nach Benutzergruppe unterschiedliche Passwörter:
| Passwort | Zugang | Sichtbare Bereiche |
|----------|--------|--------------------|
| Benutzerpasswort | Benutzer | Dienste, Home Assistant |
| Praxis-Passwort | Praxis-Team | \+ Praxis-Sektion (QM, Shops, Finanzen …) |
| Admin-Passwort | Administrator | alle Bereiche inkl. Administration |
Das Passwort kann mit der **Enter-Taste** bestätigt werden.
> **Sicherheitshinweis:** Nach 3 falschen Eingaben wird der Zugang für 30 Sekunden gesperrt. Die drei Punkte unter dem Eingabefeld zeigen an, wie viele Versuche bereits verbraucht wurden.
### Direktlink für das Praxis-Team
Das Praxis-Team kann über einen speziellen Link direkt einsteigen ohne Passworteingabe:
```
https://hub.soeding.net?t=soeding-praxis
```
Dieser Link wird z. B. als Verknüpfung auf den Praxis-PCs hinterlegt.
### Session-Verhalten
Die Anmeldung bleibt **dauerhaft** gespeichert (im Browser-Speicher). Ein neuer Tab öffnet das Portal direkt ohne erneute Passworteingabe. Die Session endet nur durch:
* Klick auf **⎋ Sperren** oben rechts
* Manuelles Löschen der Browser-Daten
---
## Benutzeroberfläche
| `hub.soeding.net Internes Serviceportal 🕐 🌙` | ```
← Header
``` |
|---------------------------------------------------|----------|
| `🟢 Benutzer · zuletzt: 07.04.2025 08:42`
`👤 Mein Account ⎋ Sperren` | ```
← Portal-Leiste
``` |
| ```
📰 Neuigkeiten
``` | ```
← News-Box
``` |
| ```
⭐ Favoriten [Chip] [Chip]
``` | ```
← Favoriten (wenn gesetzt)
``` |
| ```
DIENSTE
[Karte] [Karte] [Karte] [Karte]
``` | ```
← Service-Karten
``` |
| ```
🏠 HOME ASSISTANT
[Karte] [Karte]
``` | |
### Elemente der Portal-Leiste
* **Badge (grün/rosa/orange)** — zeigt die aktuelle Zugangsstufe an
* **„zuletzt:"** — Zeitstempel der vorherigen Anmeldung
* **👤 Mein Account** — Link zur Zitadel-Kontoverwaltung
* **⎋ Sperren** — Portal sofort sperren
---
## Dienste im Überblick
Jede Karte enthält:
* **Icon + Name** — Klick öffnet den Dienst **im selben Tab**
* **SSO-Badge** (grün) — Dienst unterstützt Single Sign-On, kein weiteres Passwort nötig
* **Login-Badge** (grau) — eigene Zugangsdaten erforderlich
* **Status-Punkt** — zeigt ob der Dienst erreichbar ist (wird alle 60 Sekunden aktualisiert)
* **⭐ Stern** — Dienst als Favorit markieren
### Verfügbare Dienste (Benutzer)
| Dienst | URL | Hinweis |
|--------|-----|---------|
| Open WebUI | [ai.soeding.net](http://ai.soeding.net) | KI-Assistent (Ollama) |
| Webmail | [salome.soeding.net](http://salome.soeding.net) | E-Mail-Client |
| Vaultwarden | [vw.soeding.net](http://vw.soeding.net) | Passwort-Manager |
| Nextcloud | [cloud.soeding.net](http://cloud.soeding.net) | Dateispeicher, Kalender |
| Wiki | [wiki.soeding.net](http://wiki.soeding.net) | Wissensdatenbank (Outline) |
| Paperless-NGX | [paperless.soeding.net](http://paperless.soeding.net) | Dokumentenarchiv |
| Frigate | [video.re.soeding.net](http://video.re.soeding.net) | Kamera-Überwachung |
| TVHeadend | [tv.soeding.net](http://tv.soeding.net) | TV-Streaming (eigene Zugangsdaten) |
### Home Assistant Instanzen
| Instanz | URL |
|---------|-----|
| Praxis | [ha.p.soeding.net](http://ha.p.soeding.net) |
| Feuerbach | [fb.soeding.net](http://fb.soeding.net) |
| Recklinghausen | [re.soeding.net](http://re.soeding.net) |
| Ludwigsburg | [lb.soeding.net](http://lb.soeding.net) |
| Frankfurt | [f.soeding.net](http://f.soeding.net) |
| Stuttgart | [s.soeding.net](http://s.soeding.net) |
---
## Favoriten
Häufig genutzte Dienste können als Favorit markiert werden. Sie erscheinen dann dauerhaft als **Chips** über der Dienste-Liste.
**Favorit hinzufügen:** Auf den ⭐-Stern in der gewünschten Karte klicken → Stern leuchtet auf, Chip erscheint oben.
**Favorit entfernen:** Auf das **✕** im Chip klicken — oder erneut auf den ⭐-Stern in der Karte.
Favoriten werden im Browser gespeichert und bleiben dauerhaft erhalten.
---
## Service-Status
Jede Karte zeigt einen kleinen farbigen Punkt:
| Farbe | Bedeutung |
|-------|-----------|
| 🔵 Grau blinkend | Wird gerade geprüft |
| 🟢 Grün | Dienst erreichbar |
| 🔴 Rot | Dienst nicht erreichbar |
Die Prüfung erfolgt automatisch beim Laden der Seite und danach alle **60 Sekunden**.
> **Hinweis:** Der KZV-Upload-Link ([kzvbw.de](http://kzvbw.de)) wird absichtlich nicht geprüft, da dieser Dienst ein spezielles Client-Zertifikat erfordert.
---
## Neuigkeiten
Die News-Box oben im Portal zeigt aktuelle Mitteilungen. Neue (ungelesene) Einträge haben einen **blauen Punkt** rechts.
**Eintrag lesen:** Auf einen Eintrag klicken → ein Popup öffnet sich mit der vollständigen Meldung.
**Als gelesen markieren:** Der Eintrag wird automatisch beim Öffnen des Popups als gelesen markiert. Alternativ: **„✓ alle gelesen"** klicken.
Gelesene Einträge haben keinen blauen Punkt mehr. Der Status wird dauerhaft gespeichert.
---
## Design / Dark Mode
Oben rechts im Header befindet sich der **🌙-Button** zum Wechseln des Designs.
| Symbol | Modus |
|--------|-------|
| 🌓 | Automatisch (folgt dem Betriebssystem) |
| 🌙 | Immer dunkel |
| ☀️ | Immer hell |
Das Portal zeigt im Dunkelmodus einen **animierten Sternenhimmel**, im Hellmodus einen **blauen Tageshimmel mit Wolken**.
Die Einstellung wird dauerhaft gespeichert.
---
##