Prozessarchitektur 0.1
This commit is contained in:
1 parent
545008baab
commit
7d7c5db1fd
12 files changed
+399
No files matched your search
@@ -37,6 +37,94 @@ ### Dokumente, Zahlung, Storno
|
||||
### Nicht freigegeben
|
||||
Eigenständige Formulierung von Vertrags- und Stornobedingungen (Texte stammen vom Betreiber), neue externe Cloud-Dienste, KI, Zahlungsintegration, Architekturumbau, Produktivänderungen ohne gesonderte Freigabe.
|
||||
|
||||
## 2a. Entscheidungen und Prozessmodell (Abstimmung vom 30.10.2026)
|
||||
|
||||
Quelle: Antworten des Betreibers in der Session vom 30.10.2026. Als **Annahme** markierte Punkte sind noch nicht bestätigt.
|
||||
|
||||
### Grundsatz
|
||||
**Möglichst viel automatisieren; automatische Entscheidungen sind für den Benutzer korrigierbar und rückgängig zu machen.**
|
||||
|
||||
### Automatische Akte (Antwort auf §5 Frage a)
|
||||
- Die vorhandene **Regelengine** erkennt verbindliche externe Buchungen (Prämisse bisher: Buchungen erkennen, nicht pauschal „Blocker“). Greift eine Regel sicher, entsteht die Buchung mit Akte **ohne** manuelle Bestätigung.
|
||||
- Reine Termine ohne sichere Erkennung bleiben Sperrzeit und müssen erst geklärt werden („Buchung oder nur Blocker?“).
|
||||
- Jede Zuordnung ist **umkehrbar**: Stellt sich später heraus, dass es nur ein Blocker war, wird die Buchung wieder zur Sperrzeit (Akte archivieren, Verlauf behalten, nichts löschen).
|
||||
|
||||
### Buchungsakte = Dashboard (Antwort auf §5 Frage b)
|
||||
- Einstieg zeigt: Gast, Zeitraum, Personenzahl, Preis mit allen Posten/Rabatten, Vertragsvorlage, Anlagen, Stornobedingungen, laufende Fristen, Mahnstatus, nächster Schritt.
|
||||
- Fehlende Informationen werden **als fehlend markiert**; Felder erscheinen je nach Status und Informationslage dynamisch.
|
||||
- Kommunikation, verbindliche Vertragsunterlagen, Zahlungen, Verlauf: vollständig im Zugriff (Register), nicht zwingend auf dem Einstieg.
|
||||
- Gilt für **alle** Akten, egal ob eigenes Portal oder Fremdportal.
|
||||
- „Menü“ im Sinne der Fragen = die linke Seitennavigation des Admin-Bereichs; sie wird erst ganz zum Schluss gemeinsam festgelegt.
|
||||
|
||||
### Workflow-Modell: ein maximaler Ablauf, Profile überspringen Schritte
|
||||
Es gibt **einen maximalen Workflow**. Je Portal **und** Buchungstyp legt ein **Prozessprofil** fest, welche Schritte gelten, übersprungen oder anders ausgeführt werden (Vorlage, Anlagen, Storno, Zahlungsaufgaben, Mahnwesen, Versand des Vertrags durch uns oder das Portal). Das Profil ist der „Standardprozess je Portal und Buchungstyp“ (§2); die Vorlagenwahl richtet sich nach dem tatsächlichen Buchungstyp, nicht nur nach `Channel::booking_model` (Mangel §4.9).
|
||||
|
||||
Maximale Schritte (Reihenfolge): Eingang/Anfrage → Verfügbarkeit/Vorreservierung → Angebot (Zusammenstellung) → Annahme → Bestätigung + Vertrag → Kontaktdaten klären → Kalender/Portal-Abgleich → Zahlung (Aufgaben, Fristen, Mahnstatus) → Anreise-Information → Aufenthalt → Abschluss. Zusätzlich jederzeit: Storno, Vertragsänderung.
|
||||
|
||||
| Profil | Quelle / Typ | Ablauf | Übersprungen oder anders |
|
||||
|---|---|---|---|
|
||||
| **Standard (eigenes Portal)** | Webseite-Anfrage; ebenso manuell/telefonisch | Alle Schritte. Angebot (versioniert, Vertragsentwurf, signierter Link) → Annahme durch Gast mit Nachweis → Bestätigung mit Vertrag von uns → Zahlungsaufgaben (Anzahlung/Rest) → Anreise-Mail | nichts; Mahnwesen als Aufgaben/Zusammenfassung, keine automatischen Mahn-Mails |
|
||||
| **Anfrage über Fremdportal** | Portal liefert nur Anfrage | Wir antworten persönlich (im Portal oder per Mail), danach wie Standard: Angebot und Vertrag von uns, Annahme, Zahlung über uns | Kontaktweg über das Portal; Zahlungsaufgaben je Portal einstellbar |
|
||||
| **FeWo-direkt Direktbuchung** | Portal liefert verbindliche Buchung **ohne Kontaktdaten** | Eingang gilt als Annahme. Gast per Portalnachricht um Kontaktdaten bitten → Buchung bestätigen → **Vertrag von uns** (Vorlage „FeWo-direkt Direktbuchung“) → Anreise-Mail. Nach Eintrag der Kontaktdaten läuft der Prozess **wahlweise automatisch oder manuell** weiter | Angebot und Annahme entfallen; **keine Zahlungsaufgaben und kein Mahnwesen** (Zahlung über das Portal); Preis kommt vom Portal (Anpassungszeile gegenüber unserer Berechnung) |
|
||||
| **Weiteres Portal, nur Direktbuchung** | verbindliche Buchung | wie FeWo-direkt, Details je Portal | Vertrag je Konfiguration von uns oder vom Portal (dann Vertragsschritt übersprungen) |
|
||||
| **Buchungshub mit Partnerportalen** | Herkunft: Hub direkt oder Partnerportal | Profil je Herkunft (siehe Konfigurationsmodell) | je Herkunft verschieden |
|
||||
| **Eigenbelegung** | Sperrzeit | keine Akte | – |
|
||||
|
||||
**Konfigurationsmodell (Entscheidung 30.10.2026):** Es gibt einen **Standardprozess** (eigenes Portal). Für jedes angeschlossene Portal wird daran angeknüpft und innerhalb der Portalkonfiguration **nach Buchungstyp** abgewichen. Alles ist **frei konfigurierbar**, nichts ist je Portal fest verdrahtet. Beispiele, die möglich sein müssen:
|
||||
- Anfragen aus einem Direktbuchungsportal werden komplett von uns verarbeitet (Angebot, Vertrag, Zahlung).
|
||||
- Eine Direktbuchung wird wahlweise vom Portalbetreiber **oder** von uns abgewickelt (Vertrag, Zahlung, Mahnwesen).
|
||||
- **Buchungsherkunft:** Bei einem Buchungshub unterscheidet sich die Abwicklung nach der Herkunft (direkt im Hub oder über ein Partnerportal), obwohl die Buchung bei uns nur über das angeschlossene Portal eingeht. Das Profil wird also nach **Portal → Buchungstyp → Herkunft** aufgelöst; die Herkunft muss aus den Portaldaten erkennbar sein (Erkennbarkeit je Portal noch zu klären).
|
||||
- Auflösungsreihenfolge: spezifischster Treffer gewinnt (Portal + Typ + Herkunft → Portal + Typ → Portal → Standardprozess).
|
||||
|
||||
Konfigurierbar je Schritt und Profil: gilt / wird übersprungen, automatisch / manuell, Vorlage, Anlagen, Stornoregel, Zahlungsaufgaben, Mahnwesen, wer den Vertrag verschickt (wir / Portal). Das Konfigurationsmodell ist **noch nicht entworfen** und vor dem Bau mit dem Betreiber abzustimmen.
|
||||
|
||||
### Angebot, Vertrag, Vertragsänderung (Antwort zu Frage 3)
|
||||
- **Angebot** ist bis zur Annahme änderbar (neue Version).
|
||||
- Nach der Annahme ist es ein **Vertrag** und unveränderlich. Änderungen (z. B. Zusatzleistungen) erzeugen einen **Änderungsvertrag**, der den alten Vertrag **ersetzt**, neu geschrieben und versendet wird und den Ersatz ausdrücklich nennt.
|
||||
- Der Änderungsvertrag soll vom Kunden bestätigt werden. Bis zur Annahme gilt der **alte Vertrag weiter**.
|
||||
- Standard: gleiche Konditionen. Der Vermieter kann wählen, ob Konditionen angepasst werden (Rabatte entfallen, kürzere Laufzeit → höherer Tagespreis, zusätzliche Person kostet mehr).
|
||||
- **Annahme (juristisch ungeprüft):** Vertragsänderung ≙ kostenfreie Stornierung mit neuem Angebot.
|
||||
- Daraus folgt: Die Zusammenstellung wird vor der Annahme (Angebot) bzw. als Änderungsvertrag nach der Annahme bearbeitet, nie am bestehenden Vertragsdokument.
|
||||
|
||||
## 2b. Entwurf Prozessmodell (30.10.2026, **Vorschlag, vom Betreiber noch nicht bestätigt**)
|
||||
|
||||
Anlass: Das Profilmodell aus §2a reicht nicht. Der eigene Prozess dient als Vorlage, kennt aber bei der Anfrage schon Name, Personenzahl, kalkulierten Preis, Zusatzleistungen und E-Mail. Bei Fremdportalen fehlt das und muss über wechselnde Wege beschafft werden. Ziel: wenige **Archetypen**, leicht anpassbar je Portal, **keine Konfigurationshölle**.
|
||||
|
||||
### Was im Code schon trägt (nicht neu erfinden)
|
||||
- `ICalRuleEngine` (Regeln mit Bedingungen, Extraktionen, Priorität, `event_type`, Herkunftskanal `origin`) erkennt Kalendereinträge je Portal.
|
||||
- `PortalMailParser` / `ParsedPortalMail` / `PortalEmailType` (Buchung, Stornierung, Anfrage, Unbekannt) erkennen Portalmails; `ChannelBookingModel` (Anfrage / Portalbuchung / Gemischt) ist die bisherige, zu grobe Unterscheidung.
|
||||
- Der Angebotsablauf (`SendOffer`, `AcceptOffer`, `ConfirmBooking`, `OfferTerms`) ist der Standardprozess.
|
||||
|
||||
### Bausteine
|
||||
1. **Informationsfelder der Buchung** mit Status und Quelle: Gast (Name, E-Mail, Telefon, Anschrift), Zeitraum, Personen, Zusatzleistungen, Preis, Portalreferenz, Herkunft. Status je Feld: *bekannt* (Quelle: Portalmail / Kalender / Gast / manuell / unsere Berechnung), *unbestätigt* oder *fehlt*. Das Dashboard markiert „fehlt“ daraus; kein Feld wird still erfunden (kein Platzhalter-Gast).
|
||||
2. **Schritte** (maximaler Ablauf aus §2a). Jeder Schritt hat:
|
||||
- **Regel** (gilt / überspringen, optional mit Bedingung auf Felder oder Herkunft),
|
||||
- **Eingangskanäle** in Prioritätsreihenfolge, **mehrere gleichzeitig möglich**,
|
||||
- **Ausgangskanäle** (ebenfalls mehrere),
|
||||
- **Auslösung** automatisch oder manuell, Frist, Abschlusskriterium,
|
||||
- **Fallback immer manuelle Eingabe**: Fehlt die Information nach den Kanälen, entsteht eine Aufgabe für den Betreiber.
|
||||
3. **Eingangskanäle** (Informationsquellen): Portalmail-Erkennung, Kalenderregel (`ICalRuleEngine`), Gast-Formular über signierten Link (Kontaktdaten selbst eintragen), Antwort des Gastes per Mail/Portalnachricht (vom Betreiber abgelesen und eingetragen), manuelle Eingabe, unsere Berechnung (Preis).
|
||||
4. **Ausgangskanäle:** E-Mail an Gast, Portalnachricht (Text zum Kopieren; Versand durch den Betreiber im Portal), Dokument (Angebot/Vertrag/Änderungsvertrag), Aufgabe für den Betreiber, Hinweis im Postfach.
|
||||
5. **Herkunftsmerkmal je Portal konfigurierbar:** aus Kalenderregel, aus Mailregel (Absender/Text/Muster) oder **manuell auswählbar** (Pflichtfallback, wenn nur im Portal ablesbar). Die Herkunft (z. B. Hub direkt, Partnerportal X) ist Bedingung für die Prozesswahl.
|
||||
6. **Prozesswahl je Portal:** Tabelle „Eingangsart (Anfrage, verbindliche Buchung, ggf. weitere je Portal) × Herkunft → Archetyp + Abweichungen“. Spezifischster Treffer gewinnt, sonst Standardprozess.
|
||||
|
||||
### Vorgeschlagene Archetypen (3–4)
|
||||
| Archetyp | Information bei Eingang | Wir tun | Portal tut |
|
||||
|---|---|---|---|
|
||||
| **A Angebotsprozess** (eigene Webseite, telefonisch/manuell, Portalanfrage mit vollständigen Daten) | Name, E-Mail, Personen, Preis, Zusatzleistungen (soweit erfasst) | Angebot, Annahme-Link, Vertrag, Zahlungsaufgaben, Anreise-Mail | höchstens Nachrichtenweg |
|
||||
| **B Portalanfrage, Daten unvollständig** (Variante von A mit vorgeschaltetem Schritt „Informationen beschaffen“) | oft nur Zeitraum/Name/Portalreferenz | erst Daten beschaffen (Gast-Link, Portalnachricht, manuell), danach wie A | Kommunikationskanal |
|
||||
| **C Verbindliche Buchung, wir erledigen Vertrag; Zahlung läuft über das Portal** (FeWo-direkt) | Zeitraum, Referenz, Preis vom Portal; keine Kontaktdaten | Kontaktdaten beschaffen, bestätigen, Vertrag von uns, Anreise-Mail | Zahlung/Mahnwesen |
|
||||
| **D Verbindliche Buchung, alles beim Portal** (Hub o. Ä., wenn das Portal Vertrag und Zahlung stellt) | Zeitraum, Referenz, ggf. Gastdaten | erfassen, Akte, Anreise-Info, Aufenthalt/Abschluss | Vertrag, Zahlung |
|
||||
|
||||
Zusätzlich möglich, aber noch zu klären: verbindliche Buchung, die **wir komplett** abwickeln (Vertrag und Zahlung), als Variante von C statt eigener Archetyp.
|
||||
**Abweichungen** je Portal/Eingangsart/Herkunft sind auf wenige Schalter begrenzt: Schritt überspringen, Kanalreihenfolge, automatisch/manuell, Vorlage/Anlagen/Storno, Zahlungsaufgaben ja/nein, Vertrag von uns/Portal. Keine freien Skripte.
|
||||
|
||||
### Vor dem Bau zu klären
|
||||
- Stimmen die Archetypen A–D, oder braucht der Betreiber andere Abgrenzungen?
|
||||
- Welche Eingangsarten pro Portal gibt es (Anfrage, Buchung, Stornierung, Änderung?) und wie werden sie erkannt?
|
||||
- Wer bestätigt Informationen, die aus mehreren Kanälen widersprüchlich kommen (Mail sagt 3 Personen, Kalender nichts)?
|
||||
- Reihenfolge der Umsetzung: Informationsfelder mit Quelle zuerst (Grundlage für Dashboard „fehlt“), dann Schritte/Kanäle, dann Archetypen und Portalkonfiguration, dann Zusammenstellung/Änderungsvertrag.
|
||||
|
||||
## 3. Aktueller Stand (Code, committed auf `develop`, Test live: Release `81c025f`)
|
||||
|
||||
Test: 614 Feature-Tests grün (isoliert, SQLite). **Nicht im Browser abgenommen**; der Betreiber hat die Oberfläche inzwischen gesehen und als fehlerhaft beurteilt (§4).
|
||||
|
||||
Reference in new issue
Block a user