159 lines
16 KiB
Markdown
159 lines
16 KiB
Markdown
# Schablonenkatalog – alle Geschäftsvorfälle aus Basisprozess, Schablonen und Fachmodulen
|
||
|
||
Stand: 05.11.2026 · 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. 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.
|