Zentralen Belegungsplan und plattformuebergreifende Buchungs- und Gaesteverwaltung integrieren
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m41s

This commit is contained in:
Lars committed 2026-10-27 21:51:56 +01:00
1 parent c74199e978
commit f369018a68
41 files changed
+1343 -157

No files matched your search

@@ -149,6 +149,30 @@ ## 8. Konsolidierte Portal-Aufgaben
## 9. Überwachung und Abrufzeiten
### Zentrale Belegungsverwaltung
Die Verwaltungsansichten werden mit dem Folgeauftrag vom 27.10.2026 fachlich zusammengeführt:
| Bereich | Inhalt und Zweck |
|---|---|
| **Belegungsplan** (`/admin/belegungsplan`) | Monatsplan je Wohnung mit freien und belegten Nächten, An-/Abreisen, Gast beziehungsweise Namensinformation, Buchungskanal, Status und Prüfhinweisen. Auf kleinen Bildschirmen werden die Tage untereinander dargestellt. Darunter stehen alle Vorgänge des Zeitraums mit Links zu den Details. |
| **Anfragen & Buchungen** (`/admin/bookings`) | Gemeinsame, durchsuchbare Liste eigener Vorgänge und erkannter Portalreservierungen. Filter nach Wohnung, Buchungsweg, Status, kommenden Aufenthalten und offener Gastzuordnung. Vorhandene Buchungsabläufe bleiben erreichbar. |
| **Gäste** (`/admin/guests`) | Gemeinsame Kartei für alle Plattformen. Zugeordnete Portalreservierungen erscheinen zusammen mit eigenen Buchungen in der Aufenthaltshistorie. Die Stammgast-Auswahl berücksichtigt beide Quellen; Umsätze beziehen sich weiterhin auf bekannte Preise eigener Buchungen. |
| **Sperrzeiten** (`/admin/blocked-periods`) | Eigene ausdrückliche Sperren und persönlich als Sperrzeit bestätigte importierte Zeiträume. Allgemeine, nicht näher bekannte iCal-Sperren werden nicht automatisch als eigene Sperrzeiten ausgegeben. |
| **Ungeklärte Belegungen** (`/admin/portal-occupations`) | Unbekannte Importzeiten und Prüffälle. Zusätzliche Register erlauben die Sicht auf alle Importereignisse sowie auf Einträge, die nicht mehr im Feed stehen. Details zeigen Herkunft, Originalereignis, führende Zuordnung und bekannte Gastinformationen. |
**Gastzuordnung bleibt bei Portalreservierungen zunächst offen**, entsprechend der Entscheidung von Lars. Ein Namensfragment erzeugt keinen Gast automatisch und führt keine Gäste automatisch zusammen. Über **Details → Gast zuordnen** wird ein vorhandener Gast persönlich gewählt oder ein neuer mit den bekannten Angaben angelegt. Nachname und E-Mail dürfen dabei fehlen; es werden keine Ersatzdaten erfunden. Die Zuordnung ist auch an eigenen Buchungen möglich. Sie sendet keine Nachricht, ersetzt keine Vertragsdatei und ändert keine Termine. Ein späterer Kalenderimport erhält die Gastzuordnung anhand derselben Ereignisidentität. Auch archivierte und wiederkehrende Ereignisse behalten diese Zuordnung.
**Belegungsart festlegen** bestätigt eine Portalreservierung, eine ausdrückliche Sperrzeit oder einen weiterhin unbekannten Sachverhalt. Diese persönliche Einordnung bleibt gegenüber späteren iCal-Regelauswertungen erhalten. Sie schließt Überschneidungen und mögliche Mehrfachdarstellungen nicht automatisch ab; dafür bleibt **Belegung zuordnen / klären** zuständig. Die führende Buchung oder Belegung erscheint einmal im Plan und in der gemeinsamen Liste. Zugeordnete Kalenderdarstellungen bleiben in den Quelldetails nachvollziehbar.
Ein erkannter Portalaufenthalt aus iCal besitzt dadurch keine erfundenen Preise, Personenzahlen, Zahlungsstände oder Vertragsbestätigungen. Fehlende Angaben werden als unbekannt angezeigt. Ein verschwundenes Feedereignis heißt **„Nicht mehr im Kalenderfeed“**; daraus wird kein gesicherter Stornogrund abgeleitet. Ohne belegenden führenden Datensatz zählt ein zugeordneter Kalendereintrag nicht als zweite Belegung.
Die zusätzliche Gastverknüpfung und persönliche Belegungsart erweitern die vorhandenen Importdaten. Bestehende IDs, UIDs, Zeiträume, Zuordnungen und Herkunftsausschlüsse werden nicht durch Löschen und Neuimport ersetzt. Unbekannte führende Importzeiten halten ihre Nächte weiterhin belegt. E-Mail-Aktionen verlangen eine vorhandene Gastadresse; Erinnerungs- und Bewertungsmails überspringen Datensätze ohne E-Mail. Die Anonymisierung berücksichtigt zugeordnete Portalaufenthalte, damit ein Gast mit aktuellem Portalaufenthalt nicht fälschlich als veralteter bloßer Interessent behandelt wird. Eine Weitergabe zugeordneter Gastnamen bleibt an die ausdrückliche Freigabe des jeweiligen Zielkanals gebunden.
Technischer Einstieg: `OccupancyOverview`, `OccupancyCalendar`, `PortalOccupationResource`, `AssignOccupationGuest`, `ClassifyPortalOccupation` und `OccupationKind`; Tests in `OccupancyManagementTest`. Die Migration ergänzt `blocked_periods.guest_id` und die optionale persönliche Belegungsart und erlaubt fehlende Gast-E-Mail-Adressen. Ein Schema-Rollback verlangt vorab die Vervollständigung solcher E-Mail-Adressen; keine Ersatzadressen werden für einen Rollback erzeugt. Den aktuellen Bereitstellungs- und Nachweisstand hält [STATUS.md](../STATUS.md) fest.
### Synchronisationsstatus
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. Der minütliche externe n8n-Auslöser mit verschlüsselten Zugangsdaten ist durch Lars veröffentlicht und aktiv. Zwei aufeinanderfolgende automatische Importe am 27.10. um 20:55:03 und 21:00:03 Uhr MEZ, jeweils 11 Ereignisse ohne Änderungen oder Konflikte, sind im Sync-Protokoll nachgewiesen. Kein manueller Abgleich während dieser Beobachtung. Der automatische Betrieb erfolgt auf dem Pi und benötigt weder Browser noch lokalen SSH-Tunnel; die externe Infrastruktur muss verfügbar sein. Einrichtung und Betriebsnachweis: [BETRIEB.md §6](../BETRIEB.md#6-erledigt--offen-im-testbetrieb).
+2 -2
View File
@@ -37,9 +37,9 @@ ## 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 **Sperrzeiten → 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.
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.
Die Sperrzeitenübersicht zeigt den erkannten Ereignistyp und verfügbare Namensinformationen. **iCal-Original & Erkennung** öffnet das Original und die treffende Regel.
Erkannte Portalreservierungen stehen zusammen mit eigenen Vorgängen unter **Anfragen & Buchungen**. Unbekannte Zeiten und Prüffälle stehen unter **Ungeklärte Belegungen**; **Sperrzeiten** enthält ausdrückliche Sperren. Die Portal-Detailansicht zeigt Einordnung und Namensinformationen. **iCal-Original & Erkennung** öffnet das Original und die treffende Regel. Gastzuordnungen bleiben bis zur persönlichen Auswahl beziehungsweise Anlage eines Gastes offen. Persönlich bestätigte Belegungsarten werden durch neue Regelinterpretationen nicht überschrieben; Identitätsprüffälle bleiben davon getrennt. Der [zentrale Belegungsplan und die gemeinsame Gästekartei](ical-kanalkonfiguration.md#zentrale-belegungsverwaltung) ergänzen die Kalenderverwaltung.
## Exportinformationen je Zielkanal