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

32 KiB

Generische iCal-Integration und konfigurierbare Portalkanäle

Stand: 27.10.2026 · Visuelle Regelengine mit 7c7955b auf stommer.info bereitgestellt, Pipeline 4669 erfolgreich; Regelengine-Bedienung und echte Kalendernachweise. Fachliche Abgrenzung zuvor mit 8927f2e, Exportlink/Erstimport-Anzeige mit e5a083c, Kacheln/Abrufhistorie mit 511faa6. Grundlegende Inbetriebnahme: MVP-Bericht.

MVP-Ergänzung im Folgeauftrag: Bereitstellung und Benutzung ergänzt die automatische Exportlink-Erzeugung in der Oberfläche, persönliche Belegungszuordnung, archivierte UID-Identität, konfigurierbares Echoverhalten und konkrete Inbetriebnahme. Die nachfolgende ursprüngliche GAP-Analyse dokumentiert die erste Ausbaustufe; Aussagen über fehlende manuelle Zuordnung sind durch die MVP-Ergänzung erweitert. Der tatsächliche Auslieferungsstand wird im verlinkten Bericht nachgeführt.

1. Gültigkeit und Nachweisstand

Die visuelle iCal-Regelengine 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
Bisher dokumentiert Der Prüfbericht vom 27.10.2026 beschreibt den unveränderten Ausgangsstand bei 6fe5bbc. Er bleibt als historischer Befund unverändert.
Jetzt implementiert Erste Ausbaustufe und MVP-Kern sind mit 7830685 auf stommer.info ausgeliefert. Beide Schema-Migrationen sind auf MariaDB erfolgreich ausgeführt. Den Folge-Stand der eigenständigen Verwaltungsseite dokumentiert der MVP-Bericht.
Automatisiert verifiziert Synthetische Kalender, simulierte HTTP-Antworten, simulierte Mails, Livewire-Verwaltung und SQLite-In-Memory-Datenbank; siehe Abschnitt 10.
Von Lars berichtet Eine FewoPortal-Sperre wurde bei FeWo-direkt importiert und angezeigt, erschien nicht im untersuchten FeWo-direkt-Export und verschwand dort nach ihrer Löschung in FewoPortal.
Nicht unabhängig praktisch verifiziert Abruf- und Löschverhalten echter Portale, deren UID-Verarbeitung, tatsächliche laufende Zuordnungen und Einrichtung des regelmäßigen Serverbetriebs.

Die erste Ausbaustufe entstand ohne Server- und Kalenderänderungen. Im ausdrücklich beauftragten Folgeauftrag wurden Anwendung und beide Migrationen über die bestehende Pipeline auf stommer.info ausgeliefert. Die lokale Anwendungsdatenbank wurde nicht migriert. Buchungen, Sperren und vorhandene externe Portalverknüpfungen wurden durch diese Bereitstellung nicht verändert; kein neuer Anbieter wurde eingerichtet.

Die vom Nutzer berichtete FeWo-direkt-Beobachtung gilt für diesen konkreten Versuch. Sie ist keine allgemeine Zusicherung für FeWo-direkt, andere Inserate oder andere Portale. Unterschiedliche UIDs bei ähnlichen Terminen in FeWo-direkt und Ostseeklar belegen weder eine gemeinsame Identität noch verschiedene Aufenthalte.

2. Kompakte GAP-Analyse

