Files
fewo-stommer/docs/Prozessarchitektur/E00_Entscheidungsprotokoll.md
T
Lars 9005c12164
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m41s
Prozessarchitektur 0.9
2026-11-01 10:30:08 +01:00

15 KiB
Raw Blame History

id, typ, titel, status, version
id typ titel status version
E00 entscheidungsprotokoll Entscheidungsprotokoll arbeitsstand 0.9

E00 – Entscheidungsprotokoll

Stand: 01.11.2026 (E-022–E-028 ergänzt; ältere Beschlüsse historisch erhalten). 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 Wertschöpfungsprozess V02; Feedbackabwicklung verbleibt in V01. Präzisierung E-008: V02 wirkt auch vor V01 (Gästegewinnung) und heißt künftig „Vermarktung, Gästegewinnung und Gästebindung“.
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.
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.
E-011 Beschlossen / Detailkriterien offen V01 kann mit unterschiedlichen fachlichen Endergebnissen enden: regulär abgeschlossen (erbrachte Leistung), ohne Buchung beendet (z. B. abgelehnte/abgelaufene Anfrage bzw. nicht angenommenes Angebot) oder storniert (nach entstandener Verbindlichkeit, soweit zutreffend). Diese Ergebnisse sind alternative Ausgänge eines einzigen generischen Prozesses, keine zusätzlichen Buchungsworkflows. Nachweise, Historie und erforderliche Folgeaktivitäten/Übergaben bleiben erhalten. Die vollständige Taxonomie und konkrete Zustandsübergänge sind noch zu spezifizieren.

Offene Grundsatzentscheidungen

  • Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Detailkriterien und die vollständige Taxonomie der alternativen Prozessausgänge (E-011).
  • Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
  • 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, §146, §148, §149, §150, §312j BGB.

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 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.

Ergänzende Beschlüsse und Prüfstände vom 31.10.2026 – Konsolidierung v0.7

Die folgenden IDs ergänzen E-001–E-011. Betreiberangaben und die daraus fachlich bestätigten Regeln sind von ausstehenden Portal- und Rechtsprüfungen zu unterscheiden.

