Skip to content

Repository files navigation

AD Kalender

Wochen- und monatsbasierte Dienst- und Terminplanung mit wiederkehrenden Terminen, Personensuche, Gruppenfiltern, Meetinglückensuche, Standarddienstzeiten, read-only Urlaubsmarkierungen und persönlichem Dienstexport in Nextcloud sowie externe Kalender.

Die Monatsansicht stellt alle betroffenen Kalenderwochen untereinander dar und lässt sich wie die Wochenansicht zwischen „Tage als Zeilen“ und „Personen als Zeilen“ umschalten. Die zu den Personen gehörende erste Spalte beziehungsweise Kopfzeile bleibt beim Scrollen sichtbar. Tage außerhalb des gewählten Monats sind abgedunkelt; Samstag und Sonntag werden zusätzlich als „Wochenende“ beschriftet. Gesetzliche Feiertage der organisationsweit konfigurierten Kalenderregion werden über den gemeinsamen LocalBase-Kalendervertrag geliefert, namentlich gekennzeichnet und bleiben ohne Auswirkung auf Dienste, Termine oder Rechte. Berlin bleibt Bestandsdefault. Zeitraum und Ausrichtung können zusammen mit den Filtern als persönlicher Standard gespeichert werden.

Staging-Kompatibilität

  • Nextcloud 34
  • PHP 8.3 oder neuer innerhalb des von Nextcloud 34 unterstützten Bereichs
  • Laufzeitbasis: localbase; orgsuite ist ab zwei AD-Fachprodukten optional aktiv
  • App-ID und Installationsordner: adcalendar

Installation

Für Staging und Auslieferung das Produktbundle ad-product-adcalendar-<release>.tar.gz und dessen enthaltenes install.sh verwenden. Es prüft und installiert LocalBase automatisch; ab dem zweiten AD-Fachprodukt aktiviert es OrgSuite.

AD Kalender funktioniert einzeln. Ohne AD Urlaub stehen manuelle Sperrtermine zur Verfügung; die read-only Urlaubsmarkierungen entfallen.

Der Befehl adcalendar:demo:seed ist ausschließlich für synthetische Testdaten gedacht und darf auf einem realitätsnahen Staging-System nicht ohne bewusste Entscheidung ausgeführt werden.

Externe Kalender

Jede angemeldete Person verwaltet Kopano-, Google-, Apple- und manuelle CalDAV-Verbindungen im eigenen Tab Einstellungen. AD Calendar erzeugt beim Anbieter einen sichtbaren Kalender AD Dienste und exportiert ausschließlich Dienste. Anbieterinhalte werden nicht in AD Calendar eingeblendet oder zurückimportiert.

  • Kopano ist mit https://mail.adberlin.org vorbelegt; die Adresse bleibt im Verbindungsdialog änderbar.
  • Der Kopano-Betreiber muss einen HTTPS-CalDAV-Endpunkt bereitstellen. HTTP 405 wird im Connector ausdrücklich als nicht freigegebener CalDAV-Zugriff erklärt; die notwendige Serverfreigabe kann nicht durch AD Kalender erfolgen.
  • Nextcloud-Admins können Adresse und Zugang im AD-Kalender-Adminabschnitt mit einer ausschließlich lesenden CalDAV-Anfrage prüfen. Das Passwort wird weder gespeichert noch zurückgegeben; der Test legt keinen Kalender an.
  • Apple und manuelles CalDAV verwenden ein Anbieter- beziehungsweise app-spezifisches Passwort.
  • CalDAV-Ziele müssen HTTPS verwenden. Nextclouds HTTP-Client erzwingt zusätzlich seine serverseitige SSRF-Sperre.
  • Persönliche Passwörter und Google-Tokens liegen verschlüsselt und als sensible Nextcloud-Benutzerkonfiguration vor.

Google benötigt einmalig einen systemweiten Web-OAuth-Client. Nextcloud-Admins hinterlegen ihn unter AdministrationseinstellungenAD KalenderGoogle Calendar OAuth. Die Oberfläche zeigt die installationsspezifische Redirect-URI, speichert das Secret als lazy und sensitive und gibt es nach dem Speichern nicht wieder aus.

In Google Cloud sind die Google Calendar API, ein OAuth-Zustimmungsbildschirm und ein OAuth-Client vom Typ Webanwendung erforderlich. Als autorisierte Redirect-URI wird exakt der Wert aus dem AD-Kalender-Adminabschnitt übernommen. Technisch verwendet die App die Schlüssel google_oauth_client_id und google_oauth_client_secret sowie den eng begrenzten Scope für app-erzeugte Kalender.

Die allgemeine Form der Weiterleitungsroute lautet:

<NEXTCLOUD-BASIS>/index.php/apps/adcalendar/oauth/google/callback

Bei installationsweit aktivem Pretty-URL-Rewriting kann index.php entfallen. Maßgeblich ist ausschließlich der in der Adminoberfläche angezeigte Wert.

Roadmap

Geplante Erweiterungen und offene Produktentscheidungen stehen in der Roadmap.

Installations-, Betriebs- und Abnahmeunterlagen stehen im öffentlichen AD-Suite-Projekt.

About

Dienst-, Termin- und Meetingplanung der AD Suite für Nextcloud

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages