Prüfbericht zum Eingang und zur Datenanreicherung sichern, mit dem Archiv der Prozessarchitektur v0.9.
Deploy FeWo mit PipelineManager / deploy (push) Successful in 4m40s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 4m40s
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
234e642e4d
commit
150a64e100
2 files changed
+360
No files matched your search
@@ -0,0 +1,360 @@
|
||||
# Architekturaudit: Multikanal-Eingang, Datenanreicherung und selbstständige Prozessfortsetzung
|
||||
|
||||
**Stand:** 02.11.2026 · **Prüfstand:** Branch `feature/aufenthalt`, Commit `234e642` (Pakete 1–9) · **Art:** reiner Prüf- und Analysebericht. Kein Code, keine Daten und keine normative Spezifikation wurden verändert.
|
||||
|
||||
**Geprüft:**
|
||||
- die normative Prozessarchitektur v0.10 (`docs/Prozessarchitektur/`);
|
||||
- die historische Fassung v0.9 aus dem Archiv `v.09 komplett.zip`;
|
||||
- die Konzepte außerhalb des Ordners: [UEBERGABE-BUCHUNGSPROZESS.md](../UEBERGABE-BUCHUNGSPROZESS.md), [konzept-vermietung](../architecture/konzept-vermietung/), [DATENMODELL-KONZEPT.md](../DATENMODELL-KONZEPT.md), [GAP-DELTA.md](../GAP-DELTA.md) und [PORTALE.md](../PORTALE.md);
|
||||
- Quellcode und Tests der aktuellen Implementierung.
|
||||
|
||||
---
|
||||
|
||||
## 1. Zusammenfassung und Gesamturteil
|
||||
|
||||
**Gesamturteil: Der Vorgangskern ist tragfähig. Die Implementierung ist aber tatsächlich auf wenige fest programmierte Eingangs- und Bearbeitungswege verengt.** Die Datenbeschaffung ist heute praktisch vollständig manuell. Einen gemeinsamen Mechanismus, über den beliebige Quellen Informationen zu einem Vorgang beitragen, gibt es nicht. Das ist eher eine Lücke in Geschäftsprozess, Konnektoren und Konfiguration als eine grundlegende Strukturschwäche. Eine schlanke Erweiterung bestehender Komponenten reicht; eine neue Workflow-Engine ist nicht nötig.
|
||||
|
||||
**Was trägt:**
|
||||
- **Ein Vorgang je Geschäftsfall:** Portalbuchungen per E-Mail und iCal werden dubletten-sicher zu einem Vorgang zusammengeführt (`PortalIntake`).
|
||||
- **Abgeleitete Aktivitäten:** Die Aktivitäten werden aus dem Zustand errechnet und nicht gespeichert (`CaseActivities`).
|
||||
- **Selbsttätiges Weiterführen:** `CaseAutomation::advance()` führt einen Vorgang weiter, sobald seine Daten es erlauben, und nennt sonst die Hindernisse.
|
||||
- **Eingefrorenes Abwicklungsprofil** mit der Hierarchie Vermieter → Wohnung → Kanal × Eingangsart (`ProcessSettings`).
|
||||
- **Ereignisverlauf** mit Akteur und Daten (`CaseLog`).
|
||||
- **Geschützter Vertragsstand:** angenommenes Angebot mit Hash, Änderung nur über `ChangeBooking`.
|
||||
- **Testbetrieb:** eine Schranke für jede ausgehende E-Mail.
|
||||
|
||||
**Was fehlt (nachgewiesen):**
|
||||
1. **Informationsbedarf je Prozessschritt** ist weder konfigurierbar noch strukturiert hinterlegt.
|
||||
- Fest im Code als Pflicht für das Weiterführen: nur die E-Mail-Adresse des Gastes, beim Angebot sein Name und bei Bestätigung oder Vertragsunterlagen der Preis.
|
||||
- Die **Anschrift ist kein Gate.** Sie fällt nur als Lücke in einer Vertragsvorlage auf. In der Automatik hält das an; von Hand lässt es sich bestätigen und übergehen.
|
||||
2. **Keine automatische Rückfrage beim Gast.** Es gibt weder einen Ergänzungslink noch eine E-Mail zur Datenanforderung. „Gast um Kontaktdaten bitten“ liefert nur einen Text zum Kopieren; die Vermieterin trägt die Antwort von Hand ein.
|
||||
3. **Kein gemeinsamer Weg, auf dem neue Angaben einfließen.** Jeder Eingabeweg ruft die Fortsetzung selbst auf: Kontaktdaten, Portalbeträge, Portalübernahme sowie die Website-Anfrage und der Abschnitt `sendMails`. Der Kontaktdialog enthält dafür sogar eine **eigene Kopie** der Fortsetzungslogik. Wird der Gast anders geändert (Gastkartei, Bearbeiten), läuft nichts weiter.
|
||||
4. **Keine Herkunft je Angabe.** Gastdaten haben weder Quelle noch Zeitpunkt oder Verlässlichkeit. Widersprüche landen als Freitext in den internen Notizen. Nur Portalbeträge (`case_amounts`) speichern Quelle und Datum.
|
||||
5. **Der E-Mail-Eingang ist ein reiner Portal-Benachrichtigungsleser.**
|
||||
- Er liest nur hinterlegte Portalabsender.
|
||||
- Er erkennt nur Buchung, Storno und Anfrage, keine Änderung.
|
||||
- Er übernimmt nur Zeitraum und Buchungsnummer: keinen Gast, keinen Preis, keine Personenzahl.
|
||||
- Antworten erkennt er nicht; direkte Gast-E-Mails verarbeitet er nicht.
|
||||
6. **Der Konnektorvertrag kennt nur Kalenderbelegungen** (`fetchOccupations`). E-Mail ist ein eigener, fest verdrahteter Pfad neben dem Konnektorsystem.
|
||||
|
||||
**Verlorene ursprüngliche Anforderungen:** Ja, teilweise. v0.9 und der Prozessmodell-Entwurf vom 30.10.2026 forderten ausdrücklich:
|
||||
- einen wiederverwendbaren Klärungsprozess;
|
||||
- Informationsfelder mit Quelle und Status;
|
||||
- Eingangskanäle je Schritt, darunter ein Gastformular über einen signierten Link;
|
||||
- die automatische Fortsetzung nach Dateneingang.
|
||||
|
||||
v0.10 hat das auf wenige Sätze verdichtet: „Datenbeschaffung automatisch, manuell oder kombiniert“, „fehlende Daten gezielt nachfordern“. Die konkreten Bausteine sind dabei normativ nicht mehr greifbar, und die Umsetzung hat überall den manuellen Weg gewählt. Einzelheiten in §2.
|
||||
|
||||
**Empfohlener nächster Schritt:** zuerst die Spezifikation **schmal ergänzen**, um Informationsbedarf je Aktivität, Datenbeschaffung und Fortsetzung, und die offenen Entscheidungen in §8 treffen. Danach Empfehlung 2 (gemeinsamer Fakteneingang) als Grundlage für alle weiteren Kanäle umsetzen.
|
||||
|
||||
---
|
||||
|
||||
## 2. Nachweise aus normativer und historischer Spezifikation
|
||||
|
||||
### 2.1 Was v0.10 normativ fordert (gültig)
|
||||
|
||||
| Anforderung | Fundstelle v0.10 | Bewertung |
|
||||
|---|---|---|
|
||||
| Ein Vorgang je qualifiziertem Anlass, keine Dubletten aus mehreren Portalmeldungen | [Prozesslandkarte](00_Prozesslandkarte.md) „Einheitlicher Vorgang“; E-023; P01 Nr. 2 | ausdrücklich |
|
||||
| Technischer Eingang (E-Mail, iCal), Ursprungskanal und Partnerherkunft sind zu unterscheiden; „Telefon/manuell/iCal/E-Mail/API“ sind Informationskanäle, keine Archetypen | Prozesslandkarte; [Archetypen](01_Buchungsarchetypen.md) | ausdrücklich |
|
||||
| Unvollständige Daten sind Normalfall; gezielte Beschaffung, Klärung und späterer Abgleich zulässig; „Unbekannt ist nicht null“ | Prozesslandkarte „Führungsprinzip“; E-014 | ausdrücklich |
|
||||
| Konfigurationsbereich **„Datenbeschaffung: automatisch, manuell oder kombiniert“** | [K00](02_Abwicklungsprofile_und_Dokumente.md) Tabelle | ausdrücklich, aber ohne Inhalt (welche Daten, welcher Weg, welche Frist) |
|
||||
| Gates als **Voraussetzungen konkreter Aktionen**, z. B. „Adresse für ein eigenes Dokument“; die nächste Tätigkeit wartet nur auf die dafür nötigen Angaben | [G00](Querschnitt/Gates_und_Nachweise.md); [P02](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) „Zustandsregel“ | ausdrücklich als Prinzip; **kein Katalog**, welche Aktion welche Angaben braucht |
|
||||
| A3–A5: „Fehlende Daten gezielt nachfordern“ | P02 | ausdrücklich; Weg offen |
|
||||
| R01: „Angaben fehlen: gezielte Nachfrage; keine Platzhalter“; „exakt erforderliche Felder“ noch zu detaillieren | [R01](Szenarien/R01_Eigene_Webseite.md) | ausdrücklich als offener Punkt |
|
||||
| Nachweise: Quelle, Referenz, Zeitpunkt, Person/System, Aktualität – „kein universelles Nachweis-Enum für jedes Feld“ | G00 „Wesentliche Nachweise“ | ausdrücklich, bewusst schlank |
|
||||
| Automatisch/manuell je Vermieterstandard und Kanalabweichung; Kanal **und tatsächliche Eingangsart** | K00; E-029; E-030 | ausdrücklich |
|
||||
| V02 übergibt qualifizierte Anfragen an V01; Social Media, Kampagnen „nicht beschlossen“ | [V02](V02_Vermarktung_und_Gaestebindung.md) | nur Rahmen |
|
||||
| R02 (Telefon/manuell) und R03 (unverbindliche Portalanfrage) | [Szenariomatrix](Szenarien/00_Szenariomatrix.md) | nur „vorgemerkt“ |
|
||||
|
||||
**Nicht in v0.10 enthalten:**
|
||||
- Rückfrage mit sicherem Ergänzungslink;
|
||||
- Erkennen von Antworten;
|
||||
- direkte Anfragen per E-Mail als eigener Eingang;
|
||||
- Herkunft und Verlässlichkeit je Angabe;
|
||||
- Regeln zu Widersprüchen zwischen Quellen über X06 hinaus („klären, keine Scheingenauigkeit“);
|
||||
- Haltefrist während einer Datenrückfrage;
|
||||
- Erinnerung und Eskalation bei ausbleibenden Daten.
|
||||
|
||||
### 2.2 Historische Anforderungsnachweise (nicht automatisch gültig)
|
||||
|
||||
| Anforderung | Fundstelle | In v0.10? |
|
||||
|---|---|---|
|
||||
| „Je Portal, Eingangsart und ggf. Herkunft sind **Auslöser, Aktivitäten, Verantwortlichkeiten, Datenbeschaffung und Ausgänge konfigurierbar**“ | v0.9 `00_Prozesslandkarte.md` Abschnitt A | verkürzt auf die K00-Konfigurationsbereiche |
|
||||
| „Vorliegende Daten **mit Quelle und Verlässlichkeit** übernehmen; fehlende Informationen über **wiederverwendbaren Klärungsprozess** nachfordern“ | v0.9 `P01` Aktivität 3 | **entfallen**; v0.10 P01 Nr. 2 sagt nur: „lösen nur bei Bedarf Klärung aus“ |
|
||||
| Gate-Standardfelder: Auslöser, **benötigte Informationen (Pflicht und optional nach Kanal-/Aktivitätstyp)**, Quelle, Verantwortlich, Ergebnis, **Folgeaktivität bei fehlenden Daten oder Widerspruch** | v0.9 `G00` „Standardfelder je Gate“ | **entfallen**; G00 v0.10 nennt nur die Gate-Fragen |
|
||||
| Evidenzstatus je Datenpunkt (übermittelt / behauptet / geprüft / manuell ergänzt / nicht geliefert / widersprüchlich) als fachliches Beispiel | v0.9 `G00` | abgeschwächt („kein universelles Nachweis-Enum“) |
|
||||
| **Informationsfelder der Buchung mit Status und Quelle**: bekannt (Portalmail / Kalender / Gast / manuell / Berechnung), unbestätigt, fehlt | [UEBERGABE-BUCHUNGSPROZESS.md §2b](../UEBERGABE-BUCHUNGSPROZESS.md) Baustein 1 (Vorschlag, vom Betreiber nicht bestätigt) | nicht übernommen |
|
||||
| Schritte mit **Eingangskanälen in Prioritätsreihenfolge** (Portalmail, Kalenderregel, **Gastformular über signierten Link**, Mail-Antwort, manuell, Berechnung), automatischer oder manueller Auslösung, Frist, Rückfall auf Aufgabe | ebd. Bausteine 2–3 | nicht übernommen |
|
||||
| FeWo-direkt: „Nach Eintrag der Kontaktdaten läuft der Prozess **wahlweise automatisch oder manuell** weiter“ | ebd. §2a | umgesetzt (manueller Eintrag) |
|
||||
| Archetyp „B – Portalanfrage, Daten unvollständig“ mit vorgeschaltetem Schritt „Informationen beschaffen“ | ebd. §2b | in A2 aufgegangen (v0.10: „Fehlende Daten ergänzen“) |
|
||||
| „Bei fehlenden entscheidungsrelevanten Angaben entsteht eine konkrete Rückfrage. Ihr Versand verlängert die Vormerkung nicht stillschweigend.“ | [Konzept_workflows.md](../architecture/konzept-vermietung/Konzept_workflows.md) F1 Nr. 4 | nicht übernommen |
|
||||
| „Wiederholte E-Mail, Kalendereintrag und spätere Buchungsdaten demselben externen Vorgang zuordnen“ | ebd. F3 Nr. 2 | ja (P01 Nr. 2) |
|
||||
| Rückfrage zu fehlender Angabe: „Vorlage oder Entwurf, anfangs freigeben“; Stopp bei neuer Antwort | [Konzept_automatisierung.md](../architecture/konzept-vermietung/Konzept_automatisierung.md) Tabelle; [Konzept_kunden-und-kommunikation.md](../architecture/konzept-vermietung/Konzept_kunden-und-kommunikation.md) | nicht übernommen |
|
||||
|
||||
**Ergebnis zur zentralen Frage:** Das Zielbild „ein Vorgang, Daten aus beliebigen Quellen, gezielte Beschaffung, Fortsetzung bei Vollständigkeit“ steht in v0.10 noch als Prinzip, nämlich in E-014, K00 „Datenbeschaffung“, G00, der P02-Zustandsregel und R01. Die **operativen Bausteine** aus v0.9 und dem Entwurf vom 30.10.2026 sind bei der Konsolidierung entfallen:
|
||||
- benötigte Informationen je Aktivität;
|
||||
- Quelle je Angabe;
|
||||
- wiederverwendbarer Klärungsprozess;
|
||||
- Eingangskanäle je Schritt;
|
||||
- signiertes Gastformular.
|
||||
|
||||
Der Umsetzungsplan v0.10 hat sie folgerichtig nicht beauftragt. Die Verengung ist also zu einem Teil spezifikationsbedingt und kein reiner Umsetzungsfehler.
|
||||
|
||||
---
|
||||
|
||||
## 3. Abgleich mit der tatsächlichen Implementierung
|
||||
|
||||
### 3.1 Eingang und Zuordnung
|
||||
|
||||
| Komponente | Was sie tut | Grenze |
|
||||
|---|---|---|
|
||||
| [CreateReservation](../../app/Actions/CreateReservation.php) (Website, Admin-Anfrage) | Vorgang mit Profil, Herkunft (`referral_source`, UTM), `origin_channel_id`, Hold nach Profil; Gast über E-Mail zugeordnet, **bestehende Kartei wird nicht überschrieben**, Abweichungen als Notiz (`guestFor`, Z. 111–149) | Abweichungen nur als Freitext; keine strukturierte Herkunft je Feld |
|
||||
| [BookingRequest](../../app/Livewire/BookingRequest.php) `rules()` Z. 320–340 | Pflicht: Zeitraum, Personen, Vor-/Nachname, E-Mail; Straße/PLZ/Ort **optional** | fest im Code; keine Konfiguration |
|
||||
| [ProcessPortalMail](../../app/Actions/ProcessPortalMail.php) + [MailboxReader](../../app/Channels/Mail/MailboxReader.php) | IMAP-Abruf nur für hinterlegte Portalabsender (`fetch($senders)`, Z. 54–99); Kanal über Absender (`channelFor`, Z. 108–130); signierter Push über n8n | keine Absender außerhalb der Portale, kein `In-Reply-To`/`References` (Z. 101–117) |
|
||||
| [PortalMailParser](../../app/Channels/Mail/PortalMailParser.php) → [ParsedPortalMail](../../app/Channels/Mail/ParsedPortalMail.php) | Typ (Buchung/Storno/Anfrage/Unbekannt), An-/Abreise, Buchungsnummer | **keine** Gastdaten, kein Preis, keine Personen; kein Typ „Änderung“ ([PortalEmailType](../../app/Enums/PortalEmailType.php)) |
|
||||
| [PortalIntake](../../app/Channels/Intake/PortalIntake.php) `evaluate()` Z. 62–148 | Zuordnung in fester Reihenfolge: bereits verknüpft → Spiegelung → **gleiche Buchungsnummer** → Vergangenheit/Sperre/privat → anderes Ursprungsportal → **gleiches Portal mit genau denselben Nächten** → Überschneidung = Klärung → Neuanlage nur bei Sicherheit; je Kanal aus/beobachten/anlegen/fortsetzen | `link()` (Z. 403) verknüpft nur den Eintrag; **keine Übernahme von Angaben** aus Mail oder Kalender in den Vorgang |
|
||||
| [SyncChannel](../../app/Actions/SyncChannel.php) Z. 58–72 | Mail-Sperre wird durch den Kalendereintrag ersetzt, wenn **iCal-UID = Mail-Buchungsnummer** | sonst bleibt sie zur Prüfung stehen |
|
||||
| [ChannelConnector](../../app/Channels/Contracts/ChannelConnector.php) | austauschbarer Kanal: `canImport`, `fetchOccupations` | **nur Belegungen**; keine Nachrichten, Gäste, Preise |
|
||||
| [TakeOverPortalInquiry](../../app/Actions/TakeOverPortalInquiry.php), [TakeOverExternalBooking](../../app/Actions/TakeOverExternalBooking.php) | Vorgang aus Portalanfrage bzw. verbindlicher Portalbuchung, Unbekanntes bleibt `null` | – |
|
||||
|
||||
### 3.2 Bewertung, Gates und Fortsetzung
|
||||
|
||||
| Komponente | Was sie tut | Grenze |
|
||||
|---|---|---|
|
||||
| [CaseAutomation](../../app/Process/CaseAutomation.php) `advance()`/`step()` Z. 29–60 | Im Modus „automatisch“: Anfrage → Angebot bzw. Auskunft; verbindlich → Unterlagen; sonst Liste der Hindernisse | wird nur von einzelnen Aktionen aufgerufen, nicht bei jeder neuen Angabe |
|
||||
| `documentBlockers()` Z. 67–74 | Gast fehlt / E-Mail fehlt / Preis fehlt | **fest verdrahtet**; Anschrift nicht enthalten |
|
||||
| [AutoOffer](../../app/Actions/AutoOffer.php) `blockers()` Z. 47–70 | offen, Hold aktiv, E-Mail vorhanden, frei, Texte freigegeben, plus „zu bestätigen“-Befunde des Dokuments | Anschrift wirkt nur indirekt: fehlender Platzhalter `mieter_anschrift` ([ContractPlaceholders](../../app/Documents/ContractPlaceholders.php) Z. 98–102) ist ein *Bestätigungs*befund ([DocumentComposer](../../app/Documents/DocumentComposer.php) Z. 210–213) |
|
||||
| [CaseActivities](../../app/Process/CaseActivities.php) Z. 63–75 | Aktivität „Kontaktdaten“: erledigt bei E-Mail, „wartet“ wenn erfragt | nur E-Mail, keine weiteren Felder |
|
||||
| [ViewBooking](../../app/Filament/Resources/Bookings/Pages/ViewBooking.php) `requestContactAction` Z. 316–331 | Text zum Kopieren ins Portal; vermerkt `contact_requested_at` | **kein Versand**, kein Link, keine Erinnerung |
|
||||
| [ProvideGuestContact](../../app/Actions/ProvideGuestContact.php) Z. 33–89 | Vermieterin trägt Kontaktdaten ein; „automatisch weiter“ bindet bzw. sendet Angebot | **eigene Fortsetzungslogik** neben `CaseAutomation`; überschreibt Gastkartei mit jedem nicht leeren Wert (Z. 51) |
|
||||
| [RecordPortalAmounts](../../app/Actions/RecordPortalAmounts.php) | Portalbeträge mit Quelle/Datum; danach `advance()` (Z. 65) | – |
|
||||
| [SubmitBookingWish](../../app/Actions/SubmitBookingWish.php) | Hold = 0: erneute Prüfung unter Sperre, idempotent, versionierter Link | Vorbild für einen versionierten, signierten Gastschritt |
|
||||
|
||||
### 3.3 Konfiguration, Verlauf, Schutz
|
||||
|
||||
- **Einstellungen** ([ProcessSetting](../../app/Enums/ProcessSetting.php) Z. 12–19): Bearbeitung, Vorreservierung, Haltefrist, Dokumente, Zahlungen, Gastnachrichten, Tage für die Anreise-Info und Vorlage.
|
||||
- Ebenen ([ProcessProfile](../../app/Process/ProcessProfile.php) Z. 18–27): System → Vermieter → Wohnung → Kanal (je Eingangsart) → Vorgang, also der Bearbeitungsmodus je Vorgang.
|
||||
- **Keine** Einstellung für Pflichtdaten je Schritt, Rückfrageweg, Erinnerung, Eskalation oder Haltefrist während einer Rückfrage.
|
||||
- **Verlauf:** [CaseLog::record](../../app/Process/CaseLog.php) (Z. 47) speichert Typ, Text, Akteur, Grund, Daten und Zeitpunkt.
|
||||
- Gastdatenänderungen werden nicht feldgenau mit Quelle protokolliert; [CaseRecorder](../../app/Process/CaseRecorder.php) vermerkt nur „Gast zugeordnet“.
|
||||
- **Schutz verbindlicher Daten:**
|
||||
- Angebotsstand mit `offer_terms`/`offer_hash`, Annahme mit Hash, Portalpreis als vereinbarter Preis.
|
||||
- Änderungen nur über `ChangeBooking` mit Änderungsangebot (P5/P6).
|
||||
- Bestätigte Werte sind damit gegen stilles Überschreiben durch die Prozesslogik geschützt.
|
||||
- Ein künftiger automatischer Fakteneingang müsste diese Grenze aber ausdrücklich respektieren; sie ist heute nur implizit, weil es keine automatischen Schreiber gibt.
|
||||
- **Missbrauchsschutz** ([config/fewo.php](../../config/fewo.php) Z. 57–70): Honeypot, Zeitfalle, Grenzen je IP und E-Mail, höchstens zwei gleichzeitig haltende Anfragen je E-Mail.
|
||||
- **Haltefrist:** wird bei Eingang gesetzt ([CreateReservation](../../app/Actions/CreateReservation.php) Z. 98) und beim Angebotsversand neu ab „jetzt“ berechnet ([DocumentComposer](../../app/Documents/DocumentComposer.php) Z. 163). [ExpireReservations](../../app/Actions/ExpireReservations.php) beendet abgelaufene Holds und Auskünfte.
|
||||
|
||||
---
|
||||
|
||||
## 4. Nachweismatrix E01–E15
|
||||
|
||||
Legende: **Spez.** = Spezifikation v0.10 (ausdrücklich / indirekt / nicht enthalten) · **Impl.** = vorhanden / teilweise / nicht vorhanden / nicht nachweisbar · **Arch.** = ohne Strukturänderung / begrenzte Erweiterung / grundlegende Anpassung.
|
||||
|
||||
| ID | Prüffall | Spez. | Impl. | Arch. | Nachweise und Begründung |
|
||||
|---|---|---|---|---|---|
|
||||
| **E01** | Website-Anfrage ohne vollständige Anschrift | ausdrücklich (P01 Nr. 2, P02 Zustandsregel) | **vorhanden** | ohne Strukturänderung | Anschrift optional ([BookingRequest](../../app/Livewire/BookingRequest.php) Z. 332–334); Vorgang entsteht. Test: `BookingRequestPageTest::test_request_requires_contact_data_and_consent` (Pflichtfelder) |
|
||||
| **E02** | Automatische Anforderung fehlender Daten | indirekt (K00 „Datenbeschaffung automatisch“, E-014; v0.9 ausdrücklich) | **nicht vorhanden** | begrenzte Erweiterung | Nur Kopiertext und Vermerk (`requestContactAction`). Test `CaseIntakeTest::test_a_portal_request_becomes_a_request_that_asks_for_the_missing_data` prüft nur die **Aufgabe** an die Vermieterin |
|
||||
| **E03** | Ergänzung über sicheren Weblink | nicht enthalten (nur im Entwurf von UEBERGABE §2b) | **nicht vorhanden** | begrenzte Erweiterung | Keine Route in [routes/web.php](../../routes/web.php) Z. 14–34. Vorbild: `information.show`/`information.wish` (signiert, versioniert, gedrosselt) |
|
||||
| **E04** | Ergänzung durch E-Mail-Antwort | nicht enthalten | **nicht vorhanden** | begrenzte Erweiterung | Postfach liest nur Portalabsender; keine Antwort-Erkennung ([MailboxReader](../../app/Channels/Mail/MailboxReader.php) Z. 54–117) |
|
||||
| **E05** | Automatische Fortsetzung nach Vervollständigung | ausdrücklich (R01, P02, K00, E-030) | **teilweise** | begrenzte Erweiterung | Nur wenn die Vermieterin im Kontaktdialog „automatisch weiter“ wählt oder Portalbeträge erfasst. Tests: `GuidedCaseHandlingTest::test_missing_data_stops_the_case_with_a_task_and_it_continues_automatically_afterwards`, `EndToEndAcceptanceTest::test_t03_…`. Kein zentraler Auslöser bei jeder neuen Angabe |
|
||||
| **E06** | Direkte Anfrage per E-Mail | indirekt (R02 vorgemerkt; Archetypen „E-Mail als Informationskanal“) | **nicht vorhanden** (nur manuelle Erfassung im Admin) | begrenzte Erweiterung | Kein Eingang außerhalb der Portalabsender; manuelle Anlage über `CreateBooking` (BookingForm „Anfrage“) |
|
||||
| **E07** | Portalanfrage per E-Mail | ausdrücklich (A2, R03 vorgemerkt) | **teilweise** | ohne Strukturänderung | `PortalIntake::inquiryMail` (Z. 253ff.) legt A2-Vorgang mit Zeitraum und Nummer an; **Gastname/Personen aus der Mail werden nicht übernommen**. Test `CaseIntakeTest::test_a_portal_request_becomes_…` |
|
||||
| **E08** | Portalbuchung: iCal vor E-Mail | ausdrücklich (P01 Nr. 2) | **teilweise** | begrenzte Erweiterung | Zuordnung über Buchungsnummer (`caseByReference`) oder `AlreadyKnown`, wenn UID = Nummer ([ProcessPortalMail](../../app/Actions/ProcessPortalMail.php) Z. 154–162). **Keine Anreicherung**, weil der Parser keine Gast- und Preisdaten liefert. Kein eigener Test dieser Reihenfolge auf Vorgangsebene |
|
||||
| **E09** | Portalbuchung: E-Mail vor iCal | ausdrücklich | **vorhanden** (Zusammenführung), Anreicherung nicht | ohne Strukturänderung | `CaseIntakeTest::test_a_booking_mail_becomes_a_case_and_the_later_calendar_entry_joins_it`; `PortalMailTest::test_calendar_without_shared_identity_keeps_the_mail_block_for_review`, `…_does_not_replace_an_unidentified_mail_block` |
|
||||
| **E10** | Widersprüchliche Informationen aus mehreren Quellen | ausdrücklich als Prinzip (X06, G00 „widersprüchlich“) | **teilweise** | begrenzte Erweiterung | Abweichende Buchungsnummer → Klärung (`PortalIntake` Z. 110–111); Portalbeträge bleiben als widersprüchliche Angaben sichtbar (P8); Gastdaten-Abweichung nur als Notiz (`CreateReservation::guestFor`); `ProvideGuestContact` überschreibt ohne Abgleich. Test: `AutomaticChannelRepresentationTest::test_missing_evidence_contradictions_…` |
|
||||
| **E11** | Wiederholte und zeitversetzte Eingänge | ausdrücklich | **vorhanden** für Portalmail/iCal | ohne Strukturänderung | Message-ID-Dublettenschutz ([ProcessPortalMail](../../app/Actions/ProcessPortalMail.php) Z. 38); `CaseIntakeTest::test_a_calendar_reservation_becomes_one_case_however_often_…`, `…_reported_once_…`; Buchungswunsch idempotent (`EndToEndStayAcceptanceTest`) |
|
||||
| **E12** | Social-Media-Anfrage und Kampagnenherkunft | indirekt (V02 Rahmen, „nicht beschlossen“) | **teilweise** | ohne Strukturänderung (Herkunft) / begrenzte Erweiterung (Eingang) | Website: `referral_source` (u. a. `social_media`, [ReferralSource](../../app/Enums/ReferralSource.php)), UTM, Aktionscode am Vorgang ([CreateReservation](../../app/Actions/CreateReservation.php) Z. 88, 93). Kein Lead-Objekt, kein Nachrichten-Eingang |
|
||||
| **E13** | Temporäre Reservierung läuft während der Rückfrage ab | nicht enthalten (offener Punkt „Beginn/Ende der Hold-Frist“, R01) | **nicht vorhanden** als Regel | begrenzte Erweiterung | Hold läuft unabhängig von Rückfragen ab ([ExpireReservations](../../app/Actions/ExpireReservations.php)); ein späteres Angebot setzt die Frist neu ([DocumentComposer](../../app/Documents/DocumentComposer.php) Z. 163) – eine bewusste Rückfrage-Frist gibt es nicht |
|
||||
| **E14** | Verbindliches Angebot bei fehlenden Pflichtdaten verhindern | ausdrücklich als Prinzip (G00 „Adresse für ein eigenes Dokument“) | **teilweise** | begrenzte Erweiterung | Hart: E-Mail und Name ([DocumentComposer](../../app/Documents/DocumentComposer.php) Z. 193–196). Anschrift: nur Bestätigungsbefund, hält die Automatik an, **von Hand übergehbar**. Test `DocumentCompositionTest::test_missing_contract_data_stops_the_automatic_offer` (Platzhalter) |
|
||||
| **E15** | Unterschiedliche Konfiguration je Kanal und Eingangsart | ausdrücklich (K00, E-029, E-030) | **vorhanden** für 8 Einstellungen; nicht für Datenbeschaffung | begrenzte Erweiterung (neue Einstellungen in bestehender Hierarchie) | [ProcessSettings](../../app/Process/ProcessSettings.php) `resolve()`; [KONFIGURATION_UND_WIRKSAMKEIT.md](KONFIGURATION_UND_WIRKSAMKEIT.md) |
|
||||
|
||||
**Bilanz:** Kein Fall erfordert eine grundlegende Anpassung.
|
||||
- Vorhanden: 3 (E01, E09 als Zusammenführung, E11).
|
||||
- Teilweise: 7 (E05, E07, E08, E10, E12, E14, E15).
|
||||
- Nicht vorhanden: 5 (E02, E03, E04, E06, E13).
|
||||
|
||||
Auf die Kernforderung, dass FewoPortal fehlende Daten selbst beschafft und danach weitermacht, entfallen ausschließlich „nicht vorhanden“ und „teilweise“.
|
||||
|
||||
---
|
||||
|
||||
## 5. Architekturbeurteilung
|
||||
|
||||
| Frage | Antwort |
|
||||
|---|---|
|
||||
| **1. Ist der Vorgangskern für ereignisgesteuerte, mehrstufige Datenanreicherung geeignet?** | **Ja.** Booking als Vorgang, abgeleitete Aktivitäten, `CaseAutomation` mit Hindernisliste, eingefrorenes Profil, Verlauf und Aufgaben (`BookingTask`, mehrfach je Art seit P9) tragen. Es fehlt eine **Eingangsschicht für Fakten** davor und ein **Anforderungskatalog** dahinter – keine neue Engine. |
|
||||
| **2. Ist die Implementierung zu stark auf manuelle Datenpflege ausgerichtet?** | **Ja.** Jede Ergänzung von Gastdaten läuft über einen Dialog der Vermieterin, der einzige „Rückfrage“-Weg ist ein Kopiertext, Mail- und Kalenderangaben (Name aus iCal) landen allenfalls als Hinweis in Notizen. Das war für Pakete 1–9 vertretbar (Sicherheit vor Automatik), entspricht aber nicht dem Ziel „weitgehend automatisiert“ (Prozesslandkarte, E-007). |
|
||||
| **3. Sind die Eingangsconnectoren ausreichend von der Prozesssteuerung getrennt?** | **Teilweise.** Gut: `PortalIntake` entscheidet zentral über Neuanlage/Zuordnung/Klärung; Konnektoren legen keine Buchungsschritte fest. Schwach: der Konnektorvertrag kennt nur Belegungen; E-Mail ist fest verdrahtet (`ProcessPortalMail` → `PortalIntake`); Fortsetzung wird an mehreren Stellen einzeln aufgerufen (Website-Anfrage, Kontaktdialog, Portalbeträge, beide Übernahmen, Moduswechsel, nächtlicher Lauf), `ProvideGuestContact` dupliziert die Fortsetzungslogik. |
|
||||
| **4. Neue Eingangskanäle ohne parallele Buchungsprozesse?** | **Für Belegungsquellen ja** (iCal-Konnektor, Regeln, Spiegelungen). **Für Nachrichten- und Datenquellen noch nicht**: Ein Instagram- oder Direktmail-Eingang müsste heute eigene Vorgangsanlage, Zuordnung und Fortsetzung programmieren – genau das Risiko paralleler Wege. |
|
||||
| **5. Welche ursprünglich vorgesehenen Anforderungen fehlen in v0.10?** | Benötigte Informationen je Aktivität/Gate; Quelle und Verlässlichkeit je Angabe; wiederverwendbarer Klärungsprozess; Folgeaktivität bei fehlenden Daten/Widerspruch; Eingangskanäle je Schritt inkl. signiertem Gastformular; Rückfrage ohne stille Hold-Verlängerung; Herkunft als Profilbedingung (Hub/Partner, UEBERGABE §2a). Siehe §2.2. |
|
||||
| **6. Normativ vorhanden, aber nicht umgesetzt?** | K00 „Datenbeschaffung automatisch, manuell oder kombiniert“ (nur manuell); P02 „Fehlende Daten gezielt nachfordern“ (nur Aufgabe); G00 „Adresse für ein eigenes Dokument“ als Aktionsvoraussetzung (nur Platzhalterbefund); X06 „Fehlende/widersprüchliche Felder klären“ für Gastdaten (Freitext). |
|
||||
| **7. Risiken einer Erweiterung ohne vorherige Korrektur?** | (a) Jeder neue Kanal baut eigene Zuordnungs- und Fortsetzungslogik → parallele Wege, widersprüchliches Verhalten, E-002 verletzt. (b) Automatisch eingelesene Angaben überschreiben ungeprüft (Muster `ProvideGuestContact`) – auch Daten fremder Personen, vgl. [GAP-DELTA](../GAP-DELTA.md) D8. (c) Datumsgleichheit wird zur Identität (s. u.). (d) Rückfragen ohne Hold-Regel blockieren den Kalender oder verlieren Gäste. (e) Ohne Herkunft je Angabe ist bei Streit nicht belegbar, woher ein Wert stammt. |
|
||||
| **8. Kleinste tragfähige Erweiterung?** | Drei Bausteine in bestehenden Komponenten: **(1)** eine Aktion „Angaben zum Vorgang beitragen“ (Fakten mit Quelle/Zeit/Verlässlichkeit/Referenz → Zuordnung über die vorhandenen `PortalIntake`-Regeln → Übernahme nach fester Schutzregel → `CaseLog` → `CaseAutomation::advance()`); **(2)** ein Anforderungskatalog je Aktion aus einer neuen Einstellung in der vorhandenen Hierarchie, der `documentBlockers`/`AutoOffer`-Prüfungen und die Aktivität „Kontaktdaten“ ersetzt; **(3)** eine Rückfrage als neue Dokument-/Mailart mit signiertem, versioniertem Ergänzungslink nach dem Muster der Auskunft (P7). Alles Weitere (Mail-Extraktion, Antworterkennung, Social) setzt darauf auf. |
|
||||
|
||||
**Abgrenzung der Ursachen:**
|
||||
|
||||
| Art | Befunde |
|
||||
|---|---|
|
||||
| Fehlende Konfiguration | Pflichtdaten je Schritt, Rückfrageweg, Erinnerung/Eskalation, Hold bei Rückfrage, Fortsetzung nach Dateneingang (heute je Dialog gewählt) |
|
||||
| Fehlender Connector | Direkte Gast-Mail, Antworterkennung, Extraktion von Gast/Preis/Personen aus Portalmails, Nachrichtenkanäle (Social) |
|
||||
| Fehlender Geschäftsprozess | Automatische Datenrückfrage mit Ergänzungslink; Regel für Widersprüche zwischen Quellen bei Gastdaten |
|
||||
| Strukturelle Schwäche (begrenzt) | Kein gemeinsamer Fakteneingang (Fortsetzung verstreut, Logik dupliziert); keine Herkunft je Angabe; Konnektorvertrag nur für Belegungen |
|
||||
|
||||
**Zuordnung allein nach Terminen (gesonderter Befund):** `PortalIntake::evaluate` verknüpft einen Eintrag automatisch mit einem Vorgang, wenn drei Bedingungen zusammenkommen: **dasselbe Portal, genau dieselben Nächte, genau ein belegender Vorgang**, und mindestens eine Seite hat keine Buchungsnummer ([PortalIntake](../../app/Channels/Intake/PortalIntake.php) Z. 108–113). Der Test `CaseIntakeTest::test_the_same_portal_with_the_same_nights_joins_the_existing_case` belegt das als gewolltes Verhalten.
|
||||
|
||||
Das Risiko ist begrenzt: Es wird nur verknüpft, nicht überschrieben, und dasselbe Portal kann dieselben Nächte nicht zweimal verkaufen. Es widerspricht aber dem Auftragsgrundsatz „übereinstimmende Termine sind kein sicherer Identitätsnachweis“ und [ical-kanalkonfiguration.md](../architecture/ical-kanalkonfiguration.md) („keine automatische Datumszusammenführung“). Sobald Angaben übernommen werden statt nur Einträge verknüpft, darf diese Regel **keine Datenübernahme** auslösen.
|
||||
|
||||
**Welche Zusammenführungen dürfen automatisch laufen:**
|
||||
- **Automatisch:**
|
||||
- gleiche Buchungsnummer desselben Portals;
|
||||
- iCal-UID gleich Buchungsnummer;
|
||||
- wiederholte Nachricht mit derselben Message-ID;
|
||||
- Antwort mit eindeutigem, signiertem Vorgangsschlüssel.
|
||||
- **Nur mit Klärung durch einen Menschen:**
|
||||
- Termin- oder Namensgleichheit ohne gemeinsame Kennung;
|
||||
- abweichende Buchungsnummern bei gleichen Nächten;
|
||||
- Überschneidungen;
|
||||
- Antworten ohne Schlüssel, etwa eine neue E-Mail von bekannter Adresse;
|
||||
- jeder Wert, der einen vorhandenen, abweichenden Wert ersetzen würde.
|
||||
|
||||
---
|
||||
|
||||
## 6. Wesentliche Lücken und Risiken
|
||||
|
||||
| # | Lücke / Risiko | Schwere | Belege |
|
||||
|---|---|---|---|
|
||||
| L1 | Kein Informationsbedarf je Aktivität; Anschrift kein hartes Gate vor dem verbindlichen Angebot | hoch (Betreiberanforderung) | §3.2; E14 |
|
||||
| L2 | Keine automatische Datenrückfrage, kein Ergänzungslink, keine Erinnerung/Eskalation | hoch (Kernziel) | E02, E03 |
|
||||
| L3 | Fortsetzung nach neuen Angaben nur aus einzelnen Dialogen; doppelte Fortsetzungslogik in `ProvideGuestContact` | mittel | E05; §3.2 |
|
||||
| L4 | Keine Herkunft/Verlässlichkeit je Gastangabe; `ProvideGuestContact` überschreibt Kartei; Abweichungen nur Freitext | mittel (Nachvollziehbarkeit, Datenschutz) | E10; GAP-DELTA D8 |
|
||||
| L5 | E-Mail-Eingang nur für Portalbenachrichtigungen, ohne Inhalte (Gast, Preis), ohne Änderungstyp, ohne Antworterkennung | mittel | E04, E06–E08 |
|
||||
| L6 | Konnektorvertrag nur für Belegungen; neue Nachrichtenkanäle hätten keinen Andockpunkt | mittel (Voraussetzung für Erweiterung) | §3.1 |
|
||||
| L7 | Keine Regel für Haltefrist während einer Rückfrage; Missbrauch nur durch die vorhandenen Formulargrenzen begrenzt | mittel | E13; `config/fewo.php` |
|
||||
| L8 | Termingleiche Zuordnung desselben Portals ohne Buchungsnummer | niedrig, wird relevant bei Datenübernahme | §5 |
|
||||
| L9 | Testbetrieb deckt nur Ausgang; eingehende Antworten im Testbetrieb sind nicht als „simuliert“ unterscheidbar | niedrig (heute keine eingehenden Gastantworten) | §7 unten |
|
||||
|
||||
**Testbetrieb und Sicherheit (Auftrag §10):** Das Prinzip ist vereinbar.
|
||||
- **Ausgehende Rückfragen** laufen über Laravels Mailer und damit durch die eine Schranke `EnforceMailTestMode`. Belegt ist das durch `MailTestModeGateTest` und `TestOperationSmtpAcceptanceTest`. Der Verlauf kennzeichnet Testzustellungen bereits als solche (`CaseRecorder::mailFact`).
|
||||
- **Ergänzungslinks** müssen dem Muster von Auskunft und Angebot folgen:
|
||||
- signierte Route mit Drosselung;
|
||||
- Versionsnummer, damit ältere Links ungültig werden;
|
||||
- Ablaufzeit;
|
||||
- Mandant über die Website-Adresse;
|
||||
- keine personenbezogenen Daten im Link.
|
||||
- **Eingehende Angaben** brauchen die Quelle (Gastlink, Antwortmail, Portal, Vermieterin, Test) im Verlauf.
|
||||
- Im Testbetrieb erreicht eine Rückfrage nur die Testadresse. Wer den Link dort betätigt, simuliert den Gast; der Eintrag sollte als „im Testbetrieb eingegangen“ erkennbar sein.
|
||||
- Echte Gastantworten aus dem Postfach dürfen im Testbetrieb höchstens beobachtet, nicht automatisch übernommen werden; das spiegelt den Kanalmodus „beobachten“.
|
||||
- **Postfachzugriff auf Nicht-Portalabsender** erweitert die Verarbeitung personenbezogener Daten. Dafür sind Löschfristen nötig, analog zum Mailauszug von Portalmails in `fewo.retention`, außerdem ein Eintrag im Datenschutzkonzept.
|
||||
|
||||
---
|
||||
|
||||
## 7. Empfehlungen (priorisiert, höchstens fünf)
|
||||
|
||||
### Empfehlung 1 – Spezifikation schmal ergänzen: Informationsbedarf, Datenbeschaffung, Fortsetzung
|
||||
|
||||
- **Problem:** v0.10 nennt „Datenbeschaffung“ nur als Überschrift. Ohne normative Grundlage wird jede Umsetzung wieder manuell oder erfindet Regeln (vgl. E-021, E00 „Grenze fachlicher Freigabe“).
|
||||
- **Bereits gedeckt?** Nur als Prinzip (K00, E-014, G00, P02, R01). Benötigt wird ein kurzer Abschnitt in K00 und G00, kein neues Dokument. Er soll festlegen:
|
||||
- Informationsbedarf je Aktion;
|
||||
- Unterscheidung von betrieblicher Pflicht und gesetzlicher Pflicht;
|
||||
- Beschaffungswege und ihre Reihenfolge;
|
||||
- Frist und Haltefrist bei Rückfrage;
|
||||
- Regeln für Erinnerung und Eskalation;
|
||||
- Fortsetzung automatisch oder per Freigabe;
|
||||
- Schutz verbindlicher Angaben;
|
||||
- zulässige automatische Zusammenführung.
|
||||
- **Bestehende Grundlagen:** v0.9 G00 (Gate-Standardfelder), UEBERGABE §2b, Konzept_workflows F1/F3, Konzept_automatisierung.
|
||||
- **Abhängig davon:** alle weiteren Empfehlungen.
|
||||
- **Charakter:** Voraussetzung. **Empfehlung: zuerst die Spezifikation ergänzen.** Die vorhandene reicht für eine belastbare Umsetzung nicht aus.
|
||||
|
||||
### Empfehlung 2 – Gemeinsamer Fakteneingang („Angaben zum Vorgang beitragen“)
|
||||
|
||||
- **Problem:** Fortsetzung ist verstreut, Logik doppelt, keine Herkunft je Angabe. Neue Kanäle müssten Prozesslogik kopieren (L3, L4, L6).
|
||||
- **Bereits gedeckt?** Ja, durch P01 Nr. 2, X06, G00 „Nachweise“ und E-002. Die Schutz- und Konfliktregel braucht Empfehlung 1.
|
||||
- **Nutzbare Komponenten:**
|
||||
- `PortalIntake` (Zuordnungsregeln);
|
||||
- `IntakeDecision` und `IntakeObservation` (beobachten/anlegen);
|
||||
- `CaseLog` (Verlauf mit Quelle);
|
||||
- `case_amounts` als Muster „Angabe mit Quelle und Datum“;
|
||||
- `CaseAutomation::advance()`.
|
||||
- **Voraussichtliche Änderungen:**
|
||||
- Eine Aktion nimmt eine Liste von Fakten entgegen: Feld, Wert, Quelle, Zeitpunkt, Verlässlichkeit, Referenz.
|
||||
- Sie ordnet den Vorgang über die vorhandenen Regeln zu und übernimmt Werte nur nach fester Regel: leere Felder füllen; Abweichung erzeugt eine Klärungsaufgabe; verbindliche Werte bleiben unangetastet.
|
||||
- Sie protokolliert und ruft danach `advance()` auf.
|
||||
- `ProvideGuestContact`, `RecordPortalAmounts` und die Übernahme-Aktionen nutzen sie.
|
||||
- Herkunft je Angabe kommt als schlanke Tabelle oder JSON am Vorgang dazu, ohne universelles Enum.
|
||||
- **Abhängig davon:** Empfehlungen 3–5 sowie alle künftigen Konnektoren.
|
||||
- **Charakter:** Voraussetzung für weitere Konnektoren.
|
||||
|
||||
### Empfehlung 3 – Anforderungsgesteuerte Gates je Aktion
|
||||
|
||||
- **Problem:** Die Pflichtangaben sind fest verdrahtet, die Anschrift ist kein hartes Gate, und die Vermieterin sieht nur „E-Mail fehlt“ (L1).
|
||||
- **Bereits gedeckt?** Ja, als Prinzip in G00 und der P02-Zustandsregel. Welche Felder Pflicht sind, ist eine offene Entscheidung (§8).
|
||||
- **Nutzbare Komponenten:**
|
||||
- `ProcessSetting`/`ProcessSettings` (eine neue Einstellung „benötigte Angaben je Aktion“ in der vorhandenen Hierarchie Vermieter → Wohnung → Kanal × Eingangsart);
|
||||
- `DocumentComposer` (Befundarten blocker/confirm);
|
||||
- `CaseActivities` und `WorkList`;
|
||||
- die Einstellungsübersicht aus [KONFIGURATION_UND_WIRKSAMKEIT.md](KONFIGURATION_UND_WIRKSAMKEIT.md).
|
||||
- **Voraussichtliche Änderungen:**
|
||||
- `documentBlockers()` und die E-Mail-Prüfung in `AutoOffer` durch eine Auswertung des Katalogs ersetzen.
|
||||
- Die Aktivität „Kontaktdaten“ wird zu „Angaben für den nächsten Schritt“ und listet, was fehlt, ob bereits nachgefragt wurde und bis wann.
|
||||
- Feste Sicherheitsregeln bleiben im Code: E-Mail für jeden Gastversand; Name für das Angebot; Preis für Bestätigung und Unterlagen.
|
||||
- **Abhängig davon:** Empfehlung 4, weil sie weiß, *was* anzufragen ist.
|
||||
- **Charakter:** Voraussetzung für die selbstständige Beschaffung.
|
||||
|
||||
### Empfehlung 4 – Automatische Rückfrage mit sicherem Ergänzungslink
|
||||
|
||||
- **Problem:** Es gibt keine selbstständige Datenbeschaffung (L2, E02, E03, E13).
|
||||
- **Bereits gedeckt?** Indirekt durch K00 und P02. Nötig sind Entscheidungen zu Haltefrist, Erinnerungen und Eskalation (§8).
|
||||
- **Nutzbare Komponenten:**
|
||||
- das Muster von `SendInformation`/`SubmitBookingWish` (signiert, versioniert, gesperrt, idempotent);
|
||||
- `DocumentKind` und `DocumentComposer`, `BookingTask` mit Fälligkeit für Erinnerung und Eskalation;
|
||||
- `SendBookingReminders` (täglicher Lauf);
|
||||
- `EnforceMailTestMode`;
|
||||
- `ExpireReservations`.
|
||||
- **Voraussichtliche Änderungen:**
|
||||
- Eine neue Mailart „Angaben ergänzen“ mit Formular, das nur die fehlenden Felder zeigt. Es schreibt über Empfehlung 2 mit der Quelle „Gast (Link)“.
|
||||
- Regeln für Rückfrage-Frist und Hold.
|
||||
- Eine Aufgabe an die Vermieterin, wenn keine Antwort kommt.
|
||||
- Im manuellen Modus Freigabe vor dem Versand (Konzept_automatisierung: „anfangs freigeben“).
|
||||
- **Abhängig davon:** das Prüfszenario aus §4 des Auftrags.
|
||||
- **Charakter:** Kernfunktion des Ziels, keine Komfortfunktion.
|
||||
|
||||
### Empfehlung 5 – E-Mail als vollwertige Informationsquelle (Extraktor-Schnittstelle, Antworterkennung)
|
||||
|
||||
- **Problem:** Portalmails liefern nur Termin und Nummer; Antworten und direkte Anfragen gehen verloren (L5, E04, E06–E08).
|
||||
- **Bereits gedeckt?** Indirekt (Archetypen „E-Mail als Informationskanal“, R02/R03 vorgemerkt). Direkte Gastmails und Antwortverarbeitung brauchen eine Entscheidung (§8).
|
||||
- **Nutzbare Komponenten:**
|
||||
- `PortalMailParser` (wird eine von mehreren Implementierungen einer Extraktor-Schnittstelle, die Fakten liefert: regelbasiert jetzt, KI-gestützt später über dieselbe Schnittstelle, jeweils mit Verlässlichkeit);
|
||||
- `MailboxReader` (Absenderfilter erweitern);
|
||||
- ein Antwortschlüssel über Reply-To mit Vorgangskennung oder die Message-ID-Referenzen der ausgehenden Mails, festgehalten in `BookingMessage`;
|
||||
- `PortalEmailType` um „Änderung“ und „Nachricht“ ergänzen.
|
||||
- **Übernahmeregel:** Unsichere Extraktionen gehen nur als Klärung in den Vorgang (Verlässlichkeit „behauptet“), nie als Überschreibung.
|
||||
- **Abhängig davon:** Social-Media- und Messenger-Eingänge, die denselben Weg nutzen (Nachricht → Fakten → Empfehlung 2). Ein Lead-Objekt erst nach einer V02-Entscheidung.
|
||||
- **Charakter:** Erweitert die Konnektoren; setzt Empfehlung 2 voraus.
|
||||
|
||||
**Reihenfolge:** 1 → 2 und 3, die parallel möglich sind → 4 → 5. Empfehlung 2 ist die eigentliche Architekturkorrektur. Ohne sie würde jede weitere Quelle einen neuen festen Bearbeitungsweg schaffen.
|
||||
|
||||
---
|
||||
|
||||
## 8. Offene fachliche Entscheidungen
|
||||
|
||||
1. **Pflichtangaben je Schritt:**
|
||||
- Welche Angaben braucht das verbindliche Angebot, welche die Bestätigung, die Anreise-Info und die Meldedaten?
|
||||
- Die vollständige Anschrift vor dem Angebot ist eine **Betreiberanforderung**. Ob und für welche Schritte sie gesetzlich nötig ist (z. B. Meldeschein nach §§ 29 f. BMG erst bei Anreise), ist nicht geprüft und wird hier nicht behauptet.
|
||||
2. **Haltefrist während der Rückfrage:**
|
||||
- Beginnt der Hold bei Eingang oder erst bei vollständigen Daten?
|
||||
- Gibt es eine eigene, kurze Rückfrage-Frist, etwa 3 Stunden als Prüfbeispiel, nicht als Standard?
|
||||
- Verlängert eine Antwort die Frist? Was gilt, wenn der Gast nach Ablauf antwortet?
|
||||
- Konzept_workflows: Eine Rückfrage verlängert die Vormerkung nicht stillschweigend.
|
||||
3. **Rückfrage automatisch versenden oder freigeben:** im Live-Betrieb, je Kanal und Eingangsart.
|
||||
4. **Erinnerung und Eskalation:** Anzahl und Abstand der Erinnerungen; ab wann die Vermieterin den Fall übernimmt.
|
||||
5. **Widersprüche zwischen Quellen:** Welche Quelle hat Vorrang (Portalmail, Kalender, Gast, Vermieterin)? Darf ein Gast über den Link Karteidaten ändern oder nur den Vorgang ergänzen?
|
||||
6. **Zuordnung nach Terminen:** Soll die heutige automatische Verknüpfung „gleiches Portal, gleiche Nächte, ohne Buchungsnummer“ bestehen bleiben, oder künftig zur Klärung werden?
|
||||
7. **Direkte Gast-E-Mails und Antworten:**
|
||||
- Darf das Postfach alle Mails lesen (Datenschutz, Löschfrist)?
|
||||
- Wird eine Mail ohne Vorgangsschlüssel zum neuen Vorgang oder zur Klärung?
|
||||
8. **Social Media und Kampagnen:** Ob ein Lead als eigener Vorgangstyp vor V01 kommt, ist nach V02 nicht beschlossen. Bis dahin genügen Herkunft und Kampagnenkennung am Vorgang.
|
||||
9. **Herkunft als Profilbedingung** (Hub direkt oder über ein Partnerportal, UEBERGABE §2a): bleibt sie bei „nicht ohne Entscheidung“ (K00), oder wird sie als dritte Kanalstufe eingeführt?
|
||||
|
||||
[Zur Startseite](README.md) · [Gates](Querschnitt/Gates_und_Nachweise.md) · [Konfiguration und Wirksamkeit](KONFIGURATION_UND_WIRKSAMKEIT.md)
|
||||
Binary file not shown.
Reference in new issue
Block a user