Prozessarchitektur 0.6a
Deploy FeWo mit PipelineManager / deploy (push) Failing after 2m54s

This commit is contained in:
Lars committed 2026-10-31 18:28:12 +01:00
1 parent 4587912e5b
commit 382c1724a3
1 file changed
+108
@@ -0,0 +1,108 @@
---
id: A00
typ: archetypenkatalog
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
status: diskussionsentwurf
version: "0.1"
stand: 2026-10-31
prozess: V01
bezugsstand_prozessarchitektur: "0.6"
---
# A00 – Buchungsarchetypen und Verantwortungsübergaben
> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.6 und Szenario R01. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
## 1. Gemeinsamer Grundsatz
FewoPortal ist das **führende interne Buchungsverwaltungssystem** für mehrere kleine Vermieter mit typischerweise 1–3 Wohnungen je Vermieter. Es gibt **einen generischen Wertschöpfungsprozess V01** mit den Phasen:
1. **P01** Buchungseingang & Verfügbarkeitssicherung
2. **P02** Konditionen & Buchungsverbindlichkeit
3. **P03** Buchungsverwaltung & kaufmännische Abwicklung
4. **P04** Leistungsvorbereitung & Aufenthalt
5. **P05** Abschluss & Nachbereitung
**Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Dieselbe Buchungsakte und dieselben Fachfunktionen werden verwendet. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen.
## 2. Katalog der sechs Archetypen
| ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf |
|---|---|---|---|---|---|
| **A1** | Kompletter Vorgang über eigene Website / FewoPortal | Unverbindliche Anfrage | Verbindliches eigenes Angebot, fristgerechte Annahme, anschließend Vertragsdokumentation | Wir | Eigene Anfrage- und Gastdaten, ggf. ergänzen |
| **A2** | Unverbindliche Anfrage eines Vermittlungsportals, Eingang z. B. über Portalnachricht, E-Mail, Telefon oder erkennbare iCal-Information | Noch keine Buchungsverbindlichkeit | Angebot/Annahme/Vertrag bei uns | Typischerweise wir, profilabhängig | Häufig unvollständig; gezielte Nachforderung |
| **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen |
| **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben |
| **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status |
| **A6** | Portal / Buchungshub vermittelt über weitere Partnerportale | Abhängig vom zugrunde liegenden A2–A5 | Abhängig von Herkunft und Abwicklungsmodell | Abhängig von Herkunft und Abwicklungsmodell | **Eingangskanal**, **tatsächliche Herkunft** und **Abwicklungsverantwortung** getrennt erfassen |
**Modellierungshinweis:** A6 ist ein **zusätzliches Herkunfts- und Vermittlungsmerkmal**, kein eigener alternativer Lebenszyklus. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein siebter Buchungsarchetyp**.
## 3. Gegenüberstellung entlang des generischen Prozesses
| Phase | A1 | A2 | A3 | A4 | A5 |
|---|---|---|---|---|---|
| **P01 Eingang** | Gastanfrage, Verfügbarkeit, ggf. zeitlicher Hold | Portalinformation prüfen, Anfrage qualifizieren, fehlende Daten nachfordern, ggf. Hold | Extern verbindliche Buchung übernehmen, Belegung sichern | Wie A3; Nachricht ggf. nur mit wenigen Gastdaten | Wie A3; lokale Datenversorgung sicherstellen |
| **P02 Konditionen / Bindung** | Eigener Preis, bindendes Angebot, fristgerechte Annahme | Nach Ergänzung der Daten grundsätzlich wie A1 | **Verbindlichen Portalpreis übernehmen**; externen Abschluss nachweisen | Gleiches Prinzip; zusätzliche Prüfung der tatsächlich vereinbarten Portalbedingungen | Externen Abschluss/Konditionsstand dokumentieren, kein eigenes Angebot |
| **P03 Abwicklung** | Vertrag, Kalender, Fristen und eigene Zahlungsüberwachung | Grundsätzlich wie A1, Kommunikation ggf. im Portal | Vertragsdokumentation und gesamte weitere Abwicklung durch uns | Vertrag durch uns; Zahlung über Portal; Storno/Mahnung noch abgrenzen | Externe Abwicklung überwachen, soweit für unsere Aufgaben/Haftung erforderlich |
| **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind |
| **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen |
**A6** wird auf die zutreffende Spalte gelegt; die Herkunft kann Konditionen, Pflichten und Kommunikationswege beeinflussen. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
## 4. Gemeinsame Informations- und Übergabegates
| Gate | Einheitlich benötigte Information / Nachweis | Vorgehen bei Lücke |
|---|---|---|
| **G1 – Eingang qualifiziert** | Objekt, Zeitraum, Eingangskanal, Buchungs-/Anfrageart, ggf. externe Referenz; Herkunft, soweit ermittelbar | Unklare Belegung als Klärungsfall; keine ungeprüfte verbindliche Buchung behaupten |
| **G2 – Bindung geklärt** | Entweder **eigenes** fristgerecht angenommenes Angebot oder **externer** Nachweis der Buchungsverbindlichkeit; maßgebliche Konditionen und Preis | Nachweis nachfordern / manuell prüfen; keine zweite Annahme der bereits verbindlichen Portalbuchung |
| **G3 – Abwicklung zugeordnet** | Zuständig für Vertrag, Zahlungsaufforderung, Zahlung, Mahnung, Storno, Rückerstattung, Kommunikation; relevante Fristen und Statusquellen | Zuständigkeit als offen markieren, Klärungsaufgabe erzeugen |
| **G4 – Leistung vorbereitet** | Erforderliche Gästedaten, Kontaktmöglichkeit, Anreise-/Leistungsinformationen, lokale gesetzliche Meldedaten soweit einschlägig | Datenbeschaffung über Portal, Gast oder manuell; Aufenthaltsvorbereitung gezielt verfolgen |
| **G5 – Leistung abgeschlossen** | Aufenthalt/Leistung beendet, Feedbackprozess angestoßen bzw. bearbeitet, offene Nachläufer einer zuständigen Bearbeitung übergeben | Fehlende Übergaben und lokale Folgeaufgaben sichtbar halten |
Pro Gate sind die Zustände **intern erfüllt / extern erfüllt (mit Quelle) / nicht anwendbar / offen** zu unterscheiden. Die **fachliche Bindung** und die **Vollständigkeit der Gastdaten** sind getrennte Dimensionen. Für einzelne Tätigkeiten kann es zusätzliche Feld- oder Fristvoraussetzungen geben.
## 5. A4 – FeWo-direkt als realer Referenzfall (Betreiberangaben)
**Bekannter bzw. beschriebener Ablauf:**
1. Gast bucht unmittelbar über FeWo-direkt; eine verbindliche Buchung entsteht laut Betreiber bereits dort.
2. FeWo-direkt bestätigt die Buchung und fordert Zahlungen (Anzahlung, Restbetrag) über seinen Zahlungsweg an.
3. FewoPortal erhält die Buchungsinformation; der Informationsumfang ist geringer als für die eigene Vertrags- und Aufenthaltsabwicklung erforderlich. Nach jüngster Betreiberangabe sind Name und E-Mail bekannt, die Anschrift fehlt; **tatsächlich übermittelte Felder müssen anhand eines Beispiels verifiziert werden**.
4. FewoPortal ordnet Buchung, Belegung, Portalkonditionen und Referenz zu. **Der vom Gast gebuchte Portalpreis wird nicht durch unsere Kalkulation ersetzt.**
5. Fehlende Gäste-/Vertrags- und ggf. örtliche Meldedaten werden über den verfügbaren Kontaktweg nachgefordert; manueller Fallback bleibt möglich.
6. Wir erstellen und versenden unsere Vertragsdokumentation **ohne erneute formale Annahme**; die Vereinbarung darf dabei nicht stillschweigend um andere Konditionen erweitert werden.
7. FewoPortal steuert Anreise, lokale Betreuung, Aufenthalt, Abreise und Abschluss. Externe Zahlungen/Statusmeldungen werden, soweit verfügbar und erforderlich, referenziert.
**Noch nicht bestätigt / zu prüfen:**
- Welche Vertragsinhalte und Zusatzbedingungen sieht der Gast **vor seiner bindenden Buchung** tatsächlich? Deckt sich das mit dem späteren von uns versandten Vertrag?
- Welche Partei / welcher Zahlungsdienstleister wickelt **Mahnung, Stornierung, Rückerstattung, Nichtzahlung und Schäden** in welcher Konstellation konkret ab?
- Welche Angaben umfasst der **verbindlich vereinbarte Gastpreis**? Werden Plattform-Servicegebühr für Reisende, Vermieterprovision, Steuer/Kurabgabe und Auszahlungsbetrag getrennt ausgewiesen? **Vermieterprovision nicht ohne Grundlage dem Gast zusätzlich berechnen.**
- Wie erhalten wir belastbare Statusinformationen über erfolgte Zahlungen, Stornos und Erstattungen? Wenn das Portal diese nicht maschinenlesbar liefert, ist der manuelle Nachweisweg zu definieren.
- Welche Daten sind für Kurabgabe/Meldepflichten tatsächlich erforderlich, und wann müssen diese vorliegen?
- Welches Ereignis wird beim Eingang einer Portalstornierung/Änderung ausgelöst; wie wird die Belegung aktualisiert und der Betreiber informiert?
**Rechtlicher Prüfvermerk, keine abschließende Bewertung:** Die offiziellen FeWo-direkt-Gastgeberbedingungen beschreiben die Vertragsbeziehung grundsätzlich zwischen Gast und Vermieter sowie Vorgaben zu offenzulegenden Bedingungen und Gebühren. Daraus lässt sich **nicht allein** ableiten, dass der konkrete nachträgliche Versand unseres Vertragsdokuments rechtswidrig oder rechtssicher ist. Zu prüfen sind tatsächlich angezeigte Vertragsbedingungen und konkreter Buchungsablauf. Quellen: [FeWo-direkt Gastgeberbedingungen](https://www.fewo-direkt.de/lp/b/partner-terms-of-use), [FeWo-direkt Gastbedingungen](https://www.fewo-direkt.de/lp/b/terms-of-service).
## 6. Übergreifende Regeln und bewusste Grenzen
- **Einheitliche Akte, einheitliche Konditions- und Vertragszusammenstellung**, keine getrennten Formulare je Kanal.
- Bei **A1/A2** ist unser befristetes Angebot für uns bindend; rechtzeitige Annahme macht die Buchung verbindlich. Bei Fristablauf ohne Annahme endet der Vorgang ohne Buchung, eigene Belegungssperre wird nach Konfliktprüfung freigegeben. **Hold- und Angebotsfrist müssen zusammenpassen** (konkrete Regel noch offen).
- Bei **A3–A5** wird die bestehende externe Verbindlichkeit **nicht** durch eigenen Angebotsversand oder einen erneuten Annahmeklick ersetzt.
- Portalpreise und zugesagte Konditionen sind als **externe Vereinbarung mit Quelle** abzulegen; unsere Vergleichskalkulation darf höchstens erklärend sein.
- Ein iCal-Belegungsereignis **allein** beweist nicht zwingend den Buchungsvertrag. Sichere Klassifikation kann zur automatischen Akte führen; unklare Ereignisse werden nicht still als Buchung interpretiert.
- Fehlende oder widersprüchliche Daten bleiben als **fehlt / unbestätigt / bekannt**, jeweils mit Quelle, sichtbar. Keine erfundenen Werte, keine vermeidbaren Dubletten-Gäste.
- Die Software für kleine Vermieter benötigt **keinen frei skriptbaren Workflow-Designer**; wenige nachvollziehbare Abwicklungsprofile und konfigurierbare Auslöser/Aktivitäten genügen zunächst.
- Automatisierte Entscheidungen sind nachzuvollziehen und bei Fehlzuordnung korrigierbar. Geschäftlich oder rechtlich wirksame Vorgänge sind nicht durch bloßes Löschen „rückgängig“ zu machen.
- Der V01-Prozess kann **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** enden. Offene Folgefälle werden kontrolliert übergeben; nicht still verworfen.
## 7. Bezug zu vorhandenen Dokumenten
- [Prozesslandkarte](00_Prozesslandkarte.md) – V01/V02, fünf Phasen und übergreifende Leitregeln.
- [Gates und Übergaben](G00_Gates_und_Uebergaben.md) – konzeptionelle Gate-Logik.
- [Entscheidungsprotokoll](E00_Entscheidungsprotokoll.md) – bereits bestätigte Entscheidungen.
- [Sonderprozesse](X00_Sonderprozesse.md) – derzeit bekannte Ausnahmefamilien.
- [Referenzfall eigene Webseite](R00_Szenarien/R01_Eigene_Webseite.md) – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
**Status dieses Dokuments:** Sechs Betreiber-Archetypen strukturiert, aber nicht als vollständige oder rechtlich validierte Portalprofile freigegeben. Nächster Fachschritt: **A4 als vollständigen Ist-/Soll-Ablauf durchspielen**, einschließlich Vertrag, Zahlung, Gastdaten und Storno; anschließend A3 und A5 dagegenlegen.