Files
fewo-stommer/docs/architecture/ical-regelengine.md
T

123 lines
21 KiB
Markdown

# Visuelle iCal-Regelengine
Stand: 29.10.2026 · **Auf stommer.info bereitgestellt**, Automatische Kalenderspiegelungen mit Anwendungskommit `add2367`, Release `20261029160338-add23678`; aktive Serverrevision, Sicherung, Migration in Batch 21 und anschließende reguläre Importe bestätigt. Regeldialog-Korrektur zuvor mit `a0497fc` bereitgestellt. Vorherige Regelbedienung mit `54efd3b` durch [Pipeline 4692](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4692) bereitgestellt. Regelengine ursprünglich mit `7c7955b` ausgeliefert. Additive MariaDB-Migration aus dem ersten Regelengine-Deployment in Batch 18 bestätigt. Die Folgekorrektur ermöglicht das direkte Abschalten der Namensweitergabe bei gespeicherter Feldzuordnung.
## 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.
**Entwurf speichern** steht dauerhaft oben auf der Seite und speichert die Regeln zunächst als Entwurf, auch bei wiederholten Änderungen. Bereits aktive Regeln bleiben für die automatischen Importe maßgeblich. **Speichern & anwenden** (zuvor „Auf Bestand anwenden“) speichert die aktuellen Formulareingaben, bestätigt und aktiviert den Entwurf und klassifiziert vorhandene Einträge neu. Danach verwenden auch folgende Importe diese Regeln. Die Anzeige **Gespeicherter Regelstand** zeigt ausdrücklich, ob sich gespeicherter Entwurf und aktive Regeln unterscheiden. Die Live-Vorschau allein ändert weder Kalender noch aktiven Regelstand.
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 fachliche Originaldaten geliefert, verlangt die Anwendung eine neue Analyse. Ausschließliche Änderungen an DTSTAMP und LAST-MODIFIED verhindern die Aktivierung nicht, sofern das vollständige Regelergebnis unverändert bleibt; die neuesten importierten Originaldaten bleiben erhalten. Verwendet die Regel einen geänderten Zeitstempel und ergibt sich dadurch ein anderes Ergebnis, ist ebenfalls eine neue Vorschau erforderlich. Abweichende Termine zwischen Analyse und gespeichertem Zeitraum werden als Prüffall markiert und durch die Klassifikation nicht verändert.
Bei erfolgreichem „Speichern & anwenden“ schließt sich die Bestätigung und die Erfolgsmeldung nennt die Anzahl geprüfter Einträge. Bei einer veralteten Vorschau oder ungültigen Formularangaben schließt sie ebenfalls und eine dauerhafte Fehlermeldung erklärt den Grund. Die Formulareingaben bleiben zur Korrektur erhalten; bei einem Abbruch werden weder Entwurf noch Exportkonfiguration oder aktive Regeln teilweise gespeichert. Der angezeigte gespeicherte Regelstand wird aus dem unveränderten Bestand neu geladen.
**Fehlerbefund vom 29.10.2026:** Bei Destination Solution war ein Regelentwurf gespeichert, aber noch keine aktive Regel vorhanden. Der automatische Import hatte ausschließlich DTSTAMP gegenüber der Vorschau geändert; Zeitraum und Regelergebnis waren gleich. Die bisherige Sicherheitsprüfung brach deshalb unnötig ab, und die zugehörige Validierungsmeldung war hinter dem Bestätigungsdialog unsichtbar. Rein lesend am echten Bestand nachgewiesen; die Korrektur und die Rückmeldungen sind mit synthetischen Livewire-Dialogtests geprüft. Mit `a0497fc` bereitgestellt; 174 relevante Tests / 1052 Assertions und Pint erfolgreich. Die ausgelieferte Zeitstempelprüfung zusätzlich rein lesend mit dem echten Destination-Bestand geprüft: akzeptiert. Keine zusätzliche visuelle Browserabnahme, keine echte Regel durch den Agenten aktiviert und keine tatsächlichen Belegungen zusammengeführt. Die vorhandene Destination-Regel enthält weiterhin keine Namensextraktion; für die Anzeige des vollständigen Namens bleibt diese gesondert einzurichten.
## 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“**.
Seit der Erweiterung vom 29.10.2026 können eindeutig erkannte Kalenderspiegelungen automatisch zugeordnet werden: Eine aktive Regel erkennt eine allgemeine Sperre als **Zusätzliche Sperre** mit unbekanntem Ursprung, ohne extrahierten Gastnamen oder Buchungsreferenz. Für exakt denselben Zeitraum existiert genau eine führende Portalreservierung eines anderen Kanals, deren Ursprung der eigene Quellkanal ist. Weitere widersprüchliche oder überlappende Belegungen, fehlende Importereignisse, persönliche Einordnungen und eigene Buchungsmerkmale verhindern die automatische Zuordnung. Priorität entscheidet bei mehreren möglichen Quellbuchungen nicht über die Identität. Andere Wohnungen und Mandanten werden nicht einbezogen. Persönliche Verknüpfungen bleiben erhalten.
Import und „Speichern & anwenden“ prüfen die Zuordnung für die gesamte betroffene Wohnung. Kalender und Buchungsliste zeigen die führende Belegung einmal und nennen die beteiligten Kalender als **Auch bei … gespiegelt**. Aufgelöste Spiegelungen zählen nicht als ungeklärte Belegung. Originalereignis, UID, Importkanal und lokaler Datensatz bleiben erhalten; Details und die Liste „Alle Importereignisse“ bleiben zugänglich. Automatische Zuordnungen sind mit `representation_automatic` ausdrücklich von persönlichen Zuordnungen getrennt. Die Vorschau verlinkt Einträge und Kandidaten weiterhin zu ihren Details.
Bei Änderungen der Termine, neuen Buchungsmerkmalen, Mehrdeutigkeit oder einem fehlenden Quellereignis wird nur die automatische Zuordnung gelöst. Ein weiterhin gemeldeter Spiegel hält seine Nächte vorsorglich wieder selbst belegt und erscheint zur Klärung; sein Rückexport bleibt gesperrt. Stimmen beide Quellen wieder eindeutig überein, kann die Zuordnung erneut automatisch erfolgen. Persönliche Zuordnungen folgen weiterhin ihrer führenden Belegung und werden nicht automatisch aufgehoben. „Eigenständige Belegung bestätigen“ verhindert eine erneute automatische Zuordnung dieses Eintrags. Ausschließlich durch eindeutig zugeordnete Spiegel verursachte Konflikte werden nicht als Doppelbuchung gemeldet.
Im Zuordnungsdialog heißt diese Auswahl **Weitere Darstellung einer Kalenderbelegung (Portalreservierung oder Sperrzeit)**. Die Ziele zeigen ihre tatsächliche Belegungsart und den erfassten Quellenhinweis. **Weitere Darstellung einer eigenen Buchung** ist für vollständige Buchungsvorgänge aus FewoPortal vorgesehen; eine importierte Portalreservierung wird als Kalenderbelegung gewählt.
### Mehrere Kanäle mit unterschiedlichen Richtungen
Die Richtungsangaben gelten aus Sicht von FewoPortal: Ein Portal, das nur empfangen kann, benötigt hier nur den Export; eine Quelle, die nur sendet, nur den Import. Die vom Nutzer am 29.10. beschriebene Konstellation ist damit als normale Kanalkonfiguration abbildbar: FeWo-direkt importiert und exportiert, Ostseeklar und Ostsee-Strandurlaub empfangen den FewoPortal-Export, Destination Solution liefert seinen Kalender an FewoPortal. Dafür gibt es keine anbieterabhängige Sonderlogik.
Die lesende Bestandsprüfung vom 29.10. zeigte bei Destination Solution einen gespeicherten Regelentwurf mit Ereignistyp Portalreservierung, Ursprung aktueller Kanal und Führungskandidat, aber noch keine aktiven Regeln. Der vorhandene Eintrag wurde deshalb unverändert als ungeklärt geführt. Eine Textextraktion für den vollständigen Gastnamen war im Entwurf noch nicht angelegt. Ein Name im Original wird erst nach ausdrücklicher Feld-/Textzuordnung und anschließender Anwendung als Namensinformation übernommen; es wird weiterhin kein Gast automatisch angelegt. Der zeitgleiche FeWo-direkt-Eintrag war eine eigenständige allgemeine Kalendersperre. Die Prüfung hat diese Datensätze, Regeln, Richtungen und Exportfreigaben nicht verändert. Eine zusätzliche rein lesende Vorschau für den vorhandenen DS-Eintrag ergab als passende Namensextraktion: Kalenderfeld SUMMARY, Ziel Vollständiger Gastname, Methode Text nach, Anfangstext `: ` (Doppelpunkt plus Leerzeichen). Vor Anwendung die Vorschau und weitere Ereignisse prüfen; die Zuordnung wurde nicht automatisch gespeichert.
Erkannte Portalreservierungen stehen zusammen mit eigenen Vorgängen unter **Anfragen & Buchungen**. Unbekannte Zeiten und Prüffälle stehen unter **Ungeklärte Belegungen**; **Sperrzeiten** enthält ausdrückliche Sperren. Die Portal-Detailansicht zeigt Einordnung und Namensinformationen. **iCal-Original & Erkennung** öffnet das Original und die treffende Regel. Gastzuordnungen bleiben bis zur persönlichen Auswahl beziehungsweise Anlage eines Gastes offen. Persönlich bestätigte Belegungsarten werden durch neue Regelinterpretationen nicht überschrieben; Identitätsprüffälle bleiben davon getrennt. Der [zentrale Belegungsplan und die gemeinsame Gästekartei](ical-kanalkonfiguration.md#zentrale-belegungsverwaltung) ergänzen die Kalenderverwaltung.
## 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. Sie lässt sich jederzeit ausschalten; die Feldzuordnung darf dabei gespeichert bleiben. Ohne Freigabe werden Namensfelder in neu erzeugten Exporten zur Laufzeit ausgeschlossen. Ein pausierter Export liefert bis zur Reaktivierung seinen bisherigen gespeicherten Stand, einschließlich zuvor freigegebener Textinformationen. 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.
## Praktische Abnahme mit vorhandenen echten Kanälen
Am 27.10.2026 wurden der vorhandene FeWo-direkt-Importkanal 1 und der vorhandene Ostseeklar-Exportkanal 2 verwendet. Es wurde kein zusätzlicher Anbieter angelegt. Die beiden Beispielregeln sind als normale Konfiguration gespeichert und aktiviert und können auf **Regeln & Exportfelder** eingesehen und bearbeitet werden.
| Prüfung | Tatsächliches Ergebnis |
|---|---|
| Echter FeWo-direkt-Kalender analysiert | 38 Originalereignisse |
| Gefundene Ereignisfelder | DTEND, DTSTAMP, DTSTART, SUMMARY, UID |
| Regel „Portalreservierungen“ | 9 Treffer |
| Regel „Allgemeine Sperren“ | 29 Treffer |
| Noch unbekannte Ereignisse | 0 |
| Aktuell zukünftige Ereignisse | 11: 3 Portalreservierungen und 8 allgemeine Sperren |
| Vergangene Ereignisse in der Analyse | 27; sichtbar in der Analyse, keine zusätzlichen alten Sperren importiert |
| Bestehenden Bestand neu ausgewertet | 11 Datensätze; keine fehlenden Originaldaten nach Ergänzung aus der Analyse |
| IDs, externe UIDs, Zeiträume und bestehende Verknüpfungen | Vorher/nachher unverändert |
| Ostseeklar-Export | Regulärer Modus, HTTP 200, 11 Ereignisse |
| Freigegebene Namensinformationen im HTTP-Export | 3 Belegungen mit verfügbaren Namensbestandteilen |
| Exportierte Ereignis-UIDs und Zeiträume | Vorher/nachher unverändert |
| Anzeige im Ostseeklar-Portal laut Nutzer | Weiterhin nur „Belegt“; Namensanzeige im praktischen Versuch bisher nicht erreicht |
| Detailansicht importierter Einträge laut Nutzer | Nicht vorhanden; eine Prüfung der übernommenen Textfelder über Eintragsdetails ist nicht möglich |
Für Ostseeklar ist die Namensweitergabe ausdrücklich aktiviert: SUMMARY enthält Belegungsbeschreibung und verfügbaren Vornamen/Namensbestandteil, DESCRIPTION den verfügbaren Namensbestandteil und eine Buchungsreferenz, falls vorhanden. Vollständige Gastnamen wurden nicht aus Vornamen erfunden. Die Konfiguration ist am Zielkanal sichtbar. Der öffentliche Feed wurde mit der eigenen Kennung `FewoPortal-Regelengine-Abnahme/1.0` geprüft; dieser Aufruf ist kein Nachweis eines Abrufs durch Ostseeklar.
**Nutzerbeobachtung vom 27.10.2026: Ostseeklar zeigt weiterhin nur „Belegt“.** Die Rückfrage ist damit beantwortet; die gewünschte Namensanzeige ist im praktischen Versuch bisher nicht erreicht. Die Daten im ausgelieferten Feed sind nachgewiesen, ihre sichtbare Übernahme im Zielportal dagegen nicht. `portal_verified_at` bleibt ungesetzt. Die Beobachtung stammt vom Nutzer und wurde nicht durch eine unabhängige Browserprüfung des Agenten bestätigt.
Die anschließende rein lesende Serverprüfung um 18:26 UTC (19:26 Uhr MEZ) bestätigt die weiterhin aktive Namensfreigabe und die Zuordnung zu SUMMARY/DESCRIPTION. Nach dem eigenen Prüfabruf um 18:18:24 UTC sind zwei weitere GET-Abrufe mit HTTP 200 und Exportzustand `live` gespeichert: um 18:20:47 UTC mit Clientkennung `GuzzleHttp/6.5.5` und um 18:24:13 UTC mit `Mozilla/5.0`. Die Clientkennungen sind keine verifizierte Absenderidentität. Ein Abruf durch Ostseeklar ist daraus allein nicht sicher ableitbar; das Abrufprotokoll weist auch keine Verarbeitung der einzelnen Textfelder im Zielportal nach. Es wurden durch diese Nachprüfung keine Kalenderabrufe ausgelöst und keine Serverdaten oder Konfigurationen geändert.
Die [öffentliche Ostseeklar-FAQ für Vermieter](https://www.ostseeklar.de/vermieter) beschreibt den Belegungsabgleich über iCal, enthält dort aber keine Aussage zur Übernahme oder Anzeige von SUMMARY/DESCRIPTION beziehungsweise Gastnamen. Daraus folgt weder eine bestätigte Unterstützung noch eine nachgewiesene generelle Einschränkung. Mögliche Ursachen bleiben eine begrenzte Darstellung, nicht übernommene Textfelder oder eine noch ausstehende Aktualisierung bestehender Ereignisse. Eine bloße Anpassung unseres Exportformats ist deshalb noch keine belegte Lösung.
**Ergänzende Nutzerbeobachtung: Für importierte Einträge gibt es bei Ostseeklar keine Detailansicht.** Der zuvor vorgesehene Prüfschritt über Verwaltungsdetails entfällt damit. Im beobachteten Verwaltungsablauf sind die exportierten Namen nicht sichtbar; ob Ostseeklar die Textfelder intern speichert, lässt sich über diese Oberfläche nicht feststellen. Eine generelle Aussage, dass Ostseeklar Namen verwirft oder grundsätzlich nicht unterstützt, ist damit nicht belegt.
Für die weitere Abnahme ist ein ausdrücklich ausgeführter Kalenderimport beziehungsweise bestätigter neuer Portalabruf von einem bloßen Neuladen der Kalenderansicht zu unterscheiden. Danach bleibt zur Klärung der Textübernahme eine Auskunft des Portalbetreibers erforderlich: Werden SUMMARY/DESCRIPTION importiert, werden Textänderungen bei unveränderter UID aktualisiert und können die Texte für Vermieter sichtbar gemacht werden? Eine solche Anfrage wurde durch den Agenten nicht versendet. Bis dahin keine neue UID, keine Löschung mit Neuimport und keine Terminänderung als Umgehung verwenden. Die gewünschte sichtbare Namensübernahme ist bisher nicht erreicht; eine weitere Unterstützung durch Ostseeklar ist ungeklärt.
Die echte Konfiguration wurde über dieselben validierenden Anwendungsaktionen gespeichert, die auch der visuelle Editor aufruft. Die Oberfläche einschließlich Analyse, Live-Vorschau, Speicherung und Aktivierung wurde mit Livewire-Interaktionstests verifiziert. Das Browserwerkzeug ließ sich in dieser Sitzung nicht starten; eine zusätzliche echte Browser-Sichtprüfung durch den Agenten wird daher nicht behauptet.
## 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. **Ursprüngliche Regelengine-Abnahme: 409 Feature-Tests / 1935 Assertions lokal erfolgreich, darunter 32 Regelengine-Fälle; Pint erfolgreich.** Aktueller Gesamtstand nach der zentralen Belegungsverwaltung: 433 Tests / 2063 Assertions, Pipeline 4671 erfolgreich. Pipeline 4669 mit Build, Tests, Sicherung und Deployment erfolgreich; Anwendungskommit und aktives Serverrelease anschließend per SSH bestätigt. Der HTTP-Export wurde nach dem letzten Deployment erneut mit 11 Ereignissen und 3 Belegungen mit SUMMARY/DESCRIPTION bestätigt.
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).