V2.1 Phase 1: Konfigurationslücken (Matrix gegen ursprüngliche Beschlüsse und V2) und fachliches Zielbild
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4410fb3ee0
commit
ef1635e59a
2 files changed
+180
No files matched your search
@@ -0,0 +1,56 @@
|
||||
# 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).
|
||||
@@ -0,0 +1,124 @@
|
||||
# V2.1 – Fachliches Zielbild: konfigurierbarer Geschäftsprozess auf V2
|
||||
|
||||
Stand: 05.11.2026 · setzt `01_KONFIGURATIONSLUECKEN.md` um. Die technische Basis von V2 (Fachmodule, Modelle, `ProcessRunner`, Konfigurator, isolierter Tester) bleibt; es kommen Fähigkeiten und Einstellungen hinzu, keine zweite Engine und keine zweite Konfigurationsquelle.
|
||||
|
||||
Leitsatz: **Die Grenze der Konfigurierbarkeit begründet die fachliche Notwendigkeit, nicht die Struktur der heutigen Implementierung.** Vor jedem neuen Mechanismus wurde geprüft, ob Modulvertrag, Parameter, Abhängigkeiten oder Erweiterungspunkte reichen. Neu gebaut wird nur, was dort nicht darstellbar war.
|
||||
|
||||
## 1. Vier getrennte Dimensionen
|
||||
|
||||
| Dimension | Beispiele | Wo es steht |
|
||||
|---|---|---|
|
||||
| Geschäftskanal (Herkunft) | Eigene Webseite, Destination Solutions, FeWo-direkt | `channels`, bleibt am Vorgang (`origin_channel_id`) |
|
||||
| Kommunikationsmedium | E-Mail, Formular, WhatsApp, Chat | `Medium` (neu); Eingang je Nachricht |
|
||||
| Nachrichtenabsicht | Auskunft, Nachfrage, Datenlieferung, Buchungsanfrage, Stornohinweis, unklar | `Intent` (neu); vom Prozesskern bestimmt |
|
||||
| Verbindlichkeit/Ereignisart | unverbindlich, extern verbindlich, Information | unverändert (`IntakeKind`, `Booking::isBinding`) |
|
||||
|
||||
Kein Medium und keine Absicht legt eine Verbindlichkeit fest. Eine eingehende Nachricht erzeugt **nie** selbst einen Vorgang, eine Reservierung, ein Angebot oder eine Buchung (strukturell: kein Wirkungstyp der Regeln legt einen Vorgang an).
|
||||
|
||||
## 2. Archetyp = Rahmen (Ausführungsvarianten statt Schlösser)
|
||||
|
||||
- Das Modell legt fest, **wer wofür verantwortlich ist**, wenn das die Vorgangsart bestimmt (Vertragsabschluss, Inkasso, Vertragsdokumentation; O1 unverändert).
|
||||
- Jedes Modul nennt, **auf welche Weisen** seine Aufgabe erfüllt werden darf (`executions`): automatisch · mit Freigabe · von Hand · durch das Portal · durch einen Dienstleister · bereits extern erledigt und nachgewiesen · nicht erforderlich. Das Modell schränkt die Menge je Archetyp ein.
|
||||
- Die Oberfläche zeigt an jedem Schritt **„So darf das erfüllt werden“** statt eines Schlosses. Eine zwingende Aufgabe bleibt zwingend; abschaltbar ist sie nicht, wohl aber ausführbar auf den zugelassenen Wegen.
|
||||
- Die Auswahl landet in vorhandenen Einstellungen (`Processing`, `DataRequest`, `Documents`, `GuestMessages`) oder in den neuen unten. Dieselbe Hierarchie Vorgang ← Kanal × Eingangsart ← Wohnung ← Vermieter ← Systemstandard; eingefroren beim Eingang.
|
||||
|
||||
## 3. Kanalfähigkeiten und Modellzulässigkeit
|
||||
|
||||
### 3.1 Fähigkeiten
|
||||
|
||||
Gespeichert im Kanal (`channels.settings.capabilities`), je Fähigkeit: Wert, bestätigt am/von, Historie (letzte 20 Änderungen).
|
||||
|
||||
| Fähigkeit | Bedeutung | Wirkt auf |
|
||||
|---|---|---|
|
||||
| `collects_payment` | Das Portal zieht das Geld des Gastes ein | Modell A4/A5 verlangen „ja“, A3 verlangt „nein“ |
|
||||
| `provides_contract_documents` | Das Portal stellt die verbindlichen Vertragsunterlagen bereit | A5 verlangt „ja“, A3/A4 „nein“ (O1) |
|
||||
| `messages_guest` | Das Portal schreibt den Gast an (Anreise-Information, Erinnerungen) | Auswahl „Portal“ bei Gastkommunikation |
|
||||
| `sends_confirmation_mail` | Das Portal schickt uns eine Buchungsbestätigung per E-Mail | Warten auf Portalbestätigung |
|
||||
|
||||
**Wert ermitteln (in dieser Reihenfolge, die Quelle wird angezeigt):**
|
||||
1. *bestätigt* – vom Administrator bestätigt;
|
||||
2. *abgeleitet* – aus einer ausdrücklich gespeicherten Altstellung (`payments`, `documents`, `guest_messages` am Kanal); der Administrator muss sie bestätigen oder korrigieren;
|
||||
3. *Vorschlag* – aus dem Kanalprofil (`config/channels.php`, z. B. R09 für FeWo-direkt, E-016 für Destination Solutions);
|
||||
4. *unbekannt* – blockiert nichts, wird als „bitte bestätigen“ gezeigt.
|
||||
|
||||
### 3.2 Zulässigkeit
|
||||
|
||||
Ein Modell ist zulässig, wenn die Eingangsart passt und jede verlangte Fähigkeit den verlangten Wert hat (unbekannt = zulässig mit Hinweis). Die feste Portalliste entfällt; sie wird zum Vorschlagsprofil. O2 bleibt als Vorgabe für FeWo-direkt erhalten (Profil: zieht Geld ein, keine Vertragsunterlagen ⇒ A4), ist aber nicht mehr dauerhaft gesperrt.
|
||||
|
||||
**Ein nicht zulässiges Modell bleibt sichtbar** mit Begründung: *Ursache* (fehlende Fähigkeit mit Quelle des aktuellen Werts), *Alternative* (welches Modell passt), *konkrete Änderung* (welche Fähigkeit bestätigen). Änderungen der Fähigkeiten im Entwurf wirken sofort auf die Auswahl.
|
||||
|
||||
### 3.3 Abgleich mit Altwerten
|
||||
|
||||
Beim Speichern prüft `ConfigureChannelProcess`, ob am Kanal Einstellungen stehen, die das gewählte Modell festlegt (z. B. `payments = portal` bei A3). Konflikte werden **aufgelistet** (Wert alt/Wert Modell/Folge), müssen ausdrücklich bestätigt werden und werden danach entfernt und im Verlauf des Kanals festgehalten. Ohne Bestätigung wird nicht gespeichert. Der Konfigurator wählt nie still ein anderes Modell.
|
||||
|
||||
### 3.4 Was auf Kanalebene bleibt
|
||||
|
||||
Ein/Aus optionaler Schritte (`steps[…].on`) gilt weiter nur je Kanal und Eingangsart. Grund: Ob ein Schritt für ein Portal entfällt, hängt an dessen Fähigkeiten; ein Vermieter- oder Wohnungsstandard würde Kanäle mit anderen Fähigkeiten falsch treffen. Ausführungsarten (Einstellungen) vererben dagegen über alle Ebenen.
|
||||
|
||||
## 4. Dokumente: Erzeugen, Ablegen, Versenden, Informieren
|
||||
|
||||
| Fähigkeit | Wo | Einstellung |
|
||||
|---|---|---|
|
||||
| Vertragsgrundlage prüfen | `documents.send` (`DocumentComposer`, Konditionsstand, Freigaben) | unverändert, nicht abschaltbar |
|
||||
| Vertragsdokument erzeugen und intern ablegen | `ConfirmBooking::deliver(notifyGuest: false)` | `contract_delivery = internal` |
|
||||
| Vertragsdokument an den Gast senden | `documents.send` | `contract_delivery = automatic / manual`, Vorgabe `follow` = wie `processing` |
|
||||
| Buchungsinformation (ohne Vertrag) | neues Modul `documents.booking_notice` | `booking_notice = off / automatic / automatic_unless_portal_confirmed / manual` |
|
||||
| Vom Portal bereitgestellte Unterlagen | Modell A5 (`Documents = Portal`) | Modellwahl (O1) |
|
||||
| Ergänzende Informationen | `arrival.info` (Zeitpunkt, Ausführender) | unverändert, unabhängig von der Vertragsdokumentation |
|
||||
|
||||
Darstellbare Fälle: Vertrag automatisch erstellen und senden · erstellen und nur intern ablegen · nach Freigabe/von Hand senden · nur Buchungsinformation · Portal stellt Unterlagen bereit (A5) · keine eigene Nachricht, wenn das Portal die Bestätigung nachweislich geschickt hat · ergänzende Informationen unabhängig.
|
||||
|
||||
**Grenzen:** Der Gast bekommt nie neue, nicht vereinbarte Pflichten (Konditionsprüfung bleibt). Bei extern verbindlicher Buchung ändert keine Dokumenteinstellung die Verbindlichkeit. Ein Vertrag, der nur intern liegt, ist **nicht** „versendet“: der Schritt bleibt offen, bis er gesendet wird oder der Vermieter ihn bewusst als erledigt markiert.
|
||||
|
||||
## 5. Warten auf ein Ereignis: Portalbestätigung
|
||||
|
||||
Modul `portal.confirmation` (optional, nur für extern verbindliche Buchungen; Einstellungen `await_portal_confirmation` ja/nein, `portal_confirmation_wait_hours`, Vorschlag 48).
|
||||
|
||||
- **Erwartet:** eine Buchungsmail des Portals (`PortalEmailType::Booking`), die dem Vorgang **deterministisch** zugeordnet ist (CH-13: belastbare Portalreferenz oder verknüpfte Belegung desselben Kanals). Keine Zuordnung nach Name, Adresse oder Zeitraum allein.
|
||||
- **Nachweis:** die Mail (Stufe „laut Portal erledigt“) oder eine ausdrückliche Bestätigung des Vermieters im Vorgang (Verlaufseintrag `portal_confirmation`). Eine Mail allein schafft keine Verbindlichkeit.
|
||||
- **Wer wartet (harte Abhängigkeit):** `documents.send`, `documents.booking_notice`. **Wer nicht:** Belegung und Kalendersperren (`binding.portal`, `channels.block`), Datenbeschaffung, Zahlungsüberwachung, Aufenthalt, interne Aufgaben.
|
||||
- **Wiederaufnahme:** nach Verarbeitung einer Portalmail für diesen Vorgang (Auslöser `portal.mail`) und durch einen Zeitgeber für wartende Vorgänge (`bookings:advance-waiting`, alle 5 Minuten).
|
||||
- **Ausbleiben:** nach Ablauf der Frist wird der Schritt zum Problem, es entsteht **eine** Aufgabe „Portalbestätigung fehlt“; die Folgeschritte bleiben angehalten, bis der Vermieter bestätigt oder von Hand sendet. Nichts wird automatisch gesendet oder aufgehoben.
|
||||
- Ist der Vorgang selbst durch diese Mail entstanden, ist der Nachweis sofort erbracht.
|
||||
|
||||
## 6. Kommunikation: Medium × Absicht
|
||||
|
||||
`IncomingMessage` (Medium, Absender, Text, Zeit, externe Kennung, überprüfter Antwortbezug) → `MessageIntake` → `MessageDecision`.
|
||||
|
||||
- **Absicht** bestimmt der Prozesskern regelbasiert (`IntentClassifier`, später KI über dieselbe Schnittstelle, E-035). Der Adapter liefert nur Rohdaten und einen **vom Adapter überprüften** Antwortbezug (signiertes Kennzeichen); eine Behauptung des Absenders zählt nicht.
|
||||
- **Regeln** (`config/communication.php`, Vermieter dürfen nur einschränken, nie erweitern): je Medium aktiv/inaktiv, Einwilligung nötig, je Absicht erlaubte Wirkungen:
|
||||
|
||||
| Wirkung | Bedeutung | Voraussetzung |
|
||||
|---|---|---|
|
||||
| `answer_information` | allgemeine Auskunft beantworten, kein Vorgang | – |
|
||||
| `contribute_facts` | Angaben an einen **zugeordneten** Vorgang über `ContributeCaseFacts` | verifizierter Antwortbezug |
|
||||
| `report_to_case` | Aufgabe am zugeordneten Vorgang | verifizierter Antwortbezug |
|
||||
| `handoff_inquiry` | Verweis auf den Anfrageprozess (Formular); kein Vorgang | – |
|
||||
| `review` | manuelle Klärung im Posteingang | – |
|
||||
|
||||
- **Zuordnung:** nur deterministisch (verifizierter Antwortbezug, bestehender `MessageMatcher` bei E-Mail). Gleiche Absenderadresse, Rufnummer, Name oder Zeitraum genügen **nicht**. Unklar ⇒ `review`.
|
||||
- **Widerspruch/Mehrdeutigkeit** ⇒ `review`, keine Übernahme.
|
||||
- **Antwort:** die Entscheidung nennt die zulässigen Antwortmedien; ein Versand durch Messenger/Chat-Adapter ist nicht Teil von V2.1.
|
||||
- WhatsApp und Chat sind **Testfälle der Architektur**: Regeln, Eingang und Tester vorhanden, kein Provideranschluss. Der bestehende E-Mail-Weg (`ReceiveInboundMessage`) bleibt unverändert.
|
||||
|
||||
## 7. Darstellung des nichtlinearen Ablaufs
|
||||
|
||||
Die Prozessansicht entsteht aus **derselben** Moduldefinition wie die Ausführung (`requires`, `waits`, `triggers`, `applies`, `executions`); es gibt keine zweite Pflege. Je Phase (P01–P05) eine Spur; je Schritt:
|
||||
|
||||
- „braucht zuerst: …“ (harte Abhängigkeit, nur wenn im Plan)
|
||||
- „soll nach: …“ (weiche Abhängigkeit)
|
||||
- „läuft unabhängig“ (keine harte Abhängigkeit im Plan)
|
||||
- „wartet auf: Gast / Portal / Frist / Vermieter“
|
||||
- „nur wenn: …“ (bedingt; Beschreibungstext der Definition, **keine** Logik)
|
||||
- „löst aus / endet durch: …“ (Auslöser)
|
||||
- Ausführung: Wer und wie (automatisch · Freigabe · von Hand · extern/Portal), abgeschaltet.
|
||||
|
||||
Die Nummerierung 1–n entfällt.
|
||||
|
||||
## 8. Prozess-Tester und Nachweisfälle
|
||||
|
||||
Die Szenarien laufen weiter im isolierten Prozess. Neu: Portalbestätigung (sofort/verspätet/ausbleibend), Dokumentvarianten (über den Entwurf), Nachrichten über andere Medien, Auskunft ohne Vorgang, Stammdaten-Abgleich, eingefrorene Konfiguration, unabhängige Aktivitäten. Fälle A–H: Abschnitt 2 der Abnahme `ABNAHME_V2_1.md`.
|
||||
|
||||
## 9. Grenzen (bewusst)
|
||||
|
||||
Keine Skripte oder Bedingungen im Konfigurator · keine Umordnung sicherheitsrelevanter Schritte · keine Umgehung von Verbindlichkeits-, Verfügbarkeits-, Preis- oder Datenschutzprüfungen · keine zweite Engine · keine zweite Wahrheitsquelle · kein Provideranschluss für Messenger/Chat · Storno/Erstattung je Modell nicht einstellbar (offen, DS-06/FW-05).
|
||||
Reference in new issue
Block a user