# Telefonliste — Benutzerhandbuch

## Aufruf

Rufen Sie die Telefonliste im Browser auf:
- Produktiv: https://telefon.c3po42.de
- Lokal: http://localhost:8870

Sie landen **sofort in der Suche** — ohne Anmeldung. Dieser Viewer-Modus ist nur lesend: suchen, filtern, anrufen, mailen. Alles, was aendert (lokale Eintraege, AD-Konfig), ist ausgeblendet.

## Anmeldung (nur fuer Redakteur / Admin)

Klick auf **"Anmelden"** unten in der Seitenleiste oeffnet ein Login-Fenster. Nach erfolgreicher Anmeldung erscheinen die zusaetzlichen Bereiche ("Lokale Eintraege", "Administration") direkt in der Seitenleiste — ohne Seitenwechsel.

Demo-Zugaenge fuer die erste Einrichtung:

| Benutzer | Passwort | Was Sie duerfen |
|---|---|---|
| admin | admin | Alles (inkl. AD-Konfiguration und Loeschen) |
| redakteur | redakteur | Kontakte anlegen, bearbeiten |

Ein separater "viewer"-Benutzer ist nicht mehr noetig — jeder unangemeldete Aufruf ist automatisch im Viewer-Modus.

## Suche

Tippen Sie **ab 3 Buchstaben** in das Suchfeld — die Liste aktualisiert sich automatisch. Gesucht wird in:

- Name, Vorname, Nachname
- Abteilung, Titel
- Telefonnummer, Mobilnummer
- E-Mail
- Raum, Notiz

Beispiele:

| Suche | findet |
|---|---|
| `radio` | alle in der Radiologie |
| `meier` | Dr. Julia Meier |
| `1234-9` | alle Nummern, die mit 1234-9 beginnen |
| `notauf` | Notaufnahme und dazugehoerige Kontakte |
| `bereit` | alle Bereitschaftsdienste |

## Filter

Zusaetzlich zur Suche koennen Sie nach **Abteilung** und **Standort** filtern. Filter kombinieren sich mit der Suche.

## Kontakt anrufen / anschreiben

- **Klick auf Telefonnummer** → startet Anruf (bei Softphone/Tischtelefon je nach Konfiguration)
- **Klick auf Mobilnummer** → wie Telefon
- **Klick auf E-Mail** → oeffnet Ihren Mailclient (Outlook, Thunderbird, ...)

## Lokale Eintraege pflegen *(Redakteur + Admin)*

Wechseln Sie im Menue links auf **"Lokale Einträge"**.

- **+ Neuer Kontakt** legt einen neuen Eintrag an (z.B. Sammelnummer, Bereitschaftshandy, externer Dienstleister)
- Klick auf **"Bearbeiten"** oeffnet den Editor. Anzeigename ist Pflicht, alle anderen Felder optional.
- Admins koennen loeschen.

Pflichtfeld: **Anzeigename**. Alles andere ist optional.

## AD-Konfiguration *(nur Admin)*

Unter **"Administration"** richten Sie den Active-Directory-Sync ein. Ist er aktiviert, zieht die Telefonliste alle Benutzer aus der angegebenen OU und haelt sie aktuell.

Relevante Felder:

| Feld | Beispiel |
|---|---|
| AD-Sync aktivieren | Schalter oben |
| LDAP-Server | `dc01.ikk.local` |
| Port | `636` (LDAPS) |
| LDAPS / TLS | an (empfohlen) |
| Bind-DN | `CN=Telefonliste,OU=ServiceAccounts,DC=ikk,DC=local` |
| Bind-Passwort | Passwort des Service-Accounts |
| Base-OU | `OU=Mitarbeiter,DC=ikk,DC=local` |
| Sync-Intervall | `30` (Minuten) |

**Hinweis zum Passwort:** Wird das Feld leer gelassen, bleibt das zuvor gespeicherte Passwort erhalten.

### Ablauf

1. **Speichern** — speichert die Felder. Der Scheduler wird sofort aufgeweckt.
2. **Verbindung testen** — prueft nur den Bind, ohne Daten zu importieren. Zeigt die Anzahl gefundener Benutzer in der Base-OU.
3. **Jetzt synchronisieren** — startet einen Sync-Lauf sofort (synchron). Zeigt danach an, wie viele Kontakte angelegt / aktualisiert / deaktiviert wurden.