Anforderung Ausgangsstand Lokale Erweiterung
Beliebige Portale je Wohnung Generischer Connector, freie Namen und mehrere Kanäle vorhanden Weiterverwendet; Buchungsmodell und Einrichtungsstatus ergänzt
Richtungen getrennt steuern Gemeinsame Aktivität, Import abhängig von URL Eigene Import- und Exportschalter, zusätzlich Setup/Aktiv/Pausiert
Testbetrieb Regulärer Export außer eigenen Kanal-Sperren Expliziter Testmodus ohne Fremdbelegungen, auch für Portal-Aufgaben
Herkunft Kanal und externe UID an Sperren Bekannter Ursprung zusätzlich; Import-/Ursprungskanal an Buchungen; Prüfung auf dieselbe Wohnung
Pause Abschaltung des Feeds konnte dessen Erreichbarkeit beenden Letzten gültigen Stand weiterliefern; ohne Stand HTTP 503 statt leerem Kalender
Beschädigter Feed Teilweise Verarbeitung konnte wie verschwundene Ereignisse wirken Gesamten unterstützten Kalender vor jeder Bestandsänderung prüfen
Fehlende Ereignisse Sofortige Entfernung nach erfolgreichem Abruf Zwei bestätigende erfolgreiche Kalenderstände; mehr als fünf fehlende Ereignisse zurückhalten
Dubletten Doppelte UID im selben Lauf nicht ausreichend abgesichert Identische Belegung je UID einmal übernehmen; widersprüchliche UID ablehnen; beschädigten Altbestand erhalten
Mail und iCal Zuordnung teilweise über Termine Nur gemeinsame Referenz/UID zusammenführen; unklare Repräsentationen behalten und markieren
Termine und Entsperrung Verzögerte Observer konnten alte Daten verlieren; einzelne Löschung konnte zu viel freigeben Ereigniswerte vor Commit sichern; erst danach Aufgaben; Entsperrung nur für aktuell freie Nächte
Tokenwechsel Keine kontrollierte Übergangsphase Bewusste Rotation mit befristeter Gültigkeit des bisherigen Links
Überwachung Erfolgszeit und Fehler vorhanden Fehlerzeit, Ereigniszahl, Warnungen, Prüffälle, Exportzustand und letzter beobachteter Feedabruf
Erstimport Kein eigener Migrationsprozess Bestehende Belegungen erhalten, Überlappungen markieren; keine automatische Datumszusammenführung

3. Kanal je Wohnung konfigurieren

Ort der eigenständigen Oberfläche: Vermietung → Kalenderabgleich (iCal). Ein Eintrag bezeichnet ausschließlich die iCal-Kalenderverbindung für Belegungszeiträume. Weitere Funktionen desselben Portals benötigen gesonderte Anbindungen. Alternativ bleiben die Kalendereinstellungen an der jeweiligen Wohnung erreichbar. Jede Verbindung wird einer Wohnung und ihrem Mandanten zugeordnet. Namen wie „FeWo-direkt“ und „Ostseeklar“ sind freie Eingaben; es werden keine festen Anbieter angelegt. Der Connector bleibt ical.

Einstellung Bedeutung
Name Frei gewählter Portalname
Kanalstatus Noch nicht eingerichtet, aktiv oder pausiert
Buchungsmodell Vermittlung/Anfrage, Portalbuchung oder gemischt; derzeit nur fachliche Einordnung
Importadresse Vertrauliche Exportadresse des Portals; verdeckt mit bewusster Einblendung
Import aktiviert Regelmäßigen oder manuellen iCal-Import erlauben; nur bei aktivem Kanal und freigeschaltetem Mandantendienst
Export aktiviert Aktuellen Kalender für diesen Kanal erzeugen; ausgeschaltet gilt die sichere Pause aus Abschnitt 5
Exportmodus Testbetrieb oder reguläre Synchronisation
Erwarteter externer Abrufabstand Information in Minuten; unbekannt darf leer bleiben
Mailabsender Optionale Zuordnung für den bestehenden separaten Mail-Schnellweg
Zusätzlich von Hand sperren Zusätzliche Portal-Aufgaben für einen aktiven exportierenden Kanal
Vermieterkalender Optionaler Einstieg zur Handpflege

Neue Kanäle starten mit Status „Noch nicht eingerichtet“, Import aus, Export aus und Testmodus. Für einen eingeschalteten Import ist eine Importadresse erforderlich. Ein Kanal mit vorhandenem Importbestand darf seine Quelladresse nicht unbemerkt wechseln. Dafür einen neuen Kanal anlegen oder die Bestandsumstellung gesondert planen. Die Oberfläche bietet keine Kanallöschung mehr; eine Pause erhält Belegung und Herkunft.

Import-only, Export-only und beide Richtungen sind unabhängig wählbar. Der Kanalstatus „Pausiert“ stoppt beide Richtungen unabhängig von den vorgemerkten Richtungsschaltern. Der iCal-Importschalter steuert nicht den separaten Portal-Mail-Dienst: Bei aktivem Kanal und eingetragenen Absendern kann dieser weiterhin Sperren erzeugen. Zum vollständigen Pausieren den Kanalstatus verwenden.

Importadresse und Token sind keine normalen Übersichtswerte. Die Exportadresse ist über „Exportlink“ an der Portalkachel bewusst abrufbar und kopierbar. Token, Snapshot und Einstellungen sind bei normaler Modellserialisierung ausgeblendet. Der Export enthält Belegungen mit SUMMARY:Belegt, keine Gastnamen, Preise oder internen Sperrgründe. Die Adresse bleibt ein Zugangsschlüssel; Serverzugriffsprotokolle und Empfänger können sie dennoch kennen.

