# 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](ical-regelengine.md). Fachliche Abgrenzung zuvor mit `8927f2e`, Exportlink/Erstimport-Anzeige mit `e5a083c`, Kacheln/Abrufhistorie mit `511faa6`. Grundlegende Inbetriebnahme: [MVP-Bericht](ical-mvp-inbetriebnahme-2026-10-27.md). **MVP-Ergänzung im Folgeauftrag:** [Bereitstellung und Benutzung](ical-mvp-inbetriebnahme-2026-10-27.md) 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](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 | |---|---| | Bisher dokumentiert | Der [Prüfbericht vom 27.10.2026](ical-synchronisation-pruefung-2026-10-27.md) 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 `VEVENT`s 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](ical-mvp-inbetriebnahme-2026-10-27.md). Mail- und Kalender-Sperre werden nur bei einer gemeinsamen Kennung zusammengeführt: `email:` 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. Der bisher dokumentierte Einrichtungsbedarf auf dem Testserver wurde hier nicht verändert. `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. ```powershell 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](../STATUS.md). 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`](../../app/Actions/ConfigureChannel.php), [`Channel`](../../app/Models/Channel.php), [`ChannelsRelationManager`](../../app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php) | | Auswählen und Erzeugen des Exports | [`ICalFeed::build`](../../app/Channels/ICal/ICalFeed.php), [`ICalExport::build`](../../app/Channels/ICal/ICalExport.php), [`ChannelController::feed`](../../app/Http/Controllers/ChannelController.php) | | Abruf und vollständige Profilvalidierung | [`ICalConnector::fetchOccupations`](../../app/Channels/ICal/ICalConnector.php), [`ICalParser::parse`](../../app/Channels/ICal/ICalParser.php) | | Identität, Änderung, Fehlensbestätigung und Prüffälle | [`SyncChannel::handle`](../../app/Actions/SyncChannel.php), [`config/channels.php`](../../config/channels.php) | | Herkunft und deren Wohnungsgrenze | [`HasChannelProvenance`](../../app/Models/Concerns/HasChannelProvenance.php), [`BlockedPeriod`](../../app/Models/BlockedPeriod.php), [`Booking::isDirect`](../../app/Models/Booking.php) | | Mailidentität und referenzbasierte Stornierung | [`ProcessPortalMail`](../../app/Actions/ProcessPortalMail.php) | | Aufgaben nach Commit und konsolidierte Entsperrung | [`BlockedPeriodObserver`](../../app/Observers/BlockedPeriodObserver.php), [`BookingObserver`](../../app/Observers/BookingObserver.php), [`CreateChannelTasks`](../../app/Actions/CreateChannelTasks.php), [`ChannelTask::complete`](../../app/Models/ChannelTask.php) | | 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) |