125 lines
11 KiB
Markdown
125 lines
11 KiB
Markdown
# 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).
|