Der Status-Bereich unter den Buttons zeigt den letzten Lauf (Zeitpunkt, Status, ggf. Fehlermeldung).

### Was passiert beim Sync?

- Benutzer werden ueber ihre stabile `objectGUID` eindeutig erkannt — Umbenennungen sind unproblematisch.
- Lokale Overrides (z.B. anderer Raum, andere Durchwahl) bleiben erhalten und ueberschreiben die AD-Werte in der Anzeige.
- Benutzer, die aus der Base-OU verschwinden oder im AD deaktiviert wurden, werden **nicht geloescht**, sondern ausgegraut dargestellt.
- Der Scheduler laeuft automatisch im konfigurierten Intervall weiter, solange der Sync aktiv ist.

### Doppelte Eintraege vermeiden

Wenn ein Mitarbeiter schon lokal angelegt wurde und spaeter im AD erscheint, haelt die Telefonliste die beiden Eintraege auseinander — **sofern die Mail-Adresse identisch ist**. Dann wird der lokale Eintrag beim Sync automatisch auf AD umgehoben; lokale Werte (z.B. private Handynummer, andere Durchwahl) bleiben als Overrides erhalten.

Wo das nicht klappt (z.B. lokaler Kontakt ohne Mail), hilft der Abschnitt **"Mögliche Dubletten"** unter "Administration":

1. **Jetzt prüfen** klicken — die Liste zeigt alle Paare aus einem lokalen und einem AD-Kontakt, die vermutlich denselben Menschen meinen. Der Grund ("Gleiche Mail" / "Gleicher Vor+Nachname" / "Gleicher Anzeigename") und ein Score stehen dabei.
2. **Zusammenführen →** behaelt den AD-Eintrag, uebernimmt die lokalen Werte als Overrides und loescht den lokalen Eintrag.
3. **Ignorieren** blendet das Paar nur fuer die aktuelle Ansicht aus.

## Nutzungsstatistik

Im Admin-Tab zeigt der Abschnitt **"Nutzung"** pro Tag, wie oft die Telefonliste verwendet wird — aufgeschluesselt in **Suchen** (jemand hat nach einem Namen/einer Durchwahl gesucht) und **Detailansichten** (jemand hat einen Kontakt geoeffnet). Der Zeitraum ist umschaltbar (7 Tage / 30 Tage / 90 Tage / 1 Jahr).

Vier Kennzahlen oben:

- **Heute** — Zugriffe heute
- **Summe** — Zugriffe im gewaehlten Zeitraum
- **Ø / Tag** — Durchschnitt
- **Spitze** — hoechster einzelner Tag

Darunter ein Balkendiagramm pro Tag. Hover zeigt das genaue Datum und die Aufteilung. Personen werden **nicht** einzeln getrackt — nur die Gesamtzahl pro Tag.

## Auto-Update

Ist eine neue Version verfuegbar, erscheint oben ein gelber Banner. Klick auf **"Jetzt aktualisieren"** laedt das Update und startet den Dienst neu. Nach ~10 Sekunden laden Sie die Seite neu.

## Abmelden

Klick auf **"Abmelden"** unten in der Seitenleiste setzt Sie zurueck in den Viewer-Modus (Lesen, Suchen, Anrufen bleibt moeglich). Ohne Abmeldung bleibt Ihr Token 8 Stunden gueltig (Schichtlaenge).

## Symbole

| Symbol | Bedeutung |
|---|---|
| 📞 | Kontakt / Nummer |
| ☎ | Festnetz |
| 📱 | Mobil |
| ✉ | E-Mail |
| AD | Kontakt stammt aus Active Directory |
| LOKAL | Manueller / lokaler Eintrag |
| deaktiviert | Im AD deaktivierter Benutzer (ausgegraut) |

## Tipps

- Die Liste zeigt max. 200 Treffer — wird diese Grenze erreicht, Suche verfeinern.
- Sammelnummern (Notaufnahme, Bereitschaft) haben keinen Vor-/Nachnamen, nur einen Anzeigenamen.
- Bei Bereitschaftsdiensten steht die Schichtzeit in der Notiz-Zeile.
- AD-Eintraege koennen nicht direkt editiert werden — nur ueber Overrides. Weitere Felder wie Raum und Notiz sind aber frei.

## Support

Probleme oder Wuensche: IT (andre@astockma.de) oder Ticket unter https://support.ikk-kliniken.de