diff --git a/docs/Prozessarchitektur/00_GESAMTSPEZIFIKATION_v0.11.md b/docs/Prozessarchitektur/00_GESAMTSPEZIFIKATION_v0.11.md new file mode 100644 index 0000000..6b68026 --- /dev/null +++ b/docs/Prozessarchitektur/00_GESAMTSPEZIFIKATION_v0.11.md @@ -0,0 +1,1068 @@ +# FewoPortal – Prozessarchitektur v0.11 (konsolidierte Gesamtspezifikation) + +**Stand:** 03.11.2026 · **Status:** fachliche Sollfassung zur Betreiberfreigabe; kein Nachweis des Code-Iststands oder der rechtlichen Go-live-Freigabe. + +Diese Gesamtspezifikation vereinigt **vollständig und ohne Kürzung** die derzeit normativen Einzelkapitel der v0.11. Die Einzeldateien im Archiv sind die editierbaren Quellen. Nicht-normatives historisches Quellenmaterial wird nicht als aktuelle Anforderung wiederholt. + +## Inhaltsübersicht + +- **Grundlagen:** `00_Prozesslandkarte.md` +- **Grundlagen:** `01_Buchungsarchetypen.md` +- **Grundlagen:** `02_Abwicklungsprofile_und_Dokumente.md` +- **Hauptprozess:** `V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md` +- **Hauptprozess:** `V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md` +- **Hauptprozess:** `V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md` +- **Hauptprozess:** `V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md` +- **Hauptprozess:** `V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md` +- **Querschnitt:** `Querschnitt/Gates_und_Nachweise.md` +- **Querschnitt:** `Querschnitt/Datenbeschaffung_und_Communication_Handler.md` +- **Querschnitt:** `Querschnitt/Belegungskonflikte.md` +- **Querschnitt:** `Querschnitt/Preise_und_Zahlungen.md` +- **Querschnitt:** `Querschnitt/Sonder_und_Supportprozesse.md` +- **Konfiguration:** `KONFIGURATION_UND_WIRKSAMKEIT.md` +- **Konfiguration:** `Entscheidungen.md` +- **Konfiguration:** `Offene_Fragen.md` +- **Szenarien:** `Szenarien/00_Szenariomatrix.md` +- **Szenarien:** `Szenarien/R01_Eigene_Webseite.md` +- **Szenarien:** `Szenarien/R07_Eigenbelegung_und_Sperren.md` +- **Szenarien:** `Szenarien/R08_Destination_Solutions.md` +- **Szenarien:** `Szenarien/R09_FeWoDirekt.md` +- **Nebenprozess:** `V02_Vermarktung_und_Gaestebindung.md` + +--- + +--- + +## Kapitel: `00_Prozesslandkarte.md` + +## Prozesslandkarte FewoPortal + +### Produkt und Wertschöpfung + +FewoPortal ist eine mandantenfähige Plattform für kleine Ferienwohnungsvermieter (typisch **eine bis drei Wohnungen pro Vermieter**). Es unterstützt die eigene Website und externe Buchungskanäle; es ist **kein Ferienwohnungsmarktplatz** und vorerst kein umfangreiches Hotel-, Agentur-, Personal- oder Objektmanagementsystem. Ziel sind Gästegewinnung und eine möglichst einfache, verlässliche und weitgehend automatisierte Buchungs- und Aufenthaltsabwicklung. + +| Wertschöpfungsprozess | Zweck | +|---|---| +| **V01 – Buchung und Aufenthalt** | Geschäftsfall vom ersten relevanten Anlass bis zum fachlichen Abschluss steuern; **ein gemeinsamer Vorgang** mit bedarfsgerechtem Ablauf | +| **V02 – Vermarktung, Gästegewinnung und Gästebindung** | Website, Portale, Social Media, Print, Interessenten, Wiederbuchung, CRM/Loyalty; kann V01 auslösen und nach V01 fortgeführt werden; derzeit nur als fachlicher Rahmen | + +### V01 – Hauptwertschöpfungsprozess + +| Phase | Kernergebnis | +|---|---| +| **P01 – Eingang und Verfügbarkeit** | Anlass, Art, Quelle, Unterkunft und Zeitraum erkannt; Belegung/Hold/Sperren und Klärungen bearbeitet | +| **P02 – Konditionen und Verbindlichkeit** | Eigene Verbindlichkeit begründet oder externe Verbindlichkeit übernommen; ggf. geeignete Bestätigung; Konditionsstand bekannt bzw. Lücken gekennzeichnet | +| **P03 – Verwaltung und kaufmännische Abwicklung** | Dokumente, Gäste, Leistungen, Zahlungen, Provisionen, Fristen und Zuständigkeiten sachgerecht bearbeitet | +| **P04 – Vorbereitung und Aufenthalt** | Lokale Leistungen, notwendige Daten, Anreise und Aufenthalt bzw. interne Nutzung/Arbeiten unterstützt | +| **P05 – Abschluss und Nachbereitung** | Erfüllung oder alternative Beendigung dokumentiert; offene Folgeangelegenheiten zugewiesen | + +**Diese Phasen sind eine fachliche Hierarchie, keine fünf starren Bildschirmseiten oder zwingenden Wartezustände.** Schritte können entfallen, parallel oder zu einem späteren Zeitpunkt ausgeführt werden; nicht anwendbare Aktivitäten werden nicht künstlich erzwungen. + +### Einheitlicher Vorgang + +Jeder qualifizierte geschäftliche Anlass führt zu einem **Vorgang**, ohne separate Entscheidung „Buchungsakte anlegen“: eigene bzw. vermittelte Anfrage, bereits verbindliche externe Buchung oder interne Eigenbelegung/private Überlassung/Sperre. Ein unklarer technischer Import ist bis zur Klärung noch **kein nachgewiesener Vertrag**. Doppelte Portalmeldungen und Spiegelungen desselben Sachverhalts dürfen nicht zu zusätzlichen unabhängigen Vorgängen führen. Eine „Buchungsakte“ ist allenfalls eine Ansicht, keine zusätzlich zu eröffnende fachliche Einheit. + +**Vorgang ≠ Belegung.** Ein Vorgang dokumentiert Anlass, Beteiligte, Zustand, Aufgaben, Leistungen, Konditionen, Dokumente, Zahlungen und Ereignisse. Eine Belegung/Hold/Sperre beschreibt die zeitliche Verfügbarkeit des Objekts. Ein Vorgang kann Belegungswirkungen auslösen; importierte Spiegelungen sind keine eigenen Vertragsvorgänge. + +Die bestehende **Owner-/Ursprungskanal-Zuordnung** ist eine vorhandene Funktion. Der technische Eingang (z. B. E-Mail/iCal), Ursprungskanal und ggf. provisionsrelevante Partnerherkunft sind begrifflich zu unterscheiden. Herkunftsketten sind **kein eigener Archetyp**. + +Für die v0.11 werden **eingehende Nachrichten, Gastformular und manuelle Daten** über eine gemeinsame kontrollierte Informationsübernahme mit der vorhandenen Prozesssteuerung verbunden. Der [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md) ist eine Querschnittsfähigkeit, kein neuer Buchungsarchetyp oder eigenständiger Workflow. Der zentrale Kanalmanager pflegt eigene Website und externe Kanäle gemeinsam; die iCal-Ereignisverarbeitung bleibt bestehen. + +### Führungs- und Verantwortungsprinzip + +FewoPortal ist das führende **interne** Verwaltungs- und Arbeitsinstrument. Ein externes Portal kann den Vertrag abschließen, Geld einziehen, Nachrichten oder Stornierungen bearbeiten. Im Vorgang werden deshalb **tatsächlicher Sachverhalt, Quelle, fachliche Zuständigkeit, Nachweis und erforderliche eigene Folgehandlung** festgehalten. Externe Verantwortung bedeutet nicht, dass eine Leistung nachweislich bereits erbracht wurde. + +Unvollständige oder nicht automatisch abrufbare Daten sind normale Fälle: gezielte manuelle Beschaffung, Klärung und späterer Abgleich sind zulässig. **Unbekannt ist nicht null**. Eine fehlende Provisionsaufschlüsselung darf beispielsweise nicht die Anreise blockieren, wenn sie dafür nicht benötigt wird. + +### Prozessausgänge und Grenzen + +V01 endet – abhängig vom Fall – **regulär nach Aufenthalt/Nutzung**, **ohne verbindliche Buchung** (z. B. Angebotsablauf), **durch wirksame Stornierung** oder bei A6 durch planmäßige bzw. vorzeitige Beendigung einer Sperre. Offene Forderungen, Schäden oder Differenzen können danach als zugewiesene Folgeangelegenheiten weiterlaufen; sie werden nicht still gelöscht. Die genaue Pflichtprüfliste für den Abschluss ist fachlich noch zu konkretisieren. + +Support- und Sonderprozessfamilien sind **fachliche Fähigkeiten**, keine Verpflichtung, eigenständige Softwaremodule zu bauen. Buchungsbezogene Objektaufgaben bleiben möglichst im Vorgang integriert; die Bedienoberfläche soll wenige klare Aufgaben zeigen. + +**Vertiefung:** [A1–A6](01_Buchungsarchetypen.md) · [P01](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) · [Sonderprozesse](Querschnitt/Sonder_und_Supportprozesse.md). + +--- + +## Kapitel: `01_Buchungsarchetypen.md` + +## Buchungsarchetypen A1–A6 + +**Archetyp = Geschäftskonstellation**, kein eigenes System und kein separater Workflow. Maßgeblich sind die **tatsächliche Eingangsart und Abwicklungsverantwortung**, nicht nur der Name des Kanals. Ein Kanal kann sowohl unverbindliche Anfragen als auch verbindliche Buchungen liefern. Die Abwicklung richtet sich nach dem für den Vorgang gültigen Profil. + +| Typ | Geschäftsfall | Vertragsverbindlichkeit bei Eingang | Typische weitere Abwicklung | +|---|---|---|---| +| **A1** | Eigene Website / eigener vollständiger Buchungsweg | Zunächst Anfrage | Eigene Auskunft bzw. bindendes Angebot, Annahme, Vertrag, Zahlung, Aufenthalt | +| **A2** | Unverbindliche Anfrage eines externen Vermittlers | Noch nicht verbindlich | Fehlende Daten ergänzen; eigener Angebots- und Buchungsweg ähnlich A1 | +| **A3** | Verbindliche externe Direktbuchung; vollständige weitere Abwicklung bei uns | Bereits extern verbindlich | Vereinbarten Portalpreis übernehmen; eigene Dokumentation, Gastkontakt, Zahlungsmanagement und Aufenthalt | +| **A4** | Verbindliche externe Buchung mit **geteilter** Abwicklung | Bereits extern verbindlich | Beispielsweise eigenes Vertragsdokument und lokale Leistung, Portalzahlung; andere Verantwortungen je Profil | +| **A5** | Extern weitgehend vollständig abgewickelte Direktbuchung | Bereits extern verbindlich | Keine zweite Annahme/unnötige eigene Mahnung; nur erforderliche eigene lokale Aufgaben und Nachweise | +| **A6** | Eigenbelegung, private Überlassung, Wartung und sonstige Sperren | Interner Belegungsanlass, nicht automatisch Mietvertrag | Einheitlicher Vorgang mit Sperrgrund, Belegung und je nach Fall Gäste, Bestätigung, Zusatzleistungen und Zahlung | + +**Partner-/Hub-Vertrieb ist kein A6.** Unterschiedliche Provisionen je Partner sind eine kaufmännische Eigenschaft des Ursprungskanals bzw. der Buchung; eine separate Partnerprozessklasse wird nicht benötigt. Telefon/manuell/iCal/E-Mail/API beschreiben Informations- oder Erfassungskanäle, keine eigenen Archetypen. + +**v0.11-Präzisierung:** Der Communication Handler darf A1/A2-Anfragen mit fehlenden Daten nachfordern und beim eigenen Angebot erst nach vollständigen Pflichtangaben fortsetzen. Für A3–A5 gilt die externe Verbindlichkeit dagegen von Anfang an, auch wenn Gastdaten fehlen. Eine nachfolgende E-Mail oder ein Formular darf diese nicht in eine unverbindliche Anfrage verwandeln. Details stehen im [Communication-Handler-Querschnitt](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + +### Verhalten im gemeinsamen Prozess + +- **A1/A2:** Mit Hold > 0 kann nach geeigneter Belegungssicherung ein bindendes zeitlich befristetes Angebot verschickt werden. **Hold = 0:** reine Preis-/Verfügbarkeitsauskunft unter Vorbehalt; bei Buchungswunsch erneute Prüfung und Bestätigung entsprechend dem automatisch/manuell konfigurierten Modus. Die verbindliche Annahme eines gültigen eigenen Angebots erfordert **keine zweite Freigabe**. +- **A3–A5:** Der Vertrag entstand bereits extern. Der bestätigte Gastpreis und die nachweislich vereinbarten Bedingungen werden übernommen, **nicht durch eigene Preise oder eine zweite Annahme ersetzt**. Es ist zulässig, dass die Gastadresse, Tagespreise oder Zahlungsdetails erst später verfügbar werden. +- **A6:** Jeder eigenständige interne Sperr-/Nutzungsanlass ist ein Vorgang. Private Aufenthalte können Teilnehmer, Kurabgabe, Wäschepakete, Gebühren und Zahlungen haben, auch bei Mietpreis 0. Eine reine Wartungssperre benötigt weder Gast noch Mietvertrag. Der Hold einer A1/A2-Anfrage ist dagegen **keine eigene A6-Buchung**. +- **Alle:** Änderung, Storno/Aufhebung, Belegung, Nachweise, Fristen und Folgeaktivitäten benutzen gemeinsame fachliche Mechanismen. Die rechtliche Wirkung bleibt abhängig vom Vorgangstyp. + +### Validierung durch reale Fälle + +- [R01 – eigene Website](Szenarien/R01_Eigene_Webseite.md): A1, ggf. A2 nach Datenergänzung. +- [R08 – Destination Solutions](Szenarien/R08_Destination_Solutions.md): **A3** mit vollständig eigener weiterer Abwicklung, manuellen Portalsperren und partnerabhängiger Vermieterprovision. +- [R09 – FeWo-direkt](Szenarien/R09_FeWoDirekt.md): **A4** mit teilweise externer Zahlung/Kommunikation. +- [R07 – interne Belegung/Sperre](Szenarien/R07_Eigenbelegung_und_Sperren.md): **A6**, mit und ohne Gäste. + +**Nicht als Fakten unterstellen:** Identische Portal-Datentiefe, allgemeingültige Portal-Stornozuständigkeit, gesicherte Kalenderpropagation oder automatische Erkennbarkeit jedes iCal-Eintrags. + +--- + +## Kapitel: `02_Abwicklungsprofile_und_Dokumente.md` + +## Abwicklungsprofile, Einstellungen und Dokumente + +### Konfiguration: Vermieterstandard und Kanalabweichung + +**Mandantenregel:** Jeder Vermieter legt seine eigenen **globalen Standardeinstellungen** fest. Für einen Kanal kann er einzelne Werte ausdrücklich überschreiben. Ein **nicht gesetzter Kanalwert** erbt den globalen Vermieterwert. Das gilt auch für `0`, `nein` und `manuell`: Diese bewusst eingestellten Werte sind **keine leeren Werte**. Die in der implementierten v0.10-Betriebskonfiguration dokumentierte Hierarchie **Vermieterstandard → Wohnung → Kanal × tatsächliche Eingangsart → Vorgangsentscheidung** ist für passende Geschäftsparameter zu verwenden; die konkreten Wirkungen und Herkunftswerte müssen sichtbar bleiben. Die technische Einpassung neuer Parameter wird am Repository-Code geprüft. + +Je nach Kanal **und tatsächlicher Eingangsart** werden relevante Regeln angewandt. Es gibt kein automatisches „alle FeWo-direkt-Buchungen sind gleich“. Die Konfiguration ist bewusst schlank: keine frei programmierbare Workflow-Engine erforderlich. + +| Konfigurationsbereich | Zweck | +|---|---| +| Automatisch/manuell | Anfrage, Buchungswunsch und zulässige Folgeaktionen nach wirksamem Vermieterstandard oder Kanalabweichung bearbeiten; individuelle manuelle Übernahme möglich | +| **Bestehende Angebots-Haltefrist** | **Unverändert:** Für eigene Angebote: `0` = Auskunft unter Vorbehalt ohne Angebots-Hold; `>0` = befristete Reservierung mit passend befristetem bindendem Angebot (z. B. 24/48/72 Stunden). **Nicht** die Klärungsreservierung. | +| **Vorgelagerter Klärungsblock (neu)** | Für unvollständige unverbindliche A1/A2-Anfragen getrennt konfigurierbar; bei `0` keine Klärungssperre, bei `>0` kurze tatsächliche Verfügbarkeitsabsicherung nach Wohnung/Zeitraum/E-Mail-Qualifikation. Ausgangswerte 15 Minuten automatisch / 180 Minuten manuell oder Freigabe; keine Verlängerung durch Nachrichten. | +| Datenbeschaffung | Automatisch, manuell oder kombiniert; vorhandene, unvollständige und unbekannte Portalwerte unterscheiden | +| Verantwortung | Vertrags-/Dokumentenversand, Gastkommunikation, Zahlung, Mahnung, Storno/Erstattung, lokale Leistungen, Kalender-/Sperrpflege | +| Dokumentenprofil | Vorlagen und Anlagen abhängig von Vermieter, Objekt, Kanal, Eingangsart/Vorgangstyp und konkretem Vorgang | +| Konditionsquelle | Eigene Jahres-/Saisonpreise bei eigenem Angebot oder verbindlich akzeptierter Portalpreis bei extern abgeschlossenem Vertrag | +| Kanal-Fähigkeit | iCal/API/E-Mail/Portaloberfläche/manuell; Nachweis, Verzögerung, Vollständigkeit und erforderliche manuelle Schritte | + +Bei **Angebots-Hold = 0** ist die ursprüngliche Mitteilung **kein uneingeschränkt annehmbares Vertragsangebot**. Nach dem erneuten Verfügbarkeitscheck wird der Buchungswunsch gemäß wirksamem Modus automatisch bestätigt oder zur Vermieterentscheidung vorgelegt. Bei einem bereits verbindlich angenommenen Angebot oder extern geschlossenen Vertrag darf diese Wahl die entstandene Verbindlichkeit nicht nachträglich aufheben. + +### Zentraler Kanalmanager (v0.11) + +**Alle** Kanäle einschließlich der eigenen Website werden an einem gemeinsamen fachlichen Verwaltungsort geführt. Dort werden vorhandene Kanaleigenschaften und Wohnungszuordnungen, iCal-Import/-Export mit Einstellungen und Status, tatsächliche Eingangsarten, Kommunikationswege und kanalabhängige Geschäftsparameter einschließlich des neuen Klärungsblocks zugänglich gemacht. Die bestehenden Vermieter- und Wohnungsstandards werden wiederverwendet, nicht als zweites Konfigurationsmodell kopiert. Die operative iCal-Synchronisation, Eingangserkennung und Buchungslogik bleiben außerhalb dieses Verwaltungsbausteins unverändert. + +Bei Datenbeschaffung wird **Rückfragemodus** (automatisch/Freigabe/manuell) unabhängig von der vorhandenen **Angebotsfreigabe** konfiguriert. Gültige Einstellungen sind pro Vorgang nachvollziehbar; `null` bedeutet Vererbung, `0` bedeutet ausdrücklich keine Klärungssperre. Vorgänge behalten ihr beim Eingang geltendes Profil nach der bisherigen Wirksamkeitsregel. Kommunikationsnachrichten müssen den **tatsächlichen** Sperrstatus und nicht nur den konfigurierten Wunschwert verwenden. Siehe [Konfiguration und Wirksamkeit](KONFIGURATION_UND_WIRKSAMKEIT.md) und [CH-Querschnitt](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + +### Dokumentarten und Auswahl + +| Sachverhalt | Geeignetes Dokument | Fachliche Wirkung | +|---|---|---| +| Eigene Anfrage mit Hold > 0 | Bindendes befristetes Angebot mit Vertragstext/Anlagen und nachweisbarer Annahmemöglichkeit | Wirksame rechtzeitige Annahme führt zum Vertrag | +| Anfrage mit Hold = 0 | Preis-/Verfügbarkeitsauskunft unter Vorbehalt | Kein Vertrag durch bloße Annahme der Auskunft; Buchungswunsch erfordert neue Prüfung und Bestätigung | +| Externe bindende Direktbuchung A3/A4 | Passende Buchungs-/Vertragsdokumentation der bereits vereinbarten Bedingungen | **Dokumentiert**, begründet nicht durch zweite Annahme einen neuen Vertrag | +| A5 | Ggf. Ergänzung zur externen Bestätigung, Anreise- oder lokale Informationen | Nur soweit eigene Tätigkeit dies erfordert | +| A6 mit privaten Gästen | Aufenthalts-, Buchungs- oder Reservierungsbestätigung, ggf. Zusatzleistungen | Wirkung entsprechend dem tatsächlichen privaten Überlassungsverhältnis | +| A6 ohne Gäste | Interne Bestätigung oder kein Dokument | Kein künstlicher Mietvertrag | + +Vor Versand soll der Vermieter bei Bedarf die **gemeinsame Konditions-/Dokumentenzusammenstellung** sehen: Gast/Teilnehmer, Zeitraum, verbindlicher Preis bzw. nachgewiesene Teilbeträge, Leistungen, Stornoregel, gewählte Vorlage/Version und Anlagen. Die zugrunde liegenden Vereinbarungen bleiben mit Quelle und verwendetem Dokumentenstand nachvollziehbar. Für extern verbindliche Buchungen dürfen **keine neuen, nicht akzeptierten Pflichten** stillschweigend eingeführt werden. Bei fehlendem Konditionsnachweis wird die **betroffene Handlung** geklärt; eine bereits gültige Buchung wird nicht rückwirkend als unverbindlich behandelt. + +Die Software wählt passende Vorlagen und Folgeaktivitäten automatisch anhand des fachlichen Profils; bei zulässigem Bedarf ist eine **begründete manuelle Korrektur** möglich. Vorlagenwahl darf nicht allein vom Kanal abhängen. Ein Portalkonto kann gemischte Eingangstypen besitzen. + +### Preis- und Informationsregeln + +- Für eigene Angebote gelten gepflegte **Jahres-/Saisonpreise**, ggf. Rabatte und zusätzliche Leistungen; keine Yield- oder Buchungsklassenlogik im MVP. +- Bei **extern bereits verbindlicher Buchung** ist der vom Gast akzeptierte **Portalpreis** maßgeblich. Die eigene Tarifrechnung darf ihn höchstens vergleichen, nicht unbemerkt ersetzen. +- Portale liefern Einzelpreise, Sammelposten oder lediglich den Gesamtpreis. Alle Formen sind zulässig. Unbekannte Positionen bleiben offen; fehlende Daten dürfen bei Bedarf manuell ergänzt werden. +- Eventuelle Gast-Servicegebühr, Vermittler-/Vermieterprovision, Vertriebspreisaufschlag und Vermieterauszahlung sind verschiedene Sachverhalte, auch wenn ein Portal Beträge kombiniert. + +**Vertiefung:** [Preis- und Zahlungslogik](Querschnitt/Preise_und_Zahlungen.md) · [Gates](Querschnitt/Gates_und_Nachweise.md). + +--- + +## Kapitel: `V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md` + +## P01 – Buchungseingang und Verfügbarkeit + +**Ziel:** Relevanten Geschäftsfall als **einheitlichen Vorgang** erfassen, Verfügbarkeit und Belegungsfolgen bewerten und nur tatsächlich erforderliche Sperr-/Klärungsaufgaben auslösen. + +### Aktivitäten + +1. **Eingang klassifizieren:** Eigene Website, externer Kanal, Telefon/manuell oder interner Belegungsanlass; unterscheiden zwischen unverbindlicher Anfrage, bereits extern verbindlicher Buchung, A6-Nutzung/Sperre und ungeklärter Fremdmeldung. Vorhandene Owner-/Ursprungskanal-Zuordnung nutzen. Partnerherkunft nur erfassen, wenn kaufmännisch relevant. +2. **Identität und Daten übernehmen:** Unterkunft, Zeitraum, externe Referenz, verfügbare Gastdaten und Statusquellen. Meldungen desselben externen Buchungsfalls zusammenführen, nicht mehrfach Vorgänge erzeugen. **Unklare iCal-Sperre ist nicht automatisch ein Gastvertrag.** Fehlende Angaben bleiben unbekannt und lösen nur bei Bedarf Klärung aus. **Neu v0.11:** E-Mail-/Portalnachrichten und Gastformular ergänzen über den gemeinsamen, phasenabhängig kontrollierten Fakteneingang; die bestehende iCal-Ereignisverarbeitung bleibt unverändert. +3. **Verfügbarkeit bewerten:** Bereits verbindliche Buchungen, interne Belegungen, aktive Holds und bestehende Kalenderkonflikte berücksichtigen. Neue bereits extern verbindliche Konfliktbuchung **nicht still löschen oder für unverbindlich erklären**. +4. **Angebots-/Belegungswirkung festlegen:** Bei unverbindlicher A1/A2-Anfrage mit fehlenden Angaben kann **vor der Angebotsphase** eine getrennt konfigurierbare **Klärungsreservierung** V0/V1 geprüft werden: Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt und positive bestehende Verfügbarkeitsprüfung; bei Klärungsdauer `0` keine solche Sperre. Sie beginnt bei V1 mit qualifiziertem Eingang und endet automatisch, ohne durch Rückfragen verlängert zu werden. **Erst wenn die Angebots-Gates erfüllt sind**, greift die **unveränderte bestehende Angebots-Haltefrist**: bei `>0` interne Vorreservierung und passende externe Sperraktionen mit verbindlichem Angebot; bei `0` keine Sperre allein wegen der unverbindlichen Auskunft. Für A6 entsteht ein eigener Vorgang mit Grund; bei Wartung kann der weitere Ablauf sehr kurz sein. Ein Hold innerhalb A1/A2 erzeugt keinen A6-Vorgang. +5. **Externe Kalender behandeln:** Wo möglich automatisch aktualisieren, andernfalls priorisierte manuelle Sperraufgabe. Zeitpunkt, Quelle, Bearbeiter und ggf. sichtbaren Nachweis erfassen. „Gesendet“, „im Zielportal sichtbar“ und „in Partnerkanälen nachweislich wirksam“ sind nicht gleichbedeutend; unbekannte Wirkung bleibt unbekannt. +6. **P02 übergeben:** Anlass, Archetyp, Belegungsstatus, Quellen und offene erforderliche Aufgaben; bei extern verbindlicher Buchung Nachweis des bereits erfolgten Abschlusses. + +**Datenbeschaffung als Querschnitt (v0.11):** Für fehlende Angaben löst die bestehende Prozesssteuerung nach wirksamer Kanalkonfiguration einen Kommunikationsauftrag aus. Der Communication Handler steuert Rückfrage/Link/IMAP und liefert geprüfte Angaben an die gemeinsame Datenübernahme, nicht an eine zweite Buchungssteuerung. Bei gesperrtem Zeitraum `0` darf keine Reservierung kommuniziert werden, bei wirksamem Kurzblock nur die tatsächliche Ablauffrist. Bereits extern verbindliche A3–A5-Buchungen dürfen weder aufgrund fehlender Gastdaten noch aufgrund eines neuen Klärungs-Gates zurückgesetzt werden. [Normative Details CH-01–CH-18](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + +### Ergebnisse und Grenzen + +- Anfrage ohne Hold: Preis-/Verfügbarkeitsauskunft möglich, aber **keine Verfügbarkeitsgarantie**. +- Mit Hold: Nur mit fachlich passender Belegungssicherung ein wirklich bindendes befristetes Angebot; Angebots-/Haltefrist dürfen nicht widersprüchlich enden. +- A3–A5: Bei Eingang existiert die Verbindlichkeit bereits extern; neue Sperr- und Konfliktaufgaben ändern daran nichts. +- A6: Sperrgrund immer dokumentieren, Gäste/Leistungen optional. + +**Offen für die technische Ist-/Sollprüfung:** Kriterien zur sicheren Portalbuchungserkennung, Dubletten bei mehrfachen Portalrepräsentationen, konkrete Hold-Freigaberegel und atomare eigene Buchungsprüfung. Ein seltenes Doppelbuchungsrisiko bleibt bei zeitverzögerten Fremdportalen bewusst akzeptiert; keine überdimensionierte Risiko-Engine erforderlich. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Konfliktfälle](Querschnitt/Belegungskonflikte.md) + +--- + +## Kapitel: `V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md` + +## P02 – Konditionen und Buchungsverbindlichkeit + +**Ziel:** Entweder eine eigene verbindliche Buchung rechtssicher herbeiführen oder eine bereits extern verbindliche Buchung mit ihren tatsächlich vereinbarten Bedingungen dokumentieren; A6 entsprechend seinem Anlass bestätigen. + +### A1/A2 – Eigener Buchungsweg + +**Neues Informations-Gate v0.11 (vor eigenem verbindlichem Angebot):** Vorname und Nachname des Vertragspartners, eindeutige Anzahl der reisenden Personen, An- und Abreise, E-Mail und **vollständige postalische Anschrift** müssen vorliegen und validiert sein. Eine fehlende Anschrift ist ein **nicht manuell übergehbarer Blocker**. Die bestehenden Preis-, Dokumenten-, Freigabe- und Verfügbarkeitsprüfungen gelten zusätzlich. Einzelne Namen aller Mitreisenden und vollständige Zusatzleistungswahl sind dagegen nicht generell erforderlich; eine verpflichtende Altersaufteilung ist noch nicht abschließend bestimmt. + +Diese Angebotsvoraussetzungen sind **nicht** die Mindestqualifikation der optionalen **vorgelagerten** Klärungsreservierung. Deren Ende, `0`-Einstellung oder Nachrichtenaustausch dürfen die bestehende Angebotsfrist nicht verändern. [Communication Handler und Datenbeschaffung](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + + +**Haltefrist > 0:** Erforderliche Angaben und Preisgrundlagen feststellen; gültige Jahres-/Saisonpreise, Rabatte und Leistungen berücksichtigen; passende Vorlage einschließlich Bedingungen und Anlagen wählen. Eine wirksame Vorreservierung wird mit einem **zeitlich passenden verbindlichen Angebot** verbunden. Angebot/Konditionsstand und Versand nachweisbar halten. Rechtzeitige, wirksame Annahme über einen geeigneten, abgesicherten (z. B. signierten) Annahmeweg begründet den Vertrag ohne zweite Vermieterzustimmung. Fristablauf, Ablehnung oder abändernde/verspätete Annahme führen in den jeweils passenden Klärungs-/Neuantragsweg; fremde wirksame Belegungen werden nicht gelöscht. + +**Haltefrist = 0:** Eine **Preis-/Verfügbarkeitsauskunft unter Vorbehalt** senden; keine Reservierung und kein Annahmeweg, der irrtümlich sofort einen Vertrag entstehen lässt. Bei einem späteren Buchungswunsch Verfügbarkeit **erneut prüfen** und dann nach gültiger Vermieter-/Kanaleinstellung automatisch bestätigen oder manuell freigeben. Die Bedingungen des tatsächlichen Vertragsschlusses sind maßgeblich. Eine eigenständige Preisbindefrist ist im MVP **nicht vorgesehen**. + +**Änderungswünsche vor Annahme:** Der Communication Handler erkennt und dokumentiert Änderungsbegehren, die im MVP **kontrolliert manuell/fachlich** zu bearbeiten sind. Ein Wunsch allein ersetzt oder widerruft kein gültiges Angebot und startet keine neue Vorreservierungsfrist. Parallele alternativ annehmbare Angebote und eine einmalige Sonderverlängerung sind **nicht Teil der v0.11-MVP-Normierung**, sondern Gegenstand späterer P02-Rechts-/Fachspezifikation. + +### A3–A5 – Extern bereits verbindliche Buchung + +Die Buchung ist **bereits vor Eingang in FewoPortal verbindlich**. **Fehlende Gastinformationen ändern daran nichts: Neue Klärungsreservierungen und die eigene Angebotsannahme werden nicht nachträglich verlangt. Die Datenbeschaffung nach v0.11 dient nur den noch erforderlichen administrativen Folgehandlungen.** Externe Buchungsreferenz, maßgeblicher Preis, Konditions- und Stornostand sowie die Nachweisqualität übernehmen; **keine zweite Angebotsannahme**. Eigene Preiskalkulation oder Vertragsvorlage darf den gebuchten Preis bzw. akzeptierte Bedingungen **nicht** still ersetzen. Fehlende Daten gezielt nachfordern; unterschiedliche Bereitstellungstiefe (Gesamtpreis oder Einzelwerte) ist zulässig. + +Für A3/A4 passende Unterlagen zur bestehenden Buchung erzeugen, soweit eigene Dokumentation erforderlich und mit dem tatsächlichen Vertragsstand vereinbar ist. Für A5 nur die Dokumentation, die eigenen Pflichten entspricht. Ob der Gast bestimmte AGB/Stornoklauseln vor Buchung gesehen hat, ist ggf. **offen und zu prüfen**, nicht aus späterem PDF-Versand abzuleiten. + +### Änderungswünsche nach Vertragsschluss (v0.11 MVP) + +**Änderungswünsche nach Vertragsschluss (MVP):** Vertragsanpassung, verkürzter Aufenthalt, veränderte Personenzahl, Storno-/Zahlungswirkung zunächst **manuell** prüfen und über den vorhandenen zuständigen Fachprozess bearbeiten; keine neue automatische Umbuchungs- oder Storno/Neubuchungsroutine. Eindeutig fehlende rein administrative Daten können nach CH-03 kontrolliert ergänzt werden. Eine Stornierung und Neubuchung ist allenfalls ein **im Einzelfall manuell zu prüfender** Übergangsweg und kein freigegebener Standard. + +### A6 – Interne Nutzung und Sperre + +Bei privater Überlassung ggf. Aufenthalts-/Reservierungs-/Buchungsbestätigung mit zutreffenden Teilnehmern, Zusatzleistungen und Konditionen. Eine Wartungs- oder sonstige reine Sperre benötigt keinen Mietvertrag; das Ergebnis kann interne Bestätigung oder `nicht anwendbar` sein. Die Belegungssicherung erfolgt unabhängig davon, ob ein Mietpreis anfällt. + +### Zustandsregel + +**Verbindlichkeit**, **Vollständigkeit von Gästedaten**, **Finanzdetails** und **Dokumentenversand** sind unterschiedliche Zustände. Eine externe verbindliche Buchung bleibt bindend, auch wenn Anschriften oder Tagespreise fehlen. Die nächste Tätigkeit wartet nur auf die dafür notwendigen Informationen. + +**Juristische Prüfungen:** AGB-Einbeziehung, Online-Bestellablauf und signierte Annahme sowie verspätete/abweichende Annahme sind separat zu prüfen; kein Fachdokument ersetzt Rechtsberatung. Maßgeblich u. a. [BGB §§145](https://www.gesetze-im-internet.de/bgb/__145.html), [148](https://www.gesetze-im-internet.de/bgb/__148.html), [150](https://www.gesetze-im-internet.de/bgb/__150.html), [305](https://www.gesetze-im-internet.de/bgb/__305.html). + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Profil- und Vorlagenregeln](02_Abwicklungsprofile_und_Dokumente.md) + +--- + +## Kapitel: `V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md` + +## P03 – Buchungsverwaltung und kaufmännische Abwicklung + +**Ziel:** Nach Vertragsschluss beziehungsweise bei A6 nach Belegungsanlage alle erforderlichen Dokumentations-, Gäste-, Leistungs-, Zahlungs- und Verwaltungsaufgaben im **selben Vorgang** steuern. + +### Aktivitäten + +1. **Abwicklungsprofil anwenden:** Wer verantwortet Vertragsunterlagen, Gastkontakt, Zahlungen, Mahnung, Storno, Rückzahlung und lokale Leistungen? Automatisch/manuell nach Vermieterstandard, ausdrücklicher Kanalabweichung und tatsächlichem Vorgang; fremde Erfüllung mit Quelle kennzeichnen. +2. **Buchungs-/Aufenthaltsunterlagen bearbeiten:** Gewählte Vorlagen/Anlagen, bereits vereinbarte Konditionen und erforderlichen Versand verwenden. Keine erneute Vertragsannahme für A3–A5 und keine zusätzlichen nicht vereinbarten Gebühren in Dokumenten. +3. **Gäste und Leistungen bearbeiten:** Fehlende für konkrete Aufgaben erforderliche Gastdaten beschaffen; Zusatzleistungen, Kurabgabe soweit tatsächlich geschuldet und Belege unabhängig vom Mietpreis führen. A6 kann Gäste und Zahlungspositionen enthalten oder als reine Sperre ohne sie ablaufen. +4. **Finanzinformationen nachvollziehen:** Gesamtsummen, Einzel- und Sammelpositionen, Rabatte, Portalgebühren, Gastservice, Vermieterprovision und Vermieterauszahlungen getrennt erfassen **soweit tatsächlich bekannt**. Fehlende Positionen nicht künstlich kalkulieren; manuelle Zuordnung/Nachprüfung ermöglichen. Vertragsforderung, Zahlungsplan, Portalstatus und Bankeingang nicht gleichsetzen. +5. **Fristen und Abweichungen überwachen:** Anzahlungen/Restzahlungen, offene Forderungen, bestätigte Portalzahlungen, erwartete Auszahlungen, Mahnungen/Storno-/Änderungsfälle gemäß tatsächlicher Zuständigkeit. Nachweise und Abweichungen verknüpfen, ohne die verbindliche Buchung willkürlich umzuschreiben. +6. **P04 versorgen:** Erforderliche Informationen, Aufgaben und Kontakte für den Aufenthalt bzw. die private Nutzung/Wartung bereitstellen; nicht kritische Abrechnungsdetails dürfen als offene Aufgabe verbleiben. + +### v0.11 – Administrative Datenanreicherung bei bestehendem Vertrag + +Fehlende und eindeutig zugeordnete **rein administrative** Gastangaben können nach Validierung über den gemeinsamen Fakteneingang ergänzt werden, auch wenn die Buchung bereits verbindlich ist. Unklare oder widersprüchliche Werte werden zur Prüfung gestellt. Änderungen an **Vertragsinhalt, Personenanzahl, Aufenthaltszeitraum, Preis, Forderungen oder Stornowirkung** sind nicht als administrative Datenkorrektur zulässig; sie werden als Änderungswunsch erfasst und zunächst über den bestehenden Fachprozess **manuell** bearbeitet. Der Communication Handler erzeugt daraus weder eine neue Buchung noch ändert er die Verbindlichkeit des bestehenden Vertrags. Näheres: [Datenbeschaffung und Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + +### Anforderungen an die Darstellung + +Für den Vermieter wenige verständliche nächste Schritte, nicht mehrere getrennte Portalmasken. Bei fehlenden Informationen unterscheiden zwischen **„nicht geliefert“**, **„nicht erforderlich“**, **„widersprüchlich“** und **„nachgewiesen“**. Ein als „laut Portal bezahlt“ markierter Betrag ist nicht automatisch auf dem Vermieterkonto eingegangen. + +**Offen:** Exakte rechtlich erforderliche Gäste-/Melde-/Kurabgabedaten, Zahlungs- und Belegpflichten je Portal, Detailkriterien für Mahnung und Abrechnung; technische Datenstruktur ist nicht vorgeschrieben. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Preis- und Zahlungsmodell](Querschnitt/Preise_und_Zahlungen.md) + +--- + +## Kapitel: `V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md` + +## P04 – Leistungsvorbereitung und Aufenthalt + +**Ziel:** Den zugesagten Aufenthalt oder den intern geplanten Belegungs-/Wartungszweck mit den tatsächlich notwendigen Informationen und lokalen Leistungen durchführen. + +### Aktivitäten + +1. Prüfen, ob Anreise- bzw. Arbeitsdaten für diesen Fall ausreichen; bei externen Portalen Kontaktinformationen ggf. manuell beim Gast oder im Portal beschaffen. +2. Relevante Hinweise versenden bzw. die **externe Versandzuständigkeit** und deren belegten Status nachvollziehen. Eine für 72 Stunden vor Anreise angekündigte Portalnachricht ist nicht dasselbe wie nachgewiesene Zustellung. +3. Schlüssel-/Zugang, Reinigung, Wäsche, lokale Betreuung und sonstige vereinbarte Leistungen organisieren; ggf. Dienstleister kontaktieren und Aufgaben nachverfolgen. Keine eigenständige umfangreiche Personal- oder Objektmanagementlösung voraussetzen. +4. Kurabgabe und örtliche Melde-/Nachweispflichten prüfen, soweit für die konkrete Person und den Aufenthalt einschlägig; bei privaten Gästen (A6) nicht pauschal auf null setzen. +5. Auf Aufenthaltsänderung, verspätete Anreise, No-show, Verlängerung, Reklamation und Schäden über die vorhandenen Sonderprozesse reagieren. +6. Bei Wartung/organisatorischer Sperre statt Gästebetreuung die nötigen Arbeits-/Prüfaktivitäten ausführen und den Zeitraum geschützt halten. + +### v0.11 – Informationsbedarf je anstehender Aktivität + +Die erforderlichen Anreise-, Kontakt-, Mitreisenden- und gegebenenfalls Meldeinformationen werden **für die konkret bevorstehende Aktivität** geprüft und können auch nach Vertragsschluss per E-Mail oder sicherem Ergänzungslink angefordert werden. Es werden keine über das Angebots-Gate hinausgehenden Pflichtangaben rückwirkend für den Abschluss eines bereits verbindlichen Vertrages eingeführt. Administrative Ergänzungen und vertragsrelevante Änderungen folgen den unterschiedlichen Regeln des [Communication Handlers](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). Die Einzelheiten der Melde-/Abgabepflichten bleiben gesondert zu prüfen. + +### Ergebnis + +Leistung/Arbeit wurde erbracht oder die relevante Abweichung ist geklärt beziehungsweise als Aufgabe sichtbar. P03-Finanzfragen können weiterlaufen, sofern sie nicht Voraussetzung für diese Tätigkeit sind. + +**Noch offen:** Detaillierte Regeln zur Erforderlichkeit von Anreisedaten, zur Gastkommunikation je Kanal, zur lokalen Dienstleisterübergabe und zu gesetzlichen Melde-/Abgabefeldern. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Sonderprozesse](Querschnitt/Sonder_und_Supportprozesse.md) + +--- + +## Kapitel: `V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md` + +## P05 – Abschluss und Nachbereitung + +**Ziel:** Einen tatsächlich abgewickelten Aufenthalt bzw. die interne Nutzung oder Sperre fachlich beenden, Ergebnisse sichern und offene Folgeangelegenheiten zuordnen. + +### Aktivitäten + +1. Ende des Aufenthalts, der privaten Nutzung oder der Sperr-/Wartungsaktivität feststellen; geeignete Rückgabe-, Reinigungs- und Objektbereitstellungsaufgaben berücksichtigen. +2. Zutreffende Belegungswirkung behandeln; abgelaufene Nutzung bzw. Wartungssperre beenden/ändern und notwendige externe Kalenderaktualisierungen veranlassen. Ein abgelaufener Aufenthalt darf nicht mit einem stillen Löschen der Buchung verwechselt werden. +3. Offene Zahlungen, Portal-Auszahlungen, Provisionen, Rückerstattungen, Schäden oder Streitfälle prüfen; wenn die eigentliche Leistung abgeschlossen ist, **an verantwortliche Folgeaufgabe/-prozess übergeben** statt den ganzen Hauptprozess dauerhaft offen zu lassen. +4. Bei regulärem Gastaufenthalt Dank, zulässige Feedback-/Bewertungsabwicklung und gegebenenfalls Übergabe an **V02 Gästebindung**; bei Wartungssperre keine künstliche Bewertung oder Marketingaktivität. +5. Fachliches Endergebnis und verantwortliche Nachläufer im **gleichen Vorgang** nachvollziehbar halten. + +### Mögliche Endergebnisse + +| Ergebnis | Beispiel | +|---|---| +| Regulär abgeschlossen | Gast ist abgereist, Leistung erbracht; ggf. klar zugewiesener offener Abrechnungsnachläufer | +| Ohne Vertragsschluss beendet | Anfrage abgelehnt, Angebot abgelaufen, keine verbindliche Buchung entstanden | +| Wirksam storniert | Verbindliche Buchung nach tatsächlich wirksamer Stornoentscheidung beendet | +| A6 abgeschlossen/aufgehoben | Privater Aufenthalt beendet, Wartung abgeschlossen, Sperre vorzeitig aufgehoben oder verschoben | + +**Abschluss-Gate:** Die genauen Mindestnachweise je Vorgangsart sind noch fachlich zu bestimmen. Nicht anwendbare Gästedaten, Vertragsunterlagen oder Finanzschritte sind **keine fehlenden Pflichtdaten**. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Gates und Nachweise](Querschnitt/Gates_und_Nachweise.md) + +--- + +## Kapitel: `Querschnitt/Gates_und_Nachweise.md` + +## Gates, Informationsqualität und Übergaben + +**Gates sind fachliche Prüfregeln, keine vorgeschriebenen zusätzlichen Statusmaschinen.** Sie unterscheiden nachweisbare Vorgangszustände (z. B. verbindlich gebucht) und Voraussetzungen konkreter Aktionen (z. B. Adresse für ein eigenes Dokument). Nicht jede Aktivität ist in jedem Archetyp erforderlich. + +| Gate | Fachliche Frage | Fehlende Information | +|---|---|---| +| **G1 – Eingang** | Ist Anlass/Objekt/Zeitraum, Eingangsart, Kanal/Owner und ggf. Portalreferenz ausreichend qualifiziert? | Unklaren Import prüfen, keine künstliche Buchungsbestätigung | +| **G1a – Optionaler Klärungsblock (v0.11, nur A1/A2)** | Ist der Kurzblock konfiguriert und sind Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt sowie Verfügbarkeit gesichert? | Ohne qualifizierte/erfolgreiche Sperre keine Reservierungsbehauptung; Rückfrage ohne Sperre bleibt möglich | +| **G2 – Bindung/Konditionen** | Eigene fristgerechte Annahme oder externen bindenden Abschluss nachweisbar? Sind die für die konkrete Aktion benötigten Konditionen bekannt? | Nachweis/Einzelinformation klären; Bindung nicht wegen fehlender Anschrift rückgängig machen | +| **G2a – Vor eigenem bindendem Angebot (v0.11)** | Sind Vorname, Nachname, vollständige Anschrift, E-Mail, Personenzahl und Zeitraum validiert, zuzüglich Preis-/Dokumenten-/Verfügbarkeitsgates? | Kein eigenes bindendes Angebot vor Vollständigkeit; keine manuelle Umgehung fehlender Anschrift. Extern bindende Buchungen bleiben unberührt. | +| **G3 – Abwicklung** | Wer ist für Dokumente, Zahlungen, Mahnung, Storno, Erstattung und Kommunikation tatsächlich verantwortlich? | Zuständigkeit/Status als offen erfassen und klären | +| **G4 – Durchführung** | Sind für Gast oder A6-Zweck die nötigen Kontakt-, Leistungs-, Anreise-, Melde- oder Arbeitsinformationen vorhanden? | Nur entsprechende Aktivität zurückstellen oder ergänzen | +| **G5 – Ende** | Ist Leistung bzw. Sperrzweck erfüllt/beendet und sind offene Nachläufer verantwortlich übergeben? | Abschlussbezogene Klärung/Folgeaufgabe | + +**v0.11-Faktenregel:** Fehlende administrative Werte aus eindeutig zugeordneten Quellen dürfen phasenabhängig kontrolliert ergänzt werden; widersprüchliche oder vertragsrelevante Änderungen werden nicht blind übernommen. Der [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md) liefert nur geprüfte Informationskandidaten/Anlässe und keine eigene Vertragsentscheidung. + +**Mögliche Ergebnisse:** intern erledigt, extern erledigt (mit Nachweis/Quelle), fachlich nicht anwendbar, offen, widersprüchlich. Extern *verantwortet* ist nicht automatisch extern *erledigt*. `Unbekannt` und `nicht anwendbar` sind voneinander und von `0` zu unterscheiden. + +**Wesentliche Nachweise:** Quelle, externe Buchungs-/Vorgangsreferenz, Zeitpunkt, Person/System, gegebenenfalls Beleg, Gültigkeit/Aktualität, tatsächlicher Zustand und nächste Verantwortung. Der Detailgrad hängt von Relevanz und Portalverfügbarkeit ab; es wird kein universelles Nachweis-Enum für jedes Feld verlangt. + +**Spezialfälle:** + +- Preise können nur als Gesamtbetrag vorliegen; Tagespositionen sind nicht Voraussetzung einer bereits nachgewiesenen Bindung. +- Storno-/Änderungswunsch ist **noch keine** wirksame Stornierung/Änderung. +- Extern gesendete Belegungssperre ist **nicht automatisch** im Zielportal oder Partnernetz wirksam. +- Portalrate „bezahlt“ ist **nicht gleich** tatsächlicher Bankeingang beim Vermieter. +- A6 kann G2/G3/G4 ohne Gast, Vertrag oder Zahlung erfüllen, indem diese Tätigkeiten **nicht anwendbar** sind. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [P02](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) + +--- + +## Kapitel: `Querschnitt/Datenbeschaffung_und_Communication_Handler.md` + +## 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)). + +--- + +## Kapitel: `Querschnitt/Belegungskonflikte.md` + +## Belegungskonflikte, Kalender und Sperrnachweise + +### Betriebsrealität + +**FeWo-direkt:** Importierte iCal-Belegungen können verzögert übernommen werden; FewoPortal kann nicht garantieren, dass eine eigene Sperre sofort im Portal wirksam ist. **Destination Solutions (konkret verwendeter Zugang):** Keine automatisierte Kalendersynchronisation; Sperren in anderen Portalen werden manuell eingetragen. Eine gesonderte Bestätigung der serverseitigen Übernahme oder Partnerweitergabe steht nach Betreiberangabe nicht zur Verfügung. + +Laut Betreiberhistorie gab es **zwei Doppelbuchungen in etwa 20 Jahren**. Dieses niedrige beobachtete Auftreten rechtfertigt pragmatische Sperr- und Klärungsaufgaben, ist aber kein Nachweis der technischen Unmöglichkeit oder künftigen Risikofreiheit. Eine Echtzeitabfrage des führenden Systems durch alle Portale wäre besser, ist **bei den konkreten Integrationen nicht als vorhanden anzunehmen**. + +### v0.11 – Optionale kurze Klärungsreservierung + +Die Klärungsreservierung ist eine **separate vorgelagerte** Sperre für unvollständige **unverbindliche** Anfragen, nicht die bestehende Angebots-Vorreservierung. Sie ist nur bei eindeutiger Wohnung, Reisezeitraum, verwendbarem E-Mail-Kontakt und erfolgreicher Verfügbarkeitsprüfung zulässig; bei der Einstellung `0` entsteht kein Block. Bei `>0` beginnt die Frist im V1-Modell beim qualifizierten Eingang, läuft automatisch ab und verlängert sich nicht durch Folgefragen oder Erinnerungen. Gerade wegen langsamer Portalabfragen kann ein intern beendeter Kurzblock im Zielportal länger sichtbar bleiben; FewoPortal darf keine sofortige externe Freigabe unterstellen. Schon extern verbindliche Buchungen werden dadurch nicht neu qualifiziert oder freigegeben. + +### Fachliches Vorgehen + +1. Auslösende Buchung, Quelle/Owner, ggf. externe Referenz und eingehende Zeitstempel erfassen. +2. Eigene Belegungswirkung dokumentieren; automatische Exporte bzw. konkrete manuelle Sperraufgaben anstoßen. +3. Wenn verfügbar Erledigungszeit, Bearbeiter und **Sichtkontrolle/Screenshot** dokumentieren. +4. Den Nachweisgrad korrekt unterscheiden: **Sperrung veranlasst**, **im Zielportal erkennbar**, **im betroffenen Vertrieb nachweislich wirksam**. Ohne entsprechenden Nachweis bleibt Wirksamkeit unbekannt. +5. Bei tatsächlicher Überschneidung beide Verbindlichkeitsnachweise, zeitliche Abfolge und denkbare Ursache prüfen; Lösung bzw. wirksame Änderung/Stornierung mit Beteiligten abstimmen; Kalender-/Finanz-/Dokumentenfolgen nachvollziehen. + +Eine Sichtkontrolle beweist nicht den serverseitigen Speicherzeitpunkt oder eine Weitergabe an Partnerportale. Ein technischer Sync-Verzug beweist für sich genommen **keine rechtliche Schuldlosigkeit**. Keine verbindliche Fremdbuchung wegen einer Kalenderspiegelung still löschen; eine Stornoanfrage nicht mit einer wirksamen Stornierung gleichsetzen. + +**Abgrenzung:** Interner A6-Sperrvorgang und ein A1/A2-Hold können dieselbe Belegungsmechanik nutzen, bleiben aber unterschiedliche fachliche Anlässe. Fehlende externe Freigabenachweise dürfen ein bereits abgeschlossenes Vertragsverhältnis nicht automatisch umdeuten. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [P01](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) + +--- + +## Kapitel: `Querschnitt/Preise_und_Zahlungen.md` + +## Preise, Gebühren, Provisionen und Zahlungsstände + +### Geschäftsregel + +Bei eigener Angebotsstellung werden normalerweise **Jahres-/Saisonpreise** und ggf. Rabatte, Leistungen und Loyalty berücksichtigt; eine dynamische Hotel-/Flugtarifoptimierung ist nicht Teil des MVP. Bei **extern verbindlichen Buchungen** ist der tatsächlich vereinbarte **Gastpreis** maßgeblich. Die interne Vergleichsberechnung verändert ihn nicht. Die tatsächlich vereinbarten Konditionen und ihre Quelle bleiben pro Vorgang nachvollziehbar. + +### Verschiedene wirtschaftliche Größen + +| Größe | Bedeutung | +|---|---| +| Gastforderung für Unterkunft/gebuchte Leistungen | Vertraglich dem Vermieter zustehender Betrag, soweit nachgewiesen | +| Gast-Gesamtzahlung im Portal | Kann neben Unterkunft auch portalbezogene Leistungen/Servicegebühren enthalten | +| Gast-Servicegebühr des Vermittlers | Eigene Forderung des Portals gegen Gast, **soweit nachweisbar**; nicht automatisch Vermietermiete | +| Vermieterprovision / Vermittlergebühr | Aufwand des Vermieters; nicht nachträglich als zusätzliche Gastforderung ansetzen | +| Möglicher Partneraufschlag | Kann den gastseitigen Endpreis beeinflussen; nur bei nachgewiesener Berechnung klassifizieren | +| Rabatt | Vom gebuchten Preis abzuziehender/bei Buchung vereinbarter Betrag, gegebenenfalls portalabhängig | +| Zahlungsplan | Raten, Höhe, Fälligkeit und vom Portal gemeldeter Status | +| Vermieterauszahlung | Erwarteter Portalbetrag und tatsächlicher Bankeingang sind **verschiedene Sachverhalte** | +| Kurtaxe/Kurabgabe / Zusatzleistungen | Ggf. separate Positionen auch bei privater Nutzung mit **Mietpreis null** | + +### Zulässige Informationsformen + +Portale liefern **vollständige Einzelpositionen**, **kombinierte Sammelpositionen** oder **nur einen Gesamtbetrag**. FewoPortal muss alle drei Fälle bearbeiten können, ohne eine Einzelaufstellung zu fingieren. Kombinationen aus Servicepauschale, Provision, Reinigung, Steuern oder anderen Posten dürfen vorläufig als unbekannte Sammelposition bleiben. Bei späterer Aufteilung bleiben **Ursprungswert und Quelle** nachvollziehbar. Teil-/Summenwerte dürfen **nicht doppelt gezählt** werden. + +Zu jeder für den Prozess relevanten Information sollen nach Bedarf Betrag/Währung, Positionstyp oder „ungeklärt“, Kosten-/Zahlungsträger, Quelle, Zeitpunkt, Beleg und Zuordnung verfügbar sein. Dies ist **eine fachliche Beschreibung**, keine vorgreifende Datenbankspezifikation. Falls Informationen widersprüchlich sind, beide Beobachtungen erhalten und Klärungsaufgabe anbieten, statt einen Betrag ohne Nachweis zu überschreiben. + +### Unterschiedliche Zahlungsstände + +- Betrag **vereinbart** / **fällig laut Plan**; +- vom Portal **als bezahlt gemeldet**; +- **Auszahlung angekündigt**; +- beim Vermieter **tatsächlich eingegangen**; +- **erstattet**, **storniert** oder **ungeklärt**. + +Die Zuständigkeit für Zahlungseinzug, Mahnung, Rückerstattung und Inkasso ist **kanal- und buchungstypabhängig**. Der Vermieter kann Informationen manuell nachreichen, wenn das Portal sie nicht maschinenlesbar bereitstellt. Eine fehlende Vermittler-Provisionszerlegung blockiert nicht automatisch die lokale Leistungserbringung. + +### Konkretes Referenzbeispiel: FeWo-direkt (eine Buchung) + +7 Nächte/840,00 € Übernachtungen, −42,00 € Rabatt, 181,51 € „Gebühren und Steuern“, **979,51 € Gastgesamtbetrag**; −84,82 € als „An FeWo-direkt gezahlt“ bezeichnet, **894,69 € ausgewiesene Auszahlung**. Eine zweite Ansicht zeigte **900,20 € erwartete Auszahlung**: Differenz **5,51 € ungeklärt**. Zahlungsraten 390,61 € (als bezahlt markiert) und 588,90 € (später fällig). Diese Angaben sind Beobachtungen in **einer** Portalansicht; sie belegen keine detaillierte Tagespreiszerlegung oder tatsächlich erfolgte Auszahlung. + +**Achtung:** Ohne Prüfung der Gebührenzusammensetzung ist keine eindeutige Zuordnung der 181,51 € bzw. 84,82 € als Gast- oder Vermieterprovision zulässig. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [R09 – FeWo-direkt](Szenarien/R09_FeWoDirekt.md) + +--- + +## Kapitel: `Querschnitt/Sonder_und_Supportprozesse.md` + +## Sonderprozesse und unterstützende Funktionen + +Sonderprozesse können in mehreren P01–P05-Phasen entstehen und werden **im Zusammenhang mit demselben Vorgang** bearbeitet. Keine parallelen Buchungsakten oder separaten Portalfachprozesse. Nach dem regulären Ende können klar zugewiesene Folgeangelegenheiten weiterlaufen. + +### Sonderfälle + +| ID | Geschäftsvorfall | Fachliche Kernregel | +|---|---|---| +| X01 | Angebotsänderung/Neuangebot | Vor Vertragsabschluss neue bzw. geänderte Konditionen und passende Angebotsversion; rechtliche Wirkung beachten | +| X02 | Vertragsänderung/Umbuchung | Nach Verbindlichkeit Anfrage, Entscheidung, tatsächliche Wirksamkeit, neue Leistung/Preise und Nachweise trennen | +| X03 | Angebotsablehnung/-ablauf und Holdfreigabe | Kein stilles Lösen anderer wirksamer Belegungen; alternativer Ausgang „ohne Buchung beendet“ | +| X04 | Stornierung/Rücktritt/Aufhebung | Ursache, Initiator, technisch Ausführender und Zuständigkeit trennen; Gast- und Vermieterstorno nicht nach bedientem Button umdeuten | +| X05 | Zahlungsverzug, Mahnung, Erstattung, Streitfall | Vertrags-/Portalverantwortung beachten; offene Nachläufer dokumentieren | +| X06 | Datenkonflikt und Dubletten | Fehlende/widersprüchliche Felder klären; keine Scheingenauigkeit oder Dubletten-Vorgänge | +| X07 | Doppelbuchung, Sperr- oder Portalsynchronisationskonflikt | Belegungs- und Vertragslage sichern, keine verbindliche Fremdbuchung still löschen | +| X08 | No-show, Verlängerung, vorzeitige Abreise | Je nach Vertragsstatus Belegung, Leistungen und Zahlungen anpassen | +| X09 | Reklamation, Schaden, Kaution und Nachforderung | Lokale Klärung und verantwortliche Folgeaufgabe | + +**Ereignisprinzip:** Ein Änderungs-/Stornowunsch ist nicht automatisch wirksam. **Für den v0.11-MVP erfasst der Communication Handler vor Annahme eines eigenen Angebots Änderungswünsche nur zur kontrollierten manuellen/fachlichen Behandlung. Nach Vertragsschluss erfolgt die vertragsrelevante Änderungsbearbeitung ebenfalls zunächst manuell; automatische parallele Angebotsvarianten, Teilstorno und ein allgemeiner Storno-/Neubuchungs-Workaround sind nicht beschlossen.** Erfasst werden – soweit relevant – tatsächlicher Grund, Antragsteller, handelnde Person/Portal, Entscheidung, Wirksamkeitszeitpunkt und Folgen für Vertrag, Kalender, Leistungen und Zahlungen. Eine aufgehobene Wartungssperre nutzt dieselben generischen Mechanismen, ist rechtlich aber **keine Mietvertragsstornierung**. + +### Unterstützende Funktionen (keine automatischen eigenständigen Module) + +S01 Kanal-/Integrationsverwaltung; S02 Kalender- und Belegungsabgleich; S03 Gast-/Objekt-/Teilnehmerstammdaten; S04 Preise, Konditionen, Leistungen; S05 Dokument-/Vorlagenmanagement; S06 Kommunikation, Aufgaben und Fristen; S07 Zahlungen, Forderungen und Portalstatus; S08 buchungsbezogene lokale Dienstleister/Reinigung/Schlüssel/Reparatur; S09 Mandanten/Berechtigungen/Compliance/Sicherheit. + +**v0.11:** S01 bündelt alle Kanäle einschließlich der eigenen Website und die bestehenden iCal-Verbindungseinstellungen; S06 umfasst den [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md) mit kontrolliertem Fakteneingang. Beide sind Querschnittsfunktionen, keine eigenen Buchungs- oder Stornierungsprozesse. + +Eine kleine Vermietungsplattform soll diese Funktionen nach Möglichkeit **in den Buchungsvorgang integrieren**. Umfangreiche Objekt- oder Personaldisposition, ein vollumfängliches CRM oder freie Workflow-Modellierung werden durch diesen Katalog **nicht** als MVP-Anforderung festgelegt. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [X07 vertieft](Querschnitt/Belegungskonflikte.md) + +--- + +## Kapitel: `KONFIGURATION_UND_WIRKSAMKEIT.md` + +## Konfiguration und Wirksamkeit + +Dieses Dokument beschreibt, welche fachlichen Einstellungen es gibt, wo man sie vornimmt und wie sie sich vererben. Es zeigt auch, wie man nachprüft, dass sie in einem Vorgang wirklich angewandt wurden. Bestand der Pakete 1–9 vom 02.11.2026, um die **fachlichen v0.11-Zielparameter** ergänzt; deren Implementierung ist noch nicht nachgewiesen. + +--- + +### 1. Wo man die Wirksamkeit sieht + +| Werkzeug | Zeigt | +|---|---| +| **System › Wirksame Einstellungen** (Expertenansicht) | Für jede Wohnung und jeden Eingangsweg den Wert jeder Prozesseinstellung, der für einen **neuen** Vorgang gilt, mit Herkunft und Ort der Änderung. Eingangswege: direkte Anfrage, je Portal Anfrage und feste Buchung, A6. Neu ist die Zeile „Antwort auf eine Anfrage“: Angebot mit Reservierung, Auskunft unter Vorbehalt oder keine. Je Wohnung steht die Zeile „Aufenthalt“: Anreisezeit, Aufgaben je Aufenthalt, Kurabgabe. „Einen Vorgang prüfen“ zeigt dessen festgehaltenes Profil, eine Umstellung im Vorgang, das Dokument, das er jetzt braucht, und beide Abschlüsse mit den offenen Punkten. | +| **Vorgang › Ablauf** | Jede Aktivität mit Zustand: erledigt, übernimmt das Portal, zu tun, wartet, später oder entfällt. Dazu kommen Aufgaben mit Zuständigkeit und Erledigungsnotiz sowie beide Abschlüsse. | +| **Vorgang › Technische Angaben** (Experte) | eingefrorenes Abwicklungsprofil mit Herkunft je Wert | +| `php artisan process:settings-report` | alle Standards und Abweichungen als Text | +| `php artisan cases:recheck-payment-status` | Vorgänge, deren gespeicherter Zahlungsstatus der neuen Regel widerspricht (Vorschau) | + +Nachweise: `test_t12_…`, `test_t24_…`; Screenshots `Abnahme/2026-11-01/T12-wirksame-einstellungen.png` und `Abnahme/2026-11-02/T24-wirksame-einstellungen.png`. + +--- + +### 2. Vererbung + +``` +Grundeinstellung (im Code) + → Ihr Standard System › So arbeite ich + → Wohnung Wohnung bearbeiten › „Abweichende Abwicklung dieser Wohnung“ (Experte) + → Portal je Eingangsart Portal bearbeiten › „Anfragen über dieses Portal“ / „Feste Buchungen über dieses Portal“ + → Vorgang Schalter „Läuft automatisch / Sie geben frei“, Wahl Angebot statt Auskunft, Aufgaben +``` + +- **Leer heißt „erbt“.** Ein bewusst gesetztes „nein“, „0“ oder „manuell“ ist ein eigener Wert. +- **Eingefroren beim Eingang.** Ein Vorgang behält die Werte von seinem Eingang. Ausnahme ist die Vertragsvorlage: Sie wird erst festgehalten, wenn das Dokument erstellt wird. +- **A6 fest:** Unterlagen, Zahlungen und Gastmails „Entfällt“. +- **Anfragen:** Unterlagen schicken immer wir. +- **Vorgangsart aus den wirksamen Werten:** A1/A2 Anfrage (direkt bzw. über Portal); A3 wir kassieren und schicken Unterlagen, A4 Portal kassiert, A5 Portal schickt Unterlagen; A6 intern. + +--- + +### 3. Einstellbare Prozessparameter + +| Einstellung | Standard | Übersteuerbar auf | Wirkung | +|---|---|---|---| +| Bearbeitung (automatisch / Sie geben frei) | Sie geben frei | Vermieter, Wohnung, Portal (Anfrage und Buchung), Vorgang | Angebote, Auskünfte und Unterlagen gehen ohne Klick hinaus, sobald nichts fehlt. Ein Buchungswunsch wird automatisch nur bestätigt, wenn die erneute Prüfung ohne jeden Befund ist (Paket 7). | +| **Angebotsreservierung**: Reserviert eine vollständige Anfrage beim eigenen Angebot den Zeitraum? | ja | Vermieter, Wohnung, Portal (Anfrage) | **ja:** Angebot mit Annahmelink, Zeitraum reserviert bis zum Ablauf. **nein:** unverbindliche Auskunft mit „Buchung anfragen“, kein Eintrag im Kalender, erneute Prüfung vor der Bestätigung (Paket 7). | +| **Gültigkeit des Angebots bzw. der Auskunft (Bestand)** | 48 Stunden | Vermieter, Wohnung, Portal (Anfrage) | Frist des Angebots und der Reservierung bzw. bis wann der Gast aus der Auskunft anfragen kann; danach endet die Anfrage ohne Buchung | +| **Klärungsreservierung automatisch (v0.11, neu)** | 15 Minuten | Vermieter, Wohnung, Kanal × unverbindliche Eingangsart | **Vor** dem eigenen Angebot; `0` = keine Klärungssperre, auch bei aktiver Datenbeschaffung. Mindestdaten Wohnung, Zeitraum, verwendbarer E-Mail-Kontakt und positive Verfügbarkeitsprüfung. | +| **Klärungsreservierung Freigabe/manuell (v0.11, neu)** | 180 Minuten | Vermieter, Wohnung, Kanal × unverbindliche Eingangsart | Unabhängiger Parameter, ebenfalls `0` möglich; Beginn im V1-Modell beim ausreichend qualifizierten Anfrageeingang, nicht beim späteren manuellen Öffnen. | +| **Datenrückfrage-Modus (v0.11, neu)** | Noch zu parametrieren | Vermieter, Wohnung, Kanal × Eingangsart | Automatisch, vorbereiten mit Freigabe oder manuell; **unabhängig** vom Angebotsmodus. | +| **Erinnerungen / Folgefragen (v0.11, neu)** | Erinnerungen: maximal zwei zusätzliche Nachrichten als Ausgangsstandard; Folgefragen-Obergrenze offen | Vermieter, Wohnung, Kanal × Eingangsart | Getrennte Zähler, Intervalle konfigurierbar, keine Wiederholungsschleife; keine Reservierungsfrist-Verlängerung. | +| Wer schickt Vertrag bzw. Unterlagen? | Wir | Vermieter, Wohnung, Portal (Buchung) | Portal → A5, keine eigenen Unterlagen | +| Wer kümmert sich um die Zahlungen? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → A4: keine Mahnungen. „Laut Portal bezahlt“ ändert den Status nicht. Nach dem Aufenthalt entsteht die Aufgabe „Auszahlung des Portals prüfen“. | +| Wer schickt Anreise-Info und Bewertungsbitte? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → „durch Portal (angekündigt)“, keine eigenen Mails | +| Anreise-Info Tage vorher | 3 | Vermieter, Wohnung | Zeitpunkt der Anreisemail. Die Anreisedaten werden 2 Tage davor geprüft. | +| Vertragsvorlage | Texte der Webseite | Wohnung, Portal, Vorgang (Zusammenstellung) | Inhalt von Angebot, Auskunft, Bestätigung und Unterlagen | + +### 3a. Zentraler Kanalmanager – gemeinsamer Verwaltungsort (v0.11) + +Der zentrale Kanalmanager führt **eigene Website und externe Kanäle** gleichermaßen: Kanal-/Wohnungszuordnung, mögliche tatsächliche Eingangsarten, bestehende iCal-Import-/Exportverbindungen, technische Synchronisationsparameter und -status sowie kanalbezogene Prozess-, Kommunikations- und Klärungsparameter. Allgemeine Vermieterstandards bleiben zentral pflegbar; geerbte Werte und ihre Herkunft sollen im vorhandenen Bereich **„Wirksame Einstellungen“** sichtbar werden. + +**Keine zweite Quelle der Wahrheit:** Bestehende v0.10-Verbindungen und `ProcessSettings` bleiben fachliche Grundlage, bis die technische Ist-/Soll-Analyse ein konkretes Refactoring begründet. iCal-Sync und die bestehende regelbasierte Buchungserkennung bleiben eigenständige operative Funktionen. Die neue Konfigurationsverwaltung impliziert weder weitere aktive IMAP-Postfächer noch neue Parser, noch verändert sie Vertrags-/Angebotsentscheidungen. + +**Kritischer Unterschied zweier `0`-Werte:** `Klärungsreservierung = 0` bedeutet lediglich **kein kurzer Sperrblock während der Datenbeschaffung**. `Angebotsreservierung = 0` bedeutet im **bestehenden Angebotsweg** Auskunft unter Vorbehalt statt verbindlichem Angebot mit Hold. Diese Werte sind unabhängig und dürfen in UI, Textbausteinen und Prozesslogik nicht gleichgesetzt werden. Ein konfigurierter positiver Kurzblock ist zudem kein Beweis, dass die Sperre tatsächlich wirksam angelegt wurde. + +Zur zentralen Detailregel siehe [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + +### 4. Weitere Einstellungen + +| Einstellung | Wo | Ebene | Wirkung | +|---|---|---|---| +| **Anreisezeit erfragen** (neu) | Wohnung › Aufenthalt vorbereiten und abschließen | Wohnung | Fehlt die Anreisezeit, entsteht die Aufgabe „Anreisedaten beim Gast erfragen“. Kontaktdaten werden immer geprüft (nicht bei A6). | +| **Aufgaben je Aufenthalt** (neu) | Wohnung › Aufenthalt vorbereiten und abschließen | Wohnung | Je Zeile: Was, Wann (Tage vor Anreise / am Anreisetag / am Abreisetag), Wer, für welche Art von Aufenthalt (Gästebuchungen, Familie/Freunde, eigene Nutzung, Sperren). Daraus wird je Aufenthalt eine Aufgabe, die den Aufenthaltsabschluss aufhält, bis sie erledigt oder übergeben ist. | +| Gebuchte Leistungen | Wohnung › Zusatzleistungen | Wohnung | werden automatisch zu „Bereitstellen: …“ (nur bei eigenem Preis bzw. A6) | +| Kurabgabe je Person und Nacht | Wohnung › Preise | Wohnung | Position bei A6 | +| Erkannte Buchungen übernehmen | Portal | Kanal | Aus / Beobachten / Anlegen / Anlegen und weiter (Paket 4) | +| Was kommt über dieses Portal? | Portal | Kanal | Sofortbuchungsschutz (`CalendarClearance`) | +| Zusätzlich von Hand sperren | Portal | Kanal | Portalaufgaben mit Nachweisstufe | +| Freigabe der Dokumentarten | So arbeite ich › Dokumente | Vermieter | Arbeitsfassungen gehen nie automatisch hinaus. Neu ist die Dokumentart „Auskunft unter Vorbehalt“; solange sie nicht freigegeben ist, wird nicht automatisch geantwortet. | +| Freigabe einer Vorlage | Vorlagen › Freigabe | Vorlagenversion | Schutz vor unvereinbarten Bedingungen | +| Testbetrieb / Testadresse | System › Betrieb | Vermieter (Server-Vorgabe `FEWO_MAIL_REDIRECT_TO` gewinnt) | Jede ausgehende Mail nur an die Testadresse; der Verlauf vermerkt es. iCal-Abgleich bleibt aktiv. | +| Anzahlungsfrist, Bewertung nach Tagen | System › Betrieb | Vermieter | Zahlungsplan, Bewertungsbitte | + +**Im einzelnen Vorgang übersteuerbar:** +- Bearbeitungsart +- Vorlage (im Dokument) +- bei Haltefrist 0 „Stattdessen verbindliches Angebot mit Reservierung senden“ +- Preis bei der Bestätigung eines Wunsches (Preis der Auskunft oder ein niedrigerer heutiger Preis) +- eigene Aufgaben, Abweichungen und Folgeaufgaben; Aufgaben als erledigt, übergeben oder entfällt markieren +- Aufenthalt von Hand abschließen +- kaufmännischer Abschluss mit Begründung + +**Fest im Code:** +- Vorbereitung 14 Tage im Voraus +- Anreisedaten-Prüfung 2 Tage vor der Anreise-Info +- Auszahlungsprüfung am Tag der Abreise + 14 +- Abschluss in der Nacht nach der Abreise + +--- + +### 5. Sonderfälle nur über Konfiguration + +| Sonderfall | Konfiguration | +|---|---| +| Ein Portal leitet nur Anfragen weiter, die nichts blockieren sollen | Portal › Anfragen: „Reservieren? nein“ → Auskunft statt Angebot (T24) | +| Diese Wohnung wird von Hand bearbeitet, die andere automatisch | Wohnung › Abweichende Abwicklung: Bearbeitung | +| Schlüsselübergabe nur bei Gästen, Endreinigung auch bei Familie | Aufgaben je Aufenthalt mit „Bei“ (T19, T21) | +| Ein Gast soll trotz Haltefrist 0 ein bindendes Angebot erhalten | im Vorgang „Stattdessen verbindliches Angebot …“ | +| Portal schickt Anreise-Info selbst | Portal › Feste Buchungen: „Anreise-Info und Bewertung: Portal“ (T20) | +| Kleine Auszahlungsdifferenz akzeptieren | im Vorgang „Kaufmännisch abschließen …“ mit Begründung (T22) | + +--- + +### 6. Nachweis an konkreten Vorgängen + +| Konstellation | Erwartung | Beobachtet | +|---|---|---| +| Standard automatisch, Wohnung 24 h, direkte Anfrage | automatisch (Standard), 24 h (Wohnung) | identisch (T12) | +| FeWo-direkt feste Buchung, Zahlung Portal | A4, keine Mahnung, Status bleibt „Bestätigt“ trotz „laut Portal bezahlt“ | identisch (T04, T20) | +| Standard mit Reservierung, Ostseeklar-Anfragen ohne Reservierung und manuell | direkte Anfrage: Angebot und Reservierung. Ostseeklar: keine Reservierung, Aufgabe „Auskunft senden“ | identisch (T24) | +| Ostseeklar-Anfrage im Vorgang auf automatisch | Auskunft sofort, Wunsch automatisch bestätigt | identisch (T24) | +| Wohnung Anreise-Info 5 Tage, Anreisezeit erfragen | Anreisedaten-Aufgabe 7 Tage, Anreisemail 5 Tage vorher | identisch (T24) | +| Automatisch, aber Preis geändert bzw. Kalender veraltet | keine Automatik, Aufgabe mit Befunden | identisch (T17) | +| Familienbesuch | Unterlagen, Zahlungen, Mails „Entfällt“; Aufgaben je Aufenthalt „Familie“ wirken | identisch (T09, T21) | + +--- + +### 6a. Neue v0.11-Konfigurationsgegenstände (noch nicht als implementiert anzusehen) + +- Je Mandant zunächst **ein aktives IMAP-Postfach**, Aliasadressen möglich; Datenmodell perspektivisch mehrere Postfächer. +- KI-Extraktion: versionierte Prompts mit Platzhaltern und strukturiertem Schema, kleines Primärmodell und optional größeres Prüfmodell, programmatische Kritikalitätsregeln und zu kalibrierende Schwellwerte. Zentral administrierbar; kein grafischer Prompt-Editor als MVP-Pflicht. +- Signierte Gastlinks: Laufzeit/Status und Formularberechtigungen ohne Gastregistrierung; Sicherheitsgrenzen nicht durch Geschäftskonfiguration abschaltbar. +- Gastkommunikation: Bausteine für **tatsächlich** keinen/aktiven/abgelaufenen Klärungsblock sowie bereits verbindliche Portalbuchungen. + +### 7. Lücken und widersprüchliche Stellen + +| Stelle | Beschreibung | Empfehlung | +|---|---|---| +| Buchungsmodell am Portal und Profil | „Was kommt über dieses Portal?“ und das Profil je Eingangsart können sich widersprechen. | Modell aus den Eingangsarten ableiten oder einen Hinweis im Portalformular zeigen. | +| Alte Spalten | `properties.hold_hours`, `pre_reservation_enabled`, `arrival_info_days_before` u. a. werden nicht mehr gelesen. | Nach erfolgreicher Migration auf Produktion entfernen. | +| Aufgaben je Aufenthalt | nur je Wohnung, nicht je Portal | ausreichend für 1–3 Wohnungen | +| Feste Fristen | Vorbereitung, Anreisedaten-Prüfung, Auszahlungsprüfung | einstellbar machen, wenn Erfahrungswerte vorliegen | +| Gültigkeit der Auskunft | dieselbe Einstellung wie das Angebot | bewusst so (E-026) | + +**v0.11-Grenze:** Die oben als neu markierten Parameter beschreiben die künftige fachliche Soll-Konfiguration; die dokumentierten Screenshots, Artisan-Berichte und Tests der Pakete 1–9 belegen ausschließlich den v0.10-Bestand. + +--- + +## Kapitel: `Entscheidungen.md` + +## Gültige fachliche Entscheidungen + +**Gültige Betreiberfestlegungen**, keine technische Implementierungs- oder juristische Freigabe. Die Kennungen dienen dem Auffinden und sind keine Aufforderung, dieselben Regeln in allen Dokumenten erneut zu erklären. Versions- und Änderungshistorie wird **in Git** geführt. + +| ID | Gegenstand | Gültige Regel | +|---|---|---| +| E-001 | Feedback und Gästebindung | Dank, Feedback und Bewertung gehören zu V01/P05; die langfristige Gästebindung zu V02. | +| E-002 | Gemeinsamer Prozess | Ein führender FewoPortal-Vorgang; kanalabhängige Tätigkeiten und Verantwortlichkeiten statt getrennter Portalsoftwareprozesse. | +| E-003 | Eigenes bindendes Angebot | Mit wirksamem Hold befristet bindendes Angebot; rechtzeitige wirksame Annahme führt ohne zweite Entscheidung zum Vertrag. | +| E-004 | Externe Direktbuchung | Bereits verbindlich; Portalpreis/Konditionen übernehmen, keine zweite Annahme und keine stillen nachträglichen Pflichten. | +| E-005 | Weitgehende Portalabwicklung | Nicht zusätzlich Vertrag, Mahnung oder Storno durchführen, wenn tatsächlich extern verantwortet; erforderliche lokale Daten/Aufgaben bleiben. | +| E-006 | V01-Phasen | Gemeinsame Prozesshierarchie P01–P05; Aktivitäten sind abhängig vom Fall und zeitlich nicht zwingend strikt sequenziell. | +| E-007 | Produktfokus | Kleine Vermieter mit meist 1–3 Ferienwohnungen; mandantenfähig, kein Marktplatz, keine umfassende Agenturverwaltung. | +| E-008 | V02 | Eigenständiger Prozess für Multichannel-Vermarktung, Nachfrage, CRM, Wiederbuchung und Loyalty, vor und nach V01. | +| E-009 | Supportfunktionen | Schlüssel, Reinigung, lokale Leistungen im Buchungsvorgang integrieren; daraus folgt kein eigenständiges Modul. | +| E-010 | Folgeangelegenheiten | Nach erfülltem Aufenthalt V01 abschließen dürfen; offene Ansprüche/Konflikte verantwortlich und nachvollziehbar übergeben. | +| E-011 | Prozessausgänge | Regulär erfüllt, ohne Buchung beendet, wirksam storniert; bei A6 auch Aufhebung/Ende interner Sperre. Keine parallelen Endworkflows. | +| E-012 | Partnervertrieb | Partner-/Hub-Herkunft ist kein Buchungsarchetyp, sondern nur bei Bedarf ein kaufmännisches/analytisches Merkmal. | +| E-013 | Vertragsprofile | Vorlagen und Anlagen nach Vermieter, Objekt, Kanal und tatsächlicher Buchungs-/Vorgangsart; Version/Konditionsstand sichern. | +| E-014 | Informationsbeschaffung | Automatisch, manuell oder kombiniert; Gesamtpreis/Sammelposition zulässig; unbekannt ist nicht 0 oder geschätzt. | +| E-015 | Finanztrennung | Gastmiete, Gast-Servicegebühr, Vermieterprovision, Rabatte, Zahlungen und Auszahlung trennen; Originalwerte behalten; keine Doppelzählung. | +| E-016 | Destination Solutions | Für den beschriebenen Vermieterzugang **A3**: bindender Abschluss extern, danach Vermieterabwicklung; Partnerprovision kein Gastaufschlag ohne Vereinbarung. | +| E-017 | Destination-Storno | Vom Betreiber genannte Staffel 0/35/50/70/90/100 % nach Tagen; tatsächliche Einbeziehung, Berechnungsbasis und Wirksamkeit sind offene Prüfungen. | +| E-018 | Belegungssperren | Externer Export, Zielportal-Sichtbarkeit und nachgewiesene Wirksamkeit getrennt betrachten; keine nicht belegte Partnernetz-Bestätigung. | +| E-019 | Änderung/Storno | Ursache, Initiator, Ausführender, Entscheidung, rechtliche Wirksamkeit und Vertrags-/Kalender-/Finanzfolgen unterscheiden. | +| E-020 | FeWo-direkt-Daten | Eine Gastbuchung liefert teilaggregierte Beträge, Raten und Auszahlungsvorschauen; keine unterstellte vollständige Preiszerlegung/Exportfähigkeit. | +| E-021 | Pflege der Spezifikation | Vor künftigen Änderungen aktuelle Originale vom Betreiber anfordern; fachlichen gültigen Stand konsistent halten und Git-Diff nutzen. | +| E-022 | Sechs Archetypen | A1–A5 plus **A6 = Eigenbelegung, private Überlassung und sonstige Sperren**. | +| E-023 | Einheitlicher Vorgang | Jeder qualifizierte Geschäftsfall ein Vorgang, keine separat anzulegende Buchungsakte; Belegungswirkung davon unterscheidbar. | +| E-024 | A6 und Nebenleistungen | Je Anlass Gäste, Wäsche, Kurabgabe und Zahlungen möglich, auch bei Mietpreis 0; reine Sperre ohne Gast/Vertrag. | +| E-025 | Dokumente steuern den Ablauf | Zutreffendes Vorlagen-/Dokumentenprofil (inkl. Bestätigungen) nach tatsächlichem Vorgang und Kanal wählen; konkrete Nachweise versionieren. | +| E-026 | Schlanker Angebotsweg | **Angebots-Haltefrist als einzige Standardfrist des bestehenden Angebotswegs**: >0 bindendes Angebot passend zur Belegung, 0 Auskunft unter Vorbehalt mit erneuter Prüfung vor Bestätigung; keine separate Preisbindefrist. Der **neue optionale vorgelagerte Klärungs-Kurzblock** für unvollständige Anfragen ist davon unabhängig und keine weitere Angebotsfrist. | +| E-027 | Risikopragmatismus | Seltene Doppelbuchungen ernst nehmen, aber keine überdimensionierte Verfügbarkeits-/Risikoengine; reale Portalverzögerungen berücksichtigen. | +| E-028 | Vorhandene Owner-Zuordnung | Bereits implementierte Herkunfts-/Owner-Erkennung wiederverwenden; zunächst Ist-Abgleich statt neuer paralleler Vorgangsstruktur. | +| **E-029** | **Mandantenstandard/Vererbung** | **Globale Einstellungen gelten je Vermieter**; kanalindividuelle Werte überschreiben nur, wenn ausdrücklich gesetzt. Nicht gesetzt ≠ 0/aus/manuell. | +| **E-030** | **Automatisierung je Kanal** | Eigener Abschluss nach Hold = 0 erfolgt nach erneuter Verfügbarkeitsprüfung **automatisch oder manuell nach wirksamer Einstellung**. Bereits bestehende verbindliche Buchungen benötigen keine zweite Freigabe. | +| **E-031** | **Dokumentationsstruktur** | Fachliche Dokumente bilden eine hierarchische Prozesslandschaft und den **einen gültigen Stand** ab; wenige relevante relative Links, keine historischen Ergänzungsschichten; Änderungen in Git. | + +| **E-032** | **Vorgelagerte Datenbeschaffung** | Unvollständige unverbindliche A1/A2-Anfragen sind zulässig; vor eigenem bindendem Angebot müssen Vorname, Nachname, vollständige Postanschrift, E-Mail, Zeitraum und Personenzahl plus die bestehenden Angebots-Gates erfüllt sein. Detailregel [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). | +| **E-033** | **Zwei getrennte Reservierungszwecke** | Optionaler Klärungsblock V0/V1 (für Wohnung, Zeitraum, E-Mail und bestandene Verfügbarkeitsprüfung; konfigurierbar 15 Minuten automatisch / 180 Minuten mit Freigabe oder manuell, je `0` möglich) geht der unveränderten Angebots-Vorreservierung voraus. | +| **E-034** | **Kanalspezifische Kommunikation** | Rückfrage, Teilantwort, Folgefrage und Erinnerung über Email oder signierten Ergänzungslink; mit Status-/Fristtexten, die nur tatsächlich wirksame Reservierungen behaupten. | +| **E-035** | **Quellen und KI** | Gemeinsamer Fakteneingang; bestehende Portalparser und iCal-Pfade bleiben; IMAP und risikobasierte kleine/große LLM-Extraktion liefern nur Kandidaten. Kontrollierte Übernahme abhängig von Phase und Feldkritikalität. | +| **E-036** | **Externe Bindung geschützt** | Bereits extern verbindliche Buchung bleibt auch bei fehlenden Gastdaten gültig; keine neue Angebotsannahme und keine Klärungsreservierung wegen fehlender Angaben. | +| **E-037** | **Zentraler Kanalmanager** | Führende fachliche Kanalverwaltung für eigenes Portal und externe Kanäle, iCal-Verbindungen, Kommunikations-/Geschäftseinstellungen und Vermieter-/Wohnungsstandards; operative iCal- und Buchungslogik bleibt bestehen. | +| **E-038** | **Änderungsgrenze MVP** | Vor Annahme: Änderungswunsch erkennen/zu manueller Bearbeitung geben. Nach Vertragsschluss: vertragsrelevante Änderungen manuell; administrative fehlende Fakten können kontrolliert ergänzt werden. Parallele bindende Angebotsvarianten und Fristverlängerung bleiben spätere P02-Spezifikation. | + +### Grenze fachlicher Freigabe + +Noch nicht entschieden sind insbesondere die vollständigen Abschluss-/Statuskriterien, rechtliche Einbeziehung konkreter Drittportalbedingungen, exakte örtliche Meldedaten und die tatsächliche Funktion einzelner Portalschnittstellen. Ein Coding-Agent darf technische Lösungen selbständig vorschlagen, **fachlich offene Regeln aber nicht als beschlossen ausgeben**. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Offene Prüfungen](Offene_Fragen.md) + +--- + +## Kapitel: `Offene_Fragen.md` + +## Offene Prüfungen + +**Offen heißt nicht „nicht implementierbar“.** Wo ein Portal Details nicht liefert, sind **manuelle Klärung**, **Sammelbeträge** oder ein begründeter unbekannter Status erlaubt. Die folgenden Punkte sind **nicht automatisch Freigabesperren für den gesamten Prozess**. + +### Portalbezogene Konfiguration + +| ID | Offene Prüfung | Benötigte Grundlage | +|---|---|---| +| **DS-01** | Werden Stornobedingungen vor verbindlichem Destination-Solutions-Abschluss wirksam angezeigt? | Gast-Buchungsweg, Bestätigung, Konto-/Vertragseinstellungen | +| **DS-02** | Was umfasst der „Mietpreis“ als Basis der 0/35/50/70/90/100-%-Staffel? | Vertrag, Preisbestandteile, Rechtsprüfung | +| **DS-03** | Zusätzliche Gastgebühren oder Aufschläge in Partnerkanälen? | Gastpreisansicht, Buchungsbestätigung, Provisionsrechnung | +| **DS-04** | Detailtiefe der Preis-/Buchungsinformationen (ggf. nur Gesamtpreis)? | Anonymisiertes konkretes Buchungsbeispiel | +| **DS-05** | Zeitpunkt/Nachweis der manuellen Sperrübernahme und Partnerweitergabe? | Anbieterantwort bzw. Server-/Änderungsprotokoll | +| **DS-06** | Änderung/Storno im konkreten Konto, Verantwortung und Nachweise? | Portalvertrag, Beispielprozess, Testfall soweit möglich | +| **FW-01** | Welche Vertragsbedingungen und Bestätigungen sieht/erhält der Gast **vor/bei bindender** FeWo-direkt-Buchung? | Gastansicht/Bestätigung, Portal-AGB, Inserat | +| **FW-02** | Aufschlüsselung der 181,51 € Gebühren/Steuern und 84,82 € „an FeWo-direkt gezahlt“? | Vollständige Zahlungsdetails, Provisionsabrechnung | +| **FW-03** | Warum 894,69 € versus 900,20 € angekündigte Auszahlung? | Zahlungs-/Provisionsbeleg derselben Buchung | +| **FW-04** | Tatsächliche Zahlungs- und Auszahlungsexporte/Bankabgleich verfügbar? | Konkreter Exporttest und Kontoauszahlung | +| **FW-05** | Buchungsänderung, Vermieterstorno, Erstattung und Sanktionen tatsächlich im konkreten Konto? | Portalverfahren und dokumentierter Beispielvorgang | +| **FW-06** | Welche Gast-/Mitreisendendaten werden geliefert und rechtlich benötigt? | Konkrete Datenfelder und kommunale Vorschriften | +| **FW-07** | Tatsächliche iCal-Übernahmezeit/Wirksamkeit belegbar? | Technische Portalnachweise soweit vorhanden | + +### Übergreifende fachliche und rechtliche Prüfpunkte + +- **Vertragsrecht:** Wann kommen jeweils welche Verträge zustande, welche AGB, Stornobedingungen und Pflichtkosten sind tatsächlich vor Vertragsschluss einbezogen? Nachträglicher Versand allein erzeugt keine sichere neue Bindung. +- **Storno:** Wirksamkeit der Pauschalen, ersparte Aufwendungen, Weitervermietung, Unterschiede zwischen Gäste- und Vermietergrund; keine automatisch unterstellte Rechtslage. +- **Abgaben/Meldepflichten:** Erforderliche Felder und Besonderheiten bei privaten Gästen, Kurabgabe-Befreiungen, Verantwortung des örtlichen Dienstleisters; **keine Tarife dauerhaft als unveränderliche Produktkonstanten**. +- **P01/P02:** Beginn der Haltefrist, Fristen bei geänderten Angeboten, Vermeidung paralleler bindender Zusagen, rechtssicherer Text der Auskunft unter Vorbehalt und des Buchungsbuttons. +- **P03–P05:** Mindestdaten/Abschlussgates, Pflichtaufgaben, Übergabe von nachlaufenden Forderungen und Schäden; detaillierte Abläufe noch fachlich auszuarbeiten. +- **A6:** Bestätigungsformulierungen und Kostenpflichten privater Überlassung, Verknüpfung alter Sperren mit einheitlichem Vorgang. + +### v0.11 – Noch offene Detailprüfungen (kein neues Grundsatzdesign) + +**Fachliche Ausgestaltung/Parametrierung:** Altersunterteilung Erwachsene/Jugendliche/Kinder als verpflichtendes Angebotsfeld, feldbezogene Schutz-/Korrekturregeln nach P1/P2/P3, konkrete maximale Folgefragenzahl und Erinnerungsintervalle. **Bisherige Defaults 15/180 Minuten für den Klärungsblock bleiben bestehen; ein 15/30-Wechsel wurde nicht beschlossen.** + +**Technik/KI und Nachrichtenquellen:** E-Mail-Quellenverifikation, Prompt-/Schema-/Kontextgrenzen, modellgestützte Extraktionsgüte einschließlich übersehener Fakten, Kalibrierung der Konfidenzwerte und Eskalationsschwelle, Fehlerszenarien/Timeouts, sichere Absender-/Vorgangszuordnung und Regression des bestehenden iCal-/Portalparser-Eingangs. Betriebskonzept für ein aktives Postfach pro Mandant; Abgleich mit tatsächlicher Codebasis für Kanalmanager und wirksame Einstellungen. + +**Go-live-Compliance:** Gastlink-Gültigkeit/Berechtigung, konkrete genehmigte Textvorlagen und Nachrichtenzahl/-abstände, Lösch-/Aufbewahrungsfristen, Rechtmäßigkeit von Nachfass-E-Mails, Datenschutz der eingesetzten LLM-Anbieter bzw. lokaler Verarbeitung, IT-Sicherheit und Testversand. Kein bindender 30-Tage-Löschwert beschlossen. Die Fachspezifikation ersetzt keine Rechtsfreigabe. + +**Explizit spätere Fachspezifikation – nicht MVP:** Parallele alternativ annehmbare verbindliche Angebote, Wirkung von Ersatzangeboten, gemeinsame Verfügbarkeitsabsicherung, einmalige begrenzte Annahmefristverlängerung bei spät eintreffendem Änderungswunsch und Rechtsprüfung. Nach Vertragsschluss: Umbuchung, Verkürzung/Teilstorno, zusätzliche Leistungen, Zahlungs-/Stornofolgen; möglicher Storno-/Neubuchungs-Workaround nur manuell prüfen. Außerdem spätere Varianten V2/V3 des Klärungsblocks, mehrere aktive IMAP-Postfächer, Messenger, Gastkonto und Loyalty. + +**Fachliche Hauptregel und Abnahmefälle:** [Communication Handler und Datenbeschaffung](Querschnitt/Datenbeschaffung_und_Communication_Handler.md), CH-01–CH-18, M01–M12. + +### Vor der Implementation technisch am Repository prüfen + +Der Coding-Agent hat in seiner Bestandsanalyse **berichtet**, dass bestehende Buchungen, Blockperioden und manuelle Erfassung derzeit teilweise parallel laufen; Gast-Pflichtfelder bei Portalbuchungen Platzhalter auslösen können; `Channel::booking_model` zu grob ist; Hold und Angebot verknüpft und nur wohnungsbezogen gesteuert werden; `PortalPrice` Gesamtsummen künstlich aufteilt; Portalstornos bestehende Vorgänge nicht sichtbar erreichen und A6 nur teilweise abbildbar ist. **Das sind Agentenbefunde, keine unabhängig verifizierten Tatsachen oder technischen Architekturvorgaben.** Die aktuelle Codebasis ist vor Maßnahmen erneut zu prüfen. + +**Reihenfolge:** Bereinigte Fachspezifikation → Agent prüft Abweichungen zur aktuellen Implementierung und liefert **gespeicherten Umsetzungsplan im Repo** → fachliche Entscheidungen/Umsetzungsfreigabe → Implementierung. Kein vorschneller Gesamtumbau und keine Erfindung fehlender Geschäftsregeln. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Destination Solutions](Szenarien/R08_Destination_Solutions.md) · [FeWo-direkt](Szenarien/R09_FeWoDirekt.md) + +--- + +## Kapitel: `Szenarien/00_Szenariomatrix.md` + +## Referenz- und Prüfszenarien + +Die Fälle prüfen denselben Hauptprozess V01 entlang unterschiedlicher Quellen und Verantwortlichkeiten. Nicht für jeden vorgemerkten Vergleich ist bereits ein separates Dokument erforderlich. + +| ID | Szenario | Typ | Dokument-/Prüfstatus | +|---|---|---|---| +| **R01** | Anfrage über eigene Website; **optionale Klärungssperre** bei Datenlücken und **separate Angebots-Haltefrist** | A1 | [Ausgearbeitet](Szenarien/R01_Eigene_Webseite.md), v0.11-Informationsbeschaffung eingeschlossen | +| R02 | Telefonische/manuelle Anfrage | A1/A2 je Ursprung | Vorgemerkt; keine zusätzliche Prozessvariante | +| R03 | Unverbindliche Portalanfrage | A2 | Vorgemerkt; fehlende Gastdaten über CH beschaffen, nur optionaler Kurzblock, danach bestehender Angebotsweg | +| R04 | Externe verbindliche Buchung, Vertrag/Zahlung durch uns | A3 | Generischer Vergleichsfall; konkret als R08 geprüft | +| R05 | Portal wickelt Vertrag/Zahlung/Storno weitgehend selbst ab | A5 | Vorgemerkt; nur eigene lokale Pflichten | +| **R07** | Interne Belegung, private Überlassung, Wartung | A6 | [Ausgearbeitet](Szenarien/R07_Eigenbelegung_und_Sperren.md) | +| **R08** | Destination Solutions, direkte Bindung + eigene Abwicklung | A3 | [Ausgearbeitet](Szenarien/R08_Destination_Solutions.md) | +| **R09** | FeWo-direkt, direkte Bindung + geteilte Abwicklung | A4 | [Ausgearbeitet](Szenarien/R09_FeWoDirekt.md) | + +**Partnerherkunft** ist kein eigener Falltyp; sie kann bei Bedarf Auswirkungen auf Provision und ausgewiesenen Endpreis haben. A4 ist eine geteilte Abwicklungsvariante, nicht dasselbe wie der allgemeine R04-Fall mit weitgehend eigener Abwicklung. + +[Zur Startseite](README.md) + +--- + +## Kapitel: `Szenarien/R01_Eigene_Webseite.md` + +## R01 – Eigene Website (A1) + +Ein Gast fragt eine Wohnung mit Zeitraum, Kontakt und ggf. Zusatzleistungen an. Es entsteht ohne zusätzlichen Klick ein **Vorgang**. Bei Anfragen über einen externen Vermittler (A2) ist derselbe Grundablauf nutzbar, nachdem fehlende Daten nachgefordert wurden. + +### Regelfall + +| Phase | Vorgehen | +|---|---| +| **P01** | Unverbindliche Anfrage auch bei unvollständigen Gastdaten als Vorgang erfassen; verfügbare Angaben und Herkunft dokumentieren. Bei Wohnung + eindeutigem Zeitraum + verwendbarem E-Mail-Kontakt und positiver Verfügbarkeit **optional einen vorgelagerten Klärungsblock** nach eigener Kanalkonfiguration anlegen (auch `0` = kein Kurzblock). Fehlende Pflichtdaten über den Communication Handler anfordern. Erst danach führt der **unveränderte Angebotsweg** mit eigener Angebots-Haltefrist zur passenden Belegungswirkung. | +| **P02** | Eigenes verbindliches Angebot erst nach vollständigem Namen, Personenzahl, Reisezeitraum, E-Mail, **vollständiger Postanschrift** und weiteren bestehenden Gates; Jahres-/Saisonpreis, Leistungen, Rabatte und Anlagen ermitteln. **Angebots-Hold > 0**: bindendes befristetes Angebot mit Annahmelink; Annahme begründet Verbindlichkeit ohne zweite Freigabe. **Angebots-Hold = 0**: nur Auskunft unter Vorbehalt gemäß bestehender v0.10-Logik. | +| **P03** | Vertrag/Buchungsbestätigung, Zahlungsplan, Aufgaben und Fristen im Vorgang; keine unbeauftragte automatische Mahnung oder Stornierung | +| **P04** | Gäste-/Anreiseinformationen, lokale Leistungen, ggf. Kurabgabe und Meldedaten; Anreise-Info je konfiguriertem Ablauf (bisherige Praxis etwa drei Tage vorher) | +| **P05** | Aufenthalt abschließen, Dank/Feedback/Bewertung, Objektbereitstellung und ggf. kontrollierte Nachläuferübergabe | + +### Variante: Angebots-Haltefrist 0 (unabhängig vom Klärungsblock) + +Es wird **keine Reservierung** ausgelöst. Die Antwort ist eine Preis-/Verfügbarkeitsauskunft unter Vorbehalt und kein unbedingtes Mietvertragsangebot. Will der Gast buchen, erfolgt **eine neue Verfügbarkeitsprüfung**. Anschließend bestätigt FewoPortal automatisch oder legt die Entscheidung dem Vermieter vor – gemäß seinem globalen Standard bzw. der **ausdrücklichen kanalindividuellen Einstellung**. Die tatsächlich versandte Bestätigung muss zur Vertragswirkung passen. Keine separate Preisbindefrist und kein versteckter zweiter Hold. + +### Vorgelagerte Informationsbeschaffung (v0.11) + +Bei noch fehlenden Angebotsangaben darf eine **eigene Klärungsreservierung** für die konfigurierte kurze Zeit bestehen; sie ist **kein Angebots-Hold**. Bei `Klärungsreservierung = 0` erfolgt dieselbe Rückfrage **ohne** Reservierung und mit dem ausdrücklichen Hinweis auf die zwischenzeitlich mögliche anderweitige Buchung. Bei positivem Wert bestätigt die Rückfrage nur einen **tatsächlich wirksamen** Kurzblock samt absolutem Ablaufzeitpunkt. Ist die Sperre nicht erfolgreich angelegt oder bereits abgelaufen, darf der Text keinen Hold behaupten. Bei verspäteter Ergänzung wird vor dem Angebot die Verfügbarkeit erneut geprüft. Die Antwort per E-Mail oder sicherem Ergänzungslink führt zur gemeinsamen Datenübernahme; die Angebots-Haltefrist wird dadurch nicht verlängert. + +### Kritische Ausnahmen + +- Angaben fehlen: gezielte Nachfrage; keine Platzhalter-Gäste, erfundenen Personenzahlen oder Preise. +- Zeitraum nicht frei / parallele Holds: keine ungesicherte bindende Zusage; Alternativen oder Klärung. +- Änderung während laufender Angebotsfrist: richtige Angebotsversion und verbleibende Annahmemöglichkeit feststellen. +- Fristablauf/Ablehnung: ohne Vertrag beenden, eigenen Hold nur nach Konfliktprüfung freigeben. +- Verspätete/abweichende Annahme, unzustellbare E-Mail, mehrfach betätigter Link: keine stillschweigende zweite oder falsche Buchung. +- Nach Buchung: Umbuchung, Storno, Zahlungsausfall, No-show, Schaden und Reklamation über dieselben fachlichen Sonderfälle. + +**Noch zu prüfen:** Technische und rechtliche Wirksamkeit des Annahmewegs sowie spätere Regeln zu mehreren gleichzeitig ausstehenden Angebotsalternativen. Die **Angebots-Pflichtdaten sind für v0.11 bereits verbindlich festgelegt**; Parallelangebote sind nicht MVP-Umfang. + +[Zum Szenarioüberblick](README.md) · [P02](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) + +--- + +## Kapitel: `Szenarien/R07_Eigenbelegung_und_Sperren.md` + +## R07 – Eigenbelegung, private Überlassung und Sperren (A6) + +Ein **interner Belegungsanlass** (Familienbesuch, Eigennutzung, Wartung, Renovierung, Vorbereitung, organisatorische Sperre) wird als **Vorgang** mit Grund, Zeitraum und Belegungswirkung geführt. Er nutzt denselben Geschäftsprozess wie A1–A5, führt aber nur die fachlich erforderlichen Aktivitäten aus. + +| Phase | Private Überlassung / Familie / Freunde | Wartung / reine Sperre | +|---|---|---| +| **P01** | Anlass, Zeitraum, Gäste soweit nötig; Belegung sichern, andere Portale sperren | Grund und Zeitraum, Sperrung/Kalenderabgleich | +| **P02** | Passende Aufenthalts-/Buchungsbestätigung, ggf. Bedingungen und Leistungen | Interne Bestätigung oder kein Dokument, **kein Mietvertrag** | +| **P03** | Kurtaxe soweit geschuldet, Wäsche, andere Leistungen und Zahlungen; **Mietpreis kann 0 sein** | Keine fiktiven Gäste/Zahlungen; ggf. gesondert zu verfolgende Wartungsausgaben | +| **P04** | Anreise, Leistungen und Aufenthalt entsprechend Bedarf | Arbeiten und Sperrzweck durchführen | +| **P05** | Belegung abschließen, offene Nebenpflichten übergeben | Sperre aufheben/ändern, betroffene Kalender aktualisieren | + +**Gemeinsame Änderungslogik:** Zeitraum verschieben, verlängern, verkürzen oder absagen. Bei privaten Gästen können Dokumente/Zahlungen betroffen sein; bei Wartung lediglich Sperrwirkung und ggf. Arbeit. Eine reine Freigabe ist **keine rechtliche Mietvertragsstornierung**. + +**Abgrenzung:** Der kurzfristige Hold einer A1/A2-Anfrage ist keine zusätzliche A6. Eine private Nutzung kann lokale Abgabepflichten auslösen; Befreiungen müssen anhand geltender kommunaler Regeln und Personenkonstellation geprüft werden. Vertrags-/Bestätigungstexte sind nicht ohne juristische Prüfung freigegeben. + +[Zum Archetypenkatalog](01_Buchungsarchetypen.md) + +--- + +## Kapitel: `Szenarien/R08_Destination_Solutions.md` + +## R08 – Destination Solutions (A3) + +**Quelle:** Betreiberangaben zum konkret genutzten Zugang, nicht zur vollständigen Produktpalette von [Destination Solutions](https://www.ds-destinationsolutions.com/). + +### Tatsächlicher Geschäftsfall + +Das Portal bestätigt eine Buchung **verbindlich** und leitet sie mit den zur Verfügung stehenden Daten an den Vermieter weiter. Ab dann verantwortet der Vermieter Vertrags-/Gastkommunikation, Zahlungsforderung und -überwachung sowie Aufenthalt. **Kein erneuter Angebotsabschluss** und keine nachträgliche Belastung des Gastes mit der Vermieterprovision. + +Eine automatische Kalendersynchronisation existiert im genutzten Zugang **nicht**. Weitere Portale müssen manuell gesperrt werden; ein belastbarer Nachweis des serverseitigen Übernahmezeitpunkts bzw. der Weitergabe an Partnerportale fehlt. Das ist ein offener Risikostatus, keine Zusicherung synchroner Belegung. + +Destination Solutions kann über Partnerkanäle verkaufen. Unterschiedliche **Vermieterprovisionen** je Herkunft sind bekannt. Ob eigene Gast-Servicegebühren, höhere Vertriebs-Endpreise oder eine getrennte Preisaufschlüsselung auftreten, ist **ungeklärt**. Partnerherkunft ist ein kaufmännisches Merkmal, **kein eigener Archetyp**. + +### Verarbeitung P01–P05 + +- **P01:** Verbindliche Portalbuchung mit Ursprungskanal, Referenz, Zeitraum und Gastdaten übernehmen; interne Belegung sichern; manuelle Sperraufgaben in anderen Kanälen erzeugen und bearbeitete Schritte nachweisbar halten. +- **P02:** Vereinbarten Portalpreis/Konditionsstand übernehmen; dazu passende eigene Vertragsdokumentation der **bereits verbindlichen** Buchung erstellen, ohne zweite Annahme oder zusätzliche nicht vereinbarte Gebühr. +- **P03:** Eigene Gast-/Zahlungs-/Mahn-/Kommunikationsaufgaben erledigen; Portalprovision getrennt vom Gastpreis prüfen. +- **P04:** Gäste betreuen, Schlüssel/Reinigung/Dienstleister und ggf. lokale Abgaben organisieren. +- **P05:** Leistung/Feedback abschließen, ausstehende Zahlung/Provision/Streitfragen zuständig weiterführen. + +### Datenanreicherung bei fehlenden Gastinformationen (v0.11) + +Die extern **bereits verbindliche** Buchung wird unabhängig von der Vollständigkeit der Gastdaten in P01/P02 übernommen und gesichert. Eingehende Portal-E-Mails können über vorhandene Parser und den Communication Handler derselben Buchung zugeordnet werden. Fehlende administrative Angaben können nach den phasenabhängigen CH-03-Regeln ergänzt oder gezielt beim Gast angefordert werden; **es entsteht weder eine Klärungsreservierung noch ein neues eigenes Angebot**. Der tatsächlich verwendete Zugang verfügt laut dokumentiertem Betreiberstand weiterhin **nicht** über iCal-Synchronisation; diese v0.11-Ergänzung behauptet keine solche Integration. + +### Vom Betreiber genannte Stornostaffel + +| Zeit bis Mietbeginn | Anteil des „Mietpreises“ | +|---|---:| +| 60 Tage oder mehr | 0 % | +| 59–45 Tage | 35 % | +| 44–33 Tage | 50 % | +| 32–22 Tage | 70 % | +| 21–12 Tage | 90 % | +| 11 Tage oder weniger | 100 % | + +**Kein bestätigter Nachweis**, dass diese Staffel schon **vor** bindendem Portalabschluss wirksam eingebunden war; der Betreiber versendet bislang eigene Bedingungen nach Buchung. Auch die Basis „Mietpreis“ (nur Übernachtung oder inkl. Leistungen), rechtliche Wirksamkeit pauschaler Stornokosten und etwaige Gastgebühren sind zu klären. Eine erst nachträglich übermittelte Bedingung kann nicht automatisch eine bereits verbindliche Buchung ändern. + +[Zum Archetypenkatalog](01_Buchungsarchetypen.md) · [Offene Fragen DS-01 bis DS-06](Offene_Fragen.md) + +--- + +## Kapitel: `Szenarien/R09_FeWoDirekt.md` + +## R09 – FeWo-direkt (A4) + +**Quelle:** Vom Betreiber beschriebener tatsächlicher Ablauf, ergänzt durch gezeigte Einzelbuchungsansichten; das Portal kann in anderen Konten anders konfiguriert sein. + +### Vorgang und Zuständigkeiten + +FeWo-direkt bestätigt die Buchung unmittelbar **verbindlich**. Der Vermieter erhält eine Buchungsmeldung, pflegt die Belegung anderer Kanäle, ermittelt im Portal zusätzliche Buchungs-/Kontaktdaten, fordert fehlende Gastdaten nach und versendet eine eigene Vertragsdokumentation. Das Portal verwaltet nach bisheriger Praxis **Anzahlung und Restzahlung**, kündigt eine Gästeinformation etwa 72 Stunden vor Anreise an und übernimmt Teile der Stornoabwicklung. Exakte Mahn-/Storno-/Erstattungspflichten sind noch zu bestätigen. Reinigung, Schlüssel und lokale Gastbetreuung übernimmt der Vermieter bzw. sein Dienstleister. + +**Der eigene vierseitige Mietvertrag ist aktuell nicht im Portal hinterlegt.** Was Gäste vor dem bindenden Abschluss sehen oder als Buchungsbestätigung erhalten, ist nicht vollständig bekannt. Vertragsdokumente müssen die vorher wirksam vereinbarten Bedingungen widerspiegeln; ein später versandtes PDF darf keine neuen Pflichtbedingungen unterstellen. FeWo-direkt ist **kein universeller Standard** für Dokumente oder Portalkonditionen. + +### Nachweisbare Preis- und Zahlungsinformationen eines Beispiels + +In einer gezeigten Buchung vom **10.–17. Juli 2027** waren 840,00 € Übernachtungen, −42,00 € Rabatt, 181,51 € Gebühren/Steuern, **979,51 € Gastgesamtbetrag**, −84,82 € „An FeWo-direkt gezahlt“ und **894,69 € Auszahlung** angezeigt; in anderer Ansicht **900,20 € erwartete Auszahlung**. Die **5,51 € Abweichung** bleibt ungeklärt. Zwei Raten (390,61 € als bezahlt markiert; 588,90 € später fällig) sowie eine angekündigte Auszahlung waren sichtbar. Einzelne Tagespreise, Gebühren-/Provisionsbestandteile, Nachweis des tatsächlichen Bankeingangs und die Gast-Buchungsunterlagen sind dadurch nicht belegt. + +Eine gezeigte Stornoübersicht nennt vollständige Erstattung bei mehr als 60 Tagen, 50 % bei mehr als 30 Tagen und keine Erstattung bei weniger als 30 Tagen. Exakte Grenztage und Einbeziehung im Abschluss sind zu prüfen. Diese Anzeige ist **nicht** automatisch identisch mit der eigenen nachträglichen Vertragsvorlage. + +### Zeitlich versetzte Nachricht und Kalenderinformation (v0.11) + +Die bestehende regelbasierte iCal-Eingangserkennung wird **nicht** durch die neuen Mail-Verifikationsregeln ersetzt. Trifft eine Portal-Mail vor oder nach der Kalenderinformation ein, wird ein bereits vorhandener Buchungsvorgang bei eindeutiger Zuordnung **nicht erneut angelegt**. Fehlende Gastdaten werden über den gemeinsamen phasenabhängigen Fakteneingang ergänzt. Widersprüchliche oder zweifelhafte Angaben werden zur Prüfung bereitgestellt; eine bereits verbindliche Portalbuchung bleibt davon unberührt. + +### Besondere Abläufe + +- iCal-Übernahme externer Sperren kann verzögert sein; keine Live-Verfügbarkeitsgarantie für FeWo-direkt annehmen. +- Gäste können laut Portaldokumentation Storno-/Änderungsaktionen im Portal auslösen; der Betreiber hat eine eigene Vermieterstornierung oder Umbuchung bislang nicht selbst ausgeführt. Das echte Verhalten bei einem Vorgang muss geprüft werden. +- FeWo-direkt untersagt die Veranlassung einer Gästestornierung zur Umgehung von Gastgeberstornofolgen. Bei Doppelbuchungen tatsächliche Ursache, Vertragslage und Portalregelung korrekt behandeln. +- Dokumenten-/Abrechnungsangaben, die der Vermieter nicht elektronisch erhält, können gezielt manuell aus Portal-/Gastinformationen ergänzt werden. + +Die **ausführliche Prüfung der eigenen Vertragsvorlage** steht als getrennte Referenz bereit; sie ist keine gültige allgemeine Vertragsvorlage. + +[Zur Referenzanalyse](Referenzen/FeWoDirekt_Vertragsanalyse.md) · [Offene Fragen FW-01 bis FW-07](Offene_Fragen.md) + +--- + +## Kapitel: `V02_Vermarktung_und_Gaestebindung.md` + +## V02 – Vermarktung, Gästegewinnung und Gästebindung + +V02 ist der zweite, von V01 getrennte, **vor- und nachgelagerte Wertschöpfungsprozess**. Er umfasst Reichweite und Nachfrage über eigene Website, Social Media, Print und Vermittlungsportale, Interessentenbeziehungen, Wiederbuchung, Stammgastpflege und mögliche Loyalty-Maßnahmen. + +**Schnittstellen:** V02 übergibt qualifizierte Anfragen an V01. Loyalty-/Stammgastmerkmale können in der Angebotskalkulation von V01 berücksichtigt werden. Nach dem regulären Aufenthalt verbleiben **Dank, Feedback und Bewertung** fachlich in V01/P05; zulässig nutzbare Informationen können zur Gästebindung an V02 übergeben werden. + +**Status:** Die detaillierte Kampagnen-, CRM- oder Loyalty-Prozessgestaltung ist **nicht beschlossen** und gehört nicht zur aktuellen Priorität der Buchungsprozess-Umsetzung. Keine vorsorgliche Ausgestaltung als großes Marketingmodul. + +[Zur Prozesslandkarte](00_Prozesslandkarte.md) diff --git a/docs/Prozessarchitektur/00_Prozesslandkarte.md b/docs/Prozessarchitektur/00_Prozesslandkarte.md index 896e7b9..d78b4eb 100644 --- a/docs/Prozessarchitektur/00_Prozesslandkarte.md +++ b/docs/Prozessarchitektur/00_Prozesslandkarte.md @@ -3,7 +3,7 @@ typ: prozesslandkarte titel: FewoPortal – Prozesslandkarte status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Prozesslandkarte FewoPortal @@ -37,6 +37,8 @@ ## Einheitlicher Vorgang Die bestehende **Owner-/Ursprungskanal-Zuordnung** ist eine vorhandene Funktion. Der technische Eingang (z. B. E-Mail/iCal), Ursprungskanal und ggf. provisionsrelevante Partnerherkunft sind begrifflich zu unterscheiden. Herkunftsketten sind **kein eigener Archetyp**. +Für die v0.11 werden **eingehende Nachrichten, Gastformular und manuelle Daten** über eine gemeinsame kontrollierte Informationsübernahme mit der vorhandenen Prozesssteuerung verbunden. Der [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md) ist eine Querschnittsfähigkeit, kein neuer Buchungsarchetyp oder eigenständiger Workflow. Der zentrale Kanalmanager pflegt eigene Website und externe Kanäle gemeinsam; die iCal-Ereignisverarbeitung bleibt bestehen. + ## Führungs- und Verantwortungsprinzip FewoPortal ist das führende **interne** Verwaltungs- und Arbeitsinstrument. Ein externes Portal kann den Vertrag abschließen, Geld einziehen, Nachrichten oder Stornierungen bearbeiten. Im Vorgang werden deshalb **tatsächlicher Sachverhalt, Quelle, fachliche Zuständigkeit, Nachweis und erforderliche eigene Folgehandlung** festgehalten. Externe Verantwortung bedeutet nicht, dass eine Leistung nachweislich bereits erbracht wurde. diff --git a/docs/Prozessarchitektur/01_Buchungsarchetypen.md b/docs/Prozessarchitektur/01_Buchungsarchetypen.md index eac7d70..684ffbc 100644 --- a/docs/Prozessarchitektur/01_Buchungsarchetypen.md +++ b/docs/Prozessarchitektur/01_Buchungsarchetypen.md @@ -3,7 +3,7 @@ typ: archetypenkatalog titel: Buchungsarchetypen A1–A6 status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Buchungsarchetypen A1–A6 @@ -21,6 +21,8 @@ # Buchungsarchetypen A1–A6 **Partner-/Hub-Vertrieb ist kein A6.** Unterschiedliche Provisionen je Partner sind eine kaufmännische Eigenschaft des Ursprungskanals bzw. der Buchung; eine separate Partnerprozessklasse wird nicht benötigt. Telefon/manuell/iCal/E-Mail/API beschreiben Informations- oder Erfassungskanäle, keine eigenen Archetypen. +**v0.11-Präzisierung:** Der Communication Handler darf A1/A2-Anfragen mit fehlenden Daten nachfordern und beim eigenen Angebot erst nach vollständigen Pflichtangaben fortsetzen. Für A3–A5 gilt die externe Verbindlichkeit dagegen von Anfang an, auch wenn Gastdaten fehlen. Eine nachfolgende E-Mail oder ein Formular darf diese nicht in eine unverbindliche Anfrage verwandeln. Details stehen im [Communication-Handler-Querschnitt](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + ## Verhalten im gemeinsamen Prozess - **A1/A2:** Mit Hold > 0 kann nach geeigneter Belegungssicherung ein bindendes zeitlich befristetes Angebot verschickt werden. **Hold = 0:** reine Preis-/Verfügbarkeitsauskunft unter Vorbehalt; bei Buchungswunsch erneute Prüfung und Bestätigung entsprechend dem automatisch/manuell konfigurierten Modus. Die verbindliche Annahme eines gültigen eigenen Angebots erfordert **keine zweite Freigabe**. diff --git a/docs/Prozessarchitektur/02_Abwicklungsprofile_und_Dokumente.md b/docs/Prozessarchitektur/02_Abwicklungsprofile_und_Dokumente.md index 939dec3..0932ae6 100644 --- a/docs/Prozessarchitektur/02_Abwicklungsprofile_und_Dokumente.md +++ b/docs/Prozessarchitektur/02_Abwicklungsprofile_und_Dokumente.md @@ -3,28 +3,35 @@ typ: fachkonzept titel: Abwicklungsprofile, Einstellungen und Dokumente status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Abwicklungsprofile, Einstellungen und Dokumente ## Konfiguration: Vermieterstandard und Kanalabweichung -**Mandantenregel:** Jeder Vermieter legt seine eigenen **globalen Standardeinstellungen** fest. Für einen Kanal kann er einzelne Werte ausdrücklich überschreiben. Ein **nicht gesetzter Kanalwert** erbt den globalen Vermieterwert. Das gilt auch für `0`, `nein` und `manuell`: Diese bewusst eingestellten Werte sind **keine leeren Werte**. Objekt- und Vorgangskontext beeinflussen weiterhin Preis, Belegung und Vorlagenauswahl, soweit fachlich erforderlich; eine weitergehende Hierarchie wird nicht ohne Entscheidung eingeführt. +**Mandantenregel:** Jeder Vermieter legt seine eigenen **globalen Standardeinstellungen** fest. Für einen Kanal kann er einzelne Werte ausdrücklich überschreiben. Ein **nicht gesetzter Kanalwert** erbt den globalen Vermieterwert. Das gilt auch für `0`, `nein` und `manuell`: Diese bewusst eingestellten Werte sind **keine leeren Werte**. Die in der implementierten v0.10-Betriebskonfiguration dokumentierte Hierarchie **Vermieterstandard → Wohnung → Kanal × tatsächliche Eingangsart → Vorgangsentscheidung** ist für passende Geschäftsparameter zu verwenden; die konkreten Wirkungen und Herkunftswerte müssen sichtbar bleiben. Die technische Einpassung neuer Parameter wird am Repository-Code geprüft. Je nach Kanal **und tatsächlicher Eingangsart** werden relevante Regeln angewandt. Es gibt kein automatisches „alle FeWo-direkt-Buchungen sind gleich“. Die Konfiguration ist bewusst schlank: keine frei programmierbare Workflow-Engine erforderlich. | Konfigurationsbereich | Zweck | |---|---| | Automatisch/manuell | Anfrage, Buchungswunsch und zulässige Folgeaktionen nach wirksamem Vermieterstandard oder Kanalabweichung bearbeiten; individuelle manuelle Übernahme möglich | -| Haltefrist | Für eigene/unverbindliche Anfragen: `0` = kein Hold; `>0` = befristete Reservierung mit passend befristetem bindendem Angebot (z. B. 24/48/72 Stunden) | +| **Bestehende Angebots-Haltefrist** | **Unverändert:** Für eigene Angebote: `0` = Auskunft unter Vorbehalt ohne Angebots-Hold; `>0` = befristete Reservierung mit passend befristetem bindendem Angebot (z. B. 24/48/72 Stunden). **Nicht** die Klärungsreservierung. | +| **Vorgelagerter Klärungsblock (neu)** | Für unvollständige unverbindliche A1/A2-Anfragen getrennt konfigurierbar; bei `0` keine Klärungssperre, bei `>0` kurze tatsächliche Verfügbarkeitsabsicherung nach Wohnung/Zeitraum/E-Mail-Qualifikation. Ausgangswerte 15 Minuten automatisch / 180 Minuten manuell oder Freigabe; keine Verlängerung durch Nachrichten. | | Datenbeschaffung | Automatisch, manuell oder kombiniert; vorhandene, unvollständige und unbekannte Portalwerte unterscheiden | | Verantwortung | Vertrags-/Dokumentenversand, Gastkommunikation, Zahlung, Mahnung, Storno/Erstattung, lokale Leistungen, Kalender-/Sperrpflege | | Dokumentenprofil | Vorlagen und Anlagen abhängig von Vermieter, Objekt, Kanal, Eingangsart/Vorgangstyp und konkretem Vorgang | | Konditionsquelle | Eigene Jahres-/Saisonpreise bei eigenem Angebot oder verbindlich akzeptierter Portalpreis bei extern abgeschlossenem Vertrag | | Kanal-Fähigkeit | iCal/API/E-Mail/Portaloberfläche/manuell; Nachweis, Verzögerung, Vollständigkeit und erforderliche manuelle Schritte | -Bei **Hold = 0** ist die ursprüngliche Mitteilung **kein uneingeschränkt annehmbares Vertragsangebot**. Nach dem erneuten Verfügbarkeitscheck wird der Buchungswunsch gemäß wirksamem Modus automatisch bestätigt oder zur Vermieterentscheidung vorgelegt. Bei einem bereits verbindlich angenommenen Angebot oder extern geschlossenen Vertrag darf diese Wahl die entstandene Verbindlichkeit nicht nachträglich aufheben. +Bei **Angebots-Hold = 0** ist die ursprüngliche Mitteilung **kein uneingeschränkt annehmbares Vertragsangebot**. Nach dem erneuten Verfügbarkeitscheck wird der Buchungswunsch gemäß wirksamem Modus automatisch bestätigt oder zur Vermieterentscheidung vorgelegt. Bei einem bereits verbindlich angenommenen Angebot oder extern geschlossenen Vertrag darf diese Wahl die entstandene Verbindlichkeit nicht nachträglich aufheben. + +## Zentraler Kanalmanager (v0.11) + +**Alle** Kanäle einschließlich der eigenen Website werden an einem gemeinsamen fachlichen Verwaltungsort geführt. Dort werden vorhandene Kanaleigenschaften und Wohnungszuordnungen, iCal-Import/-Export mit Einstellungen und Status, tatsächliche Eingangsarten, Kommunikationswege und kanalabhängige Geschäftsparameter einschließlich des neuen Klärungsblocks zugänglich gemacht. Die bestehenden Vermieter- und Wohnungsstandards werden wiederverwendet, nicht als zweites Konfigurationsmodell kopiert. Die operative iCal-Synchronisation, Eingangserkennung und Buchungslogik bleiben außerhalb dieses Verwaltungsbausteins unverändert. + +Bei Datenbeschaffung wird **Rückfragemodus** (automatisch/Freigabe/manuell) unabhängig von der vorhandenen **Angebotsfreigabe** konfiguriert. Gültige Einstellungen sind pro Vorgang nachvollziehbar; `null` bedeutet Vererbung, `0` bedeutet ausdrücklich keine Klärungssperre. Vorgänge behalten ihr beim Eingang geltendes Profil nach der bisherigen Wirksamkeitsregel. Kommunikationsnachrichten müssen den **tatsächlichen** Sperrstatus und nicht nur den konfigurierten Wunschwert verwenden. Siehe [Konfiguration und Wirksamkeit](KONFIGURATION_UND_WIRKSAMKEIT.md) und [CH-Querschnitt](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). ## Dokumentarten und Auswahl diff --git a/docs/Prozessarchitektur/Entscheidungen.md b/docs/Prozessarchitektur/Entscheidungen.md index 0f43cdc..4a0cf6f 100644 --- a/docs/Prozessarchitektur/Entscheidungen.md +++ b/docs/Prozessarchitektur/Entscheidungen.md @@ -3,7 +3,7 @@ typ: entscheidungsregister titel: Gültige fachliche Entscheidungen status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Gültige fachliche Entscheidungen @@ -37,13 +37,21 @@ # Gültige fachliche Entscheidungen | E-023 | Einheitlicher Vorgang | Jeder qualifizierte Geschäftsfall ein Vorgang, keine separat anzulegende Buchungsakte; Belegungswirkung davon unterscheidbar. | | E-024 | A6 und Nebenleistungen | Je Anlass Gäste, Wäsche, Kurabgabe und Zahlungen möglich, auch bei Mietpreis 0; reine Sperre ohne Gast/Vertrag. | | E-025 | Dokumente steuern den Ablauf | Zutreffendes Vorlagen-/Dokumentenprofil (inkl. Bestätigungen) nach tatsächlichem Vorgang und Kanal wählen; konkrete Nachweise versionieren. | -| E-026 | Schlanker Angebotsweg | **Haltefrist als einzige Standardfrist**: >0 bindendes Angebot passend zur Belegung, 0 Auskunft unter Vorbehalt mit erneuter Prüfung vor Bestätigung; keine separate Preisbindefrist. | +| E-026 | Schlanker Angebotsweg | **Angebots-Haltefrist als einzige Standardfrist des bestehenden Angebotswegs**: >0 bindendes Angebot passend zur Belegung, 0 Auskunft unter Vorbehalt mit erneuter Prüfung vor Bestätigung; keine separate Preisbindefrist. Der **neue optionale vorgelagerte Klärungs-Kurzblock** für unvollständige Anfragen ist davon unabhängig und keine weitere Angebotsfrist. | | E-027 | Risikopragmatismus | Seltene Doppelbuchungen ernst nehmen, aber keine überdimensionierte Verfügbarkeits-/Risikoengine; reale Portalverzögerungen berücksichtigen. | | E-028 | Vorhandene Owner-Zuordnung | Bereits implementierte Herkunfts-/Owner-Erkennung wiederverwenden; zunächst Ist-Abgleich statt neuer paralleler Vorgangsstruktur. | | **E-029** | **Mandantenstandard/Vererbung** | **Globale Einstellungen gelten je Vermieter**; kanalindividuelle Werte überschreiben nur, wenn ausdrücklich gesetzt. Nicht gesetzt ≠ 0/aus/manuell. | | **E-030** | **Automatisierung je Kanal** | Eigener Abschluss nach Hold = 0 erfolgt nach erneuter Verfügbarkeitsprüfung **automatisch oder manuell nach wirksamer Einstellung**. Bereits bestehende verbindliche Buchungen benötigen keine zweite Freigabe. | | **E-031** | **Dokumentationsstruktur** | Fachliche Dokumente bilden eine hierarchische Prozesslandschaft und den **einen gültigen Stand** ab; wenige relevante relative Links, keine historischen Ergänzungsschichten; Änderungen in Git. | +| **E-032** | **Vorgelagerte Datenbeschaffung** | Unvollständige unverbindliche A1/A2-Anfragen sind zulässig; vor eigenem bindendem Angebot müssen Vorname, Nachname, vollständige Postanschrift, E-Mail, Zeitraum und Personenzahl plus die bestehenden Angebots-Gates erfüllt sein. Detailregel [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). | +| **E-033** | **Zwei getrennte Reservierungszwecke** | Optionaler Klärungsblock V0/V1 (für Wohnung, Zeitraum, E-Mail und bestandene Verfügbarkeitsprüfung; konfigurierbar 15 Minuten automatisch / 180 Minuten mit Freigabe oder manuell, je `0` möglich) geht der unveränderten Angebots-Vorreservierung voraus. | +| **E-034** | **Kanalspezifische Kommunikation** | Rückfrage, Teilantwort, Folgefrage und Erinnerung über Email oder signierten Ergänzungslink; mit Status-/Fristtexten, die nur tatsächlich wirksame Reservierungen behaupten. | +| **E-035** | **Quellen und KI** | Gemeinsamer Fakteneingang; bestehende Portalparser und iCal-Pfade bleiben; IMAP und risikobasierte kleine/große LLM-Extraktion liefern nur Kandidaten. Kontrollierte Übernahme abhängig von Phase und Feldkritikalität. | +| **E-036** | **Externe Bindung geschützt** | Bereits extern verbindliche Buchung bleibt auch bei fehlenden Gastdaten gültig; keine neue Angebotsannahme und keine Klärungsreservierung wegen fehlender Angaben. | +| **E-037** | **Zentraler Kanalmanager** | Führende fachliche Kanalverwaltung für eigenes Portal und externe Kanäle, iCal-Verbindungen, Kommunikations-/Geschäftseinstellungen und Vermieter-/Wohnungsstandards; operative iCal- und Buchungslogik bleibt bestehen. | +| **E-038** | **Änderungsgrenze MVP** | Vor Annahme: Änderungswunsch erkennen/zu manueller Bearbeitung geben. Nach Vertragsschluss: vertragsrelevante Änderungen manuell; administrative fehlende Fakten können kontrolliert ergänzt werden. Parallele bindende Angebotsvarianten und Fristverlängerung bleiben spätere P02-Spezifikation. | + ## Grenze fachlicher Freigabe Noch nicht entschieden sind insbesondere die vollständigen Abschluss-/Statuskriterien, rechtliche Einbeziehung konkreter Drittportalbedingungen, exakte örtliche Meldedaten und die tatsächliche Funktion einzelner Portalschnittstellen. Ein Coding-Agent darf technische Lösungen selbständig vorschlagen, **fachlich offene Regeln aber nicht als beschlossen ausgeben**. diff --git a/docs/Prozessarchitektur/Historie/CH_Entscheidungsstand_2026-11-03_v4.md b/docs/Prozessarchitektur/Historie/CH_Entscheidungsstand_2026-11-03_v4.md new file mode 100644 index 0000000..2473cde --- /dev/null +++ b/docs/Prozessarchitektur/Historie/CH_Entscheidungsstand_2026-11-03_v4.md @@ -0,0 +1,160 @@ +# FewoPortal – Communication Handler: konsolidierter fachlicher MVP-Stand + +**Stand:** 03.11.2026 · **Fassung 4** (CH-01 bis CH-18 unverändert im Beschlusskern; nachträgliche fachliche Präzisierungen und Kanalmanager ergänzt) +**Status:** Fachlich bestätigter Arbeitsstand mit ausdrücklich offenen Punkten; **keine normative Änderung** der Prozessarchitektur v0.10, **keine Implementierungsfreigabe, kein Coding-Agent-Auftrag**. +**Ausgangsbasis:** Prozessarchitektur **v0.10**, bereits vom Coding-Agenten umgesetzt. Vorhandene Angebots-Vorreservierung, Buchungs-/Stornierungslogik und regelbasierte iCal-Ereignisverarbeitung bleiben unverändert. +**Zweck:** Ein schlanker, erweiterbarer Communication Handler für eingehende Informationen, gezielte Datenbeschaffung und kontrollierte Übergabe an die bestehende Fachlogik. + +**Änderungsprinzip Fassung 4:** Die vollständige Fassung 3 bleibt die Textgrundlage. Diese Revision ergänzt ausschließlich bestätigte spätere Betreiberpräzisierungen (kurze Klärungsreservierung und deren Kommunikation, Direktbuchungsschutz, zentraler Kanalmanager einschließlich eigenes Portal). Bereits beschlossene CH-01 bis CH-18, Schnittstellen, Abnahmefälle und Ausbaustufen bleiben erhalten. Noch nicht entschiedene Standardwerte und die technische Einpassung in die tatsächlichen v0.10-Dateien werden nicht als Beschlüsse ausgegeben. + +## 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 Einpassung in den tatsächlich vorhandenen Konfigurationsbestand wird vor der Normierung 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. Nachträglich bestätigte fachliche Präzisierungen (ohne neue CH-Sonderfallserie) + +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. **Zielarchitektur beschlossen, konkrete Abbildung im Datenmodell der v0.10 noch anhand der Originaldokumente zu verifizieren.** 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 wird nach Bereitstellung des v0.10-Dokumentensatzes abgeglichen; 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 nach Sichtung des Repositories. 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. Normative Übergabe und Quellen + +**Nächster formaler Schritt:** Nach Bereitstellung des **vollständigen tatsächlich gültigen v0.10-Dokumentensatzes aus dem Repository** die bestehenden Dokumente mit dieser **Fassung 4** abgleichen und ein gezieltes Delta **v0.10 → v0.11** in den jeweils zuständigen normativen Dokumenten (z. B. K00/G00/P01, P02 später) ableiten, statt weiterer unverbundener Anhänge. Bis dahin ist **v0.10 unverändert**; insbesondere Angebots-Vorreservierung, bereits verbindliche Portalbuchungen, iCal-Ereignislogik und Buchungs-/Stornierungsregeln. + +**Quellengrundlage:** + +- `FewoPortal_SESSION_UEBERGABE_Datenbeschaffung_2026-11-02.md` (Session-Übergabe, Abschnitte A–N). +- `FewoPortal_Architekturentscheid_Kommunikationshandler_MVP_2026-11-02.md`. +- `FewoPortal_Entscheidungsstand_Aktualisiert.md` sowie `FewoPortal_Entscheidungsstand_Datenbeschaffung_und_Reservierungen_2026-11-02.md`. +- Konsolidierung Fassung 2 und **Fassung 3** vom 03.11.2026 sowie die **expliziten Entscheidungen CH-14 bis CH-18**. Diese haben im betroffenen Bereich Vorrang vor älteren MVP-Ausschlüssen von IMAP und KI-Extraktion. +- **Spätere Betreiberpräzisierungen im Gespräch vom 03.11.2026** zu Klärungsblock-Mindestdaten, differenzierten Nachrichtentexten (`0`/aktiv/abgelaufen), Verbindlichkeit externer Direktbuchungen und zentralem Kanalmanager inklusive eigenem Portal und iCal-Einstellungen. + +**Revisionsnachweis Fassung 4 (gegen Fassung 3):** Nicht gekürzt: CH-01–CH-18, sechsteiliger Schnittstellenvertrag, Kommunikationsablauf, MVP-Abgrenzung, P02-Ausbaupunkte. Ergänzt: vier querschnittliche Betreiberpräzisierungen, zustandsabhängige Kommunikation, Kanalmanager-Konfigurationsfluss, zwei fokussierte Abnahmefälle M11–M12, Bereinigung der überholten offenen Mindestqualifikationsfrage. **Keine** Behauptung, die v0.11 sei bereits normiert, die v0.10-Dokumente lägen vollständig vor oder die genannten Funktionen seien bereits implementiert. + +**Statuslegende:** **Beschlossen** = ausdrücklich bestätigtes fachliches Ziel; **Bestand** = unveränderte v0.10; **Offen** = weitere Entscheidung/Prüfung erforderlich; **Später** = kein MVP-Umfang. Konkrete Modell-, Prompt-, Schwellen- und Rechtsprüfungen sind noch **nicht** als bereits abgeschlossen dokumentiert. diff --git a/docs/Prozessarchitektur/Historie/Prozessarchitektur_v0.10_ORIGINAL.zip b/docs/Prozessarchitektur/Historie/Prozessarchitektur_v0.10_ORIGINAL.zip new file mode 100644 index 0000000..47994a9 Binary files /dev/null and b/docs/Prozessarchitektur/Historie/Prozessarchitektur_v0.10_ORIGINAL.zip differ diff --git a/docs/Prozessarchitektur/ARCHITEKTURAUDIT_EINGANG_DATENANREICHERUNG.md b/docs/Prozessarchitektur/Implementierungsstände/ARCHITEKTURAUDIT_EINGANG_DATENANREICHERUNG.md similarity index 100% rename from docs/Prozessarchitektur/ARCHITEKTURAUDIT_EINGANG_DATENANREICHERUNG.md rename to docs/Prozessarchitektur/Implementierungsstände/ARCHITEKTURAUDIT_EINGANG_DATENANREICHERUNG.md diff --git a/docs/Prozessarchitektur/END_TO_END_ABNAHME.md b/docs/Prozessarchitektur/Implementierungsstände/END_TO_END_ABNAHME.md similarity index 100% rename from docs/Prozessarchitektur/END_TO_END_ABNAHME.md rename to docs/Prozessarchitektur/Implementierungsstände/END_TO_END_ABNAHME.md diff --git a/docs/Prozessarchitektur/Implementierungsstände/ENTSCHEIDUNGSPAPIER_EINGANG_UND_GASTLINK.md b/docs/Prozessarchitektur/Implementierungsstände/ENTSCHEIDUNGSPAPIER_EINGANG_UND_GASTLINK.md new file mode 100644 index 0000000..dcf8b5d --- /dev/null +++ b/docs/Prozessarchitektur/Implementierungsstände/ENTSCHEIDUNGSPAPIER_EINGANG_UND_GASTLINK.md @@ -0,0 +1,138 @@ +# Entscheidungspapier: Universeller Eingang, Datenbeschaffung und persönlicher Gastlink + +**Stand:** 02.11.2026 · **Zweck:** Vorlage für die Strategie-Session zu den Eingangskanälen · **Status:** Arbeitsgrundlage, **nicht normativ**. Die Spezifikation v0.10 bleibt unverändert, bis die Ergebnisse der Session in v0.11 übernommen sind. + +Grundlage: [Architekturaudit Eingang und Datenanreicherung](ARCHITEKTURAUDIT_EINGANG_DATENANREICHERUNG.md), das Testen auf dem Testsystem und die Abstimmung mit dem Betreiber am 02.11.2026. + +--- + +## 1. Ausgangslage in drei Sätzen + +FewoPortal nimmt Vorgänge heute über feste Wege an: Webseite, iCal, Portal-Mail und Eingabe von Hand. Fehlende Angaben beschafft immer die Vermieterin von Hand. Die Einstellungen sind auf drei Orte verteilt, und die eigene Webseite ist kein eigener, einstellbarer Kanal. Der Vorgangskern trägt eine Erweiterung, eine neue Ablaufsteuerung ist nicht nötig (Audit §1). + +## 2. Bereits entschieden + +| # | Entscheidung | +|---|---| +| E1 | Es gibt **einen universellen Eingang**. Jede Quelle trägt Angaben zu einem Vorgang bei: Webseite, iCal, Portal-Mail, Gast-Mail, Chat, API, persönlicher Link, Eingabe von Hand. Der Posteingang wird darauf geprüft, ob weitere Angaben zu einem bestimmten Vorgang eingetroffen sind. | +| E2 | Fehlen Angaben, kann der Gast **angeschrieben und um die Angaben gebeten** werden. Er gibt sie auf einer Seite bei uns über einen **persönlichen Link** ein. | +| E3 | Über den Link sieht der Gast **alle seine Daten** und darf sie **korrigieren**. Dass ein Link weitergeleitet werden kann, wird hingenommen. | +| E4 | Der Link zeigt **je nach Stand des Vorgangs andere Inhalte**. Einen „Annehmen“-Knopf gibt es nur, solange ein Angebot zur Annahme offen ist. | +| E5 | **Ändern vor Annahme des Angebots** wird als schaltbare Einstellung vorgesehen. Wird sie genutzt, geht ein **geändertes Angebot** hinaus. Ändert der Gast die Termine, wird die **Verfügbarkeit neu geprüft**. | +| E6 | **Änderungen nach Vertragsschluss** und der Umgang mit **Verkürzungen in den Stornozeiträumen** werden gesondert entschieden (§5 E). | +| E7 | Die Seite „Eingangskanäle“ und die Pflichtangaben werden **erst nach der Session** gebaut, damit nichts zweimal entsteht. | + +## 3. Zielbild + +### 3.1 Bausteine + +Der Eingang besteht aus sechs festen Bausteinen, nicht aus einer allgemeinen Ablaufmaschine: + +1. **Quellen-Adapter:** Jede Quelle macht aus ihrer Eingabe einen *Beitrag*, also Angaben mit Herkunft, Zeitpunkt und Verlässlichkeit. Eine neue Quelle ist ein neuer Adapter. +2. **Zuordnung zum Vorgang:** über Buchungsnummer, persönlichen Link oder eine eigene Antwortadresse je Vorgang. Unklare Fälle werden zur Klärung, gleiche Termine allein beweisen keine Identität. +3. **Zusammenführen:** Eine feste Rangfolge der Quellen gilt. Bei Widerspruch entsteht eine Klärungsaufgabe, nichts wird stillschweigend überschrieben. Jede Änderung steht im Verlauf. +4. **Pflichtangaben je Schritt** (Angebot, Bestätigung, Anreise …), je Kanal einstellbar. +5. **Beschaffung:** Rückfrage per Link, Erinnerungen, Übergabe an die Vermieterin. +6. **Weiterführen:** ein einziger Einstieg, der den Vorgang danach fortsetzt, automatisch oder nach Freigabe. + +### 3.2 Persönlicher Gastlink je Stand des Vorgangs (Vorschlag) + +| Stand | Der Gast sieht | Der Gast kann | Folge | +|---|---|---|---| +| Anfrage, Angaben fehlen | Anfrage, Termine, Preis, seine Daten; Fehlendes hervorgehoben | ergänzen und korrigieren | Prüfung auf Vollständigkeit, dann weiter laut Einstellung (Angebot oder Auskunft) | +| Auskunft unter Vorbehalt (Paket 7) | Auskunft, seine Daten | Daten korrigieren, Buchung anfragen | wie heute; geänderte Termine: neue Prüfung | +| Angebot offen | Angebot mit „Annehmen“, seine Daten | annehmen; Daten oder Termine ändern, wenn eingeschaltet | geändertes Angebot mit neuer Version, der alte Link wird ungültig; bei neuen Terminen erst die Verfügbarkeitsprüfung | +| Buchung verbindlich | Bestätigung, Zahlungen, seine Daten | Daten korrigieren; Änderung **beantragen** (nach §5 E) | Kontaktdaten: Mitteilung; Termine und Leistungen: Antrag an die Vermieterin | +| Vor der Anreise | Anreise-Infos | Anreisezeit, ggf. Meldedaten | Aufgaben der Vorbereitung | +| Portalbuchung | Buchungsdaten laut Portal | Kontaktdaten korrigieren, Anreisezeit | Termine und Preis ändert nur das Portal | + +**Sicherheit:** Jede Korrektur steht im Verlauf. Der Gast bekommt eine kurze Mitteilung an die **bisherige** Adresse, bei einer geänderten E-Mail-Adresse an beide. So fällt Missbrauch auf, ohne dass der Gast einen Code eingeben muss. Die Technik ist die vorhandene: signiert, versioniert, mit Ablauf und Begrenzung der Aufrufe. + +## 4. Empfohlene Reihenfolge + +1. **v0.11 ergänzen:** den Baustein „Eingang und Datenbeschaffung“ und die Entscheidungen aus §5. +2. **Kern:** Beiträge mit Herkunft, Pflichtangaben je Schritt und ein Einstieg zum Weiterführen. Am Vorgang wird sichtbar, was fehlt und woher eine Angabe stammt. +3. **Persönlicher Gastlink**, zuerst mit den Ständen „Anfrage, Angaben fehlen“ und „Angebot offen“. Das löst auch die fehlende Anschrift aus dem Webformular richtig. +4. **Seite „Eingangskanäle“:** alle Einstellungen an einer Stelle. Die eigene Webseite und „Telefon/E-Mail“ werden Kanäle wie die Portale. +5. **Änderung nach Vertragsschluss beantragen**, mit Teilstorno-Berechnung. +6. **Posteingang:** Antwortadresse je Vorgang, Antworten und Gast-Mails erkennen. +7. **Weitere Adapter:** Chat, API, KI-Vorschläge. + +Der Link kommt vor dem Posteingang, weil er geordnete und verlässliche Angaben liefert, der Posteingang dagegen ungeordnete. + +## 5. Offene Entscheidungen mit Empfehlung + +### A. Eingang und Zuordnung + +| # | Frage | Empfehlung | +|---|---|---| +| A1 | Welche Quellen in welcher Reihenfolge? Chat und API: was genau, mit welchen Anbietern? | Reihenfolge wie §4; Chat und API erst mit konkretem Anbieter festlegen | +| A2 | Wie werden Mails einem Vorgang zugeordnet? | eigene Antwortadresse je Vorgang (z. B. `anfrage+2026-0007@…`), sonst Buchungsnummer; ohne beides wird die Mail zur Klärung | +| A3 | Bleibt die heutige automatische Zuordnung „gleiches Portal, gleiche Nächte, ohne Buchungsnummer“? | künftig als **Klärung**, nicht mehr automatisch | +| A4 | Darf das System alle Mails im Postfach lesen? Welche Löschfrist gilt? | nur ein eigenes Gästepostfach; Löschfrist wie beim Vorgang; Eintrag in den Datenschutzhinweisen | +| A5 | Wie weit wird KI genutzt, um Mails und Chats auszuwerten? | anfangs nur **Vorschläge mit Bestätigung**; Anschrift, Preis und Termine nie ungeprüft übernehmen | +| A6 | Welche Quelle gewinnt bei Widerspruch? | Vermieterin vor Gast über den Link vor Portal-Mail vor Kalender; ein Widerspruch zu einer schon bestätigten Angabe führt immer zur Klärung | +| A7 | Testbetrieb | eingehende Daten werden als **simuliert** markiert und lösen keine echten Folgen aus | + +### B. Pflichtangaben + +| # | Frage | Empfehlung | +|---|---|---| +| B1 | Was braucht das **Angebot**? | Vorname, Nachname, E-Mail, vollständige Anschrift (Straße, PLZ, Ort, Land), Personenzahl; Telefon freiwillig | +| B2 | Was braucht die **Bestätigung**? | wie B1 | +| B3 | Was braucht die **Anreise**? | Meldedaten nach rechtlicher Prüfung (§§ 29 f. BMG, Umfang nicht geprüft) | +| B4 | Fragt die Webseite fehlende Pflichtangaben gleich im Formular ab oder später per Link? | je Kanal einstellbar; Grundeinstellung: kurze Anfrage zulassen, fehlende Angaben per Link nachfordern | + +### C. Beschaffung und Haltefrist + +| # | Frage | Empfehlung | +|---|---|---| +| C1 | Geht die Rückfrage automatisch hinaus oder erst nach Freigabe? | je Kanal einstellbar; zu Beginn „nach Freigabe“ | +| C2 | Erinnerungen und Eskalation | eine Erinnerung nach 24 h, danach eine Aufgabe für die Vermieterin | +| C3 | Wann beginnt die Haltefrist: bei Eingang oder erst bei vollständigen Angaben? | bei Eingang; eine Rückfrage verlängert sie **nicht** stillschweigend (Konzept_workflows F1 Nr. 4) | +| C4 | Was gilt, wenn der Gast nach Ablauf der Frist antwortet? | neue Verfügbarkeitsprüfung, der Vorgang lebt wieder auf, wenn der Zeitraum frei ist | + +### D. Ändern vor Annahme des Angebots + +| # | Frage | Empfehlung | +|---|---|---| +| D1 | Ist eine Terminänderung ein neuer Vorgang? | nein, derselbe Vorgang mit neuer Angebotsversion | +| D2 | Läuft die Haltefrist nach einer Terminänderung neu an? | **nein**, sonst ließe sich ein Termin durch ständiges Ändern dauerhaft blockieren | +| D3 | Geänderte Termine, Preis oder Mindestnächte | alles neu prüfen und berechnen wie beim Buchungswunsch (Paket 7); ist alles in Ordnung und gilt Automatik, geht das neue Angebot sofort hinaus, sonst entsteht eine Aufgabe | +| D4 | Wie oft darf der Gast ändern? | höchstens drei Änderungen je Vorgang, danach nur noch über die Vermieterin | + +### E. Änderungen nach Vertragsschluss + +Heute kann die Vermieterin eine Buchung ändern (Paket 5): als schon vereinbart oder als Vorschlag mit Zustimmung des Gastes. **Lücke:** Bei einer Verkürzung wird der Preis für die kürzere Zeit neu berechnet, die Stornostaffel gilt für die wegfallenden Nächte **nicht**. + +| # | Frage | Empfehlung | +|---|---|---| +| E1 | Darf der Gast nach Annahme selbst Änderungen beantragen, und welche? | ja (Termine, Personen, Leistungen), wirksam erst nach Bestätigung durch die Vermieterin, nie automatisch | +| E2 | Wie werden wegfallende Nächte bei einer Verkürzung behandelt? | als **Teilstorno**: Auf den Preis der wegfallenden Nächte gilt der Satz der Stornostaffel zum Zeitpunkt der Änderung | +| E3 | Kulanz | nach Ermessen der Vermieterin, im Vorgang als Abschlag mit Begründung; Hinweis, wenn die Nächte anderweitig vermietet wurden | +| E4 | Verschieben bei gleicher Länge | bis zu einer Frist kostenlos (Vorschlag: 60 Tage vor Anreise), danach nur nach Freigabe | +| E5 | Verlängern | Verfügbarkeit prüfen und Mehrpreis berechnen, keine Staffel (wie heute) | +| E6 | Portalbuchungen | Es gelten die Regeln des Portals; der Link zeigt nur Kontaktdaten und Anreisezeit | + +**Rechtlich:** Eine Teilstorno-Regel wirkt nur, wenn die Mietbedingungen sie ausdrücklich enthalten. Sie gehört zur ohnehin offenen rechtlichen Prüfung (Gesamtabnahme §4). + +### F. Konfiguration + +| # | Frage | Empfehlung | +|---|---|---| +| F1 | Eine Seite „Eingangskanäle“ für alle Einstellungen? | ja: oben „Alle Kanäle“ (die heutigen Grundeinstellungen), darunter Webseite, Telefon/E-Mail und je Portal; je Eintrag die Bereiche Ablauf, Pflichtangaben, Beschaffung und Technik | +| F2 | Was bleibt auf „So arbeite ich“? | nur die Dokumentfreigaben, oder die Seite geht ganz in „Eingangskanäle“ auf | +| F3 | Abweichungen je Wohnung | bleiben bei der Wohnung, werden auf „Eingangskanäle“ aber angezeigt | +| F4 | Wird die Herkunft (z. B. Hub direkt oder über ein Partnerportal) eine dritte Einstellungsstufe? | nein, bis ein konkreter Fall es erfordert | + +### G. Vermarktung + +| # | Frage | Empfehlung | +|---|---|---| +| G1 | Wird ein Interessent aus Social Media oder einer Kampagne ein eigener Vorgangstyp? | nein, bis V02 entschieden ist; bis dahin werden Herkunft und Kampagnenkennung am Vorgang gespeichert | + +## 6. Was bis zur Session nicht geändert wird + +- Kein Bau der Kanal-Seite, der Pflichtangaben und des Links. +- Das Webformular bleibt, wie es ist: Die Anschrift ist freiwillig. Ein Angebot ohne Anschrift hält in der Automatik an und ist von Hand nur mit Bestätigung möglich. +- v0.10 wird auf dem Testsystem weiter abgenommen. diff --git a/docs/Prozessarchitektur/GESAMTABNAHME_v0.10.md b/docs/Prozessarchitektur/Implementierungsstände/GESAMTABNAHME_v0.10.md similarity index 100% rename from docs/Prozessarchitektur/GESAMTABNAHME_v0.10.md rename to docs/Prozessarchitektur/Implementierungsstände/GESAMTABNAHME_v0.10.md diff --git a/docs/Prozessarchitektur/Implementierungsstände/KONFIGURATION_UND_WIRKSAMKEIT.md b/docs/Prozessarchitektur/Implementierungsstände/KONFIGURATION_UND_WIRKSAMKEIT.md new file mode 100644 index 0000000..0e7e2d5 --- /dev/null +++ b/docs/Prozessarchitektur/Implementierungsstände/KONFIGURATION_UND_WIRKSAMKEIT.md @@ -0,0 +1,120 @@ +# Konfiguration und Wirksamkeit + +Dieses Dokument beschreibt, welche fachlichen Einstellungen es gibt, wo man sie vornimmt und wie sie sich vererben. Es zeigt auch, wie man nachprüft, dass sie in einem Vorgang wirklich angewandt wurden. Stand 02.11.2026, Pakete 1–9. + +--- + +## 1. Wo man die Wirksamkeit sieht + +| Werkzeug | Zeigt | +|---|---| +| **System › Wirksame Einstellungen** (Expertenansicht) | Für jede Wohnung und jeden Eingangsweg den Wert jeder Prozesseinstellung, der für einen **neuen** Vorgang gilt, mit Herkunft und Ort der Änderung. Eingangswege: direkte Anfrage, je Portal Anfrage und feste Buchung, A6. Neu ist die Zeile „Antwort auf eine Anfrage“: Angebot mit Reservierung, Auskunft unter Vorbehalt oder keine. Je Wohnung steht die Zeile „Aufenthalt“: Anreisezeit, Aufgaben je Aufenthalt, Kurabgabe. „Einen Vorgang prüfen“ zeigt dessen festgehaltenes Profil, eine Umstellung im Vorgang, das Dokument, das er jetzt braucht, und beide Abschlüsse mit den offenen Punkten. | +| **Vorgang › Ablauf** | Jede Aktivität mit Zustand: erledigt, übernimmt das Portal, zu tun, wartet, später oder entfällt. Dazu kommen Aufgaben mit Zuständigkeit und Erledigungsnotiz sowie beide Abschlüsse. | +| **Vorgang › Technische Angaben** (Experte) | eingefrorenes Abwicklungsprofil mit Herkunft je Wert | +| `php artisan process:settings-report` | alle Standards und Abweichungen als Text | +| `php artisan cases:recheck-payment-status` | Vorgänge, deren gespeicherter Zahlungsstatus der neuen Regel widerspricht (Vorschau) | + +Nachweise: `test_t12_…`, `test_t24_…`; Screenshots `Abnahme/2026-11-01/T12-wirksame-einstellungen.png` und `Abnahme/2026-11-02/T24-wirksame-einstellungen.png`. + +--- + +## 2. Vererbung + +``` +Grundeinstellung (im Code) + → Ihr Standard System › So arbeite ich + → Wohnung Wohnung bearbeiten › „Abweichende Abwicklung dieser Wohnung“ (Experte) + → Portal je Eingangsart Portal bearbeiten › „Anfragen über dieses Portal“ / „Feste Buchungen über dieses Portal“ + → Vorgang Schalter „Läuft automatisch / Sie geben frei“, Wahl Angebot statt Auskunft, Aufgaben +``` + +- **Leer heißt „erbt“.** Ein bewusst gesetztes „nein“, „0“ oder „manuell“ ist ein eigener Wert. +- **Eingefroren beim Eingang.** Ein Vorgang behält die Werte von seinem Eingang. Ausnahme ist die Vertragsvorlage: Sie wird erst festgehalten, wenn das Dokument erstellt wird. +- **A6 fest:** Unterlagen, Zahlungen und Gastmails „Entfällt“. +- **Anfragen:** Unterlagen schicken immer wir. +- **Vorgangsart aus den wirksamen Werten:** A1/A2 Anfrage (direkt bzw. über Portal); A3 wir kassieren und schicken Unterlagen, A4 Portal kassiert, A5 Portal schickt Unterlagen; A6 intern. + +--- + +## 3. Einstellbare Prozessparameter + +| Einstellung | Standard | Übersteuerbar auf | Wirkung | +|---|---|---|---| +| Bearbeitung (automatisch / Sie geben frei) | Sie geben frei | Vermieter, Wohnung, Portal (Anfrage und Buchung), Vorgang | Angebote, Auskünfte und Unterlagen gehen ohne Klick hinaus, sobald nichts fehlt. Ein Buchungswunsch wird automatisch nur bestätigt, wenn die erneute Prüfung ohne jeden Befund ist (Paket 7). | +| Reserviert eine Anfrage den Zeitraum? | ja | Vermieter, Wohnung, Portal (Anfrage) | **ja:** Angebot mit Annahmelink, Zeitraum reserviert bis zum Ablauf. **nein:** unverbindliche Auskunft mit „Buchung anfragen“, kein Eintrag im Kalender, erneute Prüfung vor der Bestätigung (Paket 7). | +| Gültigkeit Angebot bzw. Auskunft | 48 Stunden | Vermieter, Wohnung, Portal (Anfrage) | Frist des Angebots und der Reservierung bzw. bis wann der Gast aus der Auskunft anfragen kann; danach endet die Anfrage ohne Buchung | +| Wer schickt Vertrag bzw. Unterlagen? | Wir | Vermieter, Wohnung, Portal (Buchung) | Portal → A5, keine eigenen Unterlagen | +| Wer kümmert sich um die Zahlungen? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → A4: keine Mahnungen. „Laut Portal bezahlt“ ändert den Status nicht. Nach dem Aufenthalt entsteht die Aufgabe „Auszahlung des Portals prüfen“. | +| Wer schickt Anreise-Info und Bewertungsbitte? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → „durch Portal (angekündigt)“, keine eigenen Mails | +| Anreise-Info Tage vorher | 3 | Vermieter, Wohnung | Zeitpunkt der Anreisemail. Die Anreisedaten werden 2 Tage davor geprüft. | +| Vertragsvorlage | Texte der Webseite | Wohnung, Portal, Vorgang (Zusammenstellung) | Inhalt von Angebot, Auskunft, Bestätigung und Unterlagen | + +## 4. Weitere Einstellungen + +| Einstellung | Wo | Ebene | Wirkung | +|---|---|---|---| +| **Anreisezeit erfragen** (neu) | Wohnung › Aufenthalt vorbereiten und abschließen | Wohnung | Fehlt die Anreisezeit, entsteht die Aufgabe „Anreisedaten beim Gast erfragen“. Kontaktdaten werden immer geprüft (nicht bei A6). | +| **Aufgaben je Aufenthalt** (neu) | Wohnung › Aufenthalt vorbereiten und abschließen | Wohnung | Je Zeile: Was, Wann (Tage vor Anreise / am Anreisetag / am Abreisetag), Wer, für welche Art von Aufenthalt (Gästebuchungen, Familie/Freunde, eigene Nutzung, Sperren). Daraus wird je Aufenthalt eine Aufgabe, die den Aufenthaltsabschluss aufhält, bis sie erledigt oder übergeben ist. | +| Gebuchte Leistungen | Wohnung › Zusatzleistungen | Wohnung | werden automatisch zu „Bereitstellen: …“ (nur bei eigenem Preis bzw. A6) | +| Kurabgabe je Person und Nacht | Wohnung › Preise | Wohnung | Position bei A6 | +| Erkannte Buchungen übernehmen | Portal | Kanal | Aus / Beobachten / Anlegen / Anlegen und weiter (Paket 4) | +| Was kommt über dieses Portal? | Portal | Kanal | Sofortbuchungsschutz (`CalendarClearance`) | +| Zusätzlich von Hand sperren | Portal | Kanal | Portalaufgaben mit Nachweisstufe | +| Freigabe der Dokumentarten | So arbeite ich › Dokumente | Vermieter | Arbeitsfassungen gehen nie automatisch hinaus. Neu ist die Dokumentart „Auskunft unter Vorbehalt“; solange sie nicht freigegeben ist, wird nicht automatisch geantwortet. | +| Freigabe einer Vorlage | Vorlagen › Freigabe | Vorlagenversion | Schutz vor unvereinbarten Bedingungen | +| Testbetrieb / Testadresse | System › Betrieb | Vermieter (Server-Vorgabe `FEWO_MAIL_REDIRECT_TO` gewinnt) | Jede ausgehende Mail nur an die Testadresse; der Verlauf vermerkt es. iCal-Abgleich bleibt aktiv. | +| Anzahlungsfrist, Bewertung nach Tagen | System › Betrieb | Vermieter | Zahlungsplan, Bewertungsbitte | + +**Im einzelnen Vorgang übersteuerbar:** +- Bearbeitungsart +- Vorlage (im Dokument) +- bei Haltefrist 0 „Stattdessen verbindliches Angebot mit Reservierung senden“ +- Preis bei der Bestätigung eines Wunsches (Preis der Auskunft oder ein niedrigerer heutiger Preis) +- eigene Aufgaben, Abweichungen und Folgeaufgaben; Aufgaben als erledigt, übergeben oder entfällt markieren +- Aufenthalt von Hand abschließen +- kaufmännischer Abschluss mit Begründung + +**Fest im Code:** +- Vorbereitung 14 Tage im Voraus +- Anreisedaten-Prüfung 2 Tage vor der Anreise-Info +- Auszahlungsprüfung am Tag der Abreise + 14 +- Abschluss in der Nacht nach der Abreise + +--- + +## 5. Sonderfälle nur über Konfiguration + +| Sonderfall | Konfiguration | +|---|---| +| Ein Portal leitet nur Anfragen weiter, die nichts blockieren sollen | Portal › Anfragen: „Reservieren? nein“ → Auskunft statt Angebot (T24) | +| Diese Wohnung wird von Hand bearbeitet, die andere automatisch | Wohnung › Abweichende Abwicklung: Bearbeitung | +| Schlüsselübergabe nur bei Gästen, Endreinigung auch bei Familie | Aufgaben je Aufenthalt mit „Bei“ (T19, T21) | +| Ein Gast soll trotz Haltefrist 0 ein bindendes Angebot erhalten | im Vorgang „Stattdessen verbindliches Angebot …“ | +| Portal schickt Anreise-Info selbst | Portal › Feste Buchungen: „Anreise-Info und Bewertung: Portal“ (T20) | +| Kleine Auszahlungsdifferenz akzeptieren | im Vorgang „Kaufmännisch abschließen …“ mit Begründung (T22) | + +--- + +## 6. Nachweis an konkreten Vorgängen + +| Konstellation | Erwartung | Beobachtet | +|---|---|---| +| Standard automatisch, Wohnung 24 h, direkte Anfrage | automatisch (Standard), 24 h (Wohnung) | identisch (T12) | +| FeWo-direkt feste Buchung, Zahlung Portal | A4, keine Mahnung, Status bleibt „Bestätigt“ trotz „laut Portal bezahlt“ | identisch (T04, T20) | +| Standard mit Reservierung, Ostseeklar-Anfragen ohne Reservierung und manuell | direkte Anfrage: Angebot und Reservierung. Ostseeklar: keine Reservierung, Aufgabe „Auskunft senden“ | identisch (T24) | +| Ostseeklar-Anfrage im Vorgang auf automatisch | Auskunft sofort, Wunsch automatisch bestätigt | identisch (T24) | +| Wohnung Anreise-Info 5 Tage, Anreisezeit erfragen | Anreisedaten-Aufgabe 7 Tage, Anreisemail 5 Tage vorher | identisch (T24) | +| Automatisch, aber Preis geändert bzw. Kalender veraltet | keine Automatik, Aufgabe mit Befunden | identisch (T17) | +| Familienbesuch | Unterlagen, Zahlungen, Mails „Entfällt“; Aufgaben je Aufenthalt „Familie“ wirken | identisch (T09, T21) | + +--- + +## 7. Lücken und widersprüchliche Stellen + +| Stelle | Beschreibung | Empfehlung | +|---|---|---| +| Buchungsmodell am Portal und Profil | „Was kommt über dieses Portal?“ und das Profil je Eingangsart können sich widersprechen. | Modell aus den Eingangsarten ableiten oder einen Hinweis im Portalformular zeigen. | +| Alte Spalten | `properties.hold_hours`, `pre_reservation_enabled`, `arrival_info_days_before` u. a. werden nicht mehr gelesen. | Nach erfolgreicher Migration auf Produktion entfernen. | +| Aufgaben je Aufenthalt | nur je Wohnung, nicht je Portal | ausreichend für 1–3 Wohnungen | +| Feste Fristen | Vorbereitung, Anreisedaten-Prüfung, Auszahlungsprüfung | einstellbar machen, wenn Erfahrungswerte vorliegen | +| Gültigkeit der Auskunft | dieselbe Einstellung wie das Angebot | bewusst so (E-026) | diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P1_P2.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P1_P2.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P3.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P3.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P4.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P4.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P5_P6_P8.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P5_P6_P8.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P5_P6_P8.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P5_P6_P8.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P7_P9.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P7_P9.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P7_P9.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_P7_P9.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSPLAN_v0.10.md b/docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSPLAN_v0.10.md similarity index 100% rename from docs/Prozessarchitektur/UMSETZUNGSPLAN_v0.10.md rename to docs/Prozessarchitektur/Implementierungsstände/UMSETZUNGSPLAN_v0.10.md diff --git a/docs/Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md b/docs/Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md index 0e7e2d5..d2686d1 100644 --- a/docs/Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md +++ b/docs/Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md @@ -1,6 +1,6 @@ # Konfiguration und Wirksamkeit -Dieses Dokument beschreibt, welche fachlichen Einstellungen es gibt, wo man sie vornimmt und wie sie sich vererben. Es zeigt auch, wie man nachprüft, dass sie in einem Vorgang wirklich angewandt wurden. Stand 02.11.2026, Pakete 1–9. +Dieses Dokument beschreibt, welche fachlichen Einstellungen es gibt, wo man sie vornimmt und wie sie sich vererben. Es zeigt auch, wie man nachprüft, dass sie in einem Vorgang wirklich angewandt wurden. Bestand der Pakete 1–9 vom 02.11.2026, um die **fachlichen v0.11-Zielparameter** ergänzt; deren Implementierung ist noch nicht nachgewiesen. --- @@ -41,14 +41,28 @@ ## 3. Einstellbare Prozessparameter | Einstellung | Standard | Übersteuerbar auf | Wirkung | |---|---|---|---| | Bearbeitung (automatisch / Sie geben frei) | Sie geben frei | Vermieter, Wohnung, Portal (Anfrage und Buchung), Vorgang | Angebote, Auskünfte und Unterlagen gehen ohne Klick hinaus, sobald nichts fehlt. Ein Buchungswunsch wird automatisch nur bestätigt, wenn die erneute Prüfung ohne jeden Befund ist (Paket 7). | -| Reserviert eine Anfrage den Zeitraum? | ja | Vermieter, Wohnung, Portal (Anfrage) | **ja:** Angebot mit Annahmelink, Zeitraum reserviert bis zum Ablauf. **nein:** unverbindliche Auskunft mit „Buchung anfragen“, kein Eintrag im Kalender, erneute Prüfung vor der Bestätigung (Paket 7). | -| Gültigkeit Angebot bzw. Auskunft | 48 Stunden | Vermieter, Wohnung, Portal (Anfrage) | Frist des Angebots und der Reservierung bzw. bis wann der Gast aus der Auskunft anfragen kann; danach endet die Anfrage ohne Buchung | +| **Angebotsreservierung**: Reserviert eine vollständige Anfrage beim eigenen Angebot den Zeitraum? | ja | Vermieter, Wohnung, Portal (Anfrage) | **ja:** Angebot mit Annahmelink, Zeitraum reserviert bis zum Ablauf. **nein:** unverbindliche Auskunft mit „Buchung anfragen“, kein Eintrag im Kalender, erneute Prüfung vor der Bestätigung (Paket 7). | +| **Gültigkeit des Angebots bzw. der Auskunft (Bestand)** | 48 Stunden | Vermieter, Wohnung, Portal (Anfrage) | Frist des Angebots und der Reservierung bzw. bis wann der Gast aus der Auskunft anfragen kann; danach endet die Anfrage ohne Buchung | +| **Klärungsreservierung automatisch (v0.11, neu)** | 15 Minuten | Vermieter, Wohnung, Kanal × unverbindliche Eingangsart | **Vor** dem eigenen Angebot; `0` = keine Klärungssperre, auch bei aktiver Datenbeschaffung. Mindestdaten Wohnung, Zeitraum, verwendbarer E-Mail-Kontakt und positive Verfügbarkeitsprüfung. | +| **Klärungsreservierung Freigabe/manuell (v0.11, neu)** | 180 Minuten | Vermieter, Wohnung, Kanal × unverbindliche Eingangsart | Unabhängiger Parameter, ebenfalls `0` möglich; Beginn im V1-Modell beim ausreichend qualifizierten Anfrageeingang, nicht beim späteren manuellen Öffnen. | +| **Datenrückfrage-Modus (v0.11, neu)** | Noch zu parametrieren | Vermieter, Wohnung, Kanal × Eingangsart | Automatisch, vorbereiten mit Freigabe oder manuell; **unabhängig** vom Angebotsmodus. | +| **Erinnerungen / Folgefragen (v0.11, neu)** | Erinnerungen: maximal zwei zusätzliche Nachrichten als Ausgangsstandard; Folgefragen-Obergrenze offen | Vermieter, Wohnung, Kanal × Eingangsart | Getrennte Zähler, Intervalle konfigurierbar, keine Wiederholungsschleife; keine Reservierungsfrist-Verlängerung. | | Wer schickt Vertrag bzw. Unterlagen? | Wir | Vermieter, Wohnung, Portal (Buchung) | Portal → A5, keine eigenen Unterlagen | | Wer kümmert sich um die Zahlungen? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → A4: keine Mahnungen. „Laut Portal bezahlt“ ändert den Status nicht. Nach dem Aufenthalt entsteht die Aufgabe „Auszahlung des Portals prüfen“. | | Wer schickt Anreise-Info und Bewertungsbitte? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → „durch Portal (angekündigt)“, keine eigenen Mails | | Anreise-Info Tage vorher | 3 | Vermieter, Wohnung | Zeitpunkt der Anreisemail. Die Anreisedaten werden 2 Tage davor geprüft. | | Vertragsvorlage | Texte der Webseite | Wohnung, Portal, Vorgang (Zusammenstellung) | Inhalt von Angebot, Auskunft, Bestätigung und Unterlagen | +## 3a. Zentraler Kanalmanager – gemeinsamer Verwaltungsort (v0.11) + +Der zentrale Kanalmanager führt **eigene Website und externe Kanäle** gleichermaßen: Kanal-/Wohnungszuordnung, mögliche tatsächliche Eingangsarten, bestehende iCal-Import-/Exportverbindungen, technische Synchronisationsparameter und -status sowie kanalbezogene Prozess-, Kommunikations- und Klärungsparameter. Allgemeine Vermieterstandards bleiben zentral pflegbar; geerbte Werte und ihre Herkunft sollen im vorhandenen Bereich **„Wirksame Einstellungen“** sichtbar werden. + +**Keine zweite Quelle der Wahrheit:** Bestehende v0.10-Verbindungen und `ProcessSettings` bleiben fachliche Grundlage, bis die technische Ist-/Soll-Analyse ein konkretes Refactoring begründet. iCal-Sync und die bestehende regelbasierte Buchungserkennung bleiben eigenständige operative Funktionen. Die neue Konfigurationsverwaltung impliziert weder weitere aktive IMAP-Postfächer noch neue Parser, noch verändert sie Vertrags-/Angebotsentscheidungen. + +**Kritischer Unterschied zweier `0`-Werte:** `Klärungsreservierung = 0` bedeutet lediglich **kein kurzer Sperrblock während der Datenbeschaffung**. `Angebotsreservierung = 0` bedeutet im **bestehenden Angebotsweg** Auskunft unter Vorbehalt statt verbindlichem Angebot mit Hold. Diese Werte sind unabhängig und dürfen in UI, Textbausteinen und Prozesslogik nicht gleichgesetzt werden. Ein konfigurierter positiver Kurzblock ist zudem kein Beweis, dass die Sperre tatsächlich wirksam angelegt wurde. + +Zur zentralen Detailregel siehe [Communication Handler](Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + ## 4. Weitere Einstellungen | Einstellung | Wo | Ebene | Wirkung | @@ -109,6 +123,13 @@ ## 6. Nachweis an konkreten Vorgängen --- +## 6a. Neue v0.11-Konfigurationsgegenstände (noch nicht als implementiert anzusehen) + +- Je Mandant zunächst **ein aktives IMAP-Postfach**, Aliasadressen möglich; Datenmodell perspektivisch mehrere Postfächer. +- KI-Extraktion: versionierte Prompts mit Platzhaltern und strukturiertem Schema, kleines Primärmodell und optional größeres Prüfmodell, programmatische Kritikalitätsregeln und zu kalibrierende Schwellwerte. Zentral administrierbar; kein grafischer Prompt-Editor als MVP-Pflicht. +- Signierte Gastlinks: Laufzeit/Status und Formularberechtigungen ohne Gastregistrierung; Sicherheitsgrenzen nicht durch Geschäftskonfiguration abschaltbar. +- Gastkommunikation: Bausteine für **tatsächlich** keinen/aktiven/abgelaufenen Klärungsblock sowie bereits verbindliche Portalbuchungen. + ## 7. Lücken und widersprüchliche Stellen | Stelle | Beschreibung | Empfehlung | @@ -118,3 +139,5 @@ ## 7. Lücken und widersprüchliche Stellen | Aufgaben je Aufenthalt | nur je Wohnung, nicht je Portal | ausreichend für 1–3 Wohnungen | | Feste Fristen | Vorbereitung, Anreisedaten-Prüfung, Auszahlungsprüfung | einstellbar machen, wenn Erfahrungswerte vorliegen | | Gültigkeit der Auskunft | dieselbe Einstellung wie das Angebot | bewusst so (E-026) | + +**v0.11-Grenze:** Die oben als neu markierten Parameter beschreiben die künftige fachliche Soll-Konfiguration; die dokumentierten Screenshots, Artisan-Berichte und Tests der Pakete 1–9 belegen ausschließlich den v0.10-Bestand. diff --git a/docs/Prozessarchitektur/KONSOLIDIERUNGSBERICHT_v0.11.md b/docs/Prozessarchitektur/KONSOLIDIERUNGSBERICHT_v0.11.md new file mode 100644 index 0000000..1a2ad7a --- /dev/null +++ b/docs/Prozessarchitektur/KONSOLIDIERUNGSBERICHT_v0.11.md @@ -0,0 +1,41 @@ +# FewoPortal – Konsolidierungs- und Vollständigkeitsprüfung v0.11 + +**Stand:** 03.11.2026 · **Status:** fachlich konsolidierte Sollfassung zur Betreiberfreigabe; keine Code-/Rechtsfreigabe. + +## Ergebnis + +- Alle aktuellen Kernkapitel der v0.10 werden als **eigenständig lesbare v0.11-Fachkapitel** fortgeführt. Weiterhin gültiger Bestand wurde nicht neu erfunden. +- Bestehende bereits v0.11-geänderte Kernkapitel (P01/P02, G00, Konfiguration, CH-Querschnitt etc.) wurden erhalten und **an den bisher noch v0.10-orientierten Berührungspunkten** konsistent ergänzt: R01, R08, R09, Szenariomatrix, P03, P04 und Belegungskonflikte. +- Die **CH-01 bis CH-18**, S1–S6 und M01–M12 stehen vollständig und ohne Reduktion im führenden Querschnittsdokument; die übrigen Kapitel referenzieren es, ohne widersprüchliche zweite Regeln einzuführen. +- Die **vollständige Original-v0.10** liegt unverändert als eigenes Archiv im Paket unter `Historie/Prozessarchitektur_v0.10_ORIGINAL.zip` und ist für nachvollziehbare Herkunft verfügbar. Historische Tests/Abnahmebilder werden nicht mehr als Nachweis einer realisierten v0.11 zwischen aktuelle Fachnormen gemischt. +- `00_GESAMTSPEZIFIKATION_v0.11.md` enthält die **vollständigen aktuellen normativen Einzeltexte** der 22 Kapitel als eigenständig lesbare Gesamtausgabe. Die Einzeldateien bleiben die führenden editierbaren Quellen. + +## Tragende Grenzen + +1. **Angebots-Vorreservierung unverändert.** `Angebots-Hold = 0` bedeutet Auskunft unter Vorbehalt; `Klärungsblock = 0` bedeutet lediglich keine kurzzeitige Datennachforderungs-Sperre. Separate Parameter und Gasttexte. +2. **Klärungsreservierung** für unvollständige unverbindliche A1/A2: Wohnung + eindeutiger Zeitraum + verwendbare E-Mail + erfolgreiche Verfügbarkeitsprüfung; V0/V1, konfigurierbar einschließlich `0`, Ausgangswerte 15/180 Minuten bis anderweitiger Beschluss. +3. **Externe verbindliche Buchungen** bleiben verbindlich und werden unabhängig von fehlenden Gastdaten erfasst. +4. **Bestehende iCal-/Portalparser sowie `CaseAutomation`** behalten ihre bisherigen Ereignis-/Buchungsentscheidungen. Der CH fügt keine Sperrgates davor. +5. **Zentraler Kanalmanager** als gemeinsame führende Verwaltung für eigenes Portal, externe Kanäle und iCal-Konfiguration; kein neuer Buchungskern. +6. **LLM-Kaskade** liefert Informationskandidaten, keine Rechts-/Buchungsentscheidungen; CH-03 regelt phasenabhängige Übernahme. +7. **P02-Ausbau außerhalb MVP:** parallele Angebotsvarianten, Frist-Sonderverlängerung, automatisierte Vertragsänderungen nach Buchung. + +## Dokumentenabgleich + +| Merkmal | Ergebnis | +|---|---| +| Aktuelle normative Einzelkapitel (inkl. Szenarien) | 22 | +| Vollständige Gesamtspezifikation | 1 zusätzliche Markdown-Datei | +| CH-/Datenbeschaffungsquelle | vollständiger Beschlussstand v4 als historischer Beleg | +| Historischer v0.10-Originalsatz | vollständig als unverändertes ZIP beigefügt | +| Nicht aufgelöste relative Markdown-Dateilinks im aktuellen Satz | 0 | + +## Vor der formalen Freigabe verbleibende Nachweise + +- Code-Ist-Abgleich gegen laufendes Repository einschließlich bisheriger iCal- und Portal-Mail-Anbindungen, Datenbanken und Admin-Oberflächen. +- KI-/Prompt-/Schwellenwerte und Betriebsparameter anhand repräsentativer Nachrichten validieren und sicheren Fallback nachweisen. +- Juristische/DSGVO-Prüfung von Rückfragetexten, Fristen, Gastlinks und Datenhaltung. +- Fachliche Abnahme CH M01–M12 sowie Regression der vorhandenen v0.10-Prozesspfade. +- Die noch offenen Feld-/Altersdifferenzierungsregeln nur bei wirklicher Relevanz für Implementierung konkretisieren. + +**Keine neue Prozessarchitektur oder weitere Sonderfallserie erforderlich.** Die hier dokumentierte v0.11 ist ein vollständiges fachliches SOLL, aber noch keine Behauptung einer technischen oder rechtlichen Go-live-Bereitschaft. diff --git a/docs/Prozessarchitektur/Offene_Fragen.md b/docs/Prozessarchitektur/Offene_Fragen.md index 3d01834..dd0d252 100644 --- a/docs/Prozessarchitektur/Offene_Fragen.md +++ b/docs/Prozessarchitektur/Offene_Fragen.md @@ -3,7 +3,7 @@ typ: prueffallregister titel: Offene fachliche, rechtliche und Portal-Prüffälle status: offen -version: "0.10" +version: "0.11" --- # Offene Prüfungen @@ -37,6 +37,18 @@ ## Übergreifende fachliche und rechtliche Prüfpunkte - **P03–P05:** Mindestdaten/Abschlussgates, Pflichtaufgaben, Übergabe von nachlaufenden Forderungen und Schäden; detaillierte Abläufe noch fachlich auszuarbeiten. - **A6:** Bestätigungsformulierungen und Kostenpflichten privater Überlassung, Verknüpfung alter Sperren mit einheitlichem Vorgang. +## v0.11 – Noch offene Detailprüfungen (kein neues Grundsatzdesign) + +**Fachliche Ausgestaltung/Parametrierung:** Altersunterteilung Erwachsene/Jugendliche/Kinder als verpflichtendes Angebotsfeld, feldbezogene Schutz-/Korrekturregeln nach P1/P2/P3, konkrete maximale Folgefragenzahl und Erinnerungsintervalle. **Bisherige Defaults 15/180 Minuten für den Klärungsblock bleiben bestehen; ein 15/30-Wechsel wurde nicht beschlossen.** + +**Technik/KI und Nachrichtenquellen:** E-Mail-Quellenverifikation, Prompt-/Schema-/Kontextgrenzen, modellgestützte Extraktionsgüte einschließlich übersehener Fakten, Kalibrierung der Konfidenzwerte und Eskalationsschwelle, Fehlerszenarien/Timeouts, sichere Absender-/Vorgangszuordnung und Regression des bestehenden iCal-/Portalparser-Eingangs. Betriebskonzept für ein aktives Postfach pro Mandant; Abgleich mit tatsächlicher Codebasis für Kanalmanager und wirksame Einstellungen. + +**Go-live-Compliance:** Gastlink-Gültigkeit/Berechtigung, konkrete genehmigte Textvorlagen und Nachrichtenzahl/-abstände, Lösch-/Aufbewahrungsfristen, Rechtmäßigkeit von Nachfass-E-Mails, Datenschutz der eingesetzten LLM-Anbieter bzw. lokaler Verarbeitung, IT-Sicherheit und Testversand. Kein bindender 30-Tage-Löschwert beschlossen. Die Fachspezifikation ersetzt keine Rechtsfreigabe. + +**Explizit spätere Fachspezifikation – nicht MVP:** Parallele alternativ annehmbare verbindliche Angebote, Wirkung von Ersatzangeboten, gemeinsame Verfügbarkeitsabsicherung, einmalige begrenzte Annahmefristverlängerung bei spät eintreffendem Änderungswunsch und Rechtsprüfung. Nach Vertragsschluss: Umbuchung, Verkürzung/Teilstorno, zusätzliche Leistungen, Zahlungs-/Stornofolgen; möglicher Storno-/Neubuchungs-Workaround nur manuell prüfen. Außerdem spätere Varianten V2/V3 des Klärungsblocks, mehrere aktive IMAP-Postfächer, Messenger, Gastkonto und Loyalty. + +**Fachliche Hauptregel und Abnahmefälle:** [Communication Handler und Datenbeschaffung](Querschnitt/Datenbeschaffung_und_Communication_Handler.md), CH-01–CH-18, M01–M12. + ## Vor der Implementation technisch am Repository prüfen Der Coding-Agent hat in seiner Bestandsanalyse **berichtet**, dass bestehende Buchungen, Blockperioden und manuelle Erfassung derzeit teilweise parallel laufen; Gast-Pflichtfelder bei Portalbuchungen Platzhalter auslösen können; `Channel::booking_model` zu grob ist; Hold und Angebot verknüpft und nur wohnungsbezogen gesteuert werden; `PortalPrice` Gesamtsummen künstlich aufteilt; Portalstornos bestehende Vorgänge nicht sichtbar erreichen und A6 nur teilweise abbildbar ist. **Das sind Agentenbefunde, keine unabhängig verifizierten Tatsachen oder technischen Architekturvorgaben.** Die aktuelle Codebasis ist vor Maßnahmen erneut zu prüfen. diff --git a/docs/Prozessarchitektur/Querschnitt/Belegungskonflikte.md b/docs/Prozessarchitektur/Querschnitt/Belegungskonflikte.md index bfa9995..f2d2006 100644 --- a/docs/Prozessarchitektur/Querschnitt/Belegungskonflikte.md +++ b/docs/Prozessarchitektur/Querschnitt/Belegungskonflikte.md @@ -3,7 +3,7 @@ typ: sonderprozess titel: Belegungskonflikte, Kalender und Sperrnachweise status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Belegungskonflikte, Kalender und Sperrnachweise @@ -14,6 +14,10 @@ ## Betriebsrealität Laut Betreiberhistorie gab es **zwei Doppelbuchungen in etwa 20 Jahren**. Dieses niedrige beobachtete Auftreten rechtfertigt pragmatische Sperr- und Klärungsaufgaben, ist aber kein Nachweis der technischen Unmöglichkeit oder künftigen Risikofreiheit. Eine Echtzeitabfrage des führenden Systems durch alle Portale wäre besser, ist **bei den konkreten Integrationen nicht als vorhanden anzunehmen**. +## v0.11 – Optionale kurze Klärungsreservierung + +Die Klärungsreservierung ist eine **separate vorgelagerte** Sperre für unvollständige **unverbindliche** Anfragen, nicht die bestehende Angebots-Vorreservierung. Sie ist nur bei eindeutiger Wohnung, Reisezeitraum, verwendbarem E-Mail-Kontakt und erfolgreicher Verfügbarkeitsprüfung zulässig; bei der Einstellung `0` entsteht kein Block. Bei `>0` beginnt die Frist im V1-Modell beim qualifizierten Eingang, läuft automatisch ab und verlängert sich nicht durch Folgefragen oder Erinnerungen. Gerade wegen langsamer Portalabfragen kann ein intern beendeter Kurzblock im Zielportal länger sichtbar bleiben; FewoPortal darf keine sofortige externe Freigabe unterstellen. Schon extern verbindliche Buchungen werden dadurch nicht neu qualifiziert oder freigegeben. + ## Fachliches Vorgehen 1. Auslösende Buchung, Quelle/Owner, ggf. externe Referenz und eingehende Zeitstempel erfassen. diff --git a/docs/Prozessarchitektur/Querschnitt/Datenbeschaffung_und_Communication_Handler.md b/docs/Prozessarchitektur/Querschnitt/Datenbeschaffung_und_Communication_Handler.md new file mode 100644 index 0000000..2d8db68 --- /dev/null +++ b/docs/Prozessarchitektur/Querschnitt/Datenbeschaffung_und_Communication_Handler.md @@ -0,0 +1,154 @@ +--- +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)). diff --git a/docs/Prozessarchitektur/Querschnitt/Gates_und_Nachweise.md b/docs/Prozessarchitektur/Querschnitt/Gates_und_Nachweise.md index ba8a5db..98787fc 100644 --- a/docs/Prozessarchitektur/Querschnitt/Gates_und_Nachweise.md +++ b/docs/Prozessarchitektur/Querschnitt/Gates_und_Nachweise.md @@ -3,7 +3,7 @@ typ: fachkonzept titel: Gates, Informationsqualität und Übergaben status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Gates, Informationsqualität und Übergaben @@ -13,11 +13,15 @@ # Gates, Informationsqualität und Übergaben | Gate | Fachliche Frage | Fehlende Information | |---|---|---| | **G1 – Eingang** | Ist Anlass/Objekt/Zeitraum, Eingangsart, Kanal/Owner und ggf. Portalreferenz ausreichend qualifiziert? | Unklaren Import prüfen, keine künstliche Buchungsbestätigung | +| **G1a – Optionaler Klärungsblock (v0.11, nur A1/A2)** | Ist der Kurzblock konfiguriert und sind Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt sowie Verfügbarkeit gesichert? | Ohne qualifizierte/erfolgreiche Sperre keine Reservierungsbehauptung; Rückfrage ohne Sperre bleibt möglich | | **G2 – Bindung/Konditionen** | Eigene fristgerechte Annahme oder externen bindenden Abschluss nachweisbar? Sind die für die konkrete Aktion benötigten Konditionen bekannt? | Nachweis/Einzelinformation klären; Bindung nicht wegen fehlender Anschrift rückgängig machen | +| **G2a – Vor eigenem bindendem Angebot (v0.11)** | Sind Vorname, Nachname, vollständige Anschrift, E-Mail, Personenzahl und Zeitraum validiert, zuzüglich Preis-/Dokumenten-/Verfügbarkeitsgates? | Kein eigenes bindendes Angebot vor Vollständigkeit; keine manuelle Umgehung fehlender Anschrift. Extern bindende Buchungen bleiben unberührt. | | **G3 – Abwicklung** | Wer ist für Dokumente, Zahlungen, Mahnung, Storno, Erstattung und Kommunikation tatsächlich verantwortlich? | Zuständigkeit/Status als offen erfassen und klären | | **G4 – Durchführung** | Sind für Gast oder A6-Zweck die nötigen Kontakt-, Leistungs-, Anreise-, Melde- oder Arbeitsinformationen vorhanden? | Nur entsprechende Aktivität zurückstellen oder ergänzen | | **G5 – Ende** | Ist Leistung bzw. Sperrzweck erfüllt/beendet und sind offene Nachläufer verantwortlich übergeben? | Abschlussbezogene Klärung/Folgeaufgabe | +**v0.11-Faktenregel:** Fehlende administrative Werte aus eindeutig zugeordneten Quellen dürfen phasenabhängig kontrolliert ergänzt werden; widersprüchliche oder vertragsrelevante Änderungen werden nicht blind übernommen. Der [Communication Handler](Datenbeschaffung_und_Communication_Handler.md) liefert nur geprüfte Informationskandidaten/Anlässe und keine eigene Vertragsentscheidung. + **Mögliche Ergebnisse:** intern erledigt, extern erledigt (mit Nachweis/Quelle), fachlich nicht anwendbar, offen, widersprüchlich. Extern *verantwortet* ist nicht automatisch extern *erledigt*. `Unbekannt` und `nicht anwendbar` sind voneinander und von `0` zu unterscheiden. **Wesentliche Nachweise:** Quelle, externe Buchungs-/Vorgangsreferenz, Zeitpunkt, Person/System, gegebenenfalls Beleg, Gültigkeit/Aktualität, tatsächlicher Zustand und nächste Verantwortung. Der Detailgrad hängt von Relevanz und Portalverfügbarkeit ab; es wird kein universelles Nachweis-Enum für jedes Feld verlangt. diff --git a/docs/Prozessarchitektur/Querschnitt/Preise_und_Zahlungen.md b/docs/Prozessarchitektur/Querschnitt/Preise_und_Zahlungen.md index e312026..15fed04 100644 --- a/docs/Prozessarchitektur/Querschnitt/Preise_und_Zahlungen.md +++ b/docs/Prozessarchitektur/Querschnitt/Preise_und_Zahlungen.md @@ -3,7 +3,7 @@ typ: fachkonzept titel: Preise, Gebühren, Provisionen und Zahlungsstände status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Preise, Gebühren, Provisionen und Zahlungsstände diff --git a/docs/Prozessarchitektur/Querschnitt/Sonder_und_Supportprozesse.md b/docs/Prozessarchitektur/Querschnitt/Sonder_und_Supportprozesse.md index 6e96a84..2970908 100644 --- a/docs/Prozessarchitektur/Querschnitt/Sonder_und_Supportprozesse.md +++ b/docs/Prozessarchitektur/Querschnitt/Sonder_und_Supportprozesse.md @@ -3,7 +3,7 @@ typ: prozesskatalog titel: Sonderprozesse und unterstützende Funktionen status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Sonderprozesse und unterstützende Funktionen @@ -24,12 +24,14 @@ ## Sonderfälle | X08 | No-show, Verlängerung, vorzeitige Abreise | Je nach Vertragsstatus Belegung, Leistungen und Zahlungen anpassen | | X09 | Reklamation, Schaden, Kaution und Nachforderung | Lokale Klärung und verantwortliche Folgeaufgabe | -**Ereignisprinzip:** Ein Änderungs-/Stornowunsch ist nicht automatisch wirksam. Erfasst werden – soweit relevant – tatsächlicher Grund, Antragsteller, handelnde Person/Portal, Entscheidung, Wirksamkeitszeitpunkt und Folgen für Vertrag, Kalender, Leistungen und Zahlungen. Eine aufgehobene Wartungssperre nutzt dieselben generischen Mechanismen, ist rechtlich aber **keine Mietvertragsstornierung**. +**Ereignisprinzip:** Ein Änderungs-/Stornowunsch ist nicht automatisch wirksam. **Für den v0.11-MVP erfasst der Communication Handler vor Annahme eines eigenen Angebots Änderungswünsche nur zur kontrollierten manuellen/fachlichen Behandlung. Nach Vertragsschluss erfolgt die vertragsrelevante Änderungsbearbeitung ebenfalls zunächst manuell; automatische parallele Angebotsvarianten, Teilstorno und ein allgemeiner Storno-/Neubuchungs-Workaround sind nicht beschlossen.** Erfasst werden – soweit relevant – tatsächlicher Grund, Antragsteller, handelnde Person/Portal, Entscheidung, Wirksamkeitszeitpunkt und Folgen für Vertrag, Kalender, Leistungen und Zahlungen. Eine aufgehobene Wartungssperre nutzt dieselben generischen Mechanismen, ist rechtlich aber **keine Mietvertragsstornierung**. ## Unterstützende Funktionen (keine automatischen eigenständigen Module) S01 Kanal-/Integrationsverwaltung; S02 Kalender- und Belegungsabgleich; S03 Gast-/Objekt-/Teilnehmerstammdaten; S04 Preise, Konditionen, Leistungen; S05 Dokument-/Vorlagenmanagement; S06 Kommunikation, Aufgaben und Fristen; S07 Zahlungen, Forderungen und Portalstatus; S08 buchungsbezogene lokale Dienstleister/Reinigung/Schlüssel/Reparatur; S09 Mandanten/Berechtigungen/Compliance/Sicherheit. +**v0.11:** S01 bündelt alle Kanäle einschließlich der eigenen Website und die bestehenden iCal-Verbindungseinstellungen; S06 umfasst den [Communication Handler](Datenbeschaffung_und_Communication_Handler.md) mit kontrolliertem Fakteneingang. Beide sind Querschnittsfunktionen, keine eigenen Buchungs- oder Stornierungsprozesse. + Eine kleine Vermietungsplattform soll diese Funktionen nach Möglichkeit **in den Buchungsvorgang integrieren**. Umfangreiche Objekt- oder Personaldisposition, ein vollumfängliches CRM oder freie Workflow-Modellierung werden durch diesen Katalog **nicht** als MVP-Anforderung festgelegt. [Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [X07 vertieft](Belegungskonflikte.md) diff --git a/docs/Prozessarchitektur/README.md b/docs/Prozessarchitektur/README.md index 5d42336..4a71612 100644 --- a/docs/Prozessarchitektur/README.md +++ b/docs/Prozessarchitektur/README.md @@ -2,53 +2,55 @@ id: START typ: navigation titel: FewoPortal – Prozessarchitektur -status: fachlicher-arbeitsstand -version: "0.10" +status: fachliche-sollfassung-zur-freigabe +version: "0.11" --- -# FewoPortal – Prozessarchitektur +# FewoPortal – Prozessarchitektur v0.11 -**Fachliche Sollbeschreibung · Stand 1. November 2026 · Version 0.10** +**Vollständig konsolidierte fachliche Sollfassung · 03.11.2026 · Freigabestatus: Entwurf zur Betreiberfreigabe** -Dieses Verzeichnis beschreibt den **aktuell gültigen fachlichen Arbeitsstand**, nicht den tatsächlichen Implementierungsstand und keine rechtliche Freigabe. Es ist bewusst hierarchisch organisiert. Die Historie der früheren Fassungen gehört in Git; innerhalb der Fachdokumente werden keine veralteten Regelversionen weitergeführt. +Dies ist die **vollständige aktuelle Fachspezifikation** für FewoPortal und kein separates Änderungspaket. Sie vereint die weiterhin gültigen Prozessregeln der v0.10 mit den beschlossenen Ergänzungen zu Informationsbeschaffung, Communication Handler, KI-Extraktion, optionaler Klärungsreservierung und zentraler Kanalverwaltung. **Die Implementierung der neu ergänzten v0.11-Fähigkeiten ist damit nicht nachgewiesen.** Der tatsächliche Code-Stand und die rechtlichen Go-live-Freigaben sind getrennt zu prüfen. -## Lesereihenfolge +## Lesen und anwenden -1. [Prozesslandkarte](00_Prozesslandkarte.md): Produktziel, V01/V02, Prinzipien und Prozessgrenzen. -2. [Buchungsarchetypen](01_Buchungsarchetypen.md): A1–A6 und Verantwortlichkeiten. -3. [Abwicklungsprofile, Konfiguration und Dokumente](02_Abwicklungsprofile_und_Dokumente.md): Vermieterstandards, Kanalabweichungen, Angebotsarten, Vorlagen. -4. **V01 – Hauptwertschöpfungsprozess:** [P01](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) → [P02](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) → [P03](V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md) → [P04](V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md) → [P05](V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md). -5. Bei konkretem Bedarf die **Querschnittsthemen** sowie die **Referenzszenarien** lesen. +1. [Prozesslandkarte und Führungsprinzip](00_Prozesslandkarte.md) +2. [A1–A6: Buchungsarchetypen](01_Buchungsarchetypen.md) +3. [Abwicklungsprofile, Dokumente und zentraler Kanalmanager](02_Abwicklungsprofile_und_Dokumente.md) +4. [P01 – Eingang und Verfügbarkeit](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) → [P02 – Konditionen und Verbindlichkeit](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) → [P03 – Verwaltung/Abrechnung](V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md) → [P04 – Aufenthalt](V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md) → [P05 – Abschluss](V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md) +5. [Gates und Nachweise](Querschnitt/Gates_und_Nachweise.md) und **[Communication Handler / Datenbeschaffung – CH-01 bis CH-18](Querschnitt/Datenbeschaffung_und_Communication_Handler.md)** +6. [Zentrale Konfiguration und Wirksamkeit](KONFIGURATION_UND_WIRKSAMKEIT.md), [Entscheidungsregister](Entscheidungen.md) und [Offene Punkte](Offene_Fragen.md) +7. [Referenzszenarien](Szenarien/00_Szenariomatrix.md) mit [eigener Website](Szenarien/R01_Eigene_Webseite.md), [Eigenbelegung](Szenarien/R07_Eigenbelegung_und_Sperren.md), [Destination Solutions](Szenarien/R08_Destination_Solutions.md) und [FeWo-direkt](Szenarien/R09_FeWoDirekt.md) -## Querschnitt und Beispiele +Eine **zusammenhängende Lesefassung** mit allen derzeit maßgeblichen Fachtexten steht unter [00_GESAMTSPEZIFIKATION_v0.11.md](00_GESAMTSPEZIFIKATION_v0.11.md). Die Einzeldateien bleiben die führenden editierbaren Kapitel. -[Szenariomatrix](Szenarien/00_Szenariomatrix.md) – alle bisherigen und weiteren vorgesehenen Referenzfälle. +## Querschnitt -| Bereich | Dokument | Zweck | -|---|---|---| -| Querschnitt | [Gates und Nachweise](Querschnitt/Gates_und_Nachweise.md) | Voraussetzungen, Zuständigkeit, Ergebnisqualität | -| Querschnitt | [Preis und Zahlung](Querschnitt/Preise_und_Zahlungen.md) | Gesamtbeträge, Sammelpositionen, Provisionen, Zahlungsstatus | -| Querschnitt | [Sonder- und Supportprozesse](Querschnitt/Sonder_und_Supportprozesse.md) | Änderung, Storno, Schaden, Klärung, integrierte Hilfsfunktionen | -| Querschnitt | [Belegungskonflikte](Querschnitt/Belegungskonflikte.md) | Kalender, Sperren, externe Verzögerungen | -| Szenario | [R01 – eigene Website](Szenarien/R01_Eigene_Webseite.md) | Angebot, Annahme, Hold = 0 oder > 0 | -| Szenario | [R07 – Eigenbelegung/Sperren](Szenarien/R07_Eigenbelegung_und_Sperren.md) | A6 mit und ohne Gäste/Leistungen | -| Szenario | [R08 – Destination Solutions](Szenarien/R08_Destination_Solutions.md) | A3 mit manueller Kalendersperrung | -| Szenario | [R09 – FeWo-direkt](Szenarien/R09_FeWoDirekt.md) | A4 mit geteilter Abwicklung | -| Verwaltung | [Gültige Entscheidungen](Entscheidungen.md) | Konsolidierte Beschlüsse; fachliche IDs | -| Verwaltung | [Offene Prüfungen](Offene_Fragen.md) | Recht, Portalverhalten, fachliche und technische Validierung | -| Referenz | [Analyse der bisherigen FeWo-direkt-Vorlage](Referenzen/FeWoDirekt_Vertragsanalyse.md) | Belegmaterial, kein Vertragsmuster zur automatischen Verwendung | -| Referenz | [Quellenverzeichnis](Referenzen/Quellenverzeichnis.md) | Öffentliche Quellen und Grenzen ihrer Aussagekraft | +| Dokument | Gegenstand | +|---|---| +| [Communication Handler und Datenbeschaffung](Querschnitt/Datenbeschaffung_und_Communication_Handler.md) | Eingangs-/Ausgangskanäle, IMAP, KI-Kaskade, sichere Gastlinks, Nachfassen, Faktenübernahme und Abnahmen M01–M12 | +| [Gates und Nachweise](Querschnitt/Gates_und_Nachweise.md) | Phasenabhängige Voraussetzungen, fehlende und widersprüchliche Angaben | +| [Belegungskonflikte](Querschnitt/Belegungskonflikte.md) | iCal, Portalverzögerung, reservierbare Zeiträume, exklusive Sperren | +| [Preis und Zahlung](Querschnitt/Preise_und_Zahlungen.md) | Konditionen, Abrechnung, Zahlungen, Portaldaten | +| [Sonder- und Supportprozesse](Querschnitt/Sonder_und_Supportprozesse.md) | Änderungen, Storno, Ausnahmen und zentrale Unterstützungsfunktionen | +| [V02 – Vermarktung und Gästebindung](V02_Vermarktung_und_Gaestebindung.md) | Fachliche Schnittstelle; kein Loyalty-MVP | -## Geltung und Übernahme in das Repository +## Unveränderliche Grenzen gegenüber v0.10 -Der Ordner **`docs/Prozessarchitektur/`** soll beim Import als **vollständige neue Fassung ersetzt**, nicht lediglich um die neuen Dateien ergänzt werden. Andernfalls bleiben bisherige Dubletten, historische Markdown-Dateien und unnötige Vault-Konfigurationen aktiv. Git hält den bisherigen Stand weiterhin über frühere Commits vor. Ältere Übergabe- oder Konzeptdateien außerhalb dieses Ordners sind **Hintergrundmaterial**, sofern sie dem hier dokumentierten aktuellen Fachstand widersprechen. +- **Bestehende Angebots-Vorreservierung:** Nicht neu konzipiert. Die Einstellungen `Angebots-Hold = 0` (Auskunft unter Vorbehalt) und `Klärungsblock = 0` (keine kurzzeitige Sperre während der Datenbeschaffung) sind **zwei verschiedene Werte**. +- **Neue Klärungsreservierung:** Optional und ausschließlich für noch unverbindliche unvollständige A1/A2-Anfragen. Bei V1 Mindestqualifikation Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt und positive Verfügbarkeitsprüfung. Nur der tatsächliche Sperrstatus darf gegenüber dem Gast behauptet werden. +- **Verbindliche externe Direktbuchungen:** Bleiben trotz fehlender Gastangaben wirksam; keine nachträgliche eigene Angebotsannahme, kein Klärungsgate. +- **iCal und bestehende Portalparser:** Bestehende Buchungsereignisregeln und operative Synchronisationslogik behalten ihre Geltung; der Communication Handler ergänzt Quellen/Informationen und blockiert sie nicht. +- **Nur ein Buchungsvorgang je Geschäftsfall, keine neue Prozessengine/Queue.** Der zentrale Kanalmanager ist eine führende gemeinsame **Verwaltung der Konfiguration**, nicht eine zweite Buchungsengine. -## Navigations- und Pflegeprinzip +## Geltung, Dokumente und Archiv -- Normative Fachregel **einmal** am zuständigen Ort; Szenarien illustrieren, ohne sie abweichend neu zu definieren. -- Nur Eltern-Kind-Links und wenige notwendige Querverweise; normale **relative Markdown-Links** für Obsidian, Gitea und VS Code. -- Auf Dateiebene keine Versionsnachträge, künstlichen Link-Fußzeilen oder vollständigen Änderungshistorien. Git dokumentiert Änderungen. -- **Entschieden**, **Betreiberbeobachtung**, **fachliche Empfehlung** und **offener Prüfpunkt** nicht vermischen. -- Eine künftig neue Dokumentbearbeitung beginnt erst mit der ausdrücklich vom Betreiber bereitgestellten aktuellen Repository-Fassung. Der Coding-Agent legt Analyse- und Umsetzungsergebnisse **als Datei im Repository** ab und nennt im Chat nur den Pfad und die wichtigsten Ergebnisse. +- Die im Hauptverzeichnis, unter `V01_Buchung_und_Aufenthalt/`, `Querschnitt/` und `Szenarien/` dokumentierten Regeln bilden zusammen die **aktuelle v0.11-Sollfassung**. Die aktiven Kapitel haben die Versionskennung `0.11`, auch wenn ihr fachlicher Inhalt aus v0.10 übernommen wurde. +- Die Dateien unter `Referenzen/` sind **Quellen- und Belegmaterial**, keine eigenständigen neuen Normen. Ihr historisches Versionsdatum bleibt unverändert. +- Die **vollständige Original-v0.10 mit Originaldokumenten, Audit, damaligen Umsetzungs-/Abnahmeprotokollen, Screenshots und Vault-Dateien** liegt unverändert als [Historie/Prozessarchitektur_v0.10_ORIGINAL.zip](Historie/Prozessarchitektur_v0.10_ORIGINAL.zip) bei. Sie ist **nicht** parallel gültig. Ihre technischen und rechtlichen Prüfstände belegen nur v0.10. +- Die Beschlussquelle für den neuen Bereich liegt in [Historie/CH_Entscheidungsstand_2026-11-03_v4.md](Historie/CH_Entscheidungsstand_2026-11-03_v4.md). Die normative aktuelle Regel ist die CH-Querschnittsdatei. +- Die [Konsolidierungsprüfung](KONSOLIDIERUNGSBERICHT_v0.11.md) erklärt Herkunft, Änderungen und technische Freigabevorbehalte. **Es wurde kein aktueller Repository-Code geprüft.** -**Priorität:** Die vollständige, fachlich konsistente Prozesskette ist wichtiger als ein komplexer Workflow-Designer. Technische Umsetzung, Migration und Go-live bedürfen gesonderter Freigabe. +## Offene Nachweise vor produktivem Go-live + +Die v0.11 ist als Fachspezifikation selbstständig nutzbar. Für Umsetzung und produktive Freigabe bleiben die in [Offene Fragen](Offene_Fragen.md) benannten **fachlich bereits abgegrenzten** Validierungen offen: Code-Ist-Abgleich, Betriebs-/KI-Parameter, rechtliche und datenschutzrechtliche Kommunikation/Links sowie Regressionstests der bestehenden iCal-/Portal-/Angebotsprozesse. Diese Punkte sind **kein Auftrag**, bereits beschlossene Geschäftsgrundsätze neu zu diskutieren. diff --git a/docs/Prozessarchitektur/Szenarien/00_Szenariomatrix.md b/docs/Prozessarchitektur/Szenarien/00_Szenariomatrix.md index 902a549..6fe12ab 100644 --- a/docs/Prozessarchitektur/Szenarien/00_Szenariomatrix.md +++ b/docs/Prozessarchitektur/Szenarien/00_Szenariomatrix.md @@ -3,7 +3,7 @@ typ: szenarienkatalog titel: Referenz- und Prüfszenarien status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # Referenz- und Prüfszenarien @@ -12,9 +12,9 @@ # Referenz- und Prüfszenarien | ID | Szenario | Typ | Dokument-/Prüfstatus | |---|---|---|---| -| **R01** | Anfrage über eigene Website mit und ohne Hold | A1 | [Ausgearbeitet](R01_Eigene_Webseite.md) | +| **R01** | Anfrage über eigene Website; **optionale Klärungssperre** bei Datenlücken und **separate Angebots-Haltefrist** | A1 | [Ausgearbeitet](R01_Eigene_Webseite.md), v0.11-Informationsbeschaffung eingeschlossen | | R02 | Telefonische/manuelle Anfrage | A1/A2 je Ursprung | Vorgemerkt; keine zusätzliche Prozessvariante | -| R03 | Unverbindliche Portalanfrage | A2 | Vorgemerkt; Gastdaten/Portalnachricht können unvollständig sein | +| R03 | Unverbindliche Portalanfrage | A2 | Vorgemerkt; fehlende Gastdaten über CH beschaffen, nur optionaler Kurzblock, danach bestehender Angebotsweg | | R04 | Externe verbindliche Buchung, Vertrag/Zahlung durch uns | A3 | Generischer Vergleichsfall; konkret als R08 geprüft | | R05 | Portal wickelt Vertrag/Zahlung/Storno weitgehend selbst ab | A5 | Vorgemerkt; nur eigene lokale Pflichten | | **R07** | Interne Belegung, private Überlassung, Wartung | A6 | [Ausgearbeitet](R07_Eigenbelegung_und_Sperren.md) | diff --git a/docs/Prozessarchitektur/Szenarien/R01_Eigene_Webseite.md b/docs/Prozessarchitektur/Szenarien/R01_Eigene_Webseite.md index 5070abb..e2bf4e2 100644 --- a/docs/Prozessarchitektur/Szenarien/R01_Eigene_Webseite.md +++ b/docs/Prozessarchitektur/Szenarien/R01_Eigene_Webseite.md @@ -3,7 +3,7 @@ typ: referenzszenario titel: Eigene Website – Anfrage bis Abschluss status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # R01 – Eigene Website (A1) @@ -14,16 +14,20 @@ ## Regelfall | Phase | Vorgehen | |---|---| -| **P01** | Eingang erfassen, Gast zuordnen, Verfügbarkeit prüfen; **nur bei Haltefrist > 0** Hold anlegen und nach Kanal-/Portalprofil Sperrungen veranlassen | -| **P02** | Jahres-/Saisonpreis, Leistungen und Rabatte zusammenstellen; richtige Vorlage/Anlagen wählen; bei Hold > 0 bindendes befristetes Angebot und Annahmelink; rechtzeitige Annahme stellt Verbindlichkeit ohne zweite Freigabe her | +| **P01** | Unverbindliche Anfrage auch bei unvollständigen Gastdaten als Vorgang erfassen; verfügbare Angaben und Herkunft dokumentieren. Bei Wohnung + eindeutigem Zeitraum + verwendbarem E-Mail-Kontakt und positiver Verfügbarkeit **optional einen vorgelagerten Klärungsblock** nach eigener Kanalkonfiguration anlegen (auch `0` = kein Kurzblock). Fehlende Pflichtdaten über den Communication Handler anfordern. Erst danach führt der **unveränderte Angebotsweg** mit eigener Angebots-Haltefrist zur passenden Belegungswirkung. | +| **P02** | Eigenes verbindliches Angebot erst nach vollständigem Namen, Personenzahl, Reisezeitraum, E-Mail, **vollständiger Postanschrift** und weiteren bestehenden Gates; Jahres-/Saisonpreis, Leistungen, Rabatte und Anlagen ermitteln. **Angebots-Hold > 0**: bindendes befristetes Angebot mit Annahmelink; Annahme begründet Verbindlichkeit ohne zweite Freigabe. **Angebots-Hold = 0**: nur Auskunft unter Vorbehalt gemäß bestehender v0.10-Logik. | | **P03** | Vertrag/Buchungsbestätigung, Zahlungsplan, Aufgaben und Fristen im Vorgang; keine unbeauftragte automatische Mahnung oder Stornierung | | **P04** | Gäste-/Anreiseinformationen, lokale Leistungen, ggf. Kurabgabe und Meldedaten; Anreise-Info je konfiguriertem Ablauf (bisherige Praxis etwa drei Tage vorher) | | **P05** | Aufenthalt abschließen, Dank/Feedback/Bewertung, Objektbereitstellung und ggf. kontrollierte Nachläuferübergabe | -## Variante: Haltefrist 0 +## Variante: Angebots-Haltefrist 0 (unabhängig vom Klärungsblock) Es wird **keine Reservierung** ausgelöst. Die Antwort ist eine Preis-/Verfügbarkeitsauskunft unter Vorbehalt und kein unbedingtes Mietvertragsangebot. Will der Gast buchen, erfolgt **eine neue Verfügbarkeitsprüfung**. Anschließend bestätigt FewoPortal automatisch oder legt die Entscheidung dem Vermieter vor – gemäß seinem globalen Standard bzw. der **ausdrücklichen kanalindividuellen Einstellung**. Die tatsächlich versandte Bestätigung muss zur Vertragswirkung passen. Keine separate Preisbindefrist und kein versteckter zweiter Hold. +## Vorgelagerte Informationsbeschaffung (v0.11) + +Bei noch fehlenden Angebotsangaben darf eine **eigene Klärungsreservierung** für die konfigurierte kurze Zeit bestehen; sie ist **kein Angebots-Hold**. Bei `Klärungsreservierung = 0` erfolgt dieselbe Rückfrage **ohne** Reservierung und mit dem ausdrücklichen Hinweis auf die zwischenzeitlich mögliche anderweitige Buchung. Bei positivem Wert bestätigt die Rückfrage nur einen **tatsächlich wirksamen** Kurzblock samt absolutem Ablaufzeitpunkt. Ist die Sperre nicht erfolgreich angelegt oder bereits abgelaufen, darf der Text keinen Hold behaupten. Bei verspäteter Ergänzung wird vor dem Angebot die Verfügbarkeit erneut geprüft. Die Antwort per E-Mail oder sicherem Ergänzungslink führt zur gemeinsamen Datenübernahme; die Angebots-Haltefrist wird dadurch nicht verlängert. + ## Kritische Ausnahmen - Angaben fehlen: gezielte Nachfrage; keine Platzhalter-Gäste, erfundenen Personenzahlen oder Preise. @@ -33,6 +37,6 @@ ## Kritische Ausnahmen - Verspätete/abweichende Annahme, unzustellbare E-Mail, mehrfach betätigter Link: keine stillschweigende zweite oder falsche Buchung. - Nach Buchung: Umbuchung, Storno, Zahlungsausfall, No-show, Schaden und Reklamation über dieselben fachlichen Sonderfälle. -**Noch fachlich zu detaillieren:** Beginn/Ende der Hold-Frist, Verhalten bei mehreren gleichzeitig ausstehenden Angeboten, exakt erforderliche Felder und rechtliche Anforderungen des Buchungsbuttons. +**Noch zu prüfen:** Technische und rechtliche Wirksamkeit des Annahmewegs sowie spätere Regeln zu mehreren gleichzeitig ausstehenden Angebotsalternativen. Die **Angebots-Pflichtdaten sind für v0.11 bereits verbindlich festgelegt**; Parallelangebote sind nicht MVP-Umfang. [Zum Szenarioüberblick](../README.md) · [P02](../V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) diff --git a/docs/Prozessarchitektur/Szenarien/R07_Eigenbelegung_und_Sperren.md b/docs/Prozessarchitektur/Szenarien/R07_Eigenbelegung_und_Sperren.md index 987c139..e3707c8 100644 --- a/docs/Prozessarchitektur/Szenarien/R07_Eigenbelegung_und_Sperren.md +++ b/docs/Prozessarchitektur/Szenarien/R07_Eigenbelegung_und_Sperren.md @@ -3,7 +3,7 @@ typ: referenzszenario titel: A6 – Eigenbelegung, private Überlassung und Sperren status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # R07 – Eigenbelegung, private Überlassung und Sperren (A6) diff --git a/docs/Prozessarchitektur/Szenarien/R08_Destination_Solutions.md b/docs/Prozessarchitektur/Szenarien/R08_Destination_Solutions.md index 936fa28..39eba28 100644 --- a/docs/Prozessarchitektur/Szenarien/R08_Destination_Solutions.md +++ b/docs/Prozessarchitektur/Szenarien/R08_Destination_Solutions.md @@ -3,7 +3,7 @@ typ: referenzszenario titel: Destination Solutions – verbindliche Buchung, Vermieterabwicklung status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # R08 – Destination Solutions (A3) @@ -26,6 +26,10 @@ ## Verarbeitung P01–P05 - **P04:** Gäste betreuen, Schlüssel/Reinigung/Dienstleister und ggf. lokale Abgaben organisieren. - **P05:** Leistung/Feedback abschließen, ausstehende Zahlung/Provision/Streitfragen zuständig weiterführen. +## Datenanreicherung bei fehlenden Gastinformationen (v0.11) + +Die extern **bereits verbindliche** Buchung wird unabhängig von der Vollständigkeit der Gastdaten in P01/P02 übernommen und gesichert. Eingehende Portal-E-Mails können über vorhandene Parser und den Communication Handler derselben Buchung zugeordnet werden. Fehlende administrative Angaben können nach den phasenabhängigen CH-03-Regeln ergänzt oder gezielt beim Gast angefordert werden; **es entsteht weder eine Klärungsreservierung noch ein neues eigenes Angebot**. Der tatsächlich verwendete Zugang verfügt laut dokumentiertem Betreiberstand weiterhin **nicht** über iCal-Synchronisation; diese v0.11-Ergänzung behauptet keine solche Integration. + ## Vom Betreiber genannte Stornostaffel | Zeit bis Mietbeginn | Anteil des „Mietpreises“ | diff --git a/docs/Prozessarchitektur/Szenarien/R09_FeWoDirekt.md b/docs/Prozessarchitektur/Szenarien/R09_FeWoDirekt.md index 42ce1c0..ff5d3db 100644 --- a/docs/Prozessarchitektur/Szenarien/R09_FeWoDirekt.md +++ b/docs/Prozessarchitektur/Szenarien/R09_FeWoDirekt.md @@ -3,7 +3,7 @@ typ: referenzszenario titel: FeWo-direkt – extern verbindlich, geteilte Abwicklung status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # R09 – FeWo-direkt (A4) @@ -22,6 +22,10 @@ ## Nachweisbare Preis- und Zahlungsinformationen eines Beispiels Eine gezeigte Stornoübersicht nennt vollständige Erstattung bei mehr als 60 Tagen, 50 % bei mehr als 30 Tagen und keine Erstattung bei weniger als 30 Tagen. Exakte Grenztage und Einbeziehung im Abschluss sind zu prüfen. Diese Anzeige ist **nicht** automatisch identisch mit der eigenen nachträglichen Vertragsvorlage. +## Zeitlich versetzte Nachricht und Kalenderinformation (v0.11) + +Die bestehende regelbasierte iCal-Eingangserkennung wird **nicht** durch die neuen Mail-Verifikationsregeln ersetzt. Trifft eine Portal-Mail vor oder nach der Kalenderinformation ein, wird ein bereits vorhandener Buchungsvorgang bei eindeutiger Zuordnung **nicht erneut angelegt**. Fehlende Gastdaten werden über den gemeinsamen phasenabhängigen Fakteneingang ergänzt. Widersprüchliche oder zweifelhafte Angaben werden zur Prüfung bereitgestellt; eine bereits verbindliche Portalbuchung bleibt davon unberührt. + ## Besondere Abläufe - iCal-Übernahme externer Sperren kann verzögert sein; keine Live-Verfügbarkeitsgarantie für FeWo-direkt annehmen. diff --git a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md index f712076..1aa8c43 100644 --- a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md +++ b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Buchungseingang und Verfügbarkeit status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # P01 – Buchungseingang und Verfügbarkeit @@ -13,12 +13,14 @@ # P01 – Buchungseingang und Verfügbarkeit ## Aktivitäten 1. **Eingang klassifizieren:** Eigene Website, externer Kanal, Telefon/manuell oder interner Belegungsanlass; unterscheiden zwischen unverbindlicher Anfrage, bereits extern verbindlicher Buchung, A6-Nutzung/Sperre und ungeklärter Fremdmeldung. Vorhandene Owner-/Ursprungskanal-Zuordnung nutzen. Partnerherkunft nur erfassen, wenn kaufmännisch relevant. -2. **Identität und Daten übernehmen:** Unterkunft, Zeitraum, externe Referenz, verfügbare Gastdaten und Statusquellen. Meldungen desselben externen Buchungsfalls zusammenführen, nicht mehrfach Vorgänge erzeugen. **Unklare iCal-Sperre ist nicht automatisch ein Gastvertrag.** Fehlende Angaben bleiben unbekannt und lösen nur bei Bedarf Klärung aus. +2. **Identität und Daten übernehmen:** Unterkunft, Zeitraum, externe Referenz, verfügbare Gastdaten und Statusquellen. Meldungen desselben externen Buchungsfalls zusammenführen, nicht mehrfach Vorgänge erzeugen. **Unklare iCal-Sperre ist nicht automatisch ein Gastvertrag.** Fehlende Angaben bleiben unbekannt und lösen nur bei Bedarf Klärung aus. **Neu v0.11:** E-Mail-/Portalnachrichten und Gastformular ergänzen über den gemeinsamen, phasenabhängig kontrollierten Fakteneingang; die bestehende iCal-Ereignisverarbeitung bleibt unverändert. 3. **Verfügbarkeit bewerten:** Bereits verbindliche Buchungen, interne Belegungen, aktive Holds und bestehende Kalenderkonflikte berücksichtigen. Neue bereits extern verbindliche Konfliktbuchung **nicht still löschen oder für unverbindlich erklären**. -4. **Angebots-/Belegungswirkung festlegen:** Bei unverbindlicher Anfrage gilt die konfigurierbare Haltefrist. Bei `>0` interne Vorreservierung und passende externe Sperraktionen; bei `0` keine Sperre allein wegen der Auskunft. Für A6 entsteht ein eigener Vorgang mit Grund; bei Wartung kann der weitere Ablauf sehr kurz sein. Ein Hold innerhalb A1/A2 erzeugt keinen A6-Vorgang. +4. **Angebots-/Belegungswirkung festlegen:** Bei unverbindlicher A1/A2-Anfrage mit fehlenden Angaben kann **vor der Angebotsphase** eine getrennt konfigurierbare **Klärungsreservierung** V0/V1 geprüft werden: Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt und positive bestehende Verfügbarkeitsprüfung; bei Klärungsdauer `0` keine solche Sperre. Sie beginnt bei V1 mit qualifiziertem Eingang und endet automatisch, ohne durch Rückfragen verlängert zu werden. **Erst wenn die Angebots-Gates erfüllt sind**, greift die **unveränderte bestehende Angebots-Haltefrist**: bei `>0` interne Vorreservierung und passende externe Sperraktionen mit verbindlichem Angebot; bei `0` keine Sperre allein wegen der unverbindlichen Auskunft. Für A6 entsteht ein eigener Vorgang mit Grund; bei Wartung kann der weitere Ablauf sehr kurz sein. Ein Hold innerhalb A1/A2 erzeugt keinen A6-Vorgang. 5. **Externe Kalender behandeln:** Wo möglich automatisch aktualisieren, andernfalls priorisierte manuelle Sperraufgabe. Zeitpunkt, Quelle, Bearbeiter und ggf. sichtbaren Nachweis erfassen. „Gesendet“, „im Zielportal sichtbar“ und „in Partnerkanälen nachweislich wirksam“ sind nicht gleichbedeutend; unbekannte Wirkung bleibt unbekannt. 6. **P02 übergeben:** Anlass, Archetyp, Belegungsstatus, Quellen und offene erforderliche Aufgaben; bei extern verbindlicher Buchung Nachweis des bereits erfolgten Abschlusses. +**Datenbeschaffung als Querschnitt (v0.11):** Für fehlende Angaben löst die bestehende Prozesssteuerung nach wirksamer Kanalkonfiguration einen Kommunikationsauftrag aus. Der Communication Handler steuert Rückfrage/Link/IMAP und liefert geprüfte Angaben an die gemeinsame Datenübernahme, nicht an eine zweite Buchungssteuerung. Bei gesperrtem Zeitraum `0` darf keine Reservierung kommuniziert werden, bei wirksamem Kurzblock nur die tatsächliche Ablauffrist. Bereits extern verbindliche A3–A5-Buchungen dürfen weder aufgrund fehlender Gastdaten noch aufgrund eines neuen Klärungs-Gates zurückgesetzt werden. [Normative Details CH-01–CH-18](../Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + ## Ergebnisse und Grenzen - Anfrage ohne Hold: Preis-/Verfügbarkeitsauskunft möglich, aber **keine Verfügbarkeitsgarantie**. diff --git a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md index 685b4dc..867d922 100644 --- a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md +++ b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Konditionen und Buchungsverbindlichkeit status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # P02 – Konditionen und Buchungsverbindlichkeit @@ -12,16 +12,27 @@ # P02 – Konditionen und Buchungsverbindlichkeit ## A1/A2 – Eigener Buchungsweg +**Neues Informations-Gate v0.11 (vor eigenem verbindlichem Angebot):** Vorname und Nachname des Vertragspartners, eindeutige Anzahl der reisenden Personen, An- und Abreise, E-Mail und **vollständige postalische Anschrift** müssen vorliegen und validiert sein. Eine fehlende Anschrift ist ein **nicht manuell übergehbarer Blocker**. Die bestehenden Preis-, Dokumenten-, Freigabe- und Verfügbarkeitsprüfungen gelten zusätzlich. Einzelne Namen aller Mitreisenden und vollständige Zusatzleistungswahl sind dagegen nicht generell erforderlich; eine verpflichtende Altersaufteilung ist noch nicht abschließend bestimmt. + +Diese Angebotsvoraussetzungen sind **nicht** die Mindestqualifikation der optionalen **vorgelagerten** Klärungsreservierung. Deren Ende, `0`-Einstellung oder Nachrichtenaustausch dürfen die bestehende Angebotsfrist nicht verändern. [Communication Handler und Datenbeschaffung](../Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + + **Haltefrist > 0:** Erforderliche Angaben und Preisgrundlagen feststellen; gültige Jahres-/Saisonpreise, Rabatte und Leistungen berücksichtigen; passende Vorlage einschließlich Bedingungen und Anlagen wählen. Eine wirksame Vorreservierung wird mit einem **zeitlich passenden verbindlichen Angebot** verbunden. Angebot/Konditionsstand und Versand nachweisbar halten. Rechtzeitige, wirksame Annahme über einen geeigneten, abgesicherten (z. B. signierten) Annahmeweg begründet den Vertrag ohne zweite Vermieterzustimmung. Fristablauf, Ablehnung oder abändernde/verspätete Annahme führen in den jeweils passenden Klärungs-/Neuantragsweg; fremde wirksame Belegungen werden nicht gelöscht. **Haltefrist = 0:** Eine **Preis-/Verfügbarkeitsauskunft unter Vorbehalt** senden; keine Reservierung und kein Annahmeweg, der irrtümlich sofort einen Vertrag entstehen lässt. Bei einem späteren Buchungswunsch Verfügbarkeit **erneut prüfen** und dann nach gültiger Vermieter-/Kanaleinstellung automatisch bestätigen oder manuell freigeben. Die Bedingungen des tatsächlichen Vertragsschlusses sind maßgeblich. Eine eigenständige Preisbindefrist ist im MVP **nicht vorgesehen**. +**Änderungswünsche vor Annahme:** Der Communication Handler erkennt und dokumentiert Änderungsbegehren, die im MVP **kontrolliert manuell/fachlich** zu bearbeiten sind. Ein Wunsch allein ersetzt oder widerruft kein gültiges Angebot und startet keine neue Vorreservierungsfrist. Parallele alternativ annehmbare Angebote und eine einmalige Sonderverlängerung sind **nicht Teil der v0.11-MVP-Normierung**, sondern Gegenstand späterer P02-Rechts-/Fachspezifikation. + ## A3–A5 – Extern bereits verbindliche Buchung -Die Buchung ist **bereits vor Eingang in FewoPortal verbindlich**. Externe Buchungsreferenz, maßgeblicher Preis, Konditions- und Stornostand sowie die Nachweisqualität übernehmen; **keine zweite Angebotsannahme**. Eigene Preiskalkulation oder Vertragsvorlage darf den gebuchten Preis bzw. akzeptierte Bedingungen **nicht** still ersetzen. Fehlende Daten gezielt nachfordern; unterschiedliche Bereitstellungstiefe (Gesamtpreis oder Einzelwerte) ist zulässig. +Die Buchung ist **bereits vor Eingang in FewoPortal verbindlich**. **Fehlende Gastinformationen ändern daran nichts: Neue Klärungsreservierungen und die eigene Angebotsannahme werden nicht nachträglich verlangt. Die Datenbeschaffung nach v0.11 dient nur den noch erforderlichen administrativen Folgehandlungen.** Externe Buchungsreferenz, maßgeblicher Preis, Konditions- und Stornostand sowie die Nachweisqualität übernehmen; **keine zweite Angebotsannahme**. Eigene Preiskalkulation oder Vertragsvorlage darf den gebuchten Preis bzw. akzeptierte Bedingungen **nicht** still ersetzen. Fehlende Daten gezielt nachfordern; unterschiedliche Bereitstellungstiefe (Gesamtpreis oder Einzelwerte) ist zulässig. Für A3/A4 passende Unterlagen zur bestehenden Buchung erzeugen, soweit eigene Dokumentation erforderlich und mit dem tatsächlichen Vertragsstand vereinbar ist. Für A5 nur die Dokumentation, die eigenen Pflichten entspricht. Ob der Gast bestimmte AGB/Stornoklauseln vor Buchung gesehen hat, ist ggf. **offen und zu prüfen**, nicht aus späterem PDF-Versand abzuleiten. +## Änderungswünsche nach Vertragsschluss (v0.11 MVP) + +**Änderungswünsche nach Vertragsschluss (MVP):** Vertragsanpassung, verkürzter Aufenthalt, veränderte Personenzahl, Storno-/Zahlungswirkung zunächst **manuell** prüfen und über den vorhandenen zuständigen Fachprozess bearbeiten; keine neue automatische Umbuchungs- oder Storno/Neubuchungsroutine. Eindeutig fehlende rein administrative Daten können nach CH-03 kontrolliert ergänzt werden. Eine Stornierung und Neubuchung ist allenfalls ein **im Einzelfall manuell zu prüfender** Übergangsweg und kein freigegebener Standard. + ## A6 – Interne Nutzung und Sperre Bei privater Überlassung ggf. Aufenthalts-/Reservierungs-/Buchungsbestätigung mit zutreffenden Teilnehmern, Zusatzleistungen und Konditionen. Eine Wartungs- oder sonstige reine Sperre benötigt keinen Mietvertrag; das Ergebnis kann interne Bestätigung oder `nicht anwendbar` sein. Die Belegungssicherung erfolgt unabhängig davon, ob ein Mietpreis anfällt. diff --git a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md index 4680d6e..8c9068d 100644 --- a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md +++ b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Buchungsverwaltung und kaufmännische Abwicklung status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # P03 – Buchungsverwaltung und kaufmännische Abwicklung @@ -19,6 +19,10 @@ ## Aktivitäten 5. **Fristen und Abweichungen überwachen:** Anzahlungen/Restzahlungen, offene Forderungen, bestätigte Portalzahlungen, erwartete Auszahlungen, Mahnungen/Storno-/Änderungsfälle gemäß tatsächlicher Zuständigkeit. Nachweise und Abweichungen verknüpfen, ohne die verbindliche Buchung willkürlich umzuschreiben. 6. **P04 versorgen:** Erforderliche Informationen, Aufgaben und Kontakte für den Aufenthalt bzw. die private Nutzung/Wartung bereitstellen; nicht kritische Abrechnungsdetails dürfen als offene Aufgabe verbleiben. +## v0.11 – Administrative Datenanreicherung bei bestehendem Vertrag + +Fehlende und eindeutig zugeordnete **rein administrative** Gastangaben können nach Validierung über den gemeinsamen Fakteneingang ergänzt werden, auch wenn die Buchung bereits verbindlich ist. Unklare oder widersprüchliche Werte werden zur Prüfung gestellt. Änderungen an **Vertragsinhalt, Personenanzahl, Aufenthaltszeitraum, Preis, Forderungen oder Stornowirkung** sind nicht als administrative Datenkorrektur zulässig; sie werden als Änderungswunsch erfasst und zunächst über den bestehenden Fachprozess **manuell** bearbeitet. Der Communication Handler erzeugt daraus weder eine neue Buchung noch ändert er die Verbindlichkeit des bestehenden Vertrags. Näheres: [Datenbeschaffung und Communication Handler](../Querschnitt/Datenbeschaffung_und_Communication_Handler.md). + ## Anforderungen an die Darstellung Für den Vermieter wenige verständliche nächste Schritte, nicht mehrere getrennte Portalmasken. Bei fehlenden Informationen unterscheiden zwischen **„nicht geliefert“**, **„nicht erforderlich“**, **„widersprüchlich“** und **„nachgewiesen“**. Ein als „laut Portal bezahlt“ markierter Betrag ist nicht automatisch auf dem Vermieterkonto eingegangen. diff --git a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md index 5b9a612..907e2ea 100644 --- a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md +++ b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Leistungsvorbereitung und Aufenthalt status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # P04 – Leistungsvorbereitung und Aufenthalt @@ -19,6 +19,10 @@ ## Aktivitäten 5. Auf Aufenthaltsänderung, verspätete Anreise, No-show, Verlängerung, Reklamation und Schäden über die vorhandenen Sonderprozesse reagieren. 6. Bei Wartung/organisatorischer Sperre statt Gästebetreuung die nötigen Arbeits-/Prüfaktivitäten ausführen und den Zeitraum geschützt halten. +## v0.11 – Informationsbedarf je anstehender Aktivität + +Die erforderlichen Anreise-, Kontakt-, Mitreisenden- und gegebenenfalls Meldeinformationen werden **für die konkret bevorstehende Aktivität** geprüft und können auch nach Vertragsschluss per E-Mail oder sicherem Ergänzungslink angefordert werden. Es werden keine über das Angebots-Gate hinausgehenden Pflichtangaben rückwirkend für den Abschluss eines bereits verbindlichen Vertrages eingeführt. Administrative Ergänzungen und vertragsrelevante Änderungen folgen den unterschiedlichen Regeln des [Communication Handlers](../Querschnitt/Datenbeschaffung_und_Communication_Handler.md). Die Einzelheiten der Melde-/Abgabepflichten bleiben gesondert zu prüfen. + ## Ergebnis Leistung/Arbeit wurde erbracht oder die relevante Abweichung ist geklärt beziehungsweise als Aufgabe sichtbar. P03-Finanzfragen können weiterlaufen, sofern sie nicht Voraussetzung für diese Tätigkeit sind. diff --git a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md index 4fd9662..17f1da1 100644 --- a/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md +++ b/docs/Prozessarchitektur/V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Abschluss und Nachbereitung status: fachlicher-arbeitsstand -version: "0.10" +version: "0.11" --- # P05 – Abschluss und Nachbereitung diff --git a/docs/Prozessarchitektur/V02_Vermarktung_und_Gaestebindung.md b/docs/Prozessarchitektur/V02_Vermarktung_und_Gaestebindung.md index 25db881..e8534ae 100644 --- a/docs/Prozessarchitektur/V02_Vermarktung_und_Gaestebindung.md +++ b/docs/Prozessarchitektur/V02_Vermarktung_und_Gaestebindung.md @@ -3,7 +3,7 @@ typ: wertschöpfungsprozess titel: Vermarktung, Gästegewinnung und Gästebindung status: rahmenmodell -version: "0.10" +version: "0.11" --- # V02 – Vermarktung, Gästegewinnung und Gästebindung diff --git a/docs/Prozessarchitektur/v.09 komplett.zip b/docs/Prozessarchitektur/v.09 komplett.zip deleted file mode 100644 index 6d8e359..0000000 Binary files a/docs/Prozessarchitektur/v.09 komplett.zip and /dev/null differ