57 lines
11 KiB
Markdown
57 lines
11 KiB
Markdown
# V2.1 – Konfigurationslücken: bisherige Anforderung gegen V2
|
||
|
||
Stand: 05.11.2026 · Grundlage: Entscheidungen E-001 bis E-038, Archetypen (`01`), Abwicklungsprofile (`02` / K00), Szenarien R01–R09, Querschnitt „Communication Handler“ (CH-01 bis CH-18), Querschnitt „Gates und Nachweise“, `KONFIGURATION_UND_WIRKSAMKEIT`, `Vorschläge/KANALKONFIGURATOR`, Entscheidungspapier „Eingang und Gastlink“, die V2-Dokumente 00–06 mit Abschlussbericht, der Code (Stand `develop` `4410fb3`) und die Tests. Zusätzlich gelesen: der Live-Stand der Kanalkonfiguration auf stommer.info (nur lesend).
|
||
|
||
Kennzeichnung: **[Beschluss]** dokumentierte Entscheidung · **[Bestand]** im Code · **[Neu]** neue Anforderung dieses Auftrags (V2.1) · **[Offen]** fachlich nicht geklärt, nicht entschieden.
|
||
|
||
---
|
||
|
||
## 1. Was die Prüfung der ursprünglichen Entscheidungen ergibt
|
||
|
||
1. **Archetyp = Konstellation aus tatsächlicher Abwicklungsverantwortung, nicht der Name des Kanals** [Beschluss `01_Buchungsarchetypen`: „Maßgeblich sind die tatsächliche Eingangsart und Abwicklungsverantwortung, nicht nur der Name des Kanals“; K00: „kein automatisches ‚alle FeWo-direkt-Buchungen sind gleich‘“]. V2 hat das mit einer festen Liste je Portal (`config/channels.php › portal_profiles`) ins Gegenteil verkehrt.
|
||
2. **E-016 gilt „für den beschriebenen Vermieterzugang“** [Beschluss]: Destination Solutions = A3 ist die Beschreibung eines Kontos, keine Eigenschaft des Portals. R08 sagt dasselbe („Betreiberangaben zum konkret genutzten Zugang“). Die V2-Einschränkung „Destination Solutions nur A3“ war eine Planungsfestlegung (O2), kein Beschluss.
|
||
3. **Kanal-Fähigkeit ist ein vorgesehener Konfigurationsbereich** [Beschluss K00: „iCal/API/E-Mail/Portaloberfläche/manuell; Nachweis, Verzögerung, Vollständigkeit und erforderliche manuelle Schritte“]. V2 hat ihn nicht gebaut.
|
||
4. **Verantwortung ist mehrdimensional** [Beschluss K00: Vertrags-/Dokumentenversand, Gastkommunikation, Zahlung, Mahnung, Storno/Erstattung, lokale Leistungen, Kalender-/Sperrpflege]. V2 bildet Dokumente, Zahlung und Gastkommunikation nur grob ab.
|
||
5. **Phasen sind keine Reihenfolge** [Beschluss E-006, Prozesslandkarte: „Schritte können entfallen, parallel oder zu einem späteren Zeitpunkt ausgeführt werden“]. Der Runner kann das; die Oberfläche zeigt eine nummerierte Liste.
|
||
6. **Ein universeller Eingang; Chat und API sind Quellen** [Beschluss Entscheidungspapier E1: „Webseite, iCal, Portal-Mail, Gast-Mail, Chat, API, persönlicher Link, Eingabe von Hand“]. Messenger sind für den CH-MVP ausdrücklich ausgeklammert [Beschluss v0.11], aber als Quelle vorgesehen.
|
||
7. **Extern verbindlich bleibt verbindlich; ein Transportweg legt die Verbindlichkeit nicht fest** [Beschluss E-036, CH-09, A3–A5-Regel]. Gilt unverändert und bindet V2.1.
|
||
|
||
Keine der obigen Festlegungen wurde durch V2.1 geändert. V2.1 ersetzt keinen Beschluss; Abweichungen von V2-Planungsfestlegungen (O2, Pflichtschloss) sind unten einzeln begründet.
|
||
|
||
## 2. Matrix: Anforderung → V2 → Lücke → Ursache → Änderung
|
||
|
||
| # | Anforderung (Quelle) | V2 heute | Lücke | Ursache | Änderung in V2.1 |
|
||
|---|---|---|---|---|---|
|
||
| L01 | Modell folgt der tatsächlichen Verantwortung (Archetypen, K00) [Beschluss] | `portal_profiles`: Destination Solutions nur A3, FeWo-direkt nur A4 | Wechsel DS → A4 unmöglich, obwohl **auf stommer.info für DS bereits `booking.payments = portal` gespeichert ist** (Live-Stand 05.11.2026) | O2 als feste Liste statt Fähigkeit [V2-Planung] | Zulässigkeit aus bestätigten **Kanalfähigkeiten**; Profil nur Vorschlag (`02` §3) |
|
||
| L02 | Kanal-Fähigkeit pflegen und bestätigen (K00) [Beschluss] | nicht vorhanden | keine Pflege, keine Bestätigung, keine Historie | V2 hat K00-Zeile nicht umgesetzt | `ChannelCapabilities` im Kanal, bestätigt durch Administratoren, mit Historie |
|
||
| L03 | Geerbte Altwerte und Entwurf unterscheiden; Herkunft sichtbar (KONFIGURATION §1, E-029) [Beschluss] | `ChannelProcess::mount` wählt bei unzulässigem abgeleitetem Modell **still** das erste zulässige; `ConfigureChannelProcess` übernimmt Altwerte, das Modell überstimmt sie danach still (`ProcessSettings::resolve`, Herkunft „Modell“) | Altwert `payments=portal` + Modell A3 ⇒ gespeichert `portal`, wirksam `landlord`, niemand erfährt es | Fehler in V2-Umsetzung [Bestand] | Abgleich vor dem Speichern: Konflikte listen, bestätigen lassen, protokollieren; kein stilles Umschalten |
|
||
| L04 | Fachlich Zwingendes ≠ operative Ausführung (Auftrag §5) [Neu] | `toggle` Pflicht/Optional; Pflicht = Schloss | Frage „abschalten?“ statt „wie darf es erfüllt werden?“ | Modul kennt nur an/aus und Modus | `ModuleDefinition::executions` je Modul, Modell schränkt ein; Schritt zeigt zulässige Ausführungen |
|
||
| L05 | Dokumentenprofil, Nachweis, A5-Ergänzung (E-005, E-013, E-025, K00) [Beschluss] | `documents.send` koppelt Erzeugen, Ablegen, Versand | Vertrag nur intern, nur Buchungsinformation, Versand nach Freigabe als getrennte Entscheidungen nicht darstellbar | ein Modul, eine Einstellung (`Processing`) | Einstellungen `contract_delivery`, `booking_notice`; neues Modul `documents.booking_notice`; Erzeugen/Ablegen/Versand getrennt abgeleitet (`02` §4) |
|
||
| L06 | Nachweisstufen und Mindestnachweis je Schritt/Kanal (Vorschlag §5, D3) [Vorschlag, nicht beschlossen] | nur Verlaufseintrag `evidence` im Ereignis-Handler; **keine** Stufe je Schritt, **kein** `AcceptedFieldsTest` (in `03` §6 erwähnt, nicht gebaut) | Dokumentation und Code weichen ab | V2-Dokument beschrieb mehr, als umgesetzt wurde | Nachweis für Portalbestätigung und Portalunterlagen als Verlaufseintrag mit Stufe; Rest bleibt [Offen] (D3/D4 nicht beschlossen) |
|
||
| L07 | Portal-Bestätigung abwarten (Auftrag §7) [Neu] | nicht vorhanden. `PortalIntake`/`ProcessPortalMail` rufen **nie** `advance`; kein Zeitgeber wertet wartende verbindliche Vorgänge neu aus | Warten wäre nie fortgesetzt und nie eskaliert worden | Automatik hängt nur an Eingang, Fakten, Beträgen und Anfrage-Zeitgebern | Modul `portal.confirmation`, Wiederaufnahme nach Portalmail, Zeitgeber für wartende Vorgänge (`02` §5) |
|
||
| L08 | Universeller Eingang; Chat/Messenger als Quelle (Entscheidungspapier E1) [Beschluss] | Eingang ist E-Mail-förmig (`ReceiveInboundMessage(PortalMail)`) | Medium und Absicht nicht unterscheidbar | nur das Medium E-Mail gebaut | `IncomingMessage` + Regeln Medium × Absicht (`02` §6); WhatsApp/Chat nur als Testfälle |
|
||
| L09 | Nichtlinear darstellen (E-006) [Beschluss] | Runner nichtlinear; Oberfläche nummeriert 1–n | Reihenfolge suggeriert Abhängigkeit | Darstellung | Phasenansicht aus `requires`/`waits`/`triggers` derselben Definition (`02` §7) |
|
||
| L10 | Einschränkungen verständlich erklären (Auftrag §10 E) [Neu] | Schloss, Meldung „nicht zulässig“ | keine Handlungserklärung | Meldungen ohne Ursache/Alternative | strukturierte `Restriction` (Ursache, Alternative, konkrete Änderung) |
|
||
| L11 | Konfiguration der Schritte über die Hierarchie (V2-Plan `06` §1: `steps.*` auf allen Ebenen) [V2-Planung] | `steps[…].on` nur am Kanal; Ausführungseinstellungen laufen über `ProcessSettings` (alle Ebenen) | Ein/Aus eines optionalen Schritts nicht als Vermieter-/Wohnungsstandard | V2 hat nur Kanalebene umgesetzt | **Bleibt Kanalebene** (Begründung `02` §3.4); Ausführungsarten gelten über alle Ebenen |
|
||
| L12 | Mahnung, Storno/Erstattung, Kalender-/Sperrpflege als Verantwortung (K00) [Beschluss] | Mahnung folgt `payments`; Sperrpflege je Kanal (`requires_manual_blocking`); Storno/Erstattung nicht einstellbar | Storno/Erstattung je Modell nicht einstellbar | nicht im V2-Umfang | **Nicht Teil V2.1**; [Offen] DS-06/FW-05 (Portalverfahren ungeklärt) |
|
||
| L13 | D4 „akzeptierte Angaben je Kanal“ (Vorschlag) [Vorschlag] | nicht umgesetzt | – | in `03` als „entschieden“ geführt, nie gebaut | geht in die Medium-/Absichtsregeln ein (zulässige Informationsquelle); eigene Feldauswahl [Offen] |
|
||
| L14 | Datenbeschaffung unabhängig von Angebotsautomatik (K00, E-032–E-034) [Beschluss] | umgesetzt (`DataRequest`, getrennte Zähler) | keine | – | unverändert |
|
||
| L15 | Zwei getrennte Reservierungszwecke mit eigenen Fristen (E-033) [Beschluss] | umgesetzt (`hold`, `RequestHold`) | in der Oberfläche nur eine Zeile | Darstellung | in der Phasenansicht als unabhängige Aktivität mit eigener Frist |
|
||
| L16 | Verbindlichkeit externer Buchungen geschützt (E-036, CH-09) [Beschluss] | umgesetzt (`binding.portal`, `PortalIntake`) | keine | – | bleibt Voraussetzung jeder V2.1-Änderung (Belegung hängt nie an `portal.confirmation`) |
|
||
|
||
## 3. Widersprüche und offene Fragen (nicht stillschweigend entschieden)
|
||
|
||
| # | Frage | Stand | Behandlung in V2.1 |
|
||
|---|---|---|---|
|
||
| F1 | **O1 gegen „Portal stellt Vertragsunterlagen bereit“.** O1 (Betreiber, 04.11.) macht die Vertragsdokumentation archetypbestimmend: Portal ⇒ A5. | Auftrag §6 nennt „Vertragsunterlagen durch das Portal bereitstellen lassen“ als zu unterstützende Variante. | Das ist **A5**, kein Zusatz zu A3/A4. „Vertrag intern erzeugen, Gast bekommt nur eine Buchungsinformation“ bleibt innerhalb A3/A4, weil die Dokumentation bei uns bleibt. O1 bleibt unverändert. |
|
||
| F2 | Mindestnachweis (D3) und akzeptierte Angaben (D4) | im Vorschlag, nie beschlossen | [Offen]; V2.1 setzt nur den Nachweis der Portalbestätigung um |
|
||
| F3 | Frist und Rückfallverhalten, wenn eine Portalbestätigung ausbleibt | nicht beschlossen | Parameter `portal_confirmation_wait_hours` (Vorgabe 48 Stunden, als **Vorschlag** gekennzeichnet); danach Aufgabe an den Vermieter, **kein** automatisches Aufheben oder Senden |
|
||
| F4 | Darf WhatsApp einen Vorgang über ein Kennzeichen (Vorgangsnummer) zuordnen? | [Offen]; CH-07: „Buchungsnummer allein ist kein Identitätsnachweis“ | Nein: Nachrichten ohne verifizierten Antwortbezug gehen zur Klärung. Keine Zuordnung nach Rufnummer, Name oder Zeitraum |
|
||
| F5 | Einwilligungs-/Datenschutzanforderungen für Messenger | nicht geklärt | je Medium als Pflichtfeld der Regel („Einwilligung nötig“), Stand [Offen]; kein Messenger-Echtbetrieb |
|
||
| F6 | DS-01 bis DS-06, FW-01 bis FW-07 | offen (Portalnachweise) | unverändert [Offen]; V2.1 ersetzt keine Prüfung |
|
||
| F7 | Ob für Destination Solutions tatsächlich Portal-Inkasso gilt | Live-Stand: `payments = portal` gespeichert; E-016/R08: Vermieter kassiert | wird **nicht entschieden**. Die gespeicherte Einstellung wird als Fähigkeit „abgeleitet“ gezeigt und muss vom Administrator bestätigt oder korrigiert werden (L01/L03) |
|
||
|
||
## 4. Wiederverwendung
|
||
|
||
Kein Bestandteil wird ersetzt: `ProcessRunner`, `ProcessSettings`-Hierarchie, `ConfirmBooking::deliver(notifyGuest: false)` (erzeugt und legt ab, ohne zu senden), `RentalContract::generate` (idempotent über `contract_path`), `PortalIntake`/`ProcessPortalMail`, `MessageMatcher`, `ContributeCaseFacts`, `ChannelEventHandler`, der Prozess-Tester samt Sandbox, `CaseLog` (Nachweise als Verlaufseinträge).
|