ID Status Festlegung
E-012 Historischer Beschluss – Partner-A6 entfällt; vgl. E-022 Zum damaligen Stand fünf Buchungsarchetypen A1–A5 (durch E-022 für eine andere A6-Bedeutung fortgeschrieben). Der zuvor verwendete A6-Eintrag („Hub/Partnervermittlung“) entfällt als Archetyp. Partnerherkunft ist nur als optionales kaufmännisches Merkmal zu erfassen, soweit sie etwa Provisionssatz oder Auswertungen beeinflusst; keine eigenständige Vermittlungskettenlogik.
E-013 Beschlossen Vertrags-/Dokumentenprofil je Vermieter/Objekt/Portal/Buchungsart, inklusive unterschiedlicher Vorlagen und Anlagen, Versionierung und unverändertem Buchungs-/Konditionsstand. Nach externer Direktbuchung keine zweite Annahme und keine einseitigen neuen Gastpflichten. Die tatsächliche vorvertragliche Einbeziehung bleibt Prüffall.
E-014 Beschlossen Die Informationsbeschaffung kann je Portal und Feld automatisch, manuell oder gemischt erfolgen. Fehlen Einzelbeträge, dürfen Buchungen mit Gesamtpreis oder Sammelpositionen bearbeitet werden; fehlende Daten sind ausdrücklich unbekannt, nicht null und nicht geschätzt.
E-015 Beschlossen Gast-Mietforderung, ggf. gesonderte Gast-Servicegebühr, Vermieterprovision/-gebühr, Zahlungsraten, Auszahlung und Rabatte sind fachlich getrennte Sachverhalte, auch wenn ein Portal Beträge zusammenfasst. Flexible kaufmännische Positionen, spätere manuelle Zuordnung/Aufteilung, Nachweis und Differenzabgleich sind erforderlich; ursprüngliche Portalwerte bleiben erhalten. Keine doppelte Zählung zusammengefasster Teil- und Gesamtbeträge.
E-016 Beschlossen / Referenzbetrieb Destination Solutions = A3, keine Ergänzung „A6“: bereits extern verbindliche Buchung, nachfolgende Vertrags-/Zahlungs-/Aufenthaltsabwicklung durch Vermieter. Partnerherkunft kann unterschiedliche Vermittlerprovisionen zu Lasten des Vermieters bewirken, aber keine nachträgliche Belastung des Gastes. Ob das Portal selbst eine zusätzliche Gastgebühr erhebt oder den Endpreis erhöht, bleibt ungeklärt.
E-017 Bestätigte Betreiberangabe, Wirksamkeit ungeklärt Bei Destination Solutions ist folgende sechsstufige Stornostaffel genannt: mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % jeweils vom „Mietpreis“. Nicht nachgewiesen ist, ob diese Staffel im Portal bereits vor Buchung transparent gemacht und wirksam einbezogen wird; die Preisbasis („Mietpreis“) ist zu klären.
E-018 Beschlossen / Risiko festgehalten Externe Verfügbarkeit ist nicht allein durch korrekte Pflege des FewoPortal-Kalenders sicher: FeWo-direkt importiert iCal nur zeitverzögert; beim verwendeten Destination-Solutions-Zugang erfolgt manuelle Sperrung ohne bestätigtes Partnernetz-Sync und ohne verwertbaren Sperrbeleg. Vorgang „Sperre veranlasst / Zielportal erkennbar / partnernetzweit wirksam“ getrennt; letzteren Zustand niemals ohne Nachweis behaupten.
E-019 Beschlossen Buchungsänderung, Storno und Doppelbuchung sind Teil-/Sonderprozesse derselben Akte. Auslösende Ursache, Initiator, ausführender Akteur, Zuständigkeit, verbindliche Wirksamkeit sowie Kalender-/Vertrags-/Finanzfolgen getrennt führen. Technische Stornierung durch den Gast ersetzt nicht die wahrheitsgemäße Einordnung einer Vermieterursache; Fremdportalregelungen und Rechtslage fallbezogen prüfen.
E-020 Beobachteter A4-Iststand In einer FeWo-direkt-Buchung sind aggregierter Übernachtungspreis, Rabatt, Sammelgebühren, Gastgesamtbetrag, portalbezogener Abzug, Auszahlungsvorschau und Ratenstatus einsehbar. Nicht belegt sind Einzelpreise, Gebührenzusammensetzung, durchgängige Exporte und alle tatsächlich vom Gast akzeptierten Unterlagen. Widersprüchliche Auszahlungsangaben bleiben offener Prüffall.
E-021 Verbindliche Dokumentationsarbeitsregel Vor jeder künftigen Dokumentänderung/Erweiterung die aktuell gültigen Originaldateien erneut explizit beim Betreiber anfordern. Gitea bleibt führende Ablage; ältere lokale Chat-/ZIP-Kopien allein reichen für spätere Änderungen nicht. Änderungen ausschließlich auf bestätigter Basis, mit Versionsfortschreibung, Bestandsbewahrung, Diff und Quellvermerk.

Nicht beschlossen: Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.

Weitere Fachkonzepte: 00_Buchungsarchetypen, 00_Portalprofile_und_Vertragsvorlagen, K01_Preisstruktur_und_Abrechnung, R00_Szenarien/R08_Destination_Solutions, O00_Offene_Portalprueffaelle.

Ergänzende Betreiberentscheidungen vom 01.11.2026 – v0.9

Diese Beschlüsse/Präzisierungen aus dem Fachinterview vom 01.11.2026 gelten zusätzlich zu den älteren Einträgen. Wo sich ältere Zusammenfassungen widersprechen, gehen die späteren Entscheidungen vor; die historischen Einträge bleiben aus Nachvollziehbarkeitsgründen bestehen.

