Files
fewo-stommer/docs/architecture/portale-und-belegung.md
T

7.5 KiB

Portale und Belegung

Stand: 26.10.2026 · Übersicht

Fortschreibung vom 29.10.2026: Die generische iCal-Kanalkonfiguration wurde am 27.10. bereitgestellt und erweitert den hier beschriebenen Ausgangsstand um getrennte Richtungen, Test-/Regulärmodus, sichere Pause und strengere Bestandsprüfung. Ebenfalls bereitgestellt sind die zentrale Belegungsverwaltung, persönliche Gastzuordnung sowie Zweck und Privat-Kennzeichnung für Sperrzeiten. Für das geänderte Verhalten gilt die dortige Beschreibung; insbesondere werden Mail- und Kalender-Sperren nur bei gemeinsamer Kennung zusammengeführt und fehlende Ereignisse nicht sofort gelöscht.

Das System führt die zentrale Belegung aus eigenen Aufenthalten, Vormerkungen, manuellen Sperren und importierten Portalbelegungen zusammen. Ziel ist, denselben Zeitraum nicht mehrfach zu vergeben und nötige Nacharbeiten sichtbar zu machen.

Umgesetzte Funktionen

Verfügbarkeit und Sperrzeiten

Eine Nacht ist nicht verfügbar, wenn sie durch eine gültige Vormerkung, eine bestätigte Buchung oder eine Sperrzeit belegt ist. Sperrzeiten können etwa Eigennutzung, Wartung oder externe Belegung abbilden. An- und Abreise am selben Tag sind möglich, da der Abreisetag keine weitere Aufenthaltsnacht belegt.

Verfügbarkeit wird bei Anfrage, Angebot und Bestätigung geprüft. Abgelaufene Vormerkungen blockieren unabhängig vom Zeitpunkt des nächsten automatischen Laufs nicht mehr. Freie Lücken zwischen Belegungen können für Mindestaufenthaltsausnahmen und Lückenfüller-Angebote ausgewertet werden.

Seit dem 27.10. steht zusätzlich ein grafischer Belegungsplan in der Verwaltung bereit, mit freien Nächten, Wechseln und Details zu Buchungen, Sperrzeiten und ungeklärten Belegungen. Öffentliche Verfügbarkeitsanzeigen und dieser interne Plan haben unterschiedliche Aufgaben; Umfang und Bedienung stehen in der zentralen Belegungsverwaltung.

Portale je Wohnung einrichten

Die Verwaltung kann Portale mit passender Anbindung, Kalenderadresse, Aktivität, bekannten Mailabsendern und gegebenenfalls einem Link zum externen Vermieterkalender pflegen. Das Anbindungsmodell ist erweiterbar: Portale werden über austauschbare Anbindungen integriert.

Vorhanden ist der allgemeine iCal-Kalenderabgleich. Ein weiterer Kalenderkanal kann damit über die Verwaltung eingerichtet werden, sofern das Portal diesen Weg unterstützt. Eine portalspezifische Übertragung von Preisen, Nachrichten oder vollständigen Buchungsdaten ist damit noch nicht verbunden.

Kalender einlesen und bereitstellen

Richtung Funktion
Portal zum System Externe Belegungen als zugeordnete Sperrzeiten übernehmen und beim weiteren Abgleich aktualisieren
System zum Portal Eigenen Kalender je Kanal zum Abruf bereitstellen
Vermeidung von Rückkopplungen Im Kalender für ein Portal dessen eigene importierte Sperren auslassen

Abgleiche lassen sich manuell anstoßen und werden protokolliert. Der automatische Abruf ist alle fünf Minuten vorgesehen und im Aufgabenplan hinterlegt. Die tatsächliche Aktivität hängt von der Einrichtung des Hintergrundbetriebs ab.

iCal überträgt Belegungen mit Verzögerung. Die Zeit bis zur Übernahme in einem anderen Portal hängt auch davon ab, wann dieses den eigenen Kalender abholt. Das System bietet daher keine garantierte Echtzeitsperrung in allen Portalen.

Portal-E-Mails als schneller Weg

Das eigene Portal-Postfach eines Mandanten kann Buchungs-, Storno- und Anfragemails einlesen. Bekannte Absender werden dem Kanal zugeordnet; erkannte Termine und Referenzen helfen bei der Verarbeitung. Der automatische Postfachabruf ist minütlich vorgesehen. Alternativ können berechtigte externe Automatisierungen Portal-Mails übergeben.

