Files
fewo-stommer/docs/Prozessarchitektur/V2.1/01_KONFIGURATIONSLUECKEN.md
T

11 KiB
Raw Blame History

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ührungs­einstellungen 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).