Files

7.2 KiB
Raw Permalink Blame History

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.