Files
fewo-stommer/docs/Prozessarchitektur/Querschnitt/Datenbeschaffung_und_Communication_Handler.md
2026-11-03 12:13:09 +01:00

155 lines
32 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: X-CH
typ: querschnitt
titel: Communication Handler und Datenbeschaffung
status: fachlicher-arbeitsstand
version: "0.11"
---
# Communication Handler und Datenbeschaffung – MVP (v0.11)
**Geltung:** Normativer fachlicher Zielstand v0.11 für neue Kommunikations- und Datenbeschaffungsfähigkeiten; **kein Nachweis der Implementierung und keine Go-live- oder juristische Freigabe**. Die vorhandene Angebots-Vorreservierung, Buchungs- und Stornierungsprozesse sowie die bestehende regelbasierte iCal-Buchungsereigniserkennung aus v0.10 bleiben bestehen. Bestehende v0.10-Dokumente und historische Implementierungsberichte belegen nicht die Umsetzung der neuen v0.11-Funktionen.
**Zweck:** Ein schlanker, erweiterbarer Communication Handler für eingehende Informationen, gezielte Datenbeschaffung und kontrollierte Übergabe an die bestehende Fachlogik. Dieser Querschnitt ist die **führende fachliche Detailregel** für CH-01 bis CH-18, Schnittstellen S1–S6, Kommunikationsphasen, Sicherheitsregeln und Abnahmen M01–M12. P01/P02 und K00 verweisen auf ihn, ohne eine zweite parallele Regelversion einzuführen.
## 1. Beschlossene Leitplanken
1. **Fachliche Hoheit:** `CaseActivities` / `CaseAutomation` und bestehende Fachprozesse entscheiden über die nächste Aktivität, Verfügbarkeit, Angebot, Buchung, Storno und Änderung. Der Communication Handler trifft **keine** Buchungs-/Vertragsentscheidung, führt keine neue Workflow-Engine ein und erzeugt keine zweite Fortsetzungslogik.
2. **Ein Vorgang je eigenständigem Geschäftsfall:** Eingehende E-Mails, Portalinformationen, Gastformular und manuelle Angaben können denselben Vorgang anreichern. Gleiche Nächte allein beweisen keine Gastidentität. Keine Buchungswarteschlange, kein automatisches Nachrücken und keine zweite exklusive Zusage.
3. **Phasenbezogener Informationsbedarf:** Unverbindliche Anfragen dürfen unvollständig sein. Vor einem **eigenen verbindlichen Angebot** sind Vorname, Nachname, Personenzahl, An-/Abreise, E-Mail und **vollständige Postanschrift** des Vertragspartners erforderlich. Die Anschrift ist kein übergehbarer Warnhinweis. Die bestehenden Prüfungen zu Preis, Verfügbarkeit, Dokumenten und Freigaben gelten zusätzlich. Namen aller Mitreisenden sowie vollständige Zusatzleistungswahl sind kein allgemeines Erstangebots-Gate. Die Pflicht-Unterteilung Erwachsene/Jugendliche/Kinder bleibt offen.
4. **Drei relevante Zustände:** **P1** unverbindliche Anfrage; **P2** versendetes, noch nicht angenommenes verbindliches eigenes Angebot; **P3** verbindliche Buchung/Vertrag. Nur die bestehende Prozesssteuerung bestimmt die Phase. Fehlende administrative Angaben können auch in P3 kontrolliert ergänzt werden; vertragsrelevante Änderungswünsche in P3 bleiben im MVP **manuell**. **Direktbuchungsportale:** Eine extern bereits verbindliche Portalbuchung bleibt unabhängig von fehlenden Gastdaten und vom Communication Handler verbindlich; sie wird weder auf eine unverbindliche Anfrage herabgestuft noch von einer neu eingeführten Klärungsreservierung abhängig gemacht.
5. **Zwei getrennte Reservierungszwecke:** Die vorhandene **Angebots-Vorreservierung** wird **nicht geändert**. Davon getrennt kann **vor** dem eigenen verbindlichen Angebot bei einer noch unvollständigen **unverbindlichen** Anfrage eine optionale, kurzzeitige **Klärungsreservierung** entstehen. **Mindestqualifikation für den V1-Sofortblock ist nun präzisiert:** eindeutig bestimmte Wohnung, eindeutiger An-/Abreisezeitraum, verwendbarer **E-Mail-Kontakt** und positive bestehende Verfügbarkeits-/Konfliktprüfung. **Name, Anschrift und Personenzahl werden für diesen Kurzblock noch nicht benötigt**, wohl aber gemeinsam mit Zeitraum und E-Mail für das eigene verbindliche Angebot. Ausgangswerte **15 Minuten** bei automatischer Beschaffung und **180 Minuten** bei Freigabe/manuell, jeweils konfigurierbar; **`0` = keine Klärungssperre**. Die später beispielhaft genannten **15–30 Minuten** sind keine beschlossene Ersetzung des bisherigen manuellen 180-Minuten-Ausgangswerts. Beim unmittelbaren V1-Block läuft die Zeit ab Eingang der ausreichend qualifizierten Anfrage, nicht ab späterer Bearbeitung. Antwort, Erinnerung und Folgefrage verlängern weder Klärungs- noch Angebotsfrist. Nach Ablauf vor verbindlicher Fortsetzung Verfügbarkeit erneut prüfen. V2/V3 sind nicht beschlossene spätere Optionen.
6. **Unabhängige Steuerung:** Datenbeschaffung **automatisch / Entwurf mit Versandfreigabe / manuell** ist unabhängig von der Angebotsautomatik. Vorhandene Vererbung Vermieter → Wohnung → Kanal × tatsächliche Eingangsart nutzen; `null` bedeutet erben, `0` und `false` sind ausdrückliche Werte. **Zentraler Kanalmanager:** Alle Kanäle – **einschließlich des eigenen Portals** – werden hinsichtlich Anbindung, iCal-Synchronisation und kanalbezogener Geschäfts-/Kommunikationseinstellungen an einer führenden fachlichen Verwaltungsstelle behandelt; die operative iCal- und Buchungslogik der v0.10 bleibt bestehen. Die technische Einpassung in den tatsächlich vorhandenen Konfigurationsbestand wird vor der Implementierungsfreigabe geprüft.
7. **Antwortwege ohne Gastkonto:** Im MVP sind direkter E-Mail-Antwortweg und personalisierter Ergänzungslink vorgesehen. Keine verpflichtende Registrierung, kein Gast-/Loyalty-Account. Geschäftliche Entscheidungen und vertrauliche Daten werden nicht allein durch Kenntnis eines Links autorisiert.
## 2. Beschlussregister CH-01 bis CH-18
| ID | Beschluss | Bewusste Grenze |
|---|---|---|
| **CH-01** | **IMAP-Basisintegration zum Go-live**: Nachrichten empfangen, Antworten erkennen, Zuordnung und Klärung ermöglichen. | Kein selbstständig handelnder Kommunikationsagent. |
| **CH-02** | Inhaltlich erweiterte Verarbeitung von Portalmerkmalen, Betreff und Nachrichtentext; unstrukturierte/teilweise Antworten und allgemeine Anfragen berücksichtigen. E-Mail ist gleichwertiger Rückkanal neben dem Formular. | Keine autonome KI-generierte Gastkorrespondenz. Die frühere Beschränkung auf ausschließlich regelbasierte Extraktion wurde durch **CH-14** ersetzt. |
| **CH-03** | **Kontrollierte automatische Ergänzung** eindeutig zugeordneter, validierter und bisher fehlender Werte. Widersprüche nicht blind überschreiben. Rein administrative Ergänzungen auch nach Vertragsschluss; vertragsrelevante Änderungen nur als Wunsch an bestehenden Fachprozess/manuelle Bearbeitung. | Weitergehende automatische Korrektur vorhandener Werte (Option C) später. |
| **CH-04** | Unvollständige/unklare Angaben als Kandidaten dokumentieren; gezielte **regelbasierte** Rückfragen je Modus automatisch, mit Freigabe oder manuell ermöglichen. | Kein generatives freies Antwortschreiben. |
| **CH-05** | Datenmodell erlaubt mehrere Postfächer je Mandant; **Go-live: ein aktives dediziertes IMAP-Postfach** mit möglichen Aliasadressen je Mandant. | Mehrere gleichzeitige aktive Postfächer später. |
| **CH-06** | E-Mails erfassen, gegen Doppelverarbeitung sichern, bestehenden Fällen bzw. neuer Anfrage zuordnen oder in manueller **Kommunikations-Klärungsansicht** zeigen. Bekannte Absenderadressen liefern dem Bearbeiter passende Vorgangs-/Kommunikationshinweise. | Allgemeine/unklare E-Mail begründet keinen neuen Buchungsvorgang und keine Reservierungs-Queue; keine mandantenübergreifende Suche. |
| **CH-07** | Regelbasierte Zuordnung anhand technischer Referenzen und Merkmale aus Betreff/Text (Portal-/Buchungsnummer, Wohnung, Zeitraum, Absender). Nur belastbar eindeutige Zuordnung automatisieren. | Einzelindizien oder Widersprüche → Hinweise/manuelle Entscheidung; Buchungsnummer allein ist kein Identitätsnachweis. |
| **CH-08** | Bestehende Portal-Mailparser interpretieren weiterhin bekannte Formate; Handler bündelt Eingang/Kommunikation, gemeinsamer Fakteneingang, idempotente Geschäftswirkung. | Kein Neubau/Ersetzen bestehender Parser; Migration der technischen Abholung nur kontrolliert, wenn nötig. |
| **CH-09** | Eine Portal-Mail kann Buchungsereignis **und** Gastinformationen enthalten: Buchungsereignis über bestehenden Portal-/Buchungsweg, Gastdaten über Fakteneingang, Änderungsabsicht an zuständigen Fachprozess. | Extern verbindliche Buchung zuerst schützen; fehlende Gastdaten ändern ihre Verbindlichkeit nicht. |
| **CH-10** | Keine pauschale Quellenrangfolge. Buchungsereignisse, iCal-Belegung und Gastinformationen nach ihrer jeweiligen Aussagekraft bewerten. | Zweifelhafte Stornos oder Kalenderabweichungen dürfen nicht selbstständig Verfügbarkeit freigeben. |
| **CH-11** | Neue Vertrauens-/Verifikationsregeln gelten für eingehende Nachrichten des Handlers; kritische zweifelhafte Portal-Mailereignisse zur Prüfung. | **Bestehender iCal-Abgleich und dessen regelbasierte Buchungsereignisse v0.10 bleiben unverändert**; kein zusätzliches E-Mail-Gate. |
| **CH-12** | iCal und Portal-Mail dürfen in beliebiger Reihenfolge eintreffen; eindeutig zugeordnete später eintreffende Portal-Mail darf fehlende zulässige Daten des bereits existierenden Vorgangs ergänzen. | Keine zweite Buchungsanlage; bei Unsicherheit manuelle Prüfung. |
| **CH-13** | Deterministische automatische Zuordnung ohne Scoring: bekannter Antwortbezug; belastbare Portalreferenz; bei iCal-vor-Mail eindeutiger Kandidat aus Portal, Wohnung und exakt gleichen Nächten ohne Widerspruch; direkte Gast-Mail anhand eindeutiger Kombination Absender/Wohnung/Zeitraum. | Mehrdeutigkeit → nur Kandidaten; Zuordnung ist **noch keine** Übernahme- oder Änderungsberechtigung. |
| **CH-14** | **Risikobasierte zweistufige KI-Extraktion im MVP** für unstrukturierte Nachrichten: kleines LLM extrahiert strukturierte Fakten, Belegstellen, Konfidenz **je Fakt** und Änderungsabsichten. FewoPortal prüft mit **programmatischen** Regeln Buchungsphase, bestehende Werte, Widersprüche und feld-/folgenbezogene Kritikalität. Ein konfigurierbarer Eskalationsschwellwert aus Kritikalität und Unsicherheit kann eine Prüfung durch ein größeres LLM auslösen; dieses sieht Originalnachricht und Erstextraktion. | Auch hohes Modell entscheidet nichts Verbindliches; Mindestvalidierung für automatische Übernahme unabhängig vom Eskalationswert. Modellkonfidenz ist **keine kalibrierte Wahrscheinlichkeit**. Bekannte Portalparser bleiben nutzbar. |
| **CH-15** | **Initiale Rückfrage**, **gezielte Folgefrage** nach Teil-/unklarer Antwort und **Erinnerung** bei ausbleibender Antwort sind verschiedene Arten. | Folgefragen zählen nicht als Erinnerungen; eigene konfigurierbare Obergrenze verhindert Schleifen. |
| **CH-16** | Ein gemeinsamer ereignisgesteuerter Datenbeschaffungsablauf. Folgefragen- und Erinnerungszähler gelten jeweils für den **gesamten zusammenhängenden Beschaffungsvorgang**; Teilantwort setzt sie nicht zurück. Bei Grenze manuelle Aufgabe, späte Antworten weiter verarbeiten. | Keine neue Workflow-Engine; keine automatische Fristverlängerung. |
| **CH-17** | Pro Beschaffungsvorgang höchstens **eine aktuell offene automatische Rückfrage** mit zugehörigem Erinnerungsplan. Antwort hebt offene Erinnerung auf; bei Bedarf folgt gezielte neue Frage mit eigener Antwortfrist, ohne Zählerreset. Vollständigkeit, Absage oder Abschluss stoppen Nachfassen. | Kommunikationsantwortfrist ≠ Klärungsreservierung ≠ Angebotsfrist. Konkrete Intervalle weiter konfigurierbar. |
| **CH-18** | Personalisierter, zeitlich begrenzter, signierter, mandanten- und vorgangsgebundener Gastlink ohne Registrierung. Mehrfachaufruf möglich; **Lesen schreibt nicht**. Absenden prüft aktuellen Datenstand, verarbeitet idempotent und schützt gegen Konflikte. Abgelaufener Link, Versandfehler, unklare Antwort, abgeschlossener Fall → sicherer Stopp/Neuanforderung/manuelle Klärung nach Zustand. | Weitergabe des gültigen Links technisch möglich, daher minimale Dateneinsicht und keine unbefugten verbindlichen Änderungen. Keine neue Gastkontenverwaltung. |
**Aus CH-14 folgende minimale KI-Verträge:** Versionierte und konfigurierbare Prompts mit definierten Platzhaltern; schema-validierte strukturierte Ausgabe (Fakten, Belegstellen, Unsicherheiten, Änderungsabsichten); austauschbare Modellanbindung. Klein-/Großmodell liefern Kandidaten, **keine** Datenbankänderungen. Fachliche Kritikalität wird im Programm aus Feld, Änderung und Phase ermittelt, nicht vom LLM als verbindliche Geschäftsregel. Es gibt eine **gesonderte Mindestanforderung** für automatische Übernahme; unsichere Werte können auch ohne großes LLM zur manuellen Klärung gehen. Modellwahl, Gewichtung und Schwellen werden anhand repräsentativer Testnachrichten festgelegt; keine frei generierende Gastkommunikation im MVP.
## 2a. Ergänzende fachliche Festlegungen
Diese Festlegungen ergänzen CH-01 bis CH-18, ersetzen aber keine der dort dokumentierten Entscheidungen:
1. **Klärungsreservierung vor Angebots-Vorreservierung:** Nur für unverbindliche Anfragen, nur nach erfolgreicher Verfügbarkeitsprüfung und mit eindeutigem Wohnungs-/Zeitraum-/E-Mail-Bezug. Sie ist ein optionaler, konfigurierbarer Kurzblock. Für das **eigene verbindliche Angebot** werden dagegen Name, vollständige Anschrift, Personenzahl, Reisezeitraum und E-Mail sowie die bestehenden Angebots-Gates verlangt. Der Übergang zur bestehenden Angebots-Vorreservierung erfolgt ausschließlich durch den vorhandenen Angebotsprozess, nicht automatisch durch E-Mail-Antwort oder LLM-Extraktion.
2. **Gastkommunikation folgt dem *tatsächlichen* Sperrstatus:** Bei `0`, fehlgeschlagener Sperre oder bereits abgelaufener Klärungsreservierung darf keine Reservierung behauptet werden; der Gast erfährt, dass der Zeitraum bis zu einem späteren wirksamen Angebot auch anderweitig vergeben werden kann. Bei tatsächlich aktivem Kurzblock dürfen die Rückfrage-/Eingangstexte einen zeitlich befristeten Schutz **nur mit dem realen Ablaufzeitpunkt** ausdrücken und müssen klarstellen, dass noch kein verbindliches Angebot vorliegt. Dafür genügen konditionale Textbausteine innerhalb der bestehenden Nachrichtensteuerung; **keine zweite Kommunikationsprozessvariante**.
3. **Direktbuchungsportale:** Die Verbindlichkeit bereits extern wirksamer Buchungen wird durch fehlende Gastinformationen nicht relativiert. Der Handler fordert erforderliche administrative Angaben nach, ohne eine neue Klärungsreservierung, Angebotsannahme oder Neubuchung auszulösen. Eingangsart und Rechts-/Buchungsstatus ergeben sich aus dem bestehenden Portal-/Vorgangsprozess, nicht allein aus dem Transportweg iCal oder E-Mail.
4. **Zentraler Kanalmanager einschließlich eigener Website:** Ein gemeinsames führendes fachliches Konfigurationsmodell bzw. ein einheitlicher Verwaltungszugang erfasst **alle** Kanäle und kanalbezogenen Einstellungen: eigenes Portal, Anfrageportale, Direktbuchungsportale; Wohnungszuordnung; tatsächliche Eingangsart; iCal-Import/-Export und Synchronisationsparameter; Kommunikationsweg und -modus; Klärungsblock-Einstellungen; Zugriff auf vorhandene Angebots-/Prozessprofile. Allgemeine Mandanten-/Vermieterstandards bleiben zentral pflegbar und gemäß bisheriger Vererbungslogik überschreibbar. **Fachliche Zielarchitektur beschlossen; Einpassung in die tatsächlichen Komponenten/Datenmodelle ist im Repository-Code zu prüfen.** Der Kanalmanager wird **keine** neue Buchungs-, iCal-Ereignis- oder Reservierungs-Engine.
### Reservierungs- und Nachrichtenzustände – verbindliche fachliche Grenze
| Tatsächlicher Zustand | Was FewoPortal dem Gast sagen darf | Wirkung |
|---|---|---|
| **Keine Klärungsreservierung (`0`)** | „Der Zeitraum ist noch nicht für Sie reserviert. Sobald die fehlenden Angaben vorliegen, prüfen wir die Verfügbarkeit erneut.“ | Anfrage/Rückfrage weiter möglich; keine exklusive Sperre. |
| **Klärungsblock konfiguriert, aber nicht wirksam angelegt** | **Keinen** Hold bestätigen; Status und erforderlichen manuellen Klärungsbedarf korrekt darstellen. | Konfiguration allein ist kein Reservierungsnachweis. |
| **Aktive Klärungsreservierung** | „Der Zeitraum ist zur Klärung bis **[tatsächliches Datum/Uhrzeit]** vorläufig reserviert; für ein verbindliches Angebot fehlen noch Angaben.“ | Kurzblock schützt nur bis zu seinem tatsächlichen Ende; **noch kein verbindliches Angebot**. |
| **Klärungsreservierung abgelaufen** | „Die Klärungsreservierung ist abgelaufen. Ihre Angaben können weiter übermittelt werden; wir prüfen die Verfügbarkeit erneut.“ | Keine rückwirkende Fristverlängerung und kein Vorrang allein durch frühere Anfrage. |
| **Eigenes verbindliches Angebot versendet** | Nur der aus dem **bestehenden** Angebotsprozess feststehende Angebots- und Annahmestatus mit dessen realer Frist. | Angebots-Vorreservierung nach unveränderter v0.10. |
| **Extern verbindliche Direktbuchung** | Tatsächliche Buchungsbestätigung/Informationsanforderung, **keine** unverbindliche Klärungsreservierungs-Mitteilung. | Bestehende Buchung bleibt unabhängig von fehlenden Gastdaten geschützt. |
Die Beispieltexte sind **fachliche Zustandsformulierungen, keine rechtlich freigegebenen E-Mail-Vorlagen**. Der Handler muss vor Versand den tatsächlichen Zustand abfragen; er darf keine Ablaufzeit nur aus einem Defaultwert vortäuschen. `0` deaktiviert ausschließlich die Klärungssperre, nicht Informationsbeschaffung, Erinnerungen oder spätere Prüfung eines verbindlichen Angebots.
## 3. Minimale fachliche Schnittstellen
Die Bezeichnungen beschreiben **logische Verträge**, keine vorgegebene Anzahl neuer Services oder Datenbanken.
| Nr. | Sender → Empfänger | Minimaler Inhalt / Ergebnis |
|---|---|---|
| **S1** | Requirements Check / `CaseAutomation` → Handler | Mandant/Vorgang/Phase, nächste Aktion, fehlende Pflichtangaben, zulässiger Kommunikationsweg, Rückfragemodus, tatsächlicher Sperrstatus/-ablauf → Kommunikationsauftrag oder manuelle Aufgabe. Maßgeblich sind die aus dem zentralen Kanalmanager ermittelten **wirksamen** Kanal- und Vorgangseinstellungen. |
| **S2** | IMAP / bestehende Portalparser / Formular / manuelle Eingabe → Nachrichteneingang | Nachrichtenidentität, Quelle, Zeit, Absender/Empfänger und Antwortbezug, Originalnachricht bzw. strukturierte Eingabe. iCal bleibt auf seinem vorhandenen Ereignispfad. |
| **S3** | Nachrichteneingang → Zuordnung und Extraktion | Ein eindeutig verknüpfter Vorgang, neue Anfrage an vorhandene Eingangserfassung oder ungeklärte Nachricht; Fakten-/Änderungskandidaten mit Herkunft, Beleg, Konfidenz und Prüfbedarf. Eine Nachricht darf mehrere fachliche Inhalte enthalten. |
| **S4** | Handler ↔ ausgehender Mailweg / Gastformular | Zustandsabhängiger Textbaustein **mit oder ohne tatsächlich aktiven Klärungsblock**, ggf. realer Ablaufzeitpunkt, Versand-/Freigabestatus, Antwortfrist/Erinnerungsplan, Antwortbezug; sicherer Formularlink mit relevanten vorbefüllten Daten und erlaubten Korrekturen. Direkte E-Mail-Antwort bleibt möglich. **Antwortfrist ist keine Reservierungsfrist.** |
| **S5** | Formular / Parser / KI / manuelle Eingabe → gemeinsamer Fakteneingang | Validierung, Quellenbeleg, aktuell gültige Phase, bisheriger Wert, Ergänzung vs. Widerspruch vs. Änderungswunsch → zulässige Ergänzung oder Prüfauftrag; nie blindes Überschreiben verbindlicher Daten. |
| **S6** | Fakteneingang → bestehende `CaseAutomation` | Idempotenter Anlass zur Neubewertung der nächsten Aktivität; bestehende Preis-, Verfügbarkeits-, Angebots- und Freigabelogik greift unverändert. |
**Konfigurationsfluss (querschnittlich zu S1–S6):** Der **zentrale Kanalmanager** ist fachlich führender Verwaltungsort für Kanaldefinitionen, iCal-Verbindungs-/Synchronisationskonfiguration, Kommunikations- und Klärungsparameter sowie die Zuordnung zu Vermieter-/Wohnungsstandards – einschließlich des eigenen Portals. Die existierenden Laufzeitkomponenten lesen die jeweils **wirksame Konfiguration**. Das bedeutet **nicht**, dass iCal-Sync oder der Communication Handler technisch in einen einzigen Service umgebaut werden müssen. Die reale Umsetzung/Einpassung ist anhand des Repository-Codes abzugleichen; keine konkurrierenden neuen Konfigurationsquellen schaffen.
**Kontrollfluss:** IMAP-Erfassung und KI-Extraktion allein verändern keine Buchung. Erst nach zulässiger Datenübernahme wird die bestehende Fachlogik neu bewertet. Ein erkanntes Änderungsbegehren ist **nicht** selbst die Änderung.
## 4. Ein gemeinsamer Datenbeschaffungsablauf
1. Eine unverbindliche Anfrage oder ein bestehender Vorgang hat einen **phasenbezogenen** Informationsbedarf. Der Requirements Check benennt nur die für die nächste Aktivität fehlenden Angaben.
2. Gemäß **wirksamer Kanal- und Eingangsartkonfiguration** wird eine E-Mail automatisch, nach Freigabe oder manuell veranlasst. Bei fehlendem Rückweg entsteht eine Aufgabe; kein fingierter Versand. Eine **optionale Klärungssperre** wird ausschließlich nach den für V1 bestätigten Mindestdaten (Wohnung, Zeitraum, verwendbare E-Mail, Verfügbarkeit) geprüft; `0` heißt ausdrücklich **keine Sperre**. Die Rückfrage nutzt einen Textbaustein für den **wirklichen** Sperrstatus, nicht für den bloß konfigurierten Sollwert.
3. Der Gast antwortet über den **signierten Ergänzungslink** oder direkt per E-Mail. IMAP und Formular liefern an denselben Fakteneingang; unvollständige Antworten bleiben erhalten.
4. Bestehende Portalparser und die KI-Extraktion liefern **Informationskandidaten**. Programmatische Zuordnungs-, Vertrauens-, Validierungs- und phasenabhängige Übernahmeregeln entscheiden über Automatik oder manuelle Klärung.
5. `CaseAutomation` prüft die nächste Aktivität erneut. Bei offenen Angaben folgt nach Konfiguration eine **gezielte Folgefrage** oder manuelle Aufgabe; bei ausbleibender Antwort gegebenenfalls eine **Erinnerung**. Höchstens eine aktive automatische Rückfrage, getrennte nicht rücksetzbare Zähler; Erinnerungs-Standard **maximal zwei zusätzliche Nachrichten**.
6. Nach Datenvollständigkeit führt die **bestehende** Prozesssteuerung weiter. Erst wenn **alle Angebots-Pflichtdaten** einschließlich Name, Anschrift und Personenzahl sowie die bestehenden fachlichen Gates erfüllt sind, kann der **vorhandene Angebotsprozess** mit seiner **unveränderten Angebots-Vorreservierung** greifen. Kommunikationsfristen verändern keine Reservierungs-/Annahmefrist. Bei Ablauf einer Klärungssperre bleibt der Vorgang bearbeitbar; vor verbindlichem Angebot sind Verfügbarkeit/Konditionen erneut zu prüfen. **Bereits verbindliche Direktbuchungen** bleiben unabhängig hiervon geschützt und werden nur nach ihrer bestehenden Eingangs-/Buchungslogik angereichert.
## 5. Go-live-Umfang und Abgrenzung
**Zum ersten Go-live enthalten:**
- Ein aktives dediziertes IMAP-Postfach je Mandant (Aliase möglich); nachvollziehbare Erfassung und Deduplizierung, Zuordnung, manuelle Kommunikations-Klärungsansicht mit Absenderhinweisen.
- Bestehende Portalparser erhalten; Gast- und Portal-E-Mail-Inhalte bei Bedarf durch **kleines LLM → programmatische Risikoprüfung → optional großes Prüf-LLM** strukturieren; Prompts, Platzhalter und Ausgabeformat versionieren. Kein Agentendialog.
- Ausgehende Rückfragen über bestehenden Versand-/Testmodus; sicheres vorbefülltes Ergänzungsformular ohne Registrierung, direkte Antworten per E-Mail, regelbasierte Folgefragen und Erinnerungen mit Grenzen.
- Gemeinsame, phasenabhängige Faktenübernahme und idempotente Neubewertung durch bestehende `CaseAutomation`.
- Optionale Klärungsreservierung V0/V1 mit präzisierter Mindestqualifikation (Wohnung + Zeitraum + verwendbarer E-Mail-Kontakt + positive Verfügbarkeitsprüfung) und **zustandsabhängigen Rückfragehinweisen** bei Sperre `0` bzw. tatsächlich aktivem Kurzblock; keine Änderung der bestehenden Angebots-Vorreservierung. Die bestehende iCal-Ereigniserkennung wird nicht vom Handler ersetzt oder gesperrt.
- **Zentraler Kanalmanager als gemeinsame Verwaltungs-/Konfigurationsverantwortung** für eigenes Portal und externe Kanäle einschließlich iCal-Sync-Einstellungen, Geschäfts-/Kommunikationsparametern und zentralen Vermieterstandards; operative iCal- und Buchungslogik bleibt an ihrem bisherigen Ort. Für den MVP schrittweise Integration in vorhandene Konfiguration statt Neubau einer Channel-Management-Plattform.
**Nicht Bestandteil des Communication-Handler-MVP:**
- Parallele alternativ annehmbare verbindliche Angebotsversionen; automatische Angebotsänderungs-/Reservierungsvarianten und eine einmalige Verlängerung der ursprünglichen Angebotsfrist.
- Automatische vertragsrelevante Änderungen **nach** Vertragsschluss, Teilstorno oder automatische Stornierung/Neubuchung. Allenfalls **manuell zu prüfender** Übergangsweg; kein beschlossener Standard.
- Generative Gastkommunikation, KI-Agenten mit Aktionserlaubnis, Messenger-/Social-Media-Adapter, mehrere aktive Postfächer je Mandant, Benutzerregistrierung und Loyalty-/CRM-Programm.
- Neue Portalparser-/iCal-Engine, umfassende eigenständige Channel-Management-Plattform mit eigenem Buchungskern, Warteliste/Nachrücken oder zusätzliche Klärungsreservierungsvarianten V2/V3.
**P02-Abgrenzung:** Änderungswünsche vor Annahme eines eigenen verbindlichen Angebots werden im MVP **erkannt, zugeordnet und zur kontrollierten manuellen/fachlichen Bearbeitung vorgelegt**. Keine automatische parallele Angebotsverwaltung und keine stillschweigende Änderung des gültigen Angebots oder seiner Frist. Die rechtlich/fachlich vollständige P02-Änderungslogik bleibt gesondert offen. Nach Vertragsschluss gilt zunächst manuelle Bearbeitung vertragsrelevanter Änderungen; administrative Ergänzungen nach CH-03 bleiben möglich.
## 6. Minimale fachliche Abnahmefälle
| ID | Durchgangstest | Erwarteter Nachweis |
|---|---|---|
| **M01** | Unverbindliche Website-Anfrage ohne vollständige Anschrift | Vorgang erfasst, Rückfrage; **kein eigenes verbindliches Angebot** trotz manuellem Warnungs-Override. |
| **M02** | Antwort per E-Mail und/oder Gastformular, auch nur teilweise | Fehlende eindeutige Werte kontrolliert ergänzen, Restbedarf neu bewerten; keine Buchung allein durch Absenden. |
| **M03** | Gleiche Nachricht wiederholt; mehrfacher Formularaufruf/-submit | Idempotente Übernahme/Fortsetzung; keine Doppelbuchung. |
| **M04** | Allgemeine/mehrdeutige E-Mail oder zweifelhafte Zuordnung | Kein automatischer falscher Vorgangsbezug; Klärungsansicht mit Hinweisen. |
| **M05** | Mehrdeutige oder risikobehaftete Nachricht; kleine KI übersieht eventuell ein wesentliches Datum | Eskalations-/Prüfregeln und sicherer Fehlerfallback nachweisen; **übersehene Angaben separat als Fehlerrate messen**. Kein System kann die Erkennung jeder Auslassung garantieren. |
| **M06** | E-Mail enthält eindeutige fehlende Telefonnummer und möglichen Vertragsänderungswunsch | Administrative Ergänzung zulässig; Änderungswunsch nur aufnehmen/weiterreichen; keine Vertragsänderung. |
| **M07** | iCal vor Portal-Mail und umgekehrt | Bestehender iCal-Pfad unverändert; spätere eindeutige Mail ergänzt zulässige Gastdaten, kein zweiter Geschäftsvorgang. |
| **M08** | Teilantwort, Folgefrage, Erinnerung, Fristablauf | Pro Beschaffungsvorgang eine aktive automatische Rückfrage; getrennte Zähler ohne Reset; keine Verlängerung von Klärungs- oder Angebotsfrist. |
| **M09** | Abgelaufener/fremder Link, Konflikt mit zwischenzeitlich geändertem Wert, Versandfehler | Keine unbefugte Datenmutation; idempotente Behandlung und sichtbarer Prüf-/Fehlerfall. |
| **M10** | Test-Mailversand und Bestandsregression | Versand nur an Testziel, nicht als reale Gastzustellung markiert; iCal-Import/-Export unabhängig; vorhandene Angebots- und Portalpfade bestehen. |
| **M11** | Anfrage mit Klärungsblock `0`, mit aktivem 15-/konfiguriertem Kurzblock, mit fehlgeschlagener/abgelaufener Sperre | Nachricht unterscheidet „keine Reservierung“ von tatsächlich reserviertem Zeitraum mit echtem Ablaufzeitpunkt; niemals unbegründete Reservierungsbehauptung; Angebots-Vorreservierung unverändert. |
| **M12** | Eigenes Portal und externes Direktbuchungsportal über zentrale Kanalkonfiguration | Eigenes Portal wird wie ein Kanal konfiguriert; iCal-Sync-Einstellungen bleiben verwaltbar und operativ unverändert. Extern verbindliche Direktbuchung bleibt trotz fehlender Gastdaten gültig und erhält keinen neuen Klärungs-/Angebotsprozess. |
## 7. Wenige noch offene Punkte – geordnet für Abschlussarbeiten
### A. Abschluss- und Integrationsprüfung (bereits geklärte Punkte nicht erneut öffnen)
1. **Klärungsreservierung V1 – Grundsatz abgeschlossen:** Mindestqualifikation **Wohnung + eindeutig datierter Zeitraum + verwendbarer E-Mail-Kontakt + erfolgreiche Verfügbarkeitsprüfung** ist nun festgelegt. **Nur die konkrete Kanalparametrierung** (u. a. `0` für Portale mit trägem iCal-Abruf) ist im Umsetzungs-/Betriebskontext zu bestimmen. Die beschlossenen Ausgangswerte **15/180 Minuten** bleiben bis zu einer ausdrücklichen Änderung bestehen; 15–30 Minuten wurde als Beispiel genannt, **nicht** als neuer Standard beschlossen.
2. **Pflichtdaten und Datenhoheit – Prinzip beschlossen, Detailbedarf begrenzt:** Vor eigenem Angebot sind **Name, vollständige Anschrift, Personenzahl, Zeitraum und E-Mail** zwingend. **Noch offen** bleibt die Pflicht zur Altersunterteilung Erwachsene/Jugendliche/Kinder und die präzise Feldklassifikation bei P1/P2/P3 für die Umsetzung. Die grundlegende kontrollierte automatische Ergänzung administrativer Angaben (CH-03) wird **nicht** neu verhandelt.
3. **Nachrichtenverifikation und KI-Automatik:** Konkrete, testbare Kriterien für hinreichend verlässliche Portal-Mailereignisse; minimaler Feldkatalog/JSON-Schema, Prompt-/Kontextgrenzen, Eskalationsregel und Ausfallverhalten. **LLM-Selbstauskunft zur Konfidenz erst anhand Testdaten kalibrieren**; bestehender iCal-Pfad bleibt ausgenommen.
4. **Kommunikationsparameter und Sicherheit:** Obergrenze automatischer Folgefragen, Antwort-/Erinnerungsintervalle, Stopps, Versandfehler; Gastlink-Laufzeit und Sichtbarkeit; **zustandsabhängige Textbausteine** mit realem Sperrstatus, rechtliche Freigabe konkreter Formulierungen, Berechtigungen, Testbetrieb, Speicher-/Löschfristen und Datenschutz-/Sicherheitsprüfung vor Livebetrieb. **Kein verbindlich beschlossener 30-Tage-Löschwert.**
5. **Kanalmanager / Integrationsabgleich:** Die **fachliche zentrale Verwaltung einschließlich eigenes Portal und iCal-Konfiguration** ist beschlossen. **Offen ist keine neue Grundsatzfrage**, sondern die konkrete Zuordnung zu den vorhandenen v0.10-Modulen, Tabellen, Konfigurationen und Admin-Ansichten im laufenden Repository-Code. Doppelte „Sources of Truth“ sind zu vermeiden.
### B. Dokumentiert, aber **nicht** MVP-blockierend
- **P02 / Angebotsänderungen:** Änderungswünsche vor Annahme, rechtliche Bindung, Ersetzung gegenüber parallelen alternativ annehmbaren Angeboten, notwendige Verfügbarkeitsabsicherung, bei spätem erstem Änderungswunsch möglicherweise **einmalige begrenzte Fristverlängerung** (nicht beschlossen; keine automatische Fristneustartlogik).
- **Nach Vertragsschluss:** Vertragsänderungen/Verkürzungen, Zahlungs- und Stornofolgen, Teilstorno und etwaiger manuell geprüfter Storno-/Neubuchungs-Workaround; zunächst keine Änderungsautomatik.
- **Spätere Funktionen:** Mehrere aktive Postfächer, zusätzliche Kommunikationskanäle, agentische KI-Gastkommunikation, CRM/Loyalty, optionale Klärungsmodelle V2/V3 und Detailoptimierung gleichzeitig konkurrierender Anfragen ohne Queue.
## 8. Herkunft und Vorrang
Der fachliche Beschlussstand stammt aus dem Betreiberabgleich vom 02.–03.11.2026, insbesondere dem Dokument `Historie/CH_Entscheidungsstand_2026-11-03_v4.md` und seinen zugrunde liegenden Übergabe-/Entscheidungsprotokollen. Bei Widerspruch zwischen **historischen** Audit-/Umsetzungstexten und diesen neuen v0.11-Regeln gilt dieser Querschnitt für den hier neu geregelten Bereich; die bereits existierenden iCal-, Angebots-, Vertrags- und Buchungsprozesse werden dadurch **nicht umdefiniert**.
**Offen** bedeutet Prüf-/Parametrierungsbedarf, nicht stillschweigende Entscheidung. Die rechts- und datenschutzbezogenen Freigaben sowie die technische Ist-/Soll-Prüfung der Implementierung sind gesondert erforderlich (siehe [Offene Prüfungen](../Offene_Fragen.md)).