4. Exportmodi und Herkunft

Belegung Testbetrieb Regulär
Eigene belegende Buchung Ja Ja
Eigene noch gültige Vormerkung Ja, nach bestehender occupying()-Regel Ja, nach derselben Regel
Eigene manuelle Sperre Ja Ja
Importierte Kalender- oder Mail-Sperre Nein Ja, außer Importkanal oder bekanntem Ursprung des Zielkanals
Buchung mit gespeichertem Import-/Ursprungskanal Nein Ja, außer Import-/Ursprungskanal des Zielkanals
Buchung mit fremdem/unbekanntem Quellenwert ohne Kanalangabe Nein Enthalten; die fehlende Kanalzuordnung verhindert einen gezielten Herkunftsausschluss

Im Testbetrieb gelten nur die eigenen Quellen website, manual, phone, direct, email ohne Import- und Ursprungskanal als eigene Buchung. Eine Portalbuchung darf bei späterer Übernahme deshalb ihre Herkunft nicht verlieren. Die Übernahme zu einer vollständigen Buchung selbst ist weiterhin eine spätere Funktion.

Fremdbelegungen blockieren im Testbetrieb intern unverändert. Ihre Weitergabe an andere Portale ist jedoch ausgeschlossen. Der Testbetrieb gewährleistet somit keine vollständige kanalübergreifende Sperrung. Diese Regel gilt auch für neu erzeugte Aufgaben zur manuellen Pflege und deren automatische Übergabe. Bereits früher an Portale übertragene Sperren werden durch die Moduswahl nicht außerhalb des Kalenders automatisch bereinigt.

Der reguläre Modus wird ausschließlich durch eine bewusste Auswahl aktiviert. Kein Importergebnis und kein erfolgreicher Test schaltet ihn automatisch ein.

Der konkrete Sofortbuchungsfall ist damit abgesichert: Ein FeWo-direkt-Ereignis erhält beim Import die ID seines konfigurierten FeWo-direkt-Kanals. Dessen Export lässt die Sperre aus. Im Testbetrieb lassen auch alle anderen Feeds diese Fremdsperre aus; regulär geben sie sie weiter, sofern sie nicht selbst der bekannte Ursprung sind.

Bekannte Herkunft wird getrennt gespeichert: BlockedPeriod.channel_id ist der Importkanal; origin_channel_id ist ein zusätzlich bekannter Ursprung. external_uid ist die Kennung innerhalb dieses Kanals; id ist die lokale Sperr-ID. An Buchungen stehen import_channel_id und origin_channel_id bereit. Der iCal-Import setzt keinen geratenen ursprünglichen Buchungskanal. Er übernimmt auch keinen Gastnamen aus SUMMARY als Buchungsinformation. Die Verwaltung zeigt Importkanal, bekannten Ursprung, UID und Prüffälle; die interne ID ist einblendbar.

Der bisherige UID-Suffixfilter bleibt erhalten: Ereignisse mit unserer UID-Endung werden nicht erneut als Fremdsperre importiert. Verändert ein Portal die UID, ist dieser Nachweis verloren. Ein Echo über einen anderen Kanal mit neuer UID wird nicht zuverlässig erkannt. Gleiche oder überlappende Termine werden deshalb niemals allein als gemeinsame Identität behandelt.

5. Sichere Pause und Tokenwechsel

Import pausieren

Vorhandene Sperren bleiben bestehen. Es gibt keinen Abruf und keine Löschung wegen der Pause. Die Bestätigungszähler für fehlende Ereignisse werden beim Umschalten über die Verwaltung zurückgesetzt. Nach Reaktivierung sind erneut erfolgreiche vollständige Kalenderstände erforderlich.

Export pausieren

Jeder erfolgreiche aktuelle Abruf speichert den validierten Export als letzten gültigen Stand. Nach Ausschalten des Exports oder Pausieren des Kanals bleibt genau dieser Stand unter derselben Adresse erreichbar. Änderungen während der Pause verändern ihn nicht. Wurde noch nie abgerufen, sichert die Konfigurationsaktion beim Übergang aus einem aktiven Export dessen bisherigen Kalender.

