From 98eabaeb0ca60934c987ff2395e8efaf8825d333 Mon Sep 17 00:00:00 2001 From: Lars Date: Tue, 27 Oct 2026 17:35:43 +0100 Subject: [PATCH] Bereitgestellte Portalverwaltung und Abnahme dokumentieren [skip ci] --- docs/STATUS.md | 8 ++++---- docs/architecture/ical-kanalkonfiguration.md | 14 +++++++------- .../ical-mvp-inbetriebnahme-2026-10-27.md | 6 +++++- 3 files changed, 16 insertions(+), 12 deletions(-) diff --git a/docs/STATUS.md b/docs/STATUS.md index 4e912d6..3ff5df1 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,10 +1,10 @@ # Projektstand -Stand: 26.10.2026 · **Mandantenabschluss auf `develop` und Strato ausgeliefert**, Commit `06df80e`, Release `20261026161129-06df80e4`, [Pipeline-Lauf 4661 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4661). +Stand: 27.10.2026 · **Eigenständige Portalverwaltung auf `develop` und stommer.info ausgeliefert**, Anwendungskommit `1f59cbb`, Release `20261027163119-1f59cbb9`, [Pipeline-Lauf 4663 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4663). Vorheriger Mandantenabschluss: `06df80e`, Pipeline 4661. > Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“). -**Eigenständige Portalverwaltung (Folgeauftrag 27.10.2026):** Eigene Seite **Vermietung › Portale & Kalender** (`/admin/channels`), auch in der einfachen Ansicht, für frei benannte Kanäle und individuell gewählte Wohnungen. Automatische dauerhafte Exportlinks, vollständige Konfiguration, manuelle Abgleiche und Überwachung über gemeinsame Formulare/Aktionen mit der Wohnungsansicht. Rollen und Mandantentrennung über `ChannelPolicy`. **Keinen Ostseeklar-Kanal oder anderen neuen Anbieter eingerichtet.** Der vorausgehende iCal-Kern wurde durch [Pipeline 4662](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4662) erfolgreich mit Commit `7830685` nach stommer.info ausgeliefert; Server-REVISION und beide MariaDB-Migrationen in Batch 16 bestätigt. **368 Feature-Tests / 1755 Assertions lokal erfolgreich, Pint erfolgreich.** Folge-Deployment der eigenständigen Seite wird über dieselbe Pipeline ausgeliefert. [Benutzung und Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). +**Eigenständige Portalverwaltung bereitgestellt (Folgeauftrag 27.10.2026):** Eigene Seite **Vermietung › Portale & Kalender** (`/admin/channels`), auch in der einfachen Ansicht, für frei benannte Kanäle und individuell gewählte Wohnungen. Automatische dauerhafte Exportlinks, vollständige Konfiguration, manuelle Abgleiche und Überwachung über gemeinsame Formulare/Aktionen mit der Wohnungsansicht. Rollen und Mandantentrennung über `ChannelPolicy`. **Keinen Ostseeklar-Kanal oder anderen neuen Anbieter eingerichtet.** Der vorausgehende iCal-Kern und beide MariaDB-Migrationen wurden durch Pipeline 4662 erfolgreich bereitgestellt (Batch 16). Die eigenständige Oberfläche ist mit **`1f59cbb` durch Pipeline 4663 erfolgreich ausgeliefert**; Server-REVISION, Release und drei Verwaltungsrouten bestätigt. **368 Feature-Tests / 1755 Assertions lokal erfolgreich; Pipeline-Build und Tests erfolgreich; Pint erfolgreich.** `/up` und Anmeldung HTTP 200, Portalverwaltung unangemeldet zur Anmeldung umgeleitet. Bisheriger Exportlink HTTP 200 und bytegleicher Kalender vor/nach Deployment, ungültiger Token 404. Keine Buchung oder Sperre geändert. [Benutzung und Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). **iCal-MVP zur Auslieferung vorbereitet (27.10.2026):** Automatischer eigener dauerhafter Exportlink je frei benanntem Portalkanal in der Verwaltung; manuelle Klärung und Zuordnung mehrfach dargestellter Belegungen; führende Sperre/Buchung steuert Verfügbarkeit und Export, zugeordnete UID-Darstellungen bleiben nachvollziehbar. Archivierung erhält die Identität verschwundener und wiederkehrender Ereignisse. Konfigurierbares Echoverhalten, Exportumfang, Portal-Pflegehinweise und getrennte persönliche Übernahmeprüfung ergänzt. **359 Feature-Tests / 1701 Assertions lokal erfolgreich, Pint erfolgreich.** Der Nutzer hat Deployment und Migration auf der bestehenden Instanz ausdrücklich beauftragt. Keine separate Testinstallation. Vorab auf stommer.info gelesen: ein reiner FeWo-direkt-Exportkanal, keine Sperren und keine belegende Buchung; Link unverändert HTTP 200 ohne Ereignisse. Externe Importadressen fehlen dort noch und sollen auf Wunsch über die Oberfläche statt lokaler JSON-Datei eingetragen werden. [Benutzung, Zuordnung und praktische Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Auslieferungsnachweis folgt nach Abschluss der bestehenden Pipeline. @@ -78,7 +78,7 @@ ## 2. Stand auf stommer.info (Testbetrieb) ## 3. Offen -**iCal-Kanalkonfiguration:** Lokale Erweiterung und Tests fertig, Auslieferung/MariaDB-Prüfung und praktische Portalabnahme offen; Details und verbleibende Risiken im [Umsetzungsdokument](architecture/ical-kanalkonfiguration.md). Keine automatische Bestandsmigration oder Freigabe echter Kalenderverbindungen. +**iCal-Kanalkonfiguration:** Erweiterung, eigenständige Verwaltungsseite und MariaDB-Migrationen auf stommer.info bereitgestellt. Externe Importadressen sind noch nicht eingetragen; die Anbieter werden auf Wunsch vom Vermieter selbst in der Oberfläche angelegt und konfiguriert. Echte bidirektionale Portalabnahme und Nachweis des regelmäßigen Schedulerbetriebs stehen aus. [Benutzung und verbleibende praktische Schritte](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Keine automatische Bestandsbereinigung. **Entscheidungen und Inhalte (Betreiber)** - Impressum und Datenschutzerklärung werden separat erstellt; dann unter Webseite › Texte › Rechtliches eintragen. @@ -105,7 +105,7 @@ ## 3. Offen ## 4. Nächste Schritte (Vorschlag) -Für die neue iCal-Erweiterung zuerst den bestehenden Kanalbestand und die Migration auf dem Zielsystem prüfen und die Auslieferung ausdrücklich freigeben. Anschließend reale Verbindungen und den Wechsel in den regulären Modus einzeln nach dem [Freigabeablauf](architecture/ical-kanalkonfiguration.md#11-neues-portal-und-kontrollierte-freigabe) abnehmen; die bestehende Exportadresse wurde durch die lokale Umsetzung nicht verändert. +Für den praktischen iCal-Betrieb unter **Vermietung › Portale & Kalender** die gewünschten Anbieter selbst anlegen, externe Importadressen eintragen und automatisch erzeugte eigene Exportlinks den richtigen Portalen zuordnen. Reale Bestände persönlich klären und den regulären Betrieb einzeln prüfen; [Ablauf und verbleibende Testfälle](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Bestehende Exportadresse unverändert; keine erneute Auslieferung für die normale Konfiguration nötig. 1. Cronjob einrichten; SMTP einschalten und mit `mail:test` prüfen (Mails landen wegen Testbetrieb nur bei Lars); Konto für Brigitte anlegen. 1a. Vor dem Go-Live: System › Betrieb auf „scharf geschaltet“ stellen – erst dann erhalten Gäste die Mails. Beim Go-Live außerdem unter System › Betrieb › Adressen Kontakt-/Antwortadresse und Benachrichtigungen von fewo@stommer.de auf **info@fewo-stommer.de** umstellen (Entscheidung 23.10.2026; Absender ist bereits info@fewo-stommer.de). diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index 1aeb6ce..906f63c 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -1,6 +1,6 @@ # Generische iCal-Integration und konfigurierbare Portalkanäle -Stand: 27.10.2026 · erste Ausbaustufe und MVP-Kern mit `7830685` auf stommer.info ausgeliefert, Pipeline 4662 erfolgreich. Aktuelle eigenständige Verwaltungsseite und Inbetriebnahme: [MVP-Bericht](ical-mvp-inbetriebnahme-2026-10-27.md). +Stand: 27.10.2026 · **Eigenständige Portalverwaltung mit `1f59cbb` auf stommer.info bereitgestellt**, Pipeline 4663 erfolgreich; erster MVP-Kern und Migrationen zuvor mit `7830685`, Pipeline 4662. Benutzung und Nachweise: [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. @@ -11,12 +11,12 @@ ## 1. Gültigkeit und Nachweisstand | 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 | Die in diesem Dokument beschriebenen Erweiterungen liegen lokal vor. Eine neue Schema-Migration ist enthalten. | +| 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, MariaDB-Migration und Einrichtung des regelmäßigen Serverbetriebs. | +| Nicht unabhängig praktisch verifiziert | Abruf- und Löschverhalten echter Portale, deren UID-Verarbeitung, tatsächliche laufende Zuordnungen und Einrichtung des regelmäßigen Serverbetriebs. | -In diesem Umsetzungsschritt wurden keine Server, echten Kalender, Buchungen, Sperren oder Portalverknüpfungen verändert. Die lokale Anwendungsdatenbank wurde nicht migriert. Die Migration lief ausschließlich innerhalb isolierter Tests. +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. @@ -131,7 +131,7 @@ ## 6. Import, Änderungen und Entfernung ## 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. Prüffälle sind Hinweise zur persönlichen Bestandsklärung; es gibt keinen automatischen Migrations- oder Auflösungsassistenten. +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. @@ -194,7 +194,7 @@ ## 11. Neues Portal und kontrollierte Freigabe 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. Vor einer neuen echten Import-/Exportverknüpfung ausdrücklich freigeben lassen, welche Wohnung, welcher Kanal, welche Richtung und welche Bestandswirkung getestet werden darf. Vertrauliche Adressen nur an den vorgesehenen Empfänger geben. +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. @@ -206,7 +206,7 @@ ## 12. Migration, offene Risiken und Codeverweise 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, Zielsystem-/MariaDB- und Parallelitätstests sowie das Restzeitfenster bis zur manuellen oder automatisierten Ausführung. 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. +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 | |---|---| diff --git a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md index 95f8984..b50bfa9 100644 --- a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md +++ b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md @@ -1,6 +1,10 @@ # iCal-MVP: Bereitstellung und Benutzung -Stand: 27.10.2026 · Kern `7830685` auf stommer.info ausgeliefert, Pipeline 4662 erfolgreich. Eigenständige Verwaltungsseite im Folge-Deployment; Nachweis wird nach dessen Abschluss ergänzt. +Stand: 27.10.2026 · **Eigenständige Portalverwaltung auf stommer.info bereitgestellt**, Commit `1f59cbb`, Release `20261027163119-1f59cbb9`, [Pipeline 4663 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4663). Zuvor Kern `7830685` und beide MariaDB-Migrationen durch Pipeline 4662 erfolgreich bereitgestellt. + +Nach Auslieferung bestätigt: Server-`REVISION` stimmt mit dem Workflow-Commit überein; die drei Routen für Übersicht, Anlage und Bearbeitung sind registriert. `/up` und die Anmeldung liefern HTTP 200; unangemeldete Aufrufe der Portalverwaltung werden zur Anmeldung geleitet. Authentifizierte Formulare und Aktionen sind durch die lokalen und in der Pipeline ausgeführten Feature-/Livewire-Tests verifiziert. Eine zusätzliche Sichtkontrolle in einer echten angemeldeten Browsersitzung wurde nicht durchgeführt. + +Der bisherige Exportlink bleibt unverändert erreichbar: HTTP 200, Zustand `live`, derzeit null Ereignisse; Kalenderinhalt vor und nach Auslieferung bytegleich. Ein ungültiger Exporttoken liefert 404. Keine neue Portalverbindung oder zusätzliche Anbieter-Datensätze angelegt, keine Buchung oder Sperre für die Abnahme verändert. Nachweise ohne vertrauliche Adressen liegen Git-ignoriert unter `storage/app/private/ical-praxistest/mvp-http-abnahme.json`. ## Oberfläche und automatische Exportlinks