Prozessarchitektur V0.11
This commit is contained in:
1 parent
2d2ffffa33
commit
9a9e5e157e
39 files changed
+1853
-73
No files matched your search
File diff suppressed because it is too large.
Load diff
@@ -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.
|
||||
|
||||
@@ -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**.
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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**.
|
||||
|
||||
@@ -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.
|
||||
Binary file not shown.
File renamed without changes.
File renamed without changes.
+138
@@ -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.
|
||||
File renamed without changes.
@@ -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) |
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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)).
|
||||
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
@@ -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.
|
||||
@@ -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) |
|
||||
|
||||
@@ -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)
|
||||
@@ -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)
|
||||
|
||||
@@ -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“ |
|
||||
|
||||
@@ -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.
|
||||
|
||||
+5
-3
@@ -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**.
|
||||
|
||||
+13
-2
@@ -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.
|
||||
|
||||
+5
-1
@@ -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.
|
||||
|
||||
+5
-1
@@ -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.
|
||||
|
||||
+1
-1
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Abschluss und Nachbereitung
|
||||
status: fachlicher-arbeitsstand
|
||||
version: "0.10"
|
||||
version: "0.11"
|
||||
---
|
||||
|
||||
# P05 – Abschluss und Nachbereitung
|
||||
|
||||
@@ -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
|
||||
|
||||
Binary file not shown.
Reference in new issue
Block a user