Ohne gespeicherten Stand wird HTTP 503 mit Retry-After: 300 geliefert. Es wird kein leerer Kalender als Abschaltung gesendet. Ein eingefrorener Stand kann konservativ zu lange sperren und enthält keine neuen Änderungen während der Pause. Er ist keine fortlaufende Synchronisation. Bei Reaktivierung wird beim nächsten Abruf wieder aktuell erzeugt. X-Fewo-Export-State kennzeichnet live oder frozen.

Die vorhandene Mandantendienst-Sperre bleibt übergeordnet: Entzug des gesamten Portal-Dienstes liefert weiterhin 404. Sie ist kein Ersatz für die hier beschriebene betriebliche Kanalpause. Wie ein Portal HTTP-Fehler behandelt, muss praktisch geprüft werden; unsere Antwort allein garantiert dessen Bestandsverhalten nicht.

Token rotieren

Die Aktion verlangt eine bewusste Bestätigung. Der neue Link wird sofort gültig; der bisherige bleibt für die gewählte Übergangszeit von 24 bis 720 Stunden gültig, standardmäßig 168 Stunden. Beide liefern denselben Kanal mit demselben Betriebszustand. Eine weitere Rotation während der laufenden Übergangsphase wird abgewiesen.

Den neuen Link innerhalb dieser Frist selbst beim richtigen Portal eintragen und dort die Übernahme prüfen. Nach Fristablauf endet die Gültigkeit des bisherigen Links. Es gibt keinen automatischen Eintrag im Portal und keinen Nachweis, welchen der beiden Links das Portal tatsächlich verwendet. Die Frist und der nötige externe Wechsel sind in der Aktion ausdrücklich benannt.

6. Import, Änderungen und Entfernung

Vor Bestandsänderungen muss der vollständige HTTP-Abruf erfolgreich sein und der gesamte unterstützte Kalender validieren. Fehler erhalten Sperren und bisherige Erfolgszeit. Die neue Fehlerzeit und eine Meldung ohne Importtoken werden gespeichert.

Das unterstützte Profil umfasst einen vollständigen VCALENDAR mit VERSION:2.0, PRODID, geschlossenen Komponenten und einzelnen VEVENTs mit UID, gültigem UTC-DTSTAMP und positivem Übernachtungszeitraum. Gefaltete UTF-8-Zeilen, ganztägige Daten, unterstützte Zeitzonen und Zeitangaben werden verarbeitet. Fehlendes DTEND bedeutet nur bei einem ganztägigen Ereignis eine Nacht. CANCELLED und TRANSPARENT sind nicht belegend. Ein gültiger leerer Gesamtkalender ist möglich.

HTML, abgeschnittene oder widersprüchliche Strukturen, ungültige Daten, fehlende Identität/Zeitstempel und widersprüchliche doppelte UIDs lehnen den ganzen Stand ab. Identische Belegungen derselben UID werden einmal verarbeitet. Serien (RRULE, RDATE, EXDATE, RECURRENCE-ID), DURATION sowie einzelne Kalendernachrichten statt Gesamtkalendern werden abgewiesen. Das ist ein bewusst begrenztes Belegungsprofil, keine vollständige Implementierung aller iCalendar-Möglichkeiten. Die Kompatibilität der echten Feeds ist vor Aktivierung zu prüfen.

Ereignis Verarbeitung
Neue UID im Kanal Neue zugeordnete Sperre
Bekannte UID mit gleichem Zeitraum Keine zweite Sperre
Bekannte UID mit geändertem Zeitraum Dieselbe lokale Sperre aktualisieren; alte und neue Termine für Aufgaben erhalten
Fehlende zukünftige UID Beim ersten erfolgreichen Fehlen erhalten; beim zweiten bestätigenden erfolgreichen Fehlen entfernen
UID wieder vorhanden Fehlenszähler zurücksetzen
Mehr als fünf zukünftige Ereignisse fehlen Keine automatische Entfernung; Prüffälle und Warnung
Abruf oder Validierung fehlgeschlagen Keine Bestandsänderung; keine Entsperrung
Vorhandene importierte Dubletten/fehlende UID im Altbestand Abgleich abbrechen und Bestand erhalten; manuelle Prüfung nötig
Vergangene Ereignisse Nicht neu importieren; alte vergangene Sperren werden hier nicht automatisch bereinigt

