Visuelle iCal-Regelengine mit Originaldaten und individuellen Exportfeldern integrieren
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m37s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m37s
This commit is contained in:
1 parent
c4ebccbbea
commit
e9db98701b
30 files changed
+1269
-15
No files matched your search
@@ -6,6 +6,8 @@ # Generische iCal-Integration und konfigurierbare Portalkanäle
|
||||
|
||||
## 1. Gültigkeit und Nachweisstand
|
||||
|
||||
Die [visuelle iCal-Regelengine](ical-regelengine.md) erweitert diesen Stand um Analyse der Originalfelder, benutzerdefinierte Klassifikation und individuelle Exportinformationen. Die frühere Standardaussage „keine Gastdaten im Export“ gilt weiterhin ohne ausdrückliche Feldzuordnung und Namensfreigabe; die neue Option wird je Zielkanal bewusst aktiviert. IDs, Zeiträume, Herkunftsschutz und bestätigte Zuordnungen bleiben bestehen.
|
||||
|
||||
Die vorhandene Kanalverwaltung, der Connector `ical`, Import, Export, Portal-Mails, Aufgaben und Protokolle wurden erweitert. Es gibt keine separate FeWo-direkt- oder Ostseeklar-Synchronisation. Ein weiterer Anbieter benötigt keine Codeänderung, wenn er das unten beschriebene Kalenderprofil unterstützt.
|
||||
|
||||
| Ebene | Stand |
|
||||
|
||||
@@ -8,6 +8,8 @@ # iCal-MVP: Bereitstellung und Benutzung
|
||||
|
||||
## Oberfläche und automatische Exportlinks
|
||||
|
||||
**Erweiterung um Kalenderanalyse und visuelle Regeln:** [Bedienung der iCal-Regelengine](ical-regelengine.md) beschreibt Feldentdeckung, Regelentwurf, Live-Vorschau, Neuauswertung, Führungskandidaten und individuell freigegebene Exportinformationen. Der konkrete Auslieferungs- und Realteststand wird dort getrennt nachgeführt.
|
||||
|
||||
Die eigenständige Verwaltungsseite **Vermietung → Kalenderabgleich (iCal)** (`/admin/channels`) zeigt die Kalenderverbindungen des angemeldeten Vermieters. Jeder Eintrag steht für den iCal-Belegungsabgleich einer Wohnung mit einem externen Kalender. Weitere Portalfunktionen wie Preise, Nachrichten oder vollständige Buchungsabläufe benötigen eigene Anbindungen und werden durch diesen Eintrag nicht aktiviert. Die Seite ist in der einfachen und der Expertenansicht erreichbar. Über **iCal-Verbindung anlegen** werden Wohnung, frei gewählter Name der Kalenderverbindung und Kalenderanbindung eingetragen. Es gibt keine vorausgewählten oder automatisch eingerichteten Anbieter. Auch auf ausdrücklichen Wunsch im Folgeauftrag wurde kein Ostseeklar-Kanal angelegt.
|
||||
|
||||
Jede iCal-Verbindung lässt sich individuell konfigurieren und bearbeiten. Die Übersicht bietet Suche nach Namen/Wohnung sowie die Aktionen für Exportlink, Exportumfang, Import und Protokoll. Die Einstellungen bleiben zusätzlich unter **Wohnungen → Wohnung bearbeiten → Kalenderabgleich (iCal)** erreichbar; beide Ansichten verwenden dieselben Formulare, Aktionen und Geschäftsregeln. Die interne Route `/admin/channels`, vorhandene Verbindungen und Exportadressen bleiben bei der begrifflichen Klarstellung erhalten.
|
||||
|
||||
@@ -0,0 +1,71 @@
|
||||
# Visuelle iCal-Regelengine
|
||||
|
||||
Stand: 27.10.2026 · Implementierung zur Bereitstellung vorbereitet; tatsächliche Auslieferung und echte Kalendernachweise werden nach der Abnahme ergänzt.
|
||||
|
||||
## Kalender analysieren
|
||||
|
||||
Unter **Vermietung → Kalenderabgleich (iCal)** am gewünschten Kanal **Weitere Aktionen → Kalender analysieren** wählen. Dieselbe Aktion steht auf seiner Konfigurationsseite. Die Importadresse muss vorher gespeichert sein. Über **Regeln & Exportfelder** wird die Auswertungsseite auch ohne neuen Abruf geöffnet, beispielsweise für einen reinen Exportkanal.
|
||||
|
||||
Die Analyse liest den echten Portalkalender und zeigt:
|
||||
|
||||
- Anzahl der Originalereignisse, einschließlich solcher ohne aktuell belegenden Zeitraum.
|
||||
- Tatsächlich vorhandene Ereignisfelder, auch unbekannte Zusatzfelder und wiederholte Angaben.
|
||||
- Häufige Werte, Beispielwerte und generisch erkannte Textpräfixe mit Ereigniszahlen.
|
||||
- Kalender-Kopfdaten sowie aufklappbare Originalereignisse mit ihren Parametern.
|
||||
|
||||
Die Analyse importiert und löscht keine Belegung. Ein fehlgeschlagener Abruf ersetzt den bisherigen Analysestand nicht. Originalfelder, Ereignistexte und Auswertung mit Namensbestandteilen werden verschlüsselt gespeichert und nur innerhalb der berechtigten Verwaltung angezeigt. Gefaltete iCal-Zeilen werden für die lesbare Originalansicht entfaltet.
|
||||
|
||||
## Regeln ohne Code erstellen
|
||||
|
||||
Jede Regel hat einen Namen, eine Priorität, einen Aktivierungsschalter und beliebig kombinierbare Bedingungen. Kleinere Prioritätszahlen werden zuerst ausgewertet; bei Gleichstand entscheidet die sichtbare Reihenfolge. Die **erste passende aktive Regel** bestimmt die Interpretation. Nachfolgende Regeln überschreiben das Ergebnis nicht.
|
||||
|
||||
Das Feld wird aus den gefundenen Kalenderfeldern gewählt. Vergleiche sind **gleich, ungleich, beginnt mit, endet mit, enthält, vorhanden, leer**. Bedingungen werden mit **UND** oder **ODER** verbunden. Standardmäßig sind Vergleiche unabhängig von der Groß-/Kleinschreibung. „Vorhanden“ prüft die Existenz eines Feldes; „leer“ umfasst auch fehlende Felder. „Ungleich“ benötigt ein vorhandenes Feld.
|
||||
|
||||
Aktionen bestimmen Ereignistyp, bekannten ursprünglichen Buchungskanal und die Einordnung als führenden Kandidaten oder zusätzliche Sperre. Ein unbekannter Ursprung bleibt unbekannt. Die Regeln sind Kanalkonfiguration und enthalten keine fest eingebauten Anbieternamen oder Interpretationen.
|
||||
|
||||
Texte werden über **Gesamter Text**, **Text nach**, **Text vor** oder **Text zwischen** übernommen. Verfügbare Zielfelder sind Gastvorname/Namensbestandteil, vollständiger Gastname, Buchungsreferenz, Belegungsbeschreibung und Zusatzinformation. Fehlt ein Trenntext, wird keine Information erfunden. Leerzeichen in Vergleichs- und Trenntexten bleiben erhalten. Ein Vorname wird nicht automatisch zu einem vollständigen Namen ergänzt. Diese Felder erweitern die importierte Kalenderbelegung; sie erzeugen keine vollständige Buchung oder einen Gästekartei-Eintrag.
|
||||
|
||||
## Vorschau, Entwurf und Aktivierung
|
||||
|
||||
Die Live-Vorschau zeigt Treffer je Regel, unerkannte Ereignisse, Klassifikation, erkannten Ursprung, extrahierte Informationen und die Originalereignisse. Sie verwendet den gespeicherten Analysestand und den aktuellen Entwurf. Für neue Kalenderdaten erneut analysieren.
|
||||
|
||||
**Speichern** speichert die Regeln zunächst als Entwurf. Bereits aktive Regeln bleiben für die automatischen Importe maßgeblich. **Auf Bestand anwenden** bestätigt und aktiviert den Entwurf und klassifiziert vorhandene Einträge neu. Danach verwenden auch folgende Importe diese Regeln.
|
||||
|
||||
Die Neuauswertung erhält lokale IDs, externe UIDs, Zeiträume und bestätigte persönliche Zuordnungen. Fehlende Originaldaten alter Einträge können anhand derselben UID aus der Analyse ergänzt werden; Löschen und Neuimport sind nicht erforderlich. Nicht zuordenbare alte Einträge bleiben unverändert. Hat ein neuerer Import seit der Analyse andere Originaldaten geliefert, verlangt die Anwendung eine neue Analyse. Abweichende Termine zwischen Analyse und gespeichertem Zeitraum werden als Prüffall markiert und durch die Klassifikation nicht verändert.
|
||||
|
||||
## Führende Repräsentation und Zuordnung
|
||||
|
||||
Eine erkannte Portalreservierung kann als führender Kandidat mit Vorrang gegenüber einer allgemeinen Sperre gekennzeichnet werden. Bei identischen Terminen zeigt die Vorschau mögliche Zusammenhänge mit vorhandenen Sperren und die Begründung **„exakt derselbe Zeitraum“**.
|
||||
|
||||
Dieser Hinweis ist kein Identitätsnachweis. Eine Regel erzeugt keine automatische Zusammenführung und hebt keine zusätzliche Sperre ungeprüft auf. Unter **Sperrzeiten → Belegung zuordnen / klären** wird die Identität persönlich bestätigt. Führende Kandidaten stehen dort bei den gleich terminierten Zielen zuerst. Bestätigte Verknüpfungen und persönlich bekannte Herkunft werden durch die Regelauswertung erhalten.
|
||||
|
||||
Die Sperrzeitenübersicht zeigt den erkannten Ereignistyp und verfügbare Namensinformationen. **iCal-Original & Erkennung** öffnet das Original und die treffende Regel.
|
||||
|
||||
## Exportinformationen je Zielkanal
|
||||
|
||||
Auf **Regeln & Exportfelder** werden die Zielfelder **SUMMARY**, **DESCRIPTION** und **LOCATION** mit ausgewählten Informationen befüllt. Möglich sind Belegungsbeschreibung, verfügbarer Vor- oder vollständiger Name, Buchungsreferenz, Zusatztext, Wohnung, bekannter Ursprung/Importkanal, Anreise, Abreise und Nächte. Reihenfolge und Trennzeichen sind konfigurierbar.
|
||||
|
||||
Ohne Zuordnung bleibt `SUMMARY:Belegt`. Nicht vorhandene Informationen werden ausgelassen. UID, Kalenderidentität und An-/Abreise können nicht durch eine Textzuordnung überschrieben werden. Die vorhandenen Herkunftsausschlüsse, Exportmodi, sicheren Pausen und Echo-Schutzregeln bleiben wirksam.
|
||||
|
||||
**Gastnamen ausdrücklich an diesen Zielkanal weitergeben** muss für die Namensfelder eingeschaltet werden. Diese Freigabe ist je Kanal getrennt und standardmäßig aus. Ohne sie werden Namensfelder auch bei einer bereits vorhandenen Zuordnung zur Laufzeit ausgeschlossen. Ein vollständiger Name ist nur verfügbar, wenn er tatsächlich aus der Quelle oder einer eigenen Buchung bekannt ist.
|
||||
|
||||
Die Exportvorschau zeigt die aktuell berechneten Ereignisse vor dem Speichern. Ein pausierter Export liefert weiterhin seinen eingefrorenen Stand. **Speichern aktiviert die Exportkonfiguration**; der Regelentwurf wird dadurch noch nicht für Import/Bestand aktiviert. Die tatsächliche Darstellung im Zielportal muss unabhängig geprüft werden. Ein Feedabruf oder eine bei uns vorhandene SUMMARY beweist keine Namensübernahme im Portal.
|
||||
|
||||
## Generischer erster Anwendungsfall
|
||||
|
||||
Die gewünschten Beispielregeln werden als normale Daten konfiguriert:
|
||||
|
||||
| Regel | Bedingung | Ergebnis |
|
||||
|---|---|---|
|
||||
| Portalreservierungen | SUMMARY beginnt mit `Reserved - ` | Portalreservierung; Ursprung aktueller Kanal; führender Kandidat; Text nach `Reserved - ` als Gastvorname/Namensbestandteil |
|
||||
| Allgemeine Sperren | SUMMARY ist gleich `Blocked` | Allgemeine Sperre; unbekannter Ursprung; zusätzliche Sperre; kein Gastname |
|
||||
|
||||
Dieselbe Oberfläche kann andere Felder, Werte und Trennzeichen eines dritten Anbieters verwenden. Die Muster sind keine Sonderfälle im Connector. Konkrete Anzahlen und Resultate des echten FeWo-direkt-Kalenders werden erst nach der tatsächlichen Analyse protokolliert.
|
||||
|
||||
## Nachweise und technische Orientierung
|
||||
|
||||
Die neuen Feature-Tests prüfen Feldentdeckung, Musterzahlen, alle visuellen Vergleiche, UND/ODER, Priorität, einfache Textextraktion, verschlüsselte Speicherung, Vorschau und Aktivierung, Bestandsidentität, persönliche Zuordnungen, unbekannte Drittanbieter, Rollen/Mandanten, HTML- und iCal-Escaping sowie individuelle Namensfreigabe und Exportzuordnung. Es werden ausschließlich synthetische Kalender in isolierter Testdatenbank verwendet.
|
||||
|
||||
Code: `ICalParser`, `ICalAnalysis`, `ICalRuleEngine`, `AnalyzeChannelCalendar`, `SaveChannelRules`, `ApplyChannelRules`, `ICalExportFields`, `ConfigureChannelExport` und die Ressourcenseite `ChannelRules`. Originaldaten und Interpretation erweitern die vorhandenen `Channel`-/`BlockedPeriod`-Modelle. Migration: `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata`. Testdatei: `tests/Feature/ICalRuleEngineTest.php`.
|
||||
|
||||
Aktueller Auslieferungsstand: [Projektstand](../STATUS.md). Kalendergrundregeln und Herkunft: [iCal-Kanalkonfiguration](ical-kanalkonfiguration.md). Bisherige praktische Inbetriebnahme: [MVP-Bericht](ical-mvp-inbetriebnahme-2026-10-27.md).
|
||||
Reference in new issue
Block a user