Prozessarchitektur 0.1

This commit is contained in:
Lars committed 2026-10-31 13:11:34 +01:00
1 parent 545008baab
commit 7d7c5db1fd
12 files changed
+399

No files matched your search

@@ -0,0 +1,83 @@
# 00 – Prozesslandkarte FewoPortal v0.4
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
## A. Führungsprinzip
FewoPortal ist das **führende Verwaltungssystem für den gesamten Buchungsvorgang**: einheitliche Vorgangsakte, Prozesszustände, Fristen, Aufgaben, Dokumente, Kontakte, Kalender und Ereignisse. Ein angebundenes Portal kann fachliche Schritte übernehmen. FewoPortal hält **Ergebnis, Herkunft/Nachweis, Zuständigkeit und erforderliche Folgeaktivitäten** fest. Für externe Tatsachen (z. B. Portalzahlungen) bleibt das Portal die primäre Informationsquelle.
Es gibt **einen generischen Buchungsprozess**; je Portal, Eingangsart und ggf. Herkunft sind Auslöser, Aktivitäten, Verantwortlichkeiten, Datenbeschaffung und Ausgänge konfigurierbar. **Keine parallelen Buchungsprozesse und Verwaltungsoberflächen.**
Ein extern ausgeführter Schritt bedeutet nicht automatisch „übersprungen“; zu unterscheiden sind **intern erledigt / extern erfüllt / fachlich nicht anwendbar / offen bzw. Klärungsbedarf**.
## B. Wertschöpfungsprozesse
| ID | Wertschöpfungsprozess | Phasen / Zweck |
|---|---|---|
| **V01** | **Buchung und Aufenthalt** | P01–P05, einschließlich Feedback |
| **V02** | **Gästebindung und Marketing** | Eigenständiger Folgeprozess: CRM, Wiederbuchung, Kampagnen, Loyalty (Entscheidung E-001) |
### V01 – Generischer Hauptwertschöpfungsprozess
| Phase | Arbeitsbezeichnung | Fachliches Kernergebnis |
|---|---|---|
| **P01** | Buchungseingang & Verfügbarkeitssicherung | Anfrage oder verbindliche externe Buchung erkannt; Belegung/Hold korrekt vermerkt; fehlende Eingangsdaten als Aufgaben sichtbar |
| **P02** | Konditionen & Buchungsverbindlichkeit | Verbindlichkeit durch fristgerechte Annahme des **von uns bindenden Angebots** oder Nachweis einer schon verbindlichen Portalbuchung; gültige Konditionen revisionsfähig festgehalten |
| **P03** | Buchungsverwaltung & kaufmännische Abwicklung | Vertragsdokumente, Zahlungszuständigkeit, Fristen und Verwaltungsaufgaben gesteuert, auch bei extern verantworteten Aktivitäten |
| **P04** | Leistungsvorbereitung & Aufenthalt | Informationen und lokale Leistungen bereitgestellt; Anreise, Aufenthalt, Abreise betreut |
| **P05** | Abschluss & Nachbereitung | Offene Vorgänge transparent; Abschluss, Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
**Die Phasen sind logische Gruppierungen, keine zwingend exklusiven Zeitfenster.** Zahlungen/Fristen laufen u. U. über P03 hinaus, Datenbeschaffung kann nach der verbindlichen Buchung weiterlaufen. Kern-Gates beschreiben nachweisbare Zustände; Detail-Gates beschreiben Voraussetzungen für konkrete Tätigkeiten.
## C. Eingangspfade und Verbindlichkeit (fachlich vom Betreiber präzisiert)
| Pfad | Entstehung der Verbindlichkeit | Preis/Konditionen | Vertrag und Verwaltung |
|---|---|---|---|
| Eigene Website / manuell / unverbindliche Portalanfrage | Wir geben **ein für uns verbindliches, befristetes Angebot** ab; die rechtzeitige Annahme durch den Gast führt zum Vertrag | Eigene Preisermittlung mit Sonderleistungen, Saison/Rabatten/Loyalty; versionierter Konditionsstand | FewoPortal erstellt Angebot, Annahmenachweis und Vertragsunterlagen; danach eigene Verwaltung |
| Verbindliche Portal-Direktbuchung, Vertrag durch uns | **Bereits beim Portal verbindlich**; **keine zweite Annahme** bei uns | **Im Portal vereinbarter Preis zwingend als Buchungspreis übernehmen**; unsere Berechnung darf ihn nicht still ersetzen | Wir erzeugen/übermitteln das Dokument zur bestehenden Buchung; etwaige Zusatzpflichten nicht nachträglich einseitig hinzufügen; Zahlungszuständigkeit nach Profil |
| Verbindliche Portal-Direktbuchung, vollständige Abwicklung durch Portal | **Bereits beim Portal verbindlich** | Externe Konditionen als maßgeblich kennzeichnen, soweit für lokale Ausführung nötig | Portal verantwortet z. B. Vertrag, Zahlung, Mahnung, Storno; FewoPortal verwaltet notwendige Gästeinfos, lokale Betreuung, Abgaben und relevante externe Status/Ereignisse |
Bei **eigenem Angebot**: Konfigurierbare Annahmefrist; wir bleiben im beschriebenen Zeitraum gebunden. Rechtzeitige Annahme beendet das Angebot mit dem Ergebnis „verbindlich gebucht“; ohne rechtzeitige Annahme erlischt das Angebot und die **eigene** Vorreservierung wird nur nach Konfliktprüfung freigegeben. Ein extern bereits bestätigter Aufenthalt wird dadurch nicht gelöscht. Angebote und Nachweise bleiben historisch erhalten.
Vertraglicher Nachweis und ggf. PDF-Übermittlung dürfen rechtliche Verbindlichkeit **nicht neu definieren**: Eine bereits verbindliche Portalbuchung bleibt verbindlich; ihr Preis und ihre maßgeblichen Bedingungen müssen gewahrt bleiben. Die rechtlichen Anforderungen der jeweiligen Konstellation sind separat zu prüfen.
## D. Wiederverwendbare Supportprozessfamilien (vorläufig)
- S01: Portal-, Kanal- und Integrationsmanagement
- S02: Verfügbarkeit, Belegung, Kalenderabgleich und Synchronisationskontrolle
- S03: Gast-, Objekt- und weitere Stammdaten
- S04: Preis-, Leistungs-, Rabatt- und Konditionsmanagement
- S05: Dokumenten-, Vorlagen- und Nachweismanagement
- S06: Kommunikation, Aufgaben, Fristen und Eskalation
- S07: Zahlungen, Forderungen und Portalstatus-Abgleich
- S08: Objektbetrieb, Dienstleister, Übergabe, Reinigung, Reparaturen *(Einordnung als eigenständiger Supportprozess noch nicht final beschlossen)*
- S09: Mandanten, Berechtigungen, Compliance und Sicherheit
## E. Wiederverwendbare Sonderprozessfamilien (vorläufig)
- X01: Angebotsänderung und Neuangebot
- X02: Vertragsänderung, Umbuchung und Zusatzleistungen nach Vertragsschluss
- X03: Ablehnung, Angebotsablauf, Holdablauf und Freigabe
- X04: Stornierung/Rücktritt durch Gast, Portal oder Vermieter
- X05: Zahlungsverzug, Mahnung, Erstattung, Streitfall
- X06: Widersprüchliche/unvollständige Daten und Dubletten
- X07: Doppelbuchung, Kalenderkonflikt, Portal-/Importfehler
- X08: No-show, vorzeitige Abreise, Verlängerung
- X09: Reklamation, Schaden, Kaution und Nachforderung
Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie.
## F. Zentrale Gate-Philosophie
Gates dokumentieren **Trigger, erwartetes Ergebnis, erforderliche Daten, Herkunft/Nachweis, zuständige Stelle, Ergebnisstatus, Folgeschritt**. Pflichtinformationen sind **aktivitätsbezogen**, nicht für alle Portale pauschal identisch. Fehlende Adressdaten dürfen eine durch Portalnachweis verbindliche Buchung nicht entwerten; sie blockieren nur Tätigkeiten, für die sie wirklich erforderlich sind.
## G. Noch zu entscheiden
1. Fachlicher Abschluss von V01 bei offenen Rechnungen, Schäden oder Portalrückmeldungen.
2. Grobe Zuordnung des Objektbetriebs zu Support versus Wertschöpfung (keine eigene Softwareoberfläche vorentscheiden).
3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte.
@@ -0,0 +1,25 @@
# E00 – Entscheidungsprotokoll
**Stand:** 31.10.2026. Entscheidungen sind fachliche Betreiberfestlegungen, keine bestätigte Rechtsprüfung oder Implementierungsfreigabe.
| ID | Status | Entscheidung |
|---|---|---|
| **E-001** | Beschlossen (vorige Interviewrunde) | Gästebindung/Marketing sind ein eigenständiger Folge-Wertschöpfungsprozess V02; Feedbackabwicklung verbleibt in V01. |
| **E-002** | Beschlossen / durch Betreiber bestätigt | Es gibt **einen generischen Buchungsprozess** mit konfigurierbaren Auslösern und Aktivitäten je Kanal; FewoPortal ist führendes Verwaltungssystem. Bei externer Ausführung braucht es nachvollziehbare Übergaben/Gates. |
| **E-003** | Beschlossen / durch Betreiber bestätigt | **Eigenes Angebot ist für uns bindend** und befristet. Rechtzeitige Annahme führt ohne zweite Betreiberzustimmung zum Vertrag. Ohne rechtzeitige Annahme verfällt das Angebot; die **eigene** Vorreservierung ist nach Sicherheitsprüfung freizugeben. |
| **E-004** | Beschlossen / durch Betreiber bestätigt | Eine **Portal-Direktbuchung ist bereits verbindlich**; ein eigener Vertrag wird ggf. zur bestehenden Buchung erstellt und versandt, aber **nicht erneut offiziell angenommen**. Der Portalpreis ist als vereinbarter Buchungspreis zu übernehmen. |
| **E-005** | Beschlossen / durch Betreiber bestätigt | Bei **vollständiger Portalabwicklung** übernimmt FewoPortal nicht zusätzlich Vertrag, Mahnung oder Storno; es benötigt insbesondere Gästedaten und Informationen für lokale Betreuung und örtliche/gesetzliche Pflichten. |
| **E-006** | Arbeitsmodell – noch nicht abschließend einzeln genehmigt | Fünf Phasen P01–P05 gemäß v0.3/v0.4 (vom Betreiber ursprünglich vorgeschlagen), schärfere Phasennamen und Untergliederungen sind Vorschläge. |
## Offene Grundsatzentscheidungen
- Fachliche Abschlusskriterien von V01 bei nachlaufenden Forderungen/Schäden/Portalstatus.
- Zuordnung und Prozessabgrenzung des Objektbetriebs.
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
## Rechts- und technische Prüfpunkte (nicht als Beschluss ausgeben)
- Rechtssicherheit von elektronischem Annahmelink und Button, Kundendokumentation/AGB/Informationspflichten (u. a. § 312j BGB, soweit anwendbar).
- § 150 BGB: Verspätete bzw. veränderte Annahme ist nicht automatisch verbindliche Annahme des alten Angebots; § 149 BGB als möglicher Sonderfall beachten.
- Portalverträge und Übermittlung des eigenen Vertrags dürfen kein stilles Abweichen von extern vereinbarten Preisen und Konditionen bewirken.
- Hold-Ablauf, race conditions, doppelte Belegung, iCal-Verzögerungen und revisionssichere Dokumentation prüfen.
**Normquellen:** [§145](https://www.gesetze-im-internet.de/bgb/__145.html), [§146](https://www.gesetze-im-internet.de/bgb/__146.html), [§148](https://www.gesetze-im-internet.de/bgb/__148.html), [§149](https://www.gesetze-im-internet.de/bgb/__149.html), [§150](https://www.gesetze-im-internet.de/bgb/__150.html), [§312j BGB](https://www.gesetze-im-internet.de/bgb/__312j.html).
@@ -0,0 +1,27 @@
# G00 – Gate- und Übergabemodell (Arbeitsstand)
## Grundregel
FewoPortal bleibt das führende Buchungsverwaltungssystem. **Extern ausgeführt** bedeutet nicht **nicht existent**. An Übergaben sind Status, Herkunft, Verantwortung und gegebenenfalls Nachweis festzuhalten. Die notwendigen Daten richten sich nach dem tatsächlichen Folgeprozess.
## Zwei Gate-Arten
1. **Zustands-Gate:** Belegt einen fachlichen Zustand, z. B. `Buchung verbindlich` durch rechtzeitige eigene Angebotsannahme oder nachgewiesene verbindliche Portalbuchung.
2. **Aktivitäts-Gate:** Benötigt Daten/Nachweise für eine konkrete Handlung, z. B. Anschrift für einen von uns zu erstellenden Vertrag oder Anreisekontakt für lokalen Service.
## Standardfelder je Gate (noch nicht technisch festgelegt)
- Trigger / eingehendes Ereignis
- Erwarteter fachlicher Zustand oder Aktivität
- Benötigte Informationen (Pflicht und optional nach Kanal-/Aktivitätstyp)
- Quelle, Portalreferenz, Beleg/Nachweis und Aktualitätsstand
- Verantwortlich: wir / Portal / Gast / Dienstleister
- Ergebnis: intern erfüllt / extern erfüllt / nicht anwendbar / offen oder Konflikt
- Folgeaktivität bei Erfolg, fehlenden Daten oder Widerspruch
## P02 – Beispiel-Gates
- **GA:** Bindendes eigenes Angebot mit fixiertem Konditionsstand und Frist versendet.
- **GB:** Gast hat dieses Angebot fristgerecht angenommen und dies ist nachgewiesen → verbindlich.
- **GC:** Portal hat Verbindlichkeit bereits hergestellt und diese wird nachgewiesen → verbindlich, ohne erneute Annahme.
- **GD:** Erforderliche Gästedaten für lokale Abwicklung liegen vor; darf auch nach GC offen sein.
- **GE:** Externer Portalprozess vollständig verantwortet: für lokale Abwicklung notwendige Informationen vorhanden, extern zuständige Vorgänge ausgewiesen.
## Noch offen
Konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
@@ -0,0 +1,23 @@
# P01 – Buchungseingang und Verfügbarkeitssicherung
**Status:** Phasengerüst – Detailinterview steht aus.
## Zweck
Eingehende Anfrage, manuelle Meldung oder bereits verbindliche Portalbuchung eindeutig erfassen und die betroffene Belegung korrekt sichern bzw. erkennen.
## Fachliche Aktivitäten (vorläufig)
1. Eingang/Quelle und Herkunft erkennen: Website, telefonisch/manuell, Portal, Hub/Partner.
2. Eingangstyp feststellen: unverbindliche Anfrage, **bereits verbindliche Buchung**, rein blockierter Zeitraum, unklarer Eintrag.
3. Vorliegende Daten mit Quelle und Verlässlichkeit übernehmen; fehlende Informationen über wiederverwendbaren Klärungsprozess nachfordern.
4. Verfügbarkeit für Anfrage prüfen; bei Bedarf konfigurierbaren Hold (z. B. 48 h) erstellen.
5. Eigene und externe Kalender abgleichen; Synchronisationsstand und Restrisiken festhalten.
6. Übergabe an P02 bzw. direkte Übernahme einer bereits verbindlichen Buchung.
## Zentrale Gates
- Buchungsart und Quelle nachvollziehbar.
- Zeitraum/Objekt bekannt oder Klärungsaufgabe vorhanden.
- Für unsere eigene Angebotszusage Zeitraum im eigenen System gesichert; externe Bestätigung der Holds ist nicht automatisch garantiert.
- Bei Portalbuchung Nachweis externer Verbindlichkeit an P02 übergeben.
## Noch offen
Mindestfelder nach Eingangstyp, Übergaberegeln für unklare iCal-Ereignisse, Konfliktverhalten, genaue Hold- und Kalenderregeln.
@@ -0,0 +1,43 @@
# P02 – Konditionen und Buchungsverbindlichkeit
**Status:** wesentliche Geschäftsregeln im Betreiberinterview bestätigt; Detail- und Rechtsprüfung offen.
## Zweck
Konditionen und **nachweisbare Buchungsverbindlichkeit** herstellen oder von einem externen Portal übernehmen.
## Weg A – Unser verbindliches Angebot
1. Pflichtdaten/Preisgrundlagen soweit für das Angebot nötig vervollständigen.
2. Endpreis mit Saison, Rabatten, Sonderleistungen und ggf. Loyalty-Input kalkulieren.
3. Gültige Vertragsbedingungen/Anlagen, Storno-, Angebots- und Zahlungsfristen zuordnen.
4. **Bindendes, befristetes Angebot** erstellen und vollständigen gültigen Konditionsstand versioniert sichern (PDF und strukturierte Snapshot-Daten/Nachweise).
5. Angebot mit signiertem Annahmelink senden; Annahme innerhalb der Frist nachweisen.
6. Mit fristgerechter Annahme: Buchung verbindlich, keine weitere Betreiberbestätigung nötig.
7. Ohne fristgerechte Annahme: Angebot erlischt; eigene Vorreservierung nur dann freigeben, wenn kein anderer bindender Belegungstatbestand oder ungeklärter Konflikt vorliegt. Verlauf bewahren.
## Weg B – Externe verbindliche Direktbuchung, Vertrag von uns
1. **Verbindlichkeit bereits extern entstanden**; keine erneute offizielle Gastannahme in FewoPortal.
2. **Portalpreis als verbindlichen Buchungspreis übernehmen** und mit Quelle/Portalreferenz festhalten; eigene Kalkulation allenfalls als interne Vergleichsgröße.
3. Für die Vertragsdokumentation erforderliche Gastinformationen ggf. nachbeschaffen.
4. Vertrag/Bestätigung aus den tatsächlich maßgeblichen Konditionen der bestehenden Buchung erzeugen und übermitteln; nicht unbemerkt zusätzliche Bedingungen setzen.
5. Zahlung, Mahnung, Storno gemäß Kanalprofil intern/extern zuordnen.
## Weg C – Externe Direktbuchung, vollständige Abwicklung durch Portal
1. Bindungsnachweis und nötige Belegungsdaten übernehmen.
2. Keine zweite Angebotsannahme und kein eigener Vertrags-/Mahn-/Stornoablauf anstoßen.
3. Erforderliche Gästeinformationen für örtliche Betreuung, Meldung/Abgaben und andere gesetzliche Pflichten beschaffen; Verantwortung/Status des Portals nachvollziehbar halten.
## Zustands-Gate
**Buchung verbindlich** durch (A) rechtzeitig angenommene eigene Angebotversion oder (B/C) nachgewiesene externe Direktbuchung. Angaben wie Anschrift können für **einzelne nachfolgende Aktivitäten** noch offen sein, ohne diesen Zustand aufzuheben.
## Wichtige Hinweise / offene Prüfungen
- Angebot und Hold dürfen nicht auseinanderlaufen; konkrete Fristen-/Synchronisationslogik ist gesondert zu gestalten.
- Verspätete oder geänderte Annahme ist **nicht** automatische Annahme des alten Angebots (BGB §§ 146–150, insbesondere § 150).
- Digitale Verbraucher-Bestellsituation und AGB-Einbeziehung sowie konkrete Portalbedingungen gesondert rechtlich prüfen, insbesondere § 312j BGB je nach Anwendungsfall.
- Angebotsänderung vor Annahme und Vertragsänderung nach Verbindlichkeit bleiben unterschiedliche Sonderprozesse.
## Normquellen
- [§ 145 BGB – Bindung an den Antrag](https://www.gesetze-im-internet.de/bgb/__145.html)
- [§ 146 BGB – Erlöschen des Antrags](https://www.gesetze-im-internet.de/bgb/__146.html)
- [§ 148 BGB – Bestimmung einer Annahmefrist](https://www.gesetze-im-internet.de/bgb/__148.html)
- [§ 150 BGB – verspätete und abändernde Annahme](https://www.gesetze-im-internet.de/bgb/__150.html)
- [§ 312j BGB – Besonderheiten im elektronischen Geschäftsverkehr](https://www.gesetze-im-internet.de/bgb/__312j.html)
@@ -0,0 +1,20 @@
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Verbindliche Buchung, Vertragsnachweise, Zahlungen, Fristen und operative Verwaltungsaufgaben in einem Vorgang steuern, auch bei extern übernommenen Verantwortlichkeiten.
## Aktivitäten (vorläufig)
- Vertrags-/Buchungsbestätigung und Unterlagen verwalten; an den richtigen Empfänger über den verfügbaren Kommunikationsweg übermitteln.
- Fehlende Gast-/Kontaktdaten beschaffen, soweit weitere Aktivitäten sie benötigen.
- Nach intern oder extern zuständigen Zahlungsvorgängen unterscheiden; fällige Aufgaben und Fristen führen.
- Mahn-/Erstattungs-/Stornoprofil des Kanals beachten. Keine zusätzliche automatische Mahnung oder Stornierung ohne Freigabe.
- Belegungs-/Portalabgleich und Konflikte überwachen; Änderungen/Storno als Sonderprozesse behandeln.
- Extern abgewickelte Schritte mit Quelle und Status dokumentieren, nicht als intern abgearbeitet behaupten.
## Gates
Für jede auszuführende Aktivität: erforderliche Daten vorhanden, Verantwortlichkeit, Dokument/Nachweis, Ausführungsstatus und Ausnahmebehandlung geklärt. Ausstehende Zahlung kann parallel zu P04 weiterlaufen.
## Noch offen
Mindestdaten je Portalprofil, eigene versus externe Zahlungsstände, Reconciliation, Übergänge zum Abschluss.
@@ -0,0 +1,19 @@
# P04 – Leistungsvorbereitung und Aufenthalt
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Gebuchte Unterkunft und benötigte lokale Dienstleistungen vorbereiten und den Aufenthalt bis zur Abreise begleiten.
## Aktivitäten (vorläufig)
- Anreisedaten, Anreiseinformationen, Kontaktmöglichkeiten und Check-in-Verfahren bereitstellen.
- Meldedaten/Kurabgabe und ortsspezifische Pflichten prüfen und bei Bedarf abwickeln.
- Lokale Stellen für Schlüssel, Reinigung, Hausmeister oder sonstige Leistungen informieren/beauftragen.
- Aufgabenstatus und Leistungserbringung im Buchungsvorgang nachvollziehen, unabhängig vom Ausführenden.
- Anreise, Betreuung/Probleme, Sonderwünsche und Abreise verarbeiten.
## Gates
Informationen und Ressourcen müssen für die **konkret anstehende Leistung** bereitstehen. Fehlende externe Gastdaten nachfordern, ohne den Bindungsstatus der Buchung zu verändern.
## Noch offen
Ob die Organisation des Objektbetriebs vollständig als Supportprozess geführt wird; örtliche Anforderungen; Übergabe- und Eskalationsstandards.
@@ -0,0 +1,19 @@
# P05 – Abschluss und Nachbereitung
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Aufenthalt und Buchung nachvollziehbar abschließen, Feedback einholen und offene Folgeaufgaben kontrolliert weiterführen.
## Aktivitäten (vorläufig)
- Abreise und Leistungsabschluss dokumentieren.
- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen und behandeln.
- Reinigung/Reparatur/Objektbereitstellung für nächsten Aufenthalt initiieren und Status verfolgen.
- Dankesnachricht, Feedback und Bewertung im **Buchungsprozess V01** abwickeln.
- Zulässige Informationen an den **eigenständigen Wertschöpfungsprozess V02 – Gästebindung/Marketing** übergeben; ggf. Loyalty-Ereignis auslösen.
## Gates
Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. Das exakte Schließkriterium ist noch zu entscheiden.
## Noch offen
Wann Akte abgeschlossen sein darf; Weiterverfolgung offener Forderungen; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt.
+18
View File
@@ -0,0 +1,18 @@
# FewoPortal – Prozessarchitektur v0.4
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 31.10.2026
Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert.
## Dateien
- `00_Prozesslandkarte.md` – Generischer Gesamtprozess, Prozessfamilien und Zuordnung
- `P01_Buchungseingang_und_Verfuegbarkeit.md` bis `P05_Abschluss_und_Nachbereitung.md` – getrennte Phasengerüste
- `G00_Gates_und_Uebergaben.md` – übergreifende Gates
- `S00_Supportprozesse.md` und `X00_Sonderprozesse.md` – vorläufige Kataloge
- `E00_Entscheidungsprotokoll.md` – beschlossene Punkte und offene Fragen
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Keine automatischen Änderungen am produktiven System.
@@ -0,0 +1,17 @@
# S00 – Supportprozesse (vorläufiger Katalog)
Diese Prozesse unterstützen V01 und ggf. V02. Ihre Organisation als Fachprozess trifft **keine** Entscheidung über UI, Services oder Module.
| ID | Prozessfamilie | Wofür gebraucht? |
|---|---|---|
| S01 | Portal- und Integrationsmanagement | Kanäle/Portale, Herkunft, Konnektoren, Prozessprofile |
| S02 | Belegung und Kalendersynchronisation | Verfügbarkeit, Holds, Sperrzeiten, Sync/Abgleich und Konflikte |
| S03 | Stammdaten | Gäste, Objekt, Kontakte, Dienstleister; Quellen/Historie |
| S04 | Preise und Konditionen | Saison, Sonderleistungen, Rabatte, Loyalty-Input, Portalpreis-Übernahme |
| S05 | Dokumente und Nachweise | Vorlagen, Anhänge, Angebot-/Vertrags-Snapshots, Versionen |
| S06 | Kommunikation und Aufgaben | E-Mail, Portalnachricht, Fristen, Fallback, Eskalation |
| S07 | Zahlungs-/Forderungsverwaltung | Zahlungspläne intern; Portalzuständigkeit und Status extern |
| S08 | Objektbetrieb und Dienstleister | Reinigung, Schlüssel, Wartung, Reparaturen (Zuordnung noch zu beschließen) |
| S09 | Administration und Compliance | Mandanten, Rechte, Datenschutz, Sicherheit, Nachvollziehbarkeit |
Einzelheiten folgen nach Freigabe der Gesamtprozesslandkarte.
@@ -0,0 +1,17 @@
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
Sonderprozesse können aus unterschiedlichen Phasen starten. Sie nutzen dieselbe Vorgangsakte; keine parallelen Buchungsformulare/-workflows.
| ID | Prozessfamilie | Typische Auslöser |
|---|---|---|
| X01 | Angebotsänderung | Verhandlung oder Anpassung **vor** Annahme |
| X02 | Vertragsänderung/Umbuchung | Änderungen **nach** verbindlicher Buchung |
| X03 | Angebots-/Holdablauf | Ablehnung, Fristablauf, Freigabeprüfung |
| X04 | Stornierung | Gast, Vermieter, externes Portal |
| X05 | Zahlungsstörung/Erstattung | Zahlungsverzug, Rückerstattung, Streit |
| X06 | Datenklärung/Dublette | Fehlende oder widersprüchliche Gast-/Buchungsdaten |
| X07 | Verfügbarkeits-/Portalfehler | Doppelbuchung, verspätete Sync, falsche Zuordnung |
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
+88
View File
@@ -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).