Die Grenzen stehen in config/channels.php: removal_confirmation_runs = 2, max_automatic_removals = 5. Wiederholte erfolgreiche Abrufe können denselben vom Portal zwischengespeicherten Stand bestätigen. Ein formal gültiger, aber inhaltlich unvollständiger Feed mit höchstens fünf verschwundenen Ereignissen kann daher nach zwei erfolgreichen Abrufen weiterhin zu einer falschen Entfernung führen. Die Schutzregeln können fehlende Herkunfts- oder Vollständigkeitsgarantien des Portals nicht ersetzen.

Pro Kanal verhindert eine Cache-Sperre parallele Abrufe. Vor Anwendung werden Kanalkonfiguration und Wohnung unter Datenbanksperre geprüft. Ändert sich die Quelladresse oder wird der Import während des Abrufs pausiert, wird der Stand nicht übernommen. Die Cache-Sperre ist auf 120 Sekunden befristet; dies ersetzt keinen noch ausstehenden Belastungs- und Parallelitätstest auf dem Zielsystem.

7. Erstimport, Mail-Sperren und Doppelsperren

Beim Erstimport werden lokale Belegungen weder gelöscht noch anhand gleicher Daten zusammengeführt. Überschneidungen mit Buchungen, manuellen Sperren oder anderen Kanälen sowie mehrere Repräsentationen desselben Kanals bleiben sichtbar und werden als Prüffälle markiert. Auch eine nicht zugeordnete Mail-Sperre mit inzwischen anderem Zeitraum bleibt erhalten und wird zur Prüfung vorgemerkt. Im MVP ergänzt die Aktion „Belegung zuordnen / klären“ die persönliche Bestandsklärung: eigenständige Belegung bestätigen oder als Darstellung einer führenden Sperre/Buchung derselben Wohnung mit identischem Zeitraum zuordnen. Es gibt keine automatische Identitätsentscheidung anhand der Daten. Einzelheiten und Verhalten bei späterer Stornierung stehen im MVP-Bericht.

Mail- und Kalender-Sperre werden nur bei einer gemeinsamen Kennung zusammengeführt: email:<Referenz> muss zur späteren Kalender-UID passen. Dann wird dieselbe lokale Sperre zu einer Kalender-Sperre und ein geänderter Zeitraum übernommen. Stimmt die Referenz nicht mit der Portal-UID überein, bleiben beide erhalten. Ein gemeinsam belegter Zeitraum genügt nicht als Nachweis. Eine Storno-Mail ohne passende Referenz gibt keine Sperre nur anhand der Daten frei. Nach Übernahme in den Kalenderbestand steuert der Kalender dessen spätere Entfernung; eine Mail hebt Kalender-Sperren nicht direkt auf.

Bei mehreren passenden Kanälen desselben Mailabsenders wird keine erste Wohnung geraten. Die Kanäle erhalten eine Warnung. Für mehrere Inserate desselben Portals ist eine verlässliche Inserats-/Wohnungszuordnung der Mails weiterhin gesondert zu konzipieren. Die bestehende Absendererkennung allein ist außerdem kein kryptographischer Echtheitsnachweis einer Portal-Mail.

8. Konsolidierte Portal-Aufgaben

Aufgaben entstehen erst nach erfolgreichem Datenbank-Commit. Die Observer sichern vorher alte und neue Termine, Import- und Ursprungskanal. Ein Rollback erzeugt keine Aufgaben. Herkunftskanal und bekannter Ursprung werden ausgeschlossen; im Testbetrieb werden Fremdbelegungen nicht als neue Aufgaben weitergegeben.

Bei einer Entsperrung wird der aktuelle Gesamtbestand der Wohnung berücksichtigt. Nur zusammenhängende tatsächlich freie Nächte erhalten eine Entsperraufgabe. Überlappende Sperren und belegende Buchungen bleiben berücksichtigt. Vor der Automationsübergabe und beim Erledigen einer Entsperraufgabe wird die Verfügbarkeit erneut geprüft; inzwischen belegte Aufgaben werden verworfen. Überholte Sperraufgaben mit inzwischen freien Nächten werden vor einer erneuten Automationsübergabe ebenfalls verworfen. Pausierte Exporte werden nicht an eine Automation übergeben.

Eine bereits abgeschickte Automationsanweisung oder eine von Menschen außerhalb der Anwendung vorgenommene Änderung kann nicht zurückgerufen werden. Zwischen letzter Prüfung und Ausführung im Portal verbleibt ein Zeitfenster; ein externer Empfänger muss Reihenfolge, Wiederholung und aktuellen Zustand berücksichtigen. Eine tatsächliche Portal-Automation wurde hier weder eingerichtet noch getestet.

