> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Termine verwalten

> Patiententermine prüfen und stornieren sowie die Scheduling-Konfiguration im Admin-Portal verwalten

# Termine verwalten

Admins prüfen Patiententermine und verwalten die Scheduling-Konfiguration aus dem Admin-Portal.
Die Terminübersicht ist für Support- und Operations-Teams gedacht, die anstehende Buchungen
prüfen oder im Auftrag eines Patienten oder Arztes stornieren müssen.

## Wo Termine zu finden sind

Nutzen Sie die globale Terminübersicht für alle Buchungen Ihrer Organisation. Sie können auch ein
Patientenprofil öffnen und die Termine des Patienten in der Detailansicht prüfen.

Standardmäßig zeigt die Übersicht zukünftige aktive Termine.

## Filter

Termine lassen sich filtern nach:

* Arzt
* Patient
* Status
* Zeitraum

## Terminstatus

* `held` — der Slot ist vorübergehend reserviert, aber noch nicht bestätigt.
* `confirmed` — der Termin ist gebucht.
* `cancelled` — der Termin wurde storniert.
* `expired` — ein temporärer Hold ist vor der Bestätigung abgelaufen.
* `completed` — der Termin ist beendet.
* `no_show` — der Patient ist nicht erschienen.

## Termine stornieren

Admins können aktive `held`- und `confirmed`-Termine stornieren. Ein Stornogrund ist Pflicht. Der
Grund wird am Termin gespeichert, damit Support- und Operations-Teams den Hintergrund nachvollziehen
können.

<Note>
  Admin-Stornierungen sind operative Aktionen und unterliegen nicht der patientenseitigen Mindest-Vorlaufzeit.
  Patienten- und Partner-Stornoregeln bleiben unabhängig davon bestehen.
</Note>

## Booking-Token-Secrets

Wenn Ihre Organisation **Patient Booking Tokens** in einem Partner-Backend (z. B. Shopify) ausstellt,
wird jedes Token gegen ein von RxScale ausgegebenes Secret signiert. Verwalten Sie diese in den
Organisationseinstellungen:

* **Secret erstellen.** RxScale gibt eine `key_id` (für den JWT-`kid`-Header) und den Secret-Wert
  zurück. Der Wert wird verschlüsselt gespeichert. Admins können ihn jederzeit über
  Einstellungen → Buchungs-Secrets erneut einsehen, sodass das Einfügen in einen neuen Minter
  keine Neu-Provisionierung erfordert.
* **Secret widerrufen.** Der Widerruf ist sofort wirksam. Tokens, die mit dem widerrufenen Key
  signiert wurden, werden beim nächsten Aufruf abgewiesen.

### Secret rotieren

1. Neues Secret erstellen. Sie haben jetzt zwei aktive Secrets.
2. Minter so umstellen, dass neue Tokens mit der neuen `key_id` signiert werden.
3. Warten, bis Tokens mit dem alten Key abgelaufen sind (in der Regel wenige Minuten dank kurzer TTL).
4. Altes Secret widerrufen.

Da jedes Token über den `kid`-Header geroutet wird, ist die Rotation ohne Downtime möglich.

## Terminarten und Meeting-Räume provisionieren

Terminarten und persistente Meeting-Räume werden vom RxScale-Team während des Onboardings und auf
Anfrage konfiguriert:

* **Terminarten** definieren Dauer, Hold-TTL, Stornovorlauf und Umbuchungsregeln.
* **Meeting-Räume** sind pro Arzt vorkonfiguriert (`persistent_per_provider`-Strategie), sodass
  Patient und Arzt immer im selben Jitsi-Raum landen.

Wenden Sie sich an den Support, wenn eine neue Terminart angelegt oder Meeting-Räume geändert
werden sollen.

## Verfügbarkeitsfenster der Ärzte

**Ärzte verwalten ihre buchbaren Fenster selbst.** Jeder Arzt hat in seinem Portal eine
Verfügbarkeitsseite, auf der er wöchentlich wiederkehrende Slots anlegen, bearbeiten oder löschen
kann — daraus speist sich die Buchungsseite der Patienten. Als Admin können Sie die aktuellen
Fenster eines Arztes auf der Arzt-Detailseite lesend einsehen — hilfreich beim Troubleshooting,
wenn Patienten keine Slots sehen, oder beim Audit der Abdeckung. Änderungen vereinbaren Sie mit
dem Arzt oder über den Support.

## Umbuchen im Auftrag eines Patienten

Aus der Termin-Detailseite können Sie einen bestehenden Termin auf einen neuen Slot verschieben.
Die Umbuchung respektiert den `rebooking_mode` (gleicher Arzt vs. beliebiger Arzt) und die
Mindest-Vorlaufzeit der Terminart. Admin-Umbuchungen werden als neuer Termin angelegt, der über
`previous_meeting_uid` mit dem ursprünglichen verknüpft ist — der Audit-Trail bleibt erhalten.

## Termin­erinnerungen

Erinnerungen konfigurieren Sie **pro Terminart**. Jede Regel hat:

* eine Empfängergruppe — `patient`, `doctor` oder `admin`,
* einen `minutes_before`-Offset (z. B. 60 = eine Stunde vor dem Termin),
* die Schalter `send_email` und `send_sms` — sind beide aus, wird das Event trotzdem publiziert
  (Partner können es abonnieren), RxScale versendet aber selbst nichts.

Pro Gruppe können Sie mehrere Erinnerungen anlegen, z. B. eine Arzterinnerung 24h vorher und eine
zweite 15 Minuten vorher. Der Maintenance Manager läuft jede Minute und publiziert pro
auflösbarem Empfänger ein `APPOINTMENT_REMINDER_DUE`-Event. Eine interne
`appointment_reminders_sent`-Zeile garantiert Idempotenz, sodass dieselbe Erinnerung pro Termin
nie zweimal feuert.

Um die Events in Ihren Systemen zu empfangen, abonnieren Sie `APPOINTMENT_REMINDER_DUE` auf der
Benachrichtigungsabos-Seite — der bestehende Webhook-Abo-Mechanismus regelt Signatur, Custom-
Header und Retries genau wie bei Rezept-Events.

## Arzt-Telefonnummern für SMS-Erinnerungen

Aktiviert eine Regel `send_sms` für die Arzt-Empfängergruppe, benötigt RxScale eine
Mobilnummer auf dem Arztprofil. Ärzte können die Nummer selbst auf der Einstellungs-Seite im
Arztportal hinterlegen; Admins können sie auch in der Arzt-Detailseite (Feld
"Mobiltelefonnummer", getrennt vom Rezepttelefon) bearbeiten.
