Files
fewo-stommer/docs/Prozessarchitektur/AENDERUNGEN_ZU_V0.5.diff
Lars d0eb79bb9b
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m49s
Prozessarchitektur 0.5
2026-10-31 13:43:51 +01:00

185 lines
16 KiB
Diff
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
--- a/00_Prozesslandkarte.md
+++ b/00_Prozesslandkarte.md
@@ -1,4 +1,5 @@
-# 00 – Prozesslandkarte FewoPortal
+
+# 00 – Prozesslandkarte FewoPortal v0.5
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
@@ -35,7 +36,7 @@
| **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 |
+| **P05** | Abschluss & Nachbereitung | Buchungs- und Leistungserbringung fachlich abgeschlossen; offene, danach eigenständig zu bearbeitende Fälle kontrolliert an Folgeprozesse übergeben; Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
### V02 – Vermarktung, Gästegewinnung und Gästebindung (fachlich vorgesehen, Details später)
@@ -84,15 +85,17 @@
- 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.
+Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
## F. Zentrale Gate-Philosophie
+
+**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
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.
+1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
--- a/E00_Entscheidungsprotokoll.md
+++ b/E00_Entscheidungsprotokoll.md
@@ -1,3 +1,4 @@
+
# E00 – Entscheidungsprotokoll
**Stand:** 31.10.2026. Entscheidungen sind fachliche Betreiberfestlegungen, keine bestätigte Rechtsprüfung oder Implementierungsfreigabe.
@@ -13,9 +14,10 @@
| **E-007** | Beschlossen / Betreiberpräzisierung | Produktfokus: Eigene Website als zentraler Einstieg für einen Vermieter mit typischerweise **1–3 Ferienwohnungen**; mehrere Mandanten möglich; **kein Marktplatz**. Primär Gästegewinnung, Buchung und weitgehend automatisierte Abwicklung, nicht umfangreiche Haus-/Objektverwaltung. |
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
+| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
## Offene Grundsatzentscheidungen
-- Fachliche Abschlusskriterien von V01 bei nachlaufenden Forderungen/Schäden/Portalstatus.
+- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Umgang mit abgebrochenen oder stornierten Vorgängen.
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
@@ -29,4 +31,4 @@
## Dokumentationsregel (Arbeitsvereinbarung)
-Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
+Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
--- a/G00_Gates_und_Uebergaben.md
+++ b/G00_Gates_und_Uebergaben.md
@@ -1,3 +1,4 @@
+
# G00 – Gate- und Übergabemodell (Arbeitsstand)
## Grundregel
@@ -23,5 +24,10 @@
- **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.
+## P05 – Abschluss- und Folgeprozess-Übergabe (Grundsatz E-010)
+- **Abschluss V01:** Fachliche Buchungs- und Leistungserbringung ist beendet; ein ausstehender Anspruch allein blockiert den Prozessabschluss nicht, wenn dessen Bearbeitung wirksam an einen verantwortlichen Folgeprozess übergeben wurde.
+- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
+- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
+
## Noch offen
-Konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
+Detailkriterien für das P05-Abschlussgate und die Behandlung von Storno-/Abbruch-Ausgängen; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
--- a/S00_Supportprozesse.md
+++ b/S00_Supportprozesse.md
@@ -1,3 +1,4 @@
+
# S00 – Supportprozesse (vorläufiger Katalog)
Diese Prozesse unterstützen V01 und V02. **Produktmandat E-007 bis E-009:** FewoPortal richtet sich zunächst an Vermieter mit typischerweise 1–3 Ferienwohnungen, mehreren möglichen Mandanten, aber **ohne Marktplatz-/Agentur-Schwerpunkt**. Ein fachlicher Supportprozess rechtfertigt **kein eigenständiges Softwaremodul**. Buchungsbezogene Aufgaben sind möglichst in der Buchungsakte integriert und automatisiert; weitergehende Objektverwaltung bleibt Zukunftsoption.
--- a/X00_Sonderprozesse.md
+++ b/X00_Sonderprozesse.md
@@ -1,3 +1,4 @@
+
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
Sonderprozesse können aus unterschiedlichen Phasen starten. Sie nutzen dieselbe Vorgangsakte; keine parallelen Buchungsformulare/-workflows.
@@ -14,4 +15,6 @@
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
+**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
+
**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.
--- a/README.md
+++ b/README.md
@@ -1,18 +1,19 @@
-# FewoPortal – Prozessarchitektur v0.4
+
+# FewoPortal – Prozessarchitektur v0.5
**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.
+Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die danach bestätigten Entscheidungen E-007 bis E-010 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
## Dateien
- `00_Prozesslandkarte.md` – Generischer Gesamtprozess, Prozessfamilien und Zuordnung
-- `P01_Buchungseingang_und_Verfuegbarkeit.md` bis `P05_Abschluss_und_Nachbereitung.md` – getrennte Phasengerüste
+- `P01/` bis `P05/` – je ein eigener Unterordner mit dem bisherigen Phasengerüst; weitere Detaildokumente können dort ergänzt werden
- `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.
+**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
--- a/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
+++ b/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
@@ -1,3 +1,4 @@
+
# P01 – Buchungseingang und Verfügbarkeitssicherung
**Status:** Phasengerüst – Detailinterview steht aus.
--- a/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
+++ b/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
@@ -1,3 +1,4 @@
+
# P02 – Konditionen und Buchungsverbindlichkeit
**Status:** wesentliche Geschäftsregeln im Betreiberinterview bestätigt; Detail- und Rechtsprüfung offen.
--- a/P03/P03_Buchungsverwaltung_und_Abwicklung.md
+++ b/P03/P03_Buchungsverwaltung_und_Abwicklung.md
@@ -1,3 +1,4 @@
+
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
**Status:** Phasengerüst; Detailinterview steht aus.
--- a/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
+++ b/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
@@ -1,3 +1,4 @@
+
# P04 – Leistungsvorbereitung und Aufenthalt
**Status:** Phasengerüst; Detailinterview steht aus.
--- a/P05/P05_Abschluss_und_Nachbereitung.md
+++ b/P05/P05_Abschluss_und_Nachbereitung.md
@@ -1,19 +1,20 @@
+
# 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.
+Buchungs- und Leistungserbringung nachvollziehbar abschließen, Feedback einholen und offene nachlaufende Fälle **kontrolliert an zuständige Folgeprozesse übergeben**, ohne den V01-Hauptprozess deshalb künstlich offen zu halten (E-010).
## Aktivitäten (vorläufig)
- Abreise und Leistungsabschluss dokumentieren.
-- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen und behandeln.
+- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen, soweit Teil der unmittelbaren Buchungsabwicklung behandeln und sonst mit nachvollziehbarer Zuständigkeit und Buchungsreferenz an einen Folgeprozess übergeben.
- 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.
+Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
## Noch offen
-Wann Akte abgeschlossen sein darf; Weiterverfolgung offener Forderungen; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt.
+Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**