Sicher erkannte Buchungen erzeugen sofort eine Sperrzeit aus der E-Mail. Der spätere Kalenderabgleich kann diese bestätigen oder ersetzen. Eine reine Mail-Sperre wird nicht allein deshalb entfernt, weil sie im Kalenderabruf noch fehlt. Erkannte Stornierungen können zugehörige Mail-Sperren wieder freigeben.

Unsicher erkannte Nachrichten erscheinen als „Bitte prüfen“ und lösen einen internen Hinweis aus. Die Verwaltung kann daraus manuell eine Sperre anlegen. Die Erkennung ist vorhanden, muss aber noch mit echten Nachrichten der genutzten Portale weiter erprobt werden.

Aufgaben für manuelle Portalpflege

Für Portale, die zusätzlich von Hand gepflegt werden sollen, entstehen Aufgaben zum Sperren oder Freigeben von Zeiträumen. Auslöser sind unter anderem bestätigte oder stornierte Buchungen, Sperrzeiten und Belegungen anderer Kanäle.

Die Aufgabe enthält den Zeitraum und den hinterlegten Einstieg in den Portalkalender. Nach der Bearbeitung wird sie als erledigt markiert. E-Mail-Hinweise und Erinnerungen unterstützen die Nachverfolgung. Eine vorbereitete Übergabe an externe Automatisierung mit Erledigungsrückmeldung ist ebenfalls vorhanden; ein tatsächlich angebundener Portal-Bot gehört nicht zum nachgewiesenen Funktionsumfang.

Konflikte und Störungen erkennen

Neue externe Belegungen werden auf Überschneidungen geprüft. Konflikte lösen Warnungen aus. Fehlgeschlagene oder zu lange ausstehende Abgleiche und Postfachstörungen werden gemeldet. Offene Aufgaben und Kanäle mit Problemen erscheinen in der Verwaltung.

Ein geschützter Zustandsabruf ermöglicht die Einbindung einer externen Überwachung. Die externe Überwachung selbst ist noch eine Option. Auch die eingebauten Prüfungen benötigen den eingerichteten regelmäßigen Hintergrundlauf.

Grenzen des vorhandenen Portalmodells

Portalbuchungen sind derzeit im Wesentlichen Sperrzeiten und zugehörige Mailhinweise. Das System führt daraus noch keine vollständige eigene Buchung mit Gast, Preis, Gebühren, Portalabrechnung und Zahlung. iCal liefert diese Daten nicht zuverlässig mit.

Eine unbekannte Angabe darf nicht als vorhandene Gast- oder Zahlungsinformation behandelt werden. Die spätere Übernahme vollständiger Buchungen muss nachweisbare Datenquellen verwenden.

Geplante Erweiterungen und Optionen

Erweiterung Stand Abhängigkeit
Portalbuchungen als vollständige Buchungen Geplant Daten aus belastbaren Mails oder autorisierten Schnittstellen; fachlicher Umfang noch zu bestätigen
Verbindung zu einem Channel-Manager Option Passende Portalabdeckung, tatsächliche Synchronisationsleistung und klare Führung der Belegung
Direkte Portal-Schnittstellen Option Verfügbare autorisierte Anbindung; bisher kein fertiger spezifischer Anschluss
Verbindliche Website-Direktbuchung Geplant Ausreichend verlässliche zeitnahe Synchronisation vorausgesetzt
Unabhängiger Betriebswächter Option Externen Zustandsabruf regelmäßig prüfen und unabhängig alarmieren
Automatisierte Bearbeitung externer Portalkalender Option Zulässigkeit und Zuverlässigkeit je Portal klären; derzeit nur Übergabemöglichkeit vorhanden
Gästemeldung oder feratel-Anbindung Offene Option Im älteren Portalpapier vorgeschlagen; spätere Projektentscheidung sieht Kurabgabe bei Balu vor, Meldeschein-Zuständigkeit ist offen

Die aktuelle Dokumentation trifft keine neue Anbieterwahl und übernimmt keine früher recherchierten Preise oder Leistungszusagen als heutige Zusicherung.

Quellen: Konzept, Portal-Analyse, Projektstand, Datenmodell-Entwurf. Funktionsabgleich: Belegungsprüfung, Kanalabgleich, Portal-Mails und Portal-Aufgaben.