7.2 KiB
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, inconfig/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, Quelletemplate); alle anderen Parameter laufen weiter über Systemstandard → Vermieter → Wohnung → Kanal × Eingangsart → eingefroren. CaseTypeA1–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 (
TemplateAreaum einen Fall und einen Platz im Modell erweitern). - A1/A2 und A6 haben noch keine Plätze.