Files
fewo-stommer/docs/Prozessarchitektur/SCHABLONENKATALOG.md
T
2026-11-05 12:45:59 +01:00

177 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Schablonenkatalog – alle Geschäftsvorfälle aus Basisprozess, Schablonen und Fachmodulen
Stand: 05.11.2026 (Umsetzungsstand siehe Abschnitt 10) · Grundlage: Prozesslandkarte P01–P05, `MODUL_KONFIGURATIONSMATRIX.md`, Modelle A1–A6, `external.booking@1` ([SCHABLONEN.md](SCHABLONEN.md)), `ProcessRunner`, Prozess-Tester, `CommunicationRules`. Kein Code, keine neue Engine, kein neuer Archetyp. **Gebaut** heißt: im Code vorhanden und getestet; **vorgesehen** heißt: aus vorhandenen Modulen bildbar, aber noch nicht im Code.
## 1. Vier Achsen statt „Kanal = Prozess“
Ein Geschäftskanal kann mehrere Vorgangsarten liefern. Heute sind die Achsen bereits getrennt vorhanden, nur nicht zusammen sichtbar:
| Achse | Werte (Code) | Entscheidet |
|---|---|---|
| Geschäftskanal | `Channel` (eigene Webseite, Portal; `booking_model` inquiry/portal_booking/mixed, Portalprofil + bestätigte Fähigkeiten) | welche Eingangsarten und welche Schablonen überhaupt passen |
| Eingangsmedium | `Medium` (E-Mail, Formular aktiv; WhatsApp, Chat vorbereitet, `config/communication.php`), Portalmail, iCal | wie etwas ankommt, Einwilligung, Zustellweg – **nicht** den Ablauf |
| Nachrichtenabsicht | `MessageIntent`: Allgemeine Frage · Aufenthaltsanfrage · Antwort zum Vorgang · Daten liefern · Änderungswunsch · unklar | ob ein Vorgang entsteht oder ein bestehender fortgeführt wird (`MessageEffect`, nur über verifizierten Bezug) |
| Verbindlichkeit | `IntakeKind`: Anfrage (unverbindlich) · Buchung (extern schon verbindlich) · Intern | **welcher Basisprozess** gilt |
Daraus folgen **drei Basisprozesse** (kein vierter, kein A7): *Anfrage*, *Extern verbindliche Buchung* (gebaut: `external.booking`), *Interne Belegung*. Wer verbindlich macht, ist Teil des Basisprozesses: bei der Anfrage wir (Angebot → Annahme, E-003), bei der Buchung das Portal (E-036), intern niemand. Die Frage „welche Schablone“ stellt sich erst danach.
## 2. Geschäftsvorfälle und ihr Weg
| Vorfall | Heute | Basisprozess + Schablonen |
|---|---|---|
| Allgemeine Informationsfrage | **kein Vorgang**: `GeneralQuestion → AnswerInformation + Review` (Regel, nicht Prozessmodell) | Nachrichtenbearbeitung (Basisfunktion `MessageIntake`); kein Slot, kein Modul |
| Unverbindliche Verfügbarkeits-/Buchungsanfrage | `a1.information` / `a2.information` | Anfrage + *Anfragebeantwortung: Auskunft* |
| Anfrage mit verbindlichem Angebot | `a1.offer` / `a2.offer` | Anfrage + *Anfragebeantwortung: Verbindliches Angebot* |
| Extern verbindliche Buchung | `external.booking` (A3–A5 als Voreinstellung) | Buchung + *Finanz* + *Dokumente* (+ *Kommunikation*) |
| Interne Belegung (Sperre, Eigennutzung, private Überlassung) | `a6.internal` | Intern; Aufenthaltsbestätigung und Zahlung als optionale Fähigkeiten |
| Spätere Kommunikation/Änderung | `CaseReply`/`ProvideData`/`ChangeRequest` → `ReportToCase`/`ContributeFacts`; `change.proposal`, `case.tasks` | **kein eigener Ablauf**: ereignisgesteuerte Basisfunktionen jedes Vorgangs |
A1 und A2 unterscheiden sich im Code nur durch Klassifikation und die erlaubte Gastkommunikation (Portal darf bei A2 schreiben). Sie sind **ein** Anfrage-Basisprozess mit einer Kanalfähigkeit, nicht zwei Prozesse.
## 3. Ebenen und Zuordnung aller 28 Module
Legende: **Basis** = fester Bestandteil des Basisprozesses · **Schablone** · **optional** = eigenständige Fähigkeit (Schalter/Modus am Modul, keine Schablone, weil es keine fachlich verschiedenen Ausprägungen mit anderen Modulen gibt).
| Modul | Phase | Zuordnung | Basisprozess |
|---|---|---|---|
| `intake.record` | P01 | Basis (Pflicht) | alle |
| `guest.details` | P01 | Basis (Pflicht, wenn wir schreiben) | Anfrage, Buchung |
| `guest.data_request` | P01 | **optional** *Datenbeschaffung* (Modus: automatisch/Freigabe/Hand/nicht erforderlich) | Anfrage, Buchung |
| `hold` | P01 | **optional** *Reservierung* (Vorreservierung, Frist, Klärungsfrist) | Anfrage |
| `availability.check` | P01 | Basis (Pflicht, E-027) | Anfrage |
| `binding.portal` | P02 | Basis des Buchungs-Basisprozesses (Pflicht, E-036) | Buchung |
| `portal.confirmation` | P02 | Basis, bedingt (Warten ja/nein, Frist) | Buchung |
| `channels.block` | P02 | Basis (Pflicht) | alle |
| `offer.information` | P02 | **Schablone** Anfragebeantwortung – *Auskunft* | Anfrage |
| `offer.binding` | P02 | **Schablone** Anfragebeantwortung – *Verbindliches Angebot* (in beiden, bei Auskunft erst auf Buchungswunsch) | Anfrage |
| `offer.acceptance` | P02 | **Schablone** Anfragebeantwortung (Pflicht, E-003) | Anfrage |
| `documents.send` | P03 | **Schablone** Vertragsdokumentation | Anfrage, Buchung |
| `documents.booking_notice` | P03 | **Schablone** Vertragsdokumentation (einzeln schaltbar) | Buchung |
| `payments.monitor` | P03 | **Schablone** Finanzabwicklung | Anfrage, Buchung |
| `portal.payout` | P03 | **Schablone** Finanzabwicklung – *Portal-Inkasso* | Buchung |
| `arrival.details` | P04 | **Schablone** Gastkommunikation (optional im Modul) | Anfrage, Buchung |
| `arrival.info` | P04 | **Schablone** Gastkommunikation (Absender) | Anfrage, Buchung |
| `review.request` | P05 | **Schablone** Gastkommunikation (entfällt, wo das Portal schreibt) | Anfrage, Buchung |
| `stay` | P04 | Basis (Pflicht) | alle |
| `case.tasks` | P03 | Basis, ereignisgesteuert | alle |
| `change.proposal` | P03 | Basis, ereignisgesteuert (Portalmeldungen, Gästewünsche) | Anfrage, Buchung |
| `case.closure` | P05 | Basis (Pflicht, E-010) | alle |
| `case.settlement` | P05 | Basis (Pflicht, Nachweise nach O5) | alle |
| `documents.stay_confirmation` | P03 | **optional** (private Überlassung) | Intern |
| `payments.internal` | P03 | **optional** (Zahlung ohne Erinnerung) | Intern |
| `guest.address_check`, `guest.loyalty_status`, `pricing.loyalty_discount` | – | nur Prozess-Tester (E7); später Schablone *Gästebindung* (V02), nicht jetzt | – |
**Befund zur früheren Zerlegung:** Zusammengehörig sind (a) `offer.information`/`offer.binding`/`offer.acceptance` (Anfragebeantwortung, heute nur über das Modell-`fixes()` `pre_reservation` getrennt), (b) `arrival.details`/`arrival.info`/`review.request` (alle hängen am Setting `guest_messages`), (c) `payments.monitor`/`portal.payout` (bereits Schablone), (d) `documents.send`/`documents.booking_notice` (bereits Schablone). Es wird **nichts zusammengelegt**; die Module bleiben einzeln konfigurierbar. Dass die Zerlegung die Komposition eingeschränkt hat, zeigte sich nur bei Inkasso/Dokumenten (behoben) – bei Anfrage und Kommunikation steckt die Kopplung im Modell, nicht in den Modulen.
## 4. Katalog der Schablonen
Je Bereich genau eine Entscheidung; Bereiche sind unabhängig kombinierbar, soweit in 5 nichts anderes steht.
### 4.1 Finanzabwicklung – **gebaut** (`collection.own@1`, `collection.portal@1`)
- Zweck/Module/Ergebnisse/Fähigkeiten: siehe [SCHABLONEN.md §3](SCHABLONEN.md).
- Parameter: heute `deposit_due_days` (nur Vermieter-Ebene), Wer-kassiert (durch Schablone). Fehlend: Anforderung X Tage vor Fälligkeit (Konstante 7), Erinnerung automatisch/Freigabe, Mahnstufen, Bank-Abgleich (Matrix §6, Prio 1–2).
- Nachweise: Zahlungseingang (`RecordPayment`), Portalbeträge (`portal.amounts`), Auszahlungsnachweis (O5).
- Geschäftsvorfälle: Buchung (beide), Anfrage (nur *eigenes Inkasso*).
### 4.2 Vertragsdokumentation – **gebaut** (`contract_docs.own@1`, `contract_docs.external@1`)
- Parameter: `processing`, `contract_delivery`, `contract_template_id`, `booking_notice`.
- Wartet hart auf `guest.details` und `portal.confirmation` (falls im Plan); Nachweis: Dokument/Versandvermerk bzw. Portalbestätigung.
- Geschäftsvorfälle: Buchung (beide), Anfrage (nur *eigene*: der Vertrag entsteht erst mit unserem Angebot und der Annahme).
### 4.3 Anfragebeantwortung – **vorgesehen** (`inquiry.information`, `inquiry.binding_offer`)
- Zweck: wie wir auf eine Anfrage antworten und wann sie verbindlich wird.
- *Auskunft* = `offer.information` (+ `offer.binding`/`offer.acceptance` auf Buchungswunsch), setzt `pre_reservation=false`. *Verbindliches Angebot* = `offer.binding` + `offer.acceptance`, setzt `pre_reservation=true`.
- Eingaben: Gast identifiziert, Verfügbarkeit geprüft (harte Abhängigkeit von `guest.details`, `availability.check`); Ergebnis: Angebot Version n mit Vertragsentwurf, Annahmeprotokoll, danach Verbindlichkeit (`ConfirmBooking`).
- Parameter: `processing` (automatisch/Freigabe/Hand), `hold_hours`, `contract_template_id`, `guest_link_valid_days`; Preisänderung nur als `Adjustment`-Zeile.
- Nachweise: Annahme mit Zeitstempel/Prüfsumme (E-003). Inkompatibel mit Basisprozess *Buchung*.
- Geschäftsvorfälle: unverbindliche und verbindliche Anfrage (Website und Portalanfrage).
### 4.4 Gastkommunikation – **vorgesehen** (`guest_comm.own`, `guest_comm.portal`)
- Zweck: wer dem Gast Anreise-Information und Bewertungsbitte schickt. *Eigene* = `arrival.details`, `arrival.info`, `review.request`; *Portal* = `arrival.details`, `arrival.info` (Zustand „extern“), `review.request` entfällt. *Dienstleister* ist als Ausführung am Modul nur als Aufgabe vorhanden, keine Schablone.
- Heute gesteuert über das Setting `guest_messages` (Landlord/Portal) und die Fähigkeit `messages_guest`; Zulässigkeit je Modell in `Responsibilities`.
- Parameter: `arrival_info_days_before` (≤14, Konstante), Absender; Bewertungszeitpunkt nur mandantenweit.
- Fähigkeit: *Portal* nur, wenn `messages_guest` bestätigt; sonst Hinweis „nicht bestätigt“.
- Geschäftsvorfälle: Buchung, Anfrage (nur *eigene*, außer Portalanfrage mit Fähigkeit).
### 4.5 Bewusst **keine** Schablonen
Datenbeschaffung, Reservierung, Portalbestätigung, Aufenthaltsbestätigung/interne Zahlung: je ein Modul mit Modus/Parametern, ohne wechselnde Modulmengen. Eine Schablone dafür wäre eine Kleinstschablone. Auch Bereiche wie Gästebindung (Loyalty) oder Messenger bleiben, bis es echte Alternativen gibt.
## 5. Kombinationen und Unverträglichkeiten
| Basisprozess | Finanz | Dokumente | Anfragebeantwortung | Kommunikation |
|---|---|---|---|---|
| Buchung (`external.booking`) | own / portal (Fähigkeit `collects_payment`) | own / external (`provides_contract_documents`) | – | own / portal (`messages_guest`) |
| Anfrage (A1/A2) | **nur own** | **nur own** | information / binding_offer | own; portal nur bei Portalanfrage mit Fähigkeit |
| Intern (A6) | – | – | – | – (Aufenthaltsbestätigung/Zahlung optional) |
Unzulässig mit Begründung: *portal-Inkasso* bzw. *externe Unterlagen* im Anfrage-Basisprozess (wir schließen den Vertrag, E-003); Anfragebeantwortung im Buchungs-Basisprozess (schon verbindlich beim Portal, E-036); zwei Schablonen eines Bereichs (doppeltes Ergebnis); *eigenes Inkasso* bei bestätigter Portal-Einziehung (Doppelforderung). Die ersten beiden Regeln sind der fehlende Teil 7.1.
## 6. Abhängigkeiten und Parallelität (aus den Moduldefinitionen)
- **Anfrage:** `intake.record` → { `guest.details`, `hold`, `guest.data_request` } laufen **parallel**; `offer.binding` hängt hart an `guest.details` + `availability.check` (weich nach `guest.data_request`); `offer.acceptance` hart an `offer.binding`; erst danach Dokumente, Zahlungen, Anreise. Wartezustände: Gast (Daten, Annahme), Zeit (Hold-Ablauf → `ExpireReservations`).
- **Buchung:** `intake.record` → `binding.portal`; `portal.confirmation` wartet nur `documents.send`/`documents.booking_notice` (hart); Zahlungsüberwachung, Datenbeschaffung, Anreise, Kalender laufen unabhängig weiter (im Tester belegt).
- **Intern:** linear kurz, ohne Wartezustand.
- Bedingte Schritte (`applies()`): `portal.payout` nur bei Portal-Inkasso, `offer.information` nur ohne Vorreservierung, `review.request` nur wenn wir schreiben. Ereignisgesteuert: `case.tasks`, `change.proposal`.
## 7. Konkret fehlende Voraussetzungen (echte Lücken)
1. **Plätze in `InquiryModel`** (A1/A2): `TemplateArea` um *Anfragebeantwortung* und *Gastkommunikation* erweitern, `Step::slot` einsetzen. Die Schablonen-`fixes()` dürfen heute nur das Verantwortlichkeits-Setting ihres Bereichs setzen (`ProcessCatalogue::problems`); für `pre_reservation` muss der Bereich sein Setting nennen.
2. **Zulässige Schablonen je Basisprozess** (`allowedTemplates(area)` am Modell), damit *portal*-Inkasso/externe Unterlagen im Anfrage-Basisprozess begründet abgelehnt werden. Heute wirkt dort nur die Kanalfähigkeit.
3. **A1/A2 zu einem Anfrage-Basisprozess** (neues Modell `inquiry.request`, A1–A2 als Voreinstellungen). Alte Modelle und `derivedModel` bleiben für Altfälle.
4. **Nachrichtenregeln sichtbar machen:** `CommunicationRules` (Absicht → Wirkung) ist global und nur im Code; die allgemeine Informationsfrage braucht eine Anzeige (und später Einstellung) im Konfigurator, aber keinen Ablauf.
5. **Medium je Kanal:** aktivierte Medien sind global; ein Kanal kann sie nicht einschränken. Erst nötig mit WhatsApp/Chat.
6. **Ablaufspuren-Lesemodell** (siehe 8): rein lesend aus `requires`/`waits`/`triggers`/`applies`-Beschreibung; es fehlt nur die Aufbereitung, keine neuen Daten.
7. **Schon bekannte Fachlücken** (unverändert, nicht Teil dieses Katalogs): Zahlungsplan/Mahnstufen/Bank-Abgleich, Dienstleister-Zustellung, Mindestnachweis Portalbestätigung (F2), Dokumentenarten je Kanal, Storno/Erstattung (Matrix §6–7).
## 8. Bedienentwurf Kanal › Ablauf
Hauptansicht = Entscheidungen und Zusammenhang; die Schrittliste ist eine Detailebene.
```
Destination Solution [Feste Buchungen] [Anfragen: –] Modus: einfach | Experte
Fähigkeiten: Inkasso: nein ✓ bestätigt · Vertragsunterlagen: ja ⚠ nicht bestätigt · Gastnachrichten: nein ✓
1 So kommt es an Feste Buchung per Portalmail · Verbindlich beim Portal · Medium: E-Mail
2 Entscheidungen ( ) Finanz (•) Eigenes Inkasso ( ) Portal-Inkasso (nicht passend: Portal zieht nicht ein)
Dokumente ( ) Eigene (•) Externe Unterlagen ⚠ Fähigkeit nicht bestätigt
Kommunikation (•) Wir ( ) Portal
Immer dabei Datenbeschaffung [automatisch ▾] Portalbestätigung abwarten [48 h ▾]
3 Ablauf im Zusammenhang (aus den Abhängigkeiten, nicht aus einer Liste)
läuft sofort Eingang ▸ Gastangaben ▸ Kalender sperren ▸ Datenbeschaffung ▸ Zahlungsüberwachung
wartet auf Portal ⏳ Bestätigung ──▸ Buchungsinformation
bedingt Auszahlungskontrolle (nur Portal-Inkasso) · Bewertungsbitte (nur wenn wir schreiben)
später Anreise ▸ Aufenthalt ▸ Abschluss (braucht Nachweise)
4 Was ändert sich? Impact: Module, Verantwortung, Schalter/Einstellungen, Ersatzwege – nichts still
5 Einzelschritte ▸ (eingeklappt, gruppiert nach Schablone; je Modul Modus, Absender, Fristen, geerbter Wert + Herkunft)
[Ablauf testen] [Speichern – gilt für neue Vorgänge, 3 laufende bleiben]
```
Regeln: je Bereich eine Karte mit Zweck, Dimensionen, Fähigkeits-/Unverträglichkeitsgrund; *einfacher Modus* zeigt Punkte 1–4, *Experte* zusätzlich 5 mit Modulkennungen/Versionen; Spuren in 3 kommen aus `ProcessRunner`-Abhängigkeiten (hart = „wartet auf“, weich = „danach“, `applies()` = „bedingt“, `triggers` = „ereignisgesteuert“).
### Referenzfälle
- **Destination Solutions** (oben): Buchung + `collection.own` + `contract_docs.external` + `guest_comm.own` – heute bis auf die Kommunikationsschablone gebaut; der Katalog erklärt sie als Kombination 4.
- **Website – allgemeine Informationsfrage:** keine Ablaufkarte. Hauptansicht zeigt unter „Nachrichten“: Absicht *Allgemeine Frage* → Antwort mit Information + Prüfung durch Sie; kein Vorgang. (Lücke 7.4.)
- **Website – Buchungsanfrage:** Anfrage + `inquiry.binding_offer` (oder *Auskunft*) + `collection.own` + `contract_docs.own` + `guest_comm.own`; Spuren: *sofort parallel* Reservierung (`hold`, überwacht Ablauf) und Datenbeschaffung (wartet auf Gast, Folgefragen, Klärungsfrist); *wartet auf Gast* Angebotsannahme; *danach* Dokumente/Zahlung. Reservierungsüberwachung und Datenbeschaffung blockieren sich nicht, weil beide nur hart an `intake.record` hängen.
## 9. Präzisierungen (umgesetzt)
- **Kommunikation je Anlass, nicht global:** Statt einer Entweder-oder-Zuständigkeit gibt es je Anlass eine eigene Einstellung (`arrival_info_sender`, `review_request_sender`; Datenanfrage und Buchungsinformation hatten ihren eigenen Modus schon). Nicht gesetzt folgen sie dem bisherigen Sammelwert `guest_messages` – so verhalten sich Altfälle und Altkanäle wie zuvor. Die Schablonen `guest_comm.own` / `guest_comm.portal` liefern nur **Standardwerte** (unterste Ebene, jede ausdrücklich gesetzte Einstellung gewinnt) und setzen nichts fest.
- **Antwort ≠ Reservierung:** Neu ist die Einstellung `inquiry_answer` (Auskunft/Angebot), gesetzt von der Anfrageschablone. `pre_reservation` bleibt die Reservierungsstrategie (Klärungs- und Anfragereservierung) und ist unabhängig: *Verbindliches Angebot* schlägt „reservieren“ vor, erlaubt aber auch „nicht schon bei der Anfrage reservieren“ (das Angebot hält den Zeitraum trotzdem für seine Gültigkeit; Verfügbarkeit wird vor dem Versand geprüft). *Auskunft* legt „keine Reservierung“ fest – das ist die dokumentierte Definition einer Auskunft (`DocumentKind::Information`), nicht eine Prozessvorgabe.
- **Finanz/Dokumente:** unverändert unabhängig; nur Zuständigkeit wird festgelegt, Modus, Versand und Vorlage bleiben am Modul. Im Anfrage-Basisprozess sind Portal-Inkasso und externe Unterlagen mit Begründung ausgeschlossen (`ProcessModel::templateRestrictions`).
- **Darstellung aus dem Plan:** `ProcessLanes` leitet „läuft sofort / wartet auf / ereignisgesteuert / zeitgesteuert / entfällt“ aus den tatsächlichen harten Abhängigkeiten, den Auslösern und `applies()` des aufgelösten Plans ab – nicht aus Phasen oder Texten (Test vergleicht mit `ProcessRunner::unmetHardDependencies`).
## 10. Umsetzungsstand (Branch `feature/anfrage-basisprozess`)
| Punkt | Stand |
|---|---|
| Anfrage-Basisprozess `inquiry.request@1` (A1/A2 als Voreinstellung/Klassifikation/Altfassung) | gebaut |
| Schablonen `inquiry.information`, `inquiry.binding_offer`, `guest_comm.own`, `guest_comm.portal` | gebaut; `external.booking` hat jetzt ebenfalls den Kommunikationsplatz |
| Zulässigkeit je Basisprozess (Lücke 7.2) | gebaut (`templateRestrictions`) |
| Nachrichtenregeln im Kanalkonfigurator sichtbar (7.4) | gebaut, nur Anzeige |
| Ablaufspuren aus dem Plan (7.6) | gebaut |
| Medium je Kanal (7.5), Dienstleister-Zustellung, Zahlungsplan/Mahnung | offen, unverändert |
## 11. Ergebnis
Alle bisherigen Vorfälle lassen sich aus **drei Basisprozessen** und **vier Schablonenbereichen** (zwei gebaut, zwei vorgesehen) plus unabhängigen Modulparametern zusammensetzen; A1–A6 bleiben Voreinstellungen und Klassifikation. Zur Umsetzung fehlen nur die Punkte in 7.1–7.3 und die Anzeige 7.4/7.6 – kein neuer Prozess pro Variante.