Files

T

Florian WildeandClaude Opus 5 a8b2ff0235 docs: Handbuchseite und Einrichtung der Kalenderanbieter

Die Handbuchseite erklärt, was der Planer liest und was ausdrücklich nicht,
warum alle Kalender gegen jeden Bereich zählen und was beim Trennen mit den
Terminen passiert.

Die README bekommt eine Schritt-für-Schritt-Anleitung für Entra ID und die
Google Cloud Console — mit den genauen Rückleit-URIs und Berechtigungen.
Dazu der Hinweis, dass ein Google-Projekt im Status "Test" die
Aktualisierungstoken nach sieben Tagen verfallen lässt; das kostet sonst
einen halben Abend Fehlersuche.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-10 18:12:05 +02:00

5.8 KiB

Raw Permalink Blame History

Kalenderkonten verbinden

Der Planer liest deine Termine, um zu wissen, wann überhaupt Platz ist. Ab M4 schreibt er Zeitblöcke in denselben Kalender zurück.

Was der Planer liest — und was nicht

Liest er	Nutzt er wofür
Beginn und Ende	Belegung gegen die Tageskapazität
Betreff	Anzeige in der Wochenansicht
Ganztägig ja/nein	Ganztägige Termine zählen nicht zur Belegung
„Zeigt an als" (frei, gebucht, …)	Als frei markierte Termine zählen nicht

Nicht gelesen werden Teilnehmer, Beschreibungstexte, Anhänge und Orte. Betreffs stehen in der Datenbank, damit du sie in der Ansicht siehst — sie landen aber niemals in Protokollen.

Gelesen wird ein Fenster von 7 Tagen zurück bis 90 Tage voraus. Was aus diesem Fenster herauswandert, wird nachts wieder entfernt.

Einen Kalender verbinden

Im Menü auf Kalender.
Auf Microsoft 365 verbinden beziehungsweise Google verbinden.
Beim Anbieter anmelden und der Berechtigung zustimmen.
Du landest wieder hier, und der erste Abgleich läuft sofort.

Warum fragt der Planer auch nach Schreibrechten? Weil er ab M4 Zeitblöcke in den Kalender schreibt. Würde er jetzt nur Leserechte anfordern, müsstest du später jedem Konto erneut zustimmen — und genau daran scheitert Einrichtung erfahrungsgemäß.

Welche Anbieter es gibt

Das hängt an der Instanz und ist nicht verhandelbar:

	Firma	Daheim
Microsoft 365	ja	ja
Google	nein	ja

In der Firmeninstanz gibt es die Google-Seite nicht — der Aufruf endet dort mit „Diese Seite gibt es nicht". Das ist Absicht, kein Fehler.

Der Abgleich

Alle 15 Minuten läuft der Abgleich von selbst. Mit Jetzt abgleichen stößt du ihn von Hand an.

Beide Anbieter liefern nur die Änderungen seit dem letzten Mal, nicht jedes Mal alle Termine. Läuft dieser Merker ab — das passiert nach längerer Pause —, liest der Planer den ganzen Zeitraum neu ein. Davon merkst du außer einem etwas längeren Abgleich nichts.

Die Belegung

Auf der Startseite zeigt jeder Bereich, wie voll der heutige Tag schon ist: Termine aus allen verbundenen Kalendern gegen die Tageskapazität dieses Bereichs.

Warum zählen alle Kalender gegen jeden Bereich? Weil ein Termin die Zeit ohnehin blockiert, ganz gleich, zu welchem Lebensbereich er gehört. Wer um 14 Uhr beim Zahnarzt sitzt, kann zur selben Zeit nichts für die Firma tun.

Gezählt wird nur, was ins Arbeitsfenster des Bereichs fällt. Ein Termin um 22 Uhr verkleinert die Kapazität eines Bereichs nicht, dessen Fenster um 17 Uhr endet.

Überlappende Termine werden zusammengelegt — eine Doppelbuchung zählt nur einmal.

Ein Konto umbenennen

Die Bezeichnung ist frei wählbar. „Firma Outlook" oder „Gewerbe" liest sich besser als die Mailadresse, gerade wenn du mehrere Konten desselben Anbieters hast.

Ein Konto trennen

Der rote Knopf, mit Rückfrage. Die gespiegelten Termine verschwinden dabei — im Kalender selbst bleibt alles unangetastet. Der Planer hat bis M4 ohnehin nur gelesen.

Zusätzlich solltest du die Berechtigung beim Anbieter selbst zurückziehen:

Microsoft: https://myapps.microsoft.com → Zugriff verwalten
Google: https://myaccount.google.com/permissions

Wenn es klemmt

Was du siehst	Was dahintersteckt
„Der Anbieter hat kein Aktualisierungstoken herausgegeben."	Meist bei Google, wenn du schon einmal zugestimmt hattest. Berechtigung im Google-Konto entziehen und neu verbinden.
„Die Anfrage war ungültig oder zu alt."	Zwischen Klick und Zustimmung lagen mehr als 30 Minuten. Einfach neu beginnen.
„Kein Aktualisierungstoken hinterlegt."	Das Konto muss neu verbunden werden. Das passiert auch, wenn `AUTH_SECRET` gewechselt wurde.
„Der Anbieter antwortete mit 401."	Die Berechtigung wurde beim Anbieter entzogen. Neu verbinden.
„unerwartete Zeitzone …, erwartet wurde UTC"	Ein Konfigurationsfehler auf Serverseite. Bitte melden — der Planer bricht hier bewusst ab, statt Termine um Stunden zu verschieben.
Die Belegung bleibt leer	Kein Kalender verbunden, oder der erste Abgleich lief noch nicht. Die Karte zeigt die Belegung erst, wenn wirklich ein Kalender dranhängt.

Sicherheit

Die Zugangstoken liegen verschlüsselt in der Datenbank (AES-256-GCM). Wer eine Sicherung in die Hände bekommt, kann damit nichts anfangen, solange er nicht auch AUTH_SECRET hat.

Wird AUTH_SECRET gewechselt, müssen alle Kalenderkonten neu verbunden werden. Das ist gewollt: mit dem alten Geheimnis sind auch alle Sitzungen ungültig.

Für die Einrichtung auf Serverseite — was in Entra ID und in der Google Cloud Console anzulegen ist — siehe README, Abschnitt Kalenderanbieter.

5.8 KiB Raw Permalink Blame History