75 lines
7.2 KiB
Markdown
75 lines
7.2 KiB
Markdown
# Funktionsschablonen und Basisprozess „Extern verbindliche Portalbuchung“
|
||
|
||
Stand: 05.11.2026 · Branch `feature/schablonenkomposition` · kurze technische Umsetzungsgrundlage, keine neue Architekturstudie.
|
||
|
||
## 1. Prinzip
|
||
|
||
Der Basisprozess bleibt (P01–P05, `ProcessRunner`, Moduldefinitionen, harte/weiche Abhängigkeiten). Neu ist nur:
|
||
|
||
- **Platz (Slot)** im Modell (`Step::slot(TemplateArea)`), an dem die gewählte **Funktionsschablone** ihre bereits vorhandenen Module einsetzt.
|
||
- **Schablone** (`App\Process\Templates\FunctionTemplate`, versioniert, in `config/process.php › templates`): Zweck, Module, benötigte/gelieferte Ergebnisse, Verantwortlichkeit, Portal-Fähigkeit, Ausschlüsse, Dimensionen, noch nicht gebaute Erweiterungen.
|
||
- **`TemplateComposer`** (rein lesend): löst die Wahl auf, prüft Plätze/Bereiche, Voraussetzungen, doppelte Ergebnisse, Ausschlüsse, widersprüchliche Verantwortlichkeiten, doppelte Module und harte Modulabhängigkeiten. Keine Regelsprache, keine zweite Engine.
|
||
- Der **Plan** (`ProcessPlan`) friert Schablonen mit Version ein (`bookings.profile.plan.templates`, optional – alte Pläne bleiben lesbar). Die Schablone legt die Verantwortlichkeit ihres Bereichs fest (`ProcessSettings`, Quelle `template`); alle anderen Parameter laufen weiter über Systemstandard → Vermieter → Wohnung → Kanal × Eingangsart → eingefroren.
|
||
- `CaseType` A1–A6 bleibt **abgeleitete Klassifikation** (Berichte, Altfälle). Die vierte Kombination (eigenes Inkasso + externe Unterlagen) wird als A3 klassifiziert („wir kassieren“); es gibt kein A7.
|
||
|
||
## 2. Zuordnung: bisheriger Funktionsblock → Module → Schablone
|
||
|
||
| Funktionsblock (Prozesslandkarte) | Module | Zuordnung |
|
||
|---|---|---|
|
||
| Eingang, Gastangaben, Verbindlichkeit beim Portal, Bestätigung abwarten, Kalender sperren | `intake.record`, `guest.details`, `binding.portal`, `portal.confirmation`, `channels.block` | fester Bestandteil des Basisprozesses |
|
||
| Datenbeschaffung | `guest.data_request` | fest, Ausführung am Modul wählbar (automatisch/Freigabe/von Hand/nicht erforderlich) – eigene Schablone erst bei echten Alternativen |
|
||
| **Vertragsdokumentation** | `documents.send`, `documents.booking_notice` | **Schablonen** `contract_docs.own` / `contract_docs.external` |
|
||
| **Finanzabwicklung** | `payments.monitor` (+ `portal.payout`) | **Schablonen** `collection.own` (Zahlungsüberwachung) / `collection.portal` (Portalzahlungen + Auszahlungskontrolle) |
|
||
| Aufgaben, Änderungen | `case.tasks`, `change.proposal` | fest (ereignisgesteuert) |
|
||
| Anreise, Aufenthalt, Bewertung | `arrival.details`, `arrival.info`, `stay`, `review.request` | fest, Absender am Modul wählbar (Gastkommunikation) |
|
||
| Abschluss | `case.closure`, `case.settlement` | fest (Pflicht, Nachweise nach O5) |
|
||
| Angebot/Annahme (A1/A2), interne Belegung (A6), Tester-Module | `offer.*`, `hold`, `availability.check`, `payments.internal`, `documents.stay_confirmation`, `guest.*`/`pricing.*` (Tester) | nicht Teil dieses Umbaus; spätere Schablonen nutzen dasselbe Prinzip |
|
||
|
||
Es wurden bewusst **nur zwei Bereiche** zu Schablonen: dort liegen die unterschiedlichen Verantwortlichkeiten. Module wurden nicht zusammengefasst.
|
||
|
||
## 3. Die vier Schablonen
|
||
|
||
| Schablone | Module | Verantwortung | Portal-Fähigkeit | Liefert | Braucht |
|
||
|---|---|---|---|---|---|
|
||
| `collection.own@1` Eigenes Inkasso | `payments.monitor` | wir | Portal zieht **nicht** ein | `money.collection_handled`, `money.guest_payments_monitored` | `binding.portal_total` |
|
||
| `collection.portal@1` Portal-Inkasso | `payments.monitor`, `portal.payout` | Portal | Portal zieht ein | `money.collection_handled`, `money.portal_payout_checked` | `binding.portal_total` |
|
||
| `contract_docs.own@1` Eigene Vertragsdokumentation | `documents.send`, `documents.booking_notice` | wir | Portal stellt **keine** Unterlagen bereit | `contract.documented`, `contract.documents_by_us` | `guest.identified` |
|
||
| `contract_docs.external@1` Externe Vertragsunterlagen | dieselben Module | Portal | Portal stellt Unterlagen bereit | `contract.documented`, `contract.documents_by_portal` | – |
|
||
|
||
Die Schablonen der Dokumente unterscheiden sich nicht in den Modulen, sondern in **Verantwortung, Ausführungsart (Portal statt wir) und Nachweis** (§4.2 des Auftrags): Vertragsbedingungen – Erstellung – Bereitstellung/Versand – Nachweis stehen als `dimensions()` an der Schablone; Erstellung, Ablage, Bereitstellung und Versand bleiben am Modul einzeln einstellbar (`processing`, `contract_delivery`, Vorlage). Was die Unterlagen des Portals über Zahlungen sagen, ändert nichts an der Zahlungsüberwachung: sie folgt allein der Finanzschablone.
|
||
|
||
## 4. Die vier Pflichtkombinationen
|
||
|
||
| # | Inkasso | Dokumente | Klassifikation | Entspricht |
|
||
|---|---|---|---|---|
|
||
| 1 | eigenes | eigene | A3 | A3 v2 |
|
||
| 2 | Portal | eigene | A4 | A4 v2 |
|
||
| 3 | Portal | externe | A5 | A5 v2 |
|
||
| 4 | eigenes | externe | A3 | – (bisher nicht darstellbar) |
|
||
|
||
`TemplateCompositionTest` beweist: Kombinationen 1–3 haben dasselbe wirksame Profil, dieselben Aktivitäten/Zustände und denselben Ablauf wie A3–A5 (nur `portal.payout` entfällt, wo wir selbst kassieren). `TemplateProcessTesterTest` spielt alle vier im isolierten Prozess-Tester durch.
|
||
|
||
## 5. Unbestätigte Portal-Fähigkeiten
|
||
|
||
Die Schablonenwahl prüft die **bestätigten** Fähigkeiten des Kanals. Widerspruch → Schablone nicht wählbar, mit Begründung und Weg. Unbekannt oder nur vorgeschlagen/abgeleitet → nicht gesperrt, aber überall als „nicht bestätigt“ gekennzeichnet (Konfigurator, Tester-Bericht); sie gilt nie als nachgewiesen.
|
||
|
||
## 6. Umgang mit A3–A5
|
||
|
||
`external.booking@1` ist der Basisprozess für neue Konfigurationen. A3/A4/A5 (v1/v2) bleiben registriert (eingefrorene Pläne, Altkanäle) und sind im Konfigurator **Voreinstellungen** („Auf Schablonen umstellen“ / „Bekannte Kombinationen“). Gespeicherte Kanäle ändern sich nicht, bis jemand ausdrücklich speichert. `ProcessCatalogue::derivedModel` und die Altfall-Ableitung bleiben unverändert.
|
||
|
||
Stellen, an denen `CaseType`/A3–A5 vorher etwas entschieden, und was jetzt gilt:
|
||
|
||
| Stelle | Vorher | Jetzt |
|
||
|---|---|---|
|
||
| `ProcessProfile::caseTypeFor` | Dokumente = Portal ⇒ immer A5 | A5 nur, wenn Portal Dokumente **und** Inkasso hat; sonst A4 (Inkasso Portal) bzw. A3 – reine Klassifikation |
|
||
| `ProcessPlan::freeze` (Modell zulässig für Vorgangsart) | Modell nennt genau eine Art | `external.booking` nennt A3–A5; die Schablonenwahl bestimmt den Ablauf |
|
||
| `ProcessCatalogue::derivedModel` | Altfall-/Ableitungspfad nach Vorgangsart | unverändert (Altfälle, Kanäle ohne gewähltes Modell) |
|
||
| `isExternallyBinding()` (Änderung/Storno/Anzeige) | A3–A5 | unverändert, gilt für alle vier Kombinationen |
|
||
| `payments()` / `documents()` (Zahlungsaufgaben, Dokumentenart, Abschluss, Auszahlung) | Wert aus Modell-`fixes()` | Wert aus der Schablone (Quelle `template`); die Module selbst blieben unverändert |
|
||
|
||
## 7. Bewusste Grenzen / offen
|
||
|
||
- Mahnstufen, Zahlungsplan je Kanal, Bank-Abgleich: Erweiterungen (`OwnCollection::extensions()`), nicht erfunden.
|
||
- Weitere Bereiche (Gastkommunikation, Datenbeschaffung, Aufenthalt) nutzen später dasselbe Prinzip (`TemplateArea` um einen Fall und einen Platz im Modell erweitern).
|
||
- A1/A2 und A6 haben noch keine Plätze.
|