9. Überwachung und Abrufzeiten

Die Kanalliste zeigt Importzustand, letzten erfolgreichen Import, letzte Fehlerzeit, Anzahl zuletzt übernommener Ereignisse, Warnungen, Prüffallzahl, Exportmodus und Exportzustand. Die letzten 30 Protokolle sind einsehbar. Ein manueller Lauf bleibt für eingeschaltete eingerichtete Importe verfügbar.

Unser Aufgabenplan sieht channels:sync alle fünf Minuten vor. Der erwartete externe Abrufabstand ist dagegen nur eine Vermutung zum Portal und steuert diesen Plan nicht. Ohne eingerichteten Scheduler erfolgt kein regelmäßiger Abgleich. Stand 27.10.2026: Strato erlaubt laut Nutzer minimal stündliche Cron-Ausführung. Ein minütlicher externer Auslöser ist deshalb als n8n-Workflowentwurf mit verschlüsselten Zugangsdaten angelegt und einmalig erfolgreich gegen den Scheduler-Endpunkt getestet. Der Entwurf ist noch unveröffentlicht; regelmäßige automatische Kalenderimporte sind noch nicht nachgewiesen. Veröffentlichung und Betriebsnachweis: BETRIEB.md §6.

last_export_requested_at zeigt einen beobachteten Abruf dieser Feedadresse, in der Kachel als „Letzter Abruf“ getrennt vom Sync-Lauf. Die ergänzte Abrufhistorie hält je Kanal die letzten 100 verarbeiteten GET-/HEAD-Aufrufe mit Empfangszeit, Antwortstatus, Exportzustand und unbestätigter Clientkennung fest. IP-Adressen und Token werden dort nicht gespeichert. Ein eigener Test, Monitor oder weitergegebener Link kann denselben Abruf auslösen. Der Zeitpunkt beweist weder den Portalclient noch eine erfolgreiche Verarbeitung dort. Getrennte bestätigte Portal-Synchronisationszeiten werden weiterhin nicht automatisch ermittelt; persönliche Sichtkontrollen sind ein eigenes Feld. Auch Prüffälle müssen persönlich bearbeitet werden; ein technisch erfolgreicher Import bedeutet nicht konfliktfreien Bestand.

10. Automatisierte Nachweise und reproduzierbarer Testplan

Voraussetzungen: installierte Projektabhängigkeiten und PHP 8.4. Die vorhandene phpunit.xml verwendet APP_ENV=testing, SQLite :memory:, Array-Cache, Array-Mailer und synchrone Testqueue. Kein artisan migrate, channels:sync oder Postfachkommando gegen eine eingerichtete Anwendungsdatenbank ausführen.

php vendor/bin/phpunit --do-not-cache-result tests/Feature/GenericChannelIntegrationTest.php
php vendor/bin/phpunit --do-not-cache-result tests/Feature/ChannelSyncTest.php tests/Feature/PortalMailTest.php tests/Feature/TenantServiceGateTest.php tests/Feature/TenantScheduleTest.php
php vendor/bin/phpunit --do-not-cache-result

Die neue Datei enthält 44 Fälle einschließlich Datenvarianten. HTTP-Zugriffe werden darin simuliert und nicht simulierte Anfragen verboten; es werden ausschließlich synthetische Kalender und Buchungen angelegt. Die bestehenden Kanal- und Mailtests wurden an die validierten Kalender und die sichere Zuordnung angepasst.