ID Status Festlegung
E-022 Beschlossen; Fortschreibung E-012 Sechs Archetypen A1–A6. Der früher gestrichene Partnervermittlungstyp A6 bleibt gestrichen; die frei gewordene Kennung A6 bezeichnet nun Eigenbelegung, private Überlassung und sonstige Sperren. Vermittler-/Partnerherkunft bleibt nur kaufmännisches Merkmal, kein eigenständiger Workflow.
E-023 Beschlossen Ein gemeinsamer Vorgang als fachliche Klammer vom ersten relevanten Eingang bis zum Abschluss. Eine eigens anzulegende „Buchungsakte“ ist kein zusätzliches fachliches Objekt oder manueller Arbeitsschritt. Jeder A1–A6-Vorgang hat nur die tatsächlich nötigen Aktivitäten. Belegung/Zeitraum ist fachlich unterscheidbar und mit dem Vorgang verknüpft.
E-024 Beschlossen A6 kann Gäste und entgeltliche Zusatzleistungen haben: Familie/Freunde, optional Teilnehmerdaten, Kurabgabe soweit geschuldet, Wäschepakete, andere Leistungen und Zahlungen. Eine reine Wartungssperre benötigt weder Gast noch Mietvertrag. Grund, Quelle und Änderungen der Sperre dokumentieren; gemeinsame Änderungs-/Stornofunktionen wiederverwenden.
E-025 Beschlossen Angebotsart und Dokumentenprofil bestimmen den Ablauf: je Kanal/Vermieter/Objekt/Vorgangstyp passendes Angebot, ggf. Buchungs-/Aufenthalts-/Reservierungsbestätigung, Anlagen und internen Ablauf auswählen; versioniert und mit geltendem Konditionsstand. Kein separater portalabhängiger Workflow.
E-026 Beschlossen – MVP-Vereinfachung Eine konfigurierbare Haltefrist pro relevantem Anfragekanal (z. B. 0/24/48/72 h; Werte nur Beispiele). Hold > 0: soweit möglich abgestimmte Belegungssicherung + zeitlich passendes verbindliches Buchungsangebot; Hold = 0: ohne Belegungssperre nur Preis-/Verfügbarkeitsauskunft unter Vorbehalt, bei Buchungswunsch erneute Verfügbarkeitsprüfung und Bestätigung. Keine separate Preisbindefrist als Standard; Preise überwiegend kalenderjahresbezogen, keine dynamischen Buchungsklassen/Yield-Optimierung. Rechtssichere Vorlagen gesondert prüfen.
E-027 Beschlossen – Pragmatismus / Risikoakzeptanz Externe iCal-/Portalverzögerungen erzeugen ein Restrisiko. Nach Betreibererfahrung zwei Doppelbuchungen in rund 20 Jahren. Deshalb klare, schlanke manuelle/automatische Sperr- und Klärungsaufgaben statt überdimensionierter Risikosteuerung; eine externe Live-Verfügbarkeitsprüfung vor Abschluss wäre ideal, ist aber nicht als vorhandene Funktion zu unterstellen. Eigene von FewoPortal kontrollierte Abschlüsse prüfen unmittelbar vor Bestätigung erneut, soweit nötig.
E-028 Ist-Funktion bestätigt / Prüfauftrag Die Zuordnung eingehender Buchungen zum auslösenden Portal („Owner“) ist in der bestehenden Anwendung bereits implementiert. Der Coding-Agent soll vorhandene Vorgangs-, Buchungs-, Kalender-, Dokumenten- und Sperrfunktionen zunächst analysieren und wiederverwenden, nicht eine neue Owner-Zuordnung oder parallele Buchungsakten implementieren. Keine pauschale Freigabe für End-to-End-Entwicklung ohne Gap-Analyse.

Verknüpfungen (Obsidian)

README · 00_Prozesslandkarte · 00_Buchungsarchetypen · G00_Gates_und_Uebergaben · D00_Dokumentationsregel_und_Uebergabe · O00_Offene_Portalprueffaelle