Wartungsfenster¶
Mit Wartungsfenstern kündigt man geplante Wartung mit Zeitraum (von/bis) an — bei Bedarf schon weit im Voraus. Während des Zeitraums kann die App optional für Nicht-Administratoren gesperrt werden.
Die Verwaltung findet sich unter System-Administration → Betrieb & Überwachung → Wartungsfenster (nur für Administratoren). Links steht die Liste Fenster mit Zeitraum und Zustand (z. B. „vorbei"), rechts der Editor; + Neu legt ein Fenster an.
Ein Fenster anlegen¶
| Feld | Bedeutung |
|---|---|
| Titel | Kurze Überschrift, erscheint im Banner (Pflicht). |
| Nachricht | Optionaler Detailtext (betroffene Funktionen, Kontakt …). |
| Start (von) / Ende (bis) | Der Wartungszeitraum (Pflicht). Zeiten in der Server-Zeitzone. |
| Anzeigen ab | Ab wann der Ankündigungs-Banner erscheint. Leer = sofort; sonst z.B. „3 Tage vorher". |
| Schweregrad | Steuert die Banner-Farbe: Info (blau), Warnung (amber), Kritisch (rot). |
| App während der Wartung sperren | Wenn gesetzt, sehen Nicht-Admins im Zeitraum eine Wartungsseite (Admins arbeiten weiter). |
| Aktiv | Nur aktive Fenster erscheinen; zum Deaktivieren ohne Löschen ausschalten. |
Wie es sich verhält¶
Der Banner erscheint app-weit ganz oben — auch auf der Login-Seite (vor der Anmeldung). Er hat zwei Zustände:
- Geplant (upcoming): dezenter Balken in der Schweregrad-Farbe, vom Anwender wegklickbar (das Ausblenden wird pro Fenster gemerkt).
- Läuft (active): betonter roter Balken, nicht wegklickbar, zeigt die voraussichtliche Endzeit.
Ist bei einem gerade laufenden Fenster „App sperren" aktiv, sehen Nicht-Administratoren statt der Anwendung eine Wartungsseite mit Titel, Endzeit und Nachricht. Administratoren kommen weiterhin normal in die App (um die Wartung durchzuführen und Fenster zu pflegen). Nach dem Ende des Fensters verschwindet Banner und Sperre automatisch.
Vorlauf richtig setzen
Für eine frühzeitige Ankündigung legt man das Fenster mit dem echten Zeitraum an und setzt „Anzeigen ab" auf den gewünschten Vorlauf (z.B. eine Woche vorher). So sehen alle den Banner rechtzeitig, die Sperre greift aber erst zum Start.
Technisch¶
- Tabelle
maintenance_window; Admin-CRUD unter/api/admin/maintenance. - Öffentlicher Endpoint
GET /api/maintenance/activeliefert die sichtbaren Fenster inkl. serverseitig berechnetem Zustand (upcoming/active) undlockedNow— daher stimmt die Anzeige unabhängig von der Zeitzone des Browsers. Das Frontend pollt ihn regelmäßig und bei Tab-Fokus. - Die Sperre ist ein Frontend-Soft-Lock: Sie hält Nicht-Admins aus der Oberfläche, ist aber kein Ersatz für einen echten Backend-Wartungsmodus. Wer eine harte, nicht umgehbare Sperre braucht, deaktiviert das System auf Infrastruktur-Ebene (z.B. Reverse-Proxy).