Reproduzierbares Szenario Erwartung und Nachweis
Neuer Kanal, beide Richtungsschalter in vier Kombinationen Sichere Defaults, unabhängige Richtungen; test_new_channel_has_safe_defaults…, test_directions_are_independent
Eigene/Fremdbelegung, auch als Buchung Testexport nur eigene; Fremdsperre intern belegt; test_test_mode_exports_only_own_occupations…
Regulär mit Importkanal und bekanntem Ursprung Beide Zielkanäle ausgeschlossen; test_regular_mode_excludes_both…
Erstabruf, Pause, neue interne Belegung, Reaktivierung Eingefrorener Stand identisch, danach aktuell; ohne Stand 503; test_paused_export_freezes…, test_pause_before_first_request…
Identischer Feed, identische doppelte UID, eigene UID-Endung Keine Dublette, kein Echo; test_repeated_import_and_identical_duplicate_uids…
Geänderte UID-Termine Lokale ID bleibt; alte Entsperr- und neue Sperrtermine stimmen; test_changed_dates_keep_identity…
Fehlende Ereignisse und Wiederauftauchen Zwei erfolgreiche Bestätigungen nötig, Reset bei Wiederauftauchen/Pause; test_missing_events_require_two…
Mehr als fünf fehlende Ereignisse Bestand bleibt und Warnung; test_large_disappearance_is_held…
Elf fehlerhafte Feedvarianten und HTTP 403 Keine Freigabe, keine Erfolgszeitänderung, kein Token in Fehlermeldung; test_invalid_snapshot…, test_failed_fetch…
Mail mit/ohne gemeinsame Kennung, auch nach Verschiebung Nur belegte Identität zusammenführen; referenzlose Stornierung erhält Sperre; test_mail_and_calendar_merge_only…, test_unidentified_nonoverlapping…, test_cancellation_without_shared_reference…
Überlappende Belegungen löschen/ändern Entsperraufgaben nur freie Teilzeiträume; test_unblock_tasks_release_only_currently_free_nights
Verzögerte Aufgabe, inzwischen geändert Keine überholte Sperre/Entsperrung an Automation; test_outdated_block_task…, test_outdated_unblock_task…
Transaktion zurückrollen, parallelen Kanalabruf sperren Keine Aufgaben nach Rollback, kein zweiter Abruf; test_rolled_back_occupations…, test_a_channel_lock…
Falsche Wohnung, mehrere Wohnungen, mehrdeutige Mailabsender Keine falsche Herkunftszuordnung, kein gemeinsamer Bestand; test_foreign_channel_provenance…, test_two_properties…, test_ambiguous_mail_sender…; ergänzend vorhandene Mandantenregressionstests
Verwaltung bedienen Richtungen und geschützte URL bearbeitbar, Herkunft und Prüffall sichtbar; test_admin_can_configure…, test_admin_can_view…
Token rotieren und Frist überschreiten Alter/neuer Link während Übergang, alter danach ungültig; zweite Rotation verhindert; test_token_rotation…, test_second_rotation…
Migration mit synthetischem Bestand zurück/vor Richtungen, Exportumfang, Token und Sperrbestand erhalten; test_upgrade_preserves_existing…
Langer UTF-8-Wohnungsname RFC-Zeilenfaltung mit unveränderten Nächten; test_export_folds_long_utf8_lines…

Die abschließenden Gesamtergebnisse stehen im Projektstand. Automatisierte Nachweise ersetzen keine praktische Portalabnahme.

11. Neues Portal und kontrollierte Freigabe

  1. Zunächst mit synthetischen Feeddateien und simuliertem HTTP prüfen, ob das Portalprofil unterstützt wird. Bei Serien oder abweichenden UID-/Zeitstempelangaben keine echte Verbindung einschalten.
  2. Nach ausdrücklicher Freigabe zur Auslieferung die reguläre Pipeline und eine gesicherte Migration auf dem Zielsystem verwenden. Vorher MariaDB-Verhalten, Sicherung und bestehende Kanäle prüfen. In dieser Sitzung wurde dies nicht ausgeführt.
  3. Einen Kanal an der richtigen Wohnung anlegen, Namen und Buchungsmodell setzen. Status zunächst nicht eingerichtet, beide Richtungen aus, Testmodus. Den benötigten Mandantendienst und die regelmäßigen Hintergrundläufe prüfen.
  4. Bestehende Portal- und lokale Belegungen mit Herkunft aufnehmen. Alte manuelle Fremdsperren, noch wirksame Links und eventuell bereits übertragene eigene Sperren persönlich abgleichen. Keine bestehenden Sperren als automatische Bereinigung löschen.
  5. In der eigenen Verwaltungsseite die richtige Wohnung, den Kanal und die gewünschte Richtung bewusst konfigurieren und aktivieren. Vertrauliche Adressen nur an den vorgesehenen Empfänger geben. Bereits aktive externe Verknüpfungen mit möglicher Freigabewirkung und Bereinigungen echter Belegungen weiterhin vorher konkret abstimmen; normale Kanalanlage und Konfiguration brauchen keine zusätzliche technische Vorbereitung.
  6. Im freigegebenen Testbetrieb eine eigene synthetische Sperre, deren Änderung und Entfernung prüfen. Das Portal muss den Export tatsächlich übernehmen. Pausierung, Wiederaufnahme und HTTP-Fehlerverhalten am Portal prüfen. Dabei keine echten Aufenthalte verwenden.
  7. Für den Sofortbuchungsfall einen ausdrücklich freigegebenen synthetischen Portalvorgang verwenden: Import erzeugt eine interne Sperre; der eigene Zielkanal enthält sie nicht erneut. Im Testmodus darf kein anderer Feed sie weitergeben. Eine Mailrepräsentation nur bei gemeinsamer Kennung zusammenführen; sonst Prüfung sichtbar belassen.
  8. Erst nach geklärtem Bestand, Herkunft und Echoverhalten den regulären Modus für jeden Kanal bewusst freigeben. Auch die Übergangsfreigaben beim Entfernen bisher exportierter Fremdsperren oder beim Wechsel einer Quelle vorher prüfen. Gültige Buchungen dürfen dadurch nicht extern geöffnet werden.
  9. Die dokumentierte FeWo-direkt-Beobachtung für jede relevante Verbindung erneut prüfen. UIDs und tatsächliche Portalstände belegen, Zeitpunkte und Grenzen festhalten. Ein GET-Zeitpunkt allein genügt nicht.

