# OP-Saalzeiten — Benutzerhandbuch

## Einführung

OP-Saalzeiten ist Ihre zentrale Übersicht über die OP-Saalauslastung an allen IKK-Klinikstandorten. Sie sehen auf einen Blick, welche Säle belegt oder frei sind, können OPs starten und beenden und erhalten aussagekräftige Statistiken.

---

## Anmeldung

1. Öffnen Sie die Anwendung im Browser
2. Geben Sie Ihren **Benutzernamen** und Ihr **Passwort** ein
3. Klicken Sie auf **Anmelden**

Nach der Anmeldung bleiben Sie 8 Stunden (eine Schichtlänge) eingeloggt. Danach müssen Sie sich erneut anmelden.

> **Tipp:** Ihr Administrator legt Ihren Account an und teilt Ihnen die Zugangsdaten mit.

---

## Dashboard — Die Ampelansicht

Das Dashboard ist Ihre Hauptarbeitsansicht. Es zeigt alle OP-Säle aller Standorte als Ampeln:

### Ampelfarben

| Farbe | Bedeutung |
|-------|-----------|
| 🟢 **Grün** | Saal ist frei — keine laufende OP |
| 🔴 **Rot** | Saal ist belegt — OP läuft |

Jede Ampelkachel zeigt:
- **Saalname** (z.B. „Saal 1")
- **Standort** (z.B. „Ilmenau")
- Bei belegten Sälen: **OP-Typ**, **Chirurg** und **laufende Dauer** in Minuten

### Live-Updates

Das Dashboard aktualisiert sich automatisch in Echtzeit. Wenn ein Kollege eine OP startet oder beendet, ändert sich die Ampel sofort — ohne Neuladen der Seite.

---

## OP starten und beenden

### OP starten

1. Klicken Sie auf einen **freien Saal** (grüne Ampel)
2. Optional: Geben Sie **OP-Typ**, **Chirurg** und eine **Bemerkung** ein
3. Bestätigen Sie mit **OP starten**

Der Saal wechselt auf Rot. Die Startzeit wird automatisch erfasst.

> **Wichtig:** Pro Saal kann nur eine OP gleichzeitig laufen.

### OP beenden

1. Klicken Sie auf einen **belegten Saal** (rote Ampel)
2. Bestätigen Sie mit **OP beenden**

Die Endzeit wird automatisch erfasst und die OP-Dauer berechnet. Der Saal wechselt zurück auf Grün.

---

## Saalzeiten verwalten

Im Bereich **Saalzeiten** können Sie alle erfassten OPs einsehen und verwalten.

### Saalzeiten filtern

Sie können die Liste filtern nach:
- **Standort** — Nur Säle eines bestimmten Standorts
- **Saal** — Nur ein bestimmter Saal
- **Zeitraum** — Von-Datum und Bis-Datum

### Saalzeit manuell anlegen

Falls eine OP nicht über die Ampel erfasst wurde:

1. Klicken Sie auf **Neue Saalzeit**
2. Wählen Sie den **Saal**
3. Geben Sie **Beginn** und **Ende** ein
4. Optional: **OP-Typ**, **Chirurg**, **Bemerkung**
5. Speichern

### Saalzeit bearbeiten

1. Klicken Sie auf eine bestehende Saalzeit
2. Ändern Sie die gewünschten Felder (Beginn, Ende, OP-Typ, Chirurg, Bemerkung)
3. Speichern

### Saalzeit löschen

1. Klicken Sie auf eine Saalzeit
2. Klicken Sie auf **Löschen**
3. Bestätigen Sie die Löschung

> **Achtung:** Gelöschte Saalzeiten können nicht wiederhergestellt werden.

---

## Statistiken

Die Statistiken helfen Ihnen, die OP-Auslastung zu analysieren und Optimierungspotenziale zu erkennen.

### Auslastung

Zeigt die **prozentuale Auslastung** jedes Saals:

- Berechnung: OP-Zeit geteilt durch verfügbare Zeit (Montag–Freitag, 7:00–18:00 Uhr)
- Beispiel: 450 OP-Minuten an einem Tag mit 660 verfügbaren Minuten = **68,2 % Auslastung**

Sie können filtern nach:
- Standort
- Saal
- Monat (Format: JJJJ-MM, z.B. 2026-04)

### Wechselzeiten

Zeigt die **durchschnittliche Zeit zwischen zwei OPs** im selben Saal:

- Nur Wechsel am selben Tag werden gezählt
- Angezeigt werden: Durchschnitt, Minimum und Maximum
- Kurze Wechselzeiten deuten auf effiziente Abläufe hin

### OP-Dauer

Zeigt die **durchschnittliche Dauer** nach OP-Typ und Saal:

- Gruppiert nach Standort, Saal und OP-Typ
- Durchschnitt, Minimum und Maximum in Minuten
- Hilft bei der Planung und Erkennung von Abweichungen

---

## Verwaltung (nur Administratoren)

Die folgenden Funktionen stehen nur Benutzern mit der Rolle **Admin** zur Verfügung.

### Standorte verwalten

1. Navigieren Sie zu **Verwaltung → Standorte**
2. **Neuer Standort:** Name und Adresse eingeben
3. **Bearbeiten:** Klicken Sie auf einen Standort, um Name oder Adresse zu ändern
4. **Deaktivieren:** Entfernt den Standort aus der Ansicht (Daten bleiben erhalten)

### Säle verwalten

1. Navigieren Sie zu **Verwaltung → Säle**
2. **Neuer Saal:** Standort auswählen und Saalname eingeben
3. **Bearbeiten:** Klicken Sie auf einen Saal
4. **Deaktivieren:** Entfernt den Saal aus der Ampelansicht

> **Hinweis:** Saalname muss pro Standort eindeutig sein (z.B. kann jeder Standort einen „Saal 1" haben).

### Benutzer verwalten

1. Navigieren Sie zu **Verwaltung → Benutzer**
2. **Neuer Benutzer:** Benutzername, Passwort, Name, Rolle und optional Standort eingeben
3. **Bearbeiten:** Klicken Sie auf einen Benutzer (Passwort wird nur geändert, wenn ein neues eingegeben wird)
4. **Deaktivieren:** Sperrt den Login des Benutzers

---

## Rollen im Überblick

| Rolle | Was kann ich tun? |
|-------|-------------------|
| **Admin** | Alles: Standorte, Säle und Benutzer verwalten, OPs starten/stoppen, Saalzeiten bearbeiten, Statistiken ansehen |
| **Koordinator** | OPs starten und stoppen, Saalzeiten anlegen/bearbeiten/löschen, Statistiken ansehen |
| **Viewer** | Dashboard und Statistiken ansehen (nur Leserechte) |

---

## Häufige Fragen

**Warum sehe ich keinen „OP starten"-Button?**
Sie haben die Rolle „Viewer". Nur Koordinatoren und Admins können OPs starten. Wenden Sie sich an Ihren Administrator.

**Was passiert, wenn ich vergesse die OP zu beenden?**
Der Saal bleibt auf Rot. Sie können die OP nachträglich über die Ampel beenden oder die Saalzeit manuell bearbeiten.

**Kann ich Saalzeiten nachträglich korrigieren?**
Ja. Im Bereich „Saalzeiten" können Sie Beginn, Ende, OP-Typ und Chirurg jederzeit bearbeiten.

**Werden die Daten gesichert?**
Ja, alle Daten liegen in einer SQLite-Datenbank, die beim regulären Backup des Servers gesichert wird.

**Kann ich Daten exportieren?**
Die Statistik-Endpunkte liefern strukturierte Daten, die sich für Export und Weiterverarbeitung eignen. Sprechen Sie Ihren Administrator an.
