Eindeutige iCal-Kalenderspiegelungen automatisch und widerrufbar zuordnen
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m53s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m53s
This commit is contained in:
1 parent
8b36e07dc4
commit
add2367869
16 files changed
+540
-31
No files matched your search
@@ -1,5 +1,7 @@
|
||||
# Projektstand
|
||||
|
||||
**Automatische iCal-Kalenderspiegelungen (29.10.2026, lokal geprüft):** Eindeutig per aktiver Regel erkannte zusätzliche allgemeine Belegtmeldungen ohne eigene Buchungsmerkmale werden einer einzigen führenden Portalreservierung eines anderen Kanals mit exakt gleichen Terminen zugeordnet. Keine Terminheuristik bei unbekannten Ereignissen, mehreren Quellbuchungen, widersprüchlichen Überschneidungen oder persönlichen Entscheidungen. Import und Regelanwendung prüfen die gesamte Wohnung; Kalender zeigt eine Belegung mit „Auch bei … gespiegelt“, geklärte Spiegelungen verschwinden aus Klärungsliste und Zähler. Neue Kennzeichnung `representation_automatic` trennt persönliche und automatische Zuordnungen. Nur automatische Verknüpfungen werden bei Änderungen, fehlender Quelle oder neuer Mehrdeutigkeit gelöst; weiterhin gemeldete Nächte bleiben intern belegt und vom Rückexport ausgeschlossen. Persönliche Entscheidungen bleiben erhalten. Konfliktprüfung erfolgt nach der Zuordnung, vermeidet falsche Doppelbuchungsmeldungen und erhält tatsächliche Konflikte. **198 relevante Tests / 1188 Assertions und Pint erfolgreich**, davon 24 neue Tests / 136 Assertions mit beiden Importreihenfolgen, Regelanwendung auf Bestand, Änderungen, fehlender Quelle/Wiederkehr, Buchungsmerkmalen, Mehrdeutigkeit und Mandantentrennung. Additive Migration, kein Bestandsumbau in der Migration. [Regeln und Lebenszyklus](architecture/ical-regelengine.md#führende-repräsentation-und-zuordnung).
|
||||
|
||||
**Abbruch beim Anwenden von iCal-Regeln korrigiert (29.10.2026, bereitgestellt):** Destination Solution rein lesend geprüft: Entwurf vorhanden, aktive Regeln leer; nachfolgender Import unterscheidet sich von der Vorschau nur in DTSTAMP, bei gleichen Terminen und gleichem Regelergebnis. Bisher blockierte die Prüfung auf veraltete Originaldaten auch diese reine Zeitstempeländerung; die Validierungsnachricht blieb hinter dem Bestätigungsdialog unsichtbar. Reine DTSTAMP-/LAST-MODIFIED-Änderungen werden jetzt nur bei vollständig gleichem Regelergebnis toleriert, neueste importierte Originale bleiben erhalten. Fachliche Änderungen oder ein durch Zeitstempel geändertes Regelergebnis verlangen weiterhin eine neue Vorschau. Validierungsabbrüche schließen den Dialog, zeigen eine dauerhafte Meldung und behalten die Formulareingaben; gespeicherter Regelstand wird nach dem Transaktionsrückbau neu geladen. Erfolg schließt die Bestätigung und aktualisiert den aktiven Regelstand. **174 relevante Tests / 1052 Assertions und Pint erfolgreich**, darin 41 Regelengine-Tests / 289 Assertions und sieben zusätzliche Fälle mit tatsächlichem Öffnen und Bestätigen des Dialogs, Aktualisierungsrennen, fehlerhafter Extraktion und Formularvalidierung. Keine echten Kanalregeln aktiviert, keine Kalenderdaten zusammengeführt; identische Tage allein bleiben kein Identitätsnachweis. [Befund und Bedienung](architecture/ical-regelengine.md#vorschau-entwurf-und-aktivierung). Mit `a0497fc` über den vorhandenen PipelineManager bereitgestellt; Release `20261029152758-a0497fcc`, Serverrevision, private Sicherung (31.620.399 Bytes) und HTTP 200 für Gesundheit/Anmeldung bestätigt. Neue Regelseite unangemeldet zur Anmeldung umgeleitet. Die ausgelieferte Zeitstempelprüfung zusätzlich rein lesend gegen den echten Destination-Bestand ausgeführt: akzeptiert; Entwurf erkennt Portalreservierung/Führungskandidat. Aktive Regeln weiterhin leer, keine persönliche Anwendung vorweggenommen. Keine neue Migration oder zusätzliche visuelle Browserabnahme. Gitea-Status-API HTTP 401; Auslesen gespeicherter Git-Zugangsdaten dafür durch automatische Freigabeprüfung abgelehnt und nicht ausgeführt. Deployment über vorhandene SSH-Zugänge und aktive Serverrevision bestätigt, kein ungeprüfter API-Erfolgsstatus behauptet.
|
||||
|
||||
**iCal-Kompatibilität für fehlenden DTSTAMP (29.10.2026, bereitgestellt):** Ferienundwohnen-Feed liefert elf Ereignisse ohne DTSTAMP, aber mit gültigem ereignisbezogenem UTC-LAST-MODIFIED. Ablehnung mit neuem Test reproduziert; Parser verwendet LAST-MODIFIED nur bei vollständig fehlendem DTSTAMP als Ersatzprüfung. Leere/ungültige vorhandene DTSTAMP, unbrauchbare oder doppelte Zeitstempel und beschädigte Feeds bleiben abgewiesen. Keine künstlichen Originalfelder, keine geänderte UID-/Datums- oder Stornologik. **101 relevante Tests / 530 Assertions und Pint erfolgreich**, darunter zehn zusätzliche ungültige Profile sowie Importwiederholung und Datumsänderung mit fehlendem DTSTAMP. Echte, Git-ignorierte Originaldatei separat ohne Datenbankzugriff lokal erfolgreich gelesen: elf Ereignisse/Belegungen, erste Anreise/Abreise 10.–24.11.2026, letzte 03.–10.10.2027. Vorhandene Verbindung 5 hat den Import derzeit ausgeschaltet; nicht aktiviert und keine echten Belegungen importiert. Mit `2ae48e7` durch [Pipeline 4698](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4698) erfolgreich bereitgestellt; gesamte Feature-Suite, Build, Sicherung und Deployment erfolgreich, Release `20261029150456-2ae48e77`, Serverrevision und Gesundheitscheck HTTP 200 bestätigt. Anschließender echter Abruf auf Strato über ICalConnector und Parser erfolgreich: elf Ereignisse/Belegungen, elf eindeutige UIDs, alle Originale ohne DTSTAMP und mit LAST-MODIFIED. Verbindung 5 weiterhin Import aus, null Bestandszeilen vor/nach dieser rein lesenden Prüfung. Keine Migration und kein manueller Bestandsimport. [Kompatibilitätsgrenze](architecture/ical-kanalkonfiguration.md#6-import-änderungen-und-entfernung).
|
||||
|
||||
@@ -254,3 +254,12 @@ ## 12. Migration, offene Risiken und Codeverweise
|
||||
| Tokenrotation | [`RotateChannelToken::handle`](../../app/Actions/RotateChannelToken.php) |
|
||||
| Schema und kompatible Kanalübernahme | [Migration](../../database/migrations/2026_10_27_154125_add_generic_ical_controls_and_provenance.php) |
|
||||
| Ausführbare Nachweise | [`GenericChannelIntegrationTest`](../../tests/Feature/GenericChannelIntegrationTest.php), [`ChannelSyncTest`](../../tests/Feature/ChannelSyncTest.php), [`PortalMailTest`](../../tests/Feature/PortalMailTest.php), [`TenantServiceGateTest`](../../tests/Feature/TenantServiceGateTest.php), [`TenantScheduleTest`](../../tests/Feature/TenantScheduleTest.php) |
|
||||
|
||||
|
||||
## Automatische Zuordnung eindeutiger Kalenderspiegelungen (29.10.2026)
|
||||
|
||||
Eine per aktiver Regel erkannte allgemeine zusätzliche Sperrmeldung ohne Gast-/Buchungsmerkmale und mit unbekanntem Ursprung wird genau einer führenden Portalreservierung eines anderen Kanals mit identischen Anreise-/Abreisedaten zugeordnet, sofern keine widersprüchlichen Belegungen oder persönlichen Entscheidungen vorliegen. Die führende Buchung erscheint einmal; „Auch bei … gespiegelt“ nennt die weiteren Kalender. Die Originalereignisse bleiben unter „Alle Importereignisse“ nachvollziehbar. Unbekannte Ereignisse ohne passende Regel werden weiterhin nicht allein anhand von Terminen zusammengeführt.
|
||||
|
||||
Die Prüfung erfolgt nach erfolgreichem Import sowie beim Anwenden der Regeln. Eine automatische Zuordnung wird bei Änderungen oder fehlenden Quellereignissen wieder gelöst: Eine weiterhin gemeldete Sperre hält intern ihre Nächte belegt, bleibt vom Rückexport ausgeschlossen und erscheint zur Klärung. Persönliche Zuordnungen bleiben erhalten; eine persönliche Bestätigung als eigenständig verhindert erneutes automatisches Verknüpfen. Mehrere Quellbuchungen, abweichende Zeiträume und eigene Buchungsmerkmale bleiben Prüffälle.
|
||||
|
||||
Schemaergänzung: `representation_automatic`, Standard false für bestehende persönliche Zuordnungen. Migration klassifiziert keine echten Belegungen; diese werden erst im regulären Import oder beim Anwenden aktiver Regeln geprüft. Rückbau wird bei vorhandenen automatischen Zuordnungen verweigert, damit diese nicht unbemerkt als persönliche Zuordnungen fortbestehen.
|
||||
@@ -41,9 +41,11 @@ ## 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 **Ungeklärte Belegungen → Details → 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.
|
||||
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.
|
||||
|
||||
Die Vorschau verlinkt den bereits importierten Eintrag und die zeitgleichen Kandidaten direkt zu ihren Belegungsdetails. Bei einer führenden Reservierung bleibt dieser Datensatz bestehen; die weitere Darstellung wird in deren eigenen Details der führenden Belegung zugeordnet. Dafür müssen die Termine und die fachliche Identität persönlich geprüft sein. Eine gemeinsame Zeitspanne allein reicht nicht.
|
||||
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.
|
||||
|
||||
|
||||
Reference in new issue
Block a user