12. Migration, offene Risiken und Codeverweise

Die neue Migration ergänzt nur Schema und Kanalsteuerungswerte. Bestehende aktive Kanäle behalten ihren bisherigen Exportumfang als regulärer Modus und ihre Token; Import bleibt nur mit bisher aktiver Konfiguration und vorhandener URL eingeschaltet. Inaktive Kanäle werden pausiert. Das ist eine Kompatibilitätsübernahme des zuvor bereits regulären Exports, keine automatische Hochstufung eines Testkanals nach erfolgreichem Versuch. Neue Kanäle starten stets im Testmodus. Belegungen werden weder automatisch migriert noch zusammengeführt oder gelöscht.

Vor der ersten Auslieferung vorhandene Kanäle deshalb einzeln prüfen. Ein bestehender pausierter Kanal hat zunächst möglicherweise keinen Snapshot und liefert dann 503. Ein sofortiger erzwungener Wechsel aller bestehenden Feeds auf den Testmodus könnte fremde Sperren extern freigeben und wird nicht durchgeführt.

Offen bleiben insbesondere UID-Änderungen über mehrere Portale, unbekannte Alt-Herkunft, sichere mehrfache Inseratszuordnung in Mails, inhaltlich unvollständige aber formal gültige Feeds, externe Abrufverzögerungen, Prüfung der echten Exportprofile, Belastungs-/Parallelitätstests sowie das Restzeitfenster bis zur manuellen oder automatisierten Ausführung. Die regulären MariaDB-Migrationen auf dem vorhandenen Zielsystem sind inzwischen erfolgreich gelaufen; ein Rollback oder Stresstest mit realem Bestand wurde nicht durchgeführt. Konfliktmails können bei wiederholt vorhandenem Konflikt erneut entstehen. Prüffälle werden nicht automatisch als fachlich geklärt entfernt. Portalbuchungen werden weiterhin nicht mit Gästen, Preisen und Zahlungen als vollständige Buchung übernommen. Ein vollständiger Channel-Manager oder ein fertiger Portal-Bot ist nicht Bestandteil dieses Schritts.

Verantwortung Konkreter Code
Konfiguration und sichere Übergänge ConfigureChannel::handle, Channel, ChannelsRelationManager
Auswählen und Erzeugen des Exports ICalFeed::build, ICalExport::build, ChannelController::feed
Abruf und vollständige Profilvalidierung ICalConnector::fetchOccupations, ICalParser::parse
Identität, Änderung, Fehlensbestätigung und Prüffälle SyncChannel::handle, config/channels.php
Herkunft und deren Wohnungsgrenze HasChannelProvenance, BlockedPeriod, Booking::isDirect
Mailidentität und referenzbasierte Stornierung ProcessPortalMail
Aufgaben nach Commit und konsolidierte Entsperrung BlockedPeriodObserver, BookingObserver, CreateChannelTasks, ChannelTask::complete
Tokenrotation RotateChannelToken::handle
Schema und kompatible Kanalübernahme Migration
Ausführbare Nachweise GenericChannelIntegrationTest, ChannelSyncTest, PortalMailTest, TenantServiceGateTest, TenantScheduleTest