Files
fewo-stommer/docs/Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md
T
2026-11-03 12:13:09 +01:00

14 KiB
Raw Blame History

Konfiguration und Wirksamkeit

Dieses Dokument beschreibt, welche fachlichen Einstellungen es gibt, wo man sie vornimmt und wie sie sich vererben. Es zeigt auch, wie man nachprüft, dass sie in einem Vorgang wirklich angewandt wurden. Bestand der Pakete 1–9 vom 02.11.2026, um die fachlichen v0.11-Zielparameter ergänzt; deren Implementierung ist noch nicht nachgewiesen.


1. Wo man die Wirksamkeit sieht

Werkzeug Zeigt
System › Wirksame Einstellungen (Expertenansicht) Für jede Wohnung und jeden Eingangsweg den Wert jeder Prozesseinstellung, der für einen neuen Vorgang gilt, mit Herkunft und Ort der Änderung. Eingangswege: direkte Anfrage, je Portal Anfrage und feste Buchung, A6. Neu ist die Zeile „Antwort auf eine Anfrage“: Angebot mit Reservierung, Auskunft unter Vorbehalt oder keine. Je Wohnung steht die Zeile „Aufenthalt“: Anreisezeit, Aufgaben je Aufenthalt, Kurabgabe. „Einen Vorgang prüfen“ zeigt dessen festgehaltenes Profil, eine Umstellung im Vorgang, das Dokument, das er jetzt braucht, und beide Abschlüsse mit den offenen Punkten.
Vorgang › Ablauf Jede Aktivität mit Zustand: erledigt, übernimmt das Portal, zu tun, wartet, später oder entfällt. Dazu kommen Aufgaben mit Zuständigkeit und Erledigungsnotiz sowie beide Abschlüsse.
Vorgang › Technische Angaben (Experte) eingefrorenes Abwicklungsprofil mit Herkunft je Wert
php artisan process:settings-report alle Standards und Abweichungen als Text
php artisan cases:recheck-payment-status Vorgänge, deren gespeicherter Zahlungsstatus der neuen Regel widerspricht (Vorschau)

Nachweise: test_t12_…, test_t24_…; Screenshots Abnahme/2026-11-01/T12-wirksame-einstellungen.png und Abnahme/2026-11-02/T24-wirksame-einstellungen.png.


2. Vererbung

Grundeinstellung (im Code)
  → Ihr Standard               System › So arbeite ich
    → Wohnung                  Wohnung bearbeiten › „Abweichende Abwicklung dieser Wohnung“ (Experte)
      → Portal je Eingangsart  Portal bearbeiten › „Anfragen über dieses Portal“ / „Feste Buchungen über dieses Portal“
        → Vorgang              Schalter „Läuft automatisch / Sie geben frei“, Wahl Angebot statt Auskunft, Aufgaben
  • Leer heißt „erbt“. Ein bewusst gesetztes „nein“, „0“ oder „manuell“ ist ein eigener Wert.
  • Eingefroren beim Eingang. Ein Vorgang behält die Werte von seinem Eingang. Ausnahme ist die Vertragsvorlage: Sie wird erst festgehalten, wenn das Dokument erstellt wird.
  • A6 fest: Unterlagen, Zahlungen und Gastmails „Entfällt“.
  • Anfragen: Unterlagen schicken immer wir.
  • Vorgangsart aus den wirksamen Werten: A1/A2 Anfrage (direkt bzw. über Portal); A3 wir kassieren und schicken Unterlagen, A4 Portal kassiert, A5 Portal schickt Unterlagen; A6 intern.

3. Einstellbare Prozessparameter

Einstellung Standard Übersteuerbar auf Wirkung
Bearbeitung (automatisch / Sie geben frei) Sie geben frei Vermieter, Wohnung, Portal (Anfrage und Buchung), Vorgang Angebote, Auskünfte und Unterlagen gehen ohne Klick hinaus, sobald nichts fehlt. Ein Buchungswunsch wird automatisch nur bestätigt, wenn die erneute Prüfung ohne jeden Befund ist (Paket 7).
Angebotsreservierung: Reserviert eine vollständige Anfrage beim eigenen Angebot den Zeitraum? ja Vermieter, Wohnung, Portal (Anfrage) ja: Angebot mit Annahmelink, Zeitraum reserviert bis zum Ablauf. nein: unverbindliche Auskunft mit „Buchung anfragen“, kein Eintrag im Kalender, erneute Prüfung vor der Bestätigung (Paket 7).
Gültigkeit des Angebots bzw. der Auskunft (Bestand) 48 Stunden Vermieter, Wohnung, Portal (Anfrage) Frist des Angebots und der Reservierung bzw. bis wann der Gast aus der Auskunft anfragen kann; danach endet die Anfrage ohne Buchung
Klärungsreservierung automatisch (v0.11, neu) 15 Minuten Vermieter, Wohnung, Kanal × unverbindliche Eingangsart Vor dem eigenen Angebot; 0 = keine Klärungssperre, auch bei aktiver Datenbeschaffung. Mindestdaten Wohnung, Zeitraum, verwendbarer E-Mail-Kontakt und positive Verfügbarkeitsprüfung.
Klärungsreservierung Freigabe/manuell (v0.11, neu) 180 Minuten Vermieter, Wohnung, Kanal × unverbindliche Eingangsart Unabhängiger Parameter, ebenfalls 0 möglich; Beginn im V1-Modell beim ausreichend qualifizierten Anfrageeingang, nicht beim späteren manuellen Öffnen.
Datenrückfrage-Modus (v0.11, neu) Noch zu parametrieren Vermieter, Wohnung, Kanal × Eingangsart Automatisch, vorbereiten mit Freigabe oder manuell; unabhängig vom Angebotsmodus.
Erinnerungen / Folgefragen (v0.11, neu) Erinnerungen: maximal zwei zusätzliche Nachrichten als Ausgangsstandard; Folgefragen-Obergrenze offen Vermieter, Wohnung, Kanal × Eingangsart Getrennte Zähler, Intervalle konfigurierbar, keine Wiederholungsschleife; keine Reservierungsfrist-Verlängerung.
Wer schickt Vertrag bzw. Unterlagen? Wir Vermieter, Wohnung, Portal (Buchung) Portal → A5, keine eigenen Unterlagen
Wer kümmert sich um die Zahlungen? Wir Vermieter, Wohnung, Portal (Anfrage und Buchung) Portal → A4: keine Mahnungen. „Laut Portal bezahlt“ ändert den Status nicht. Nach dem Aufenthalt entsteht die Aufgabe „Auszahlung des Portals prüfen“.
Wer schickt Anreise-Info und Bewertungsbitte? Wir Vermieter, Wohnung, Portal (Anfrage und Buchung) Portal → „durch Portal (angekündigt)“, keine eigenen Mails
Anreise-Info Tage vorher 3 Vermieter, Wohnung Zeitpunkt der Anreisemail. Die Anreisedaten werden 2 Tage davor geprüft.
Vertragsvorlage Texte der Webseite Wohnung, Portal, Vorgang (Zusammenstellung) Inhalt von Angebot, Auskunft, Bestätigung und Unterlagen

3a. Zentraler Kanalmanager – gemeinsamer Verwaltungsort (v0.11)

Der zentrale Kanalmanager führt eigene Website und externe Kanäle gleichermaßen: Kanal-/Wohnungszuordnung, mögliche tatsächliche Eingangsarten, bestehende iCal-Import-/Exportverbindungen, technische Synchronisationsparameter und -status sowie kanalbezogene Prozess-, Kommunikations- und Klärungsparameter. Allgemeine Vermieterstandards bleiben zentral pflegbar; geerbte Werte und ihre Herkunft sollen im vorhandenen Bereich „Wirksame Einstellungen“ sichtbar werden.

Keine zweite Quelle der Wahrheit: Bestehende v0.10-Verbindungen und ProcessSettings bleiben fachliche Grundlage, bis die technische Ist-/Soll-Analyse ein konkretes Refactoring begründet. iCal-Sync und die bestehende regelbasierte Buchungserkennung bleiben eigenständige operative Funktionen. Die neue Konfigurationsverwaltung impliziert weder weitere aktive IMAP-Postfächer noch neue Parser, noch verändert sie Vertrags-/Angebotsentscheidungen.

Kritischer Unterschied zweier 0-Werte: Klärungsreservierung = 0 bedeutet lediglich kein kurzer Sperrblock während der Datenbeschaffung. Angebotsreservierung = 0 bedeutet im bestehenden Angebotsweg Auskunft unter Vorbehalt statt verbindlichem Angebot mit Hold. Diese Werte sind unabhängig und dürfen in UI, Textbausteinen und Prozesslogik nicht gleichgesetzt werden. Ein konfigurierter positiver Kurzblock ist zudem kein Beweis, dass die Sperre tatsächlich wirksam angelegt wurde.

Zur zentralen Detailregel siehe Communication Handler.

4. Weitere Einstellungen

Einstellung Wo Ebene Wirkung
Anreisezeit erfragen (neu) Wohnung › Aufenthalt vorbereiten und abschließen Wohnung Fehlt die Anreisezeit, entsteht die Aufgabe „Anreisedaten beim Gast erfragen“. Kontaktdaten werden immer geprüft (nicht bei A6).
Aufgaben je Aufenthalt (neu) Wohnung › Aufenthalt vorbereiten und abschließen Wohnung Je Zeile: Was, Wann (Tage vor Anreise / am Anreisetag / am Abreisetag), Wer, für welche Art von Aufenthalt (Gästebuchungen, Familie/Freunde, eigene Nutzung, Sperren). Daraus wird je Aufenthalt eine Aufgabe, die den Aufenthaltsabschluss aufhält, bis sie erledigt oder übergeben ist.
Gebuchte Leistungen Wohnung › Zusatzleistungen Wohnung werden automatisch zu „Bereitstellen: …“ (nur bei eigenem Preis bzw. A6)
Kurabgabe je Person und Nacht Wohnung › Preise Wohnung Position bei A6
Erkannte Buchungen übernehmen Portal Kanal Aus / Beobachten / Anlegen / Anlegen und weiter (Paket 4)
Was kommt über dieses Portal? Portal Kanal Sofortbuchungsschutz (CalendarClearance)
Zusätzlich von Hand sperren Portal Kanal Portalaufgaben mit Nachweisstufe
Freigabe der Dokumentarten So arbeite ich › Dokumente Vermieter Arbeitsfassungen gehen nie automatisch hinaus. Neu ist die Dokumentart „Auskunft unter Vorbehalt“; solange sie nicht freigegeben ist, wird nicht automatisch geantwortet.
Freigabe einer Vorlage Vorlagen › Freigabe Vorlagenversion Schutz vor unvereinbarten Bedingungen
Testbetrieb / Testadresse System › Betrieb Vermieter (Server-Vorgabe FEWO_MAIL_REDIRECT_TO gewinnt) Jede ausgehende Mail nur an die Testadresse; der Verlauf vermerkt es. iCal-Abgleich bleibt aktiv.
Anzahlungsfrist, Bewertung nach Tagen System › Betrieb Vermieter Zahlungsplan, Bewertungsbitte

Im einzelnen Vorgang übersteuerbar:

  • Bearbeitungsart
  • Vorlage (im Dokument)
  • bei Haltefrist 0 „Stattdessen verbindliches Angebot mit Reservierung senden“
  • Preis bei der Bestätigung eines Wunsches (Preis der Auskunft oder ein niedrigerer heutiger Preis)
  • eigene Aufgaben, Abweichungen und Folgeaufgaben; Aufgaben als erledigt, übergeben oder entfällt markieren
  • Aufenthalt von Hand abschließen
  • kaufmännischer Abschluss mit Begründung

Fest im Code:

  • Vorbereitung 14 Tage im Voraus
  • Anreisedaten-Prüfung 2 Tage vor der Anreise-Info
  • Auszahlungsprüfung am Tag der Abreise + 14
  • Abschluss in der Nacht nach der Abreise

5. Sonderfälle nur über Konfiguration

Sonderfall Konfiguration
Ein Portal leitet nur Anfragen weiter, die nichts blockieren sollen Portal › Anfragen: „Reservieren? nein“ → Auskunft statt Angebot (T24)
Diese Wohnung wird von Hand bearbeitet, die andere automatisch Wohnung › Abweichende Abwicklung: Bearbeitung
Schlüsselübergabe nur bei Gästen, Endreinigung auch bei Familie Aufgaben je Aufenthalt mit „Bei“ (T19, T21)
Ein Gast soll trotz Haltefrist 0 ein bindendes Angebot erhalten im Vorgang „Stattdessen verbindliches Angebot …“
Portal schickt Anreise-Info selbst Portal › Feste Buchungen: „Anreise-Info und Bewertung: Portal“ (T20)
Kleine Auszahlungsdifferenz akzeptieren im Vorgang „Kaufmännisch abschließen …“ mit Begründung (T22)

6. Nachweis an konkreten Vorgängen

Konstellation Erwartung Beobachtet
Standard automatisch, Wohnung 24 h, direkte Anfrage automatisch (Standard), 24 h (Wohnung) identisch (T12)
FeWo-direkt feste Buchung, Zahlung Portal A4, keine Mahnung, Status bleibt „Bestätigt“ trotz „laut Portal bezahlt“ identisch (T04, T20)
Standard mit Reservierung, Ostseeklar-Anfragen ohne Reservierung und manuell direkte Anfrage: Angebot und Reservierung. Ostseeklar: keine Reservierung, Aufgabe „Auskunft senden“ identisch (T24)
Ostseeklar-Anfrage im Vorgang auf automatisch Auskunft sofort, Wunsch automatisch bestätigt identisch (T24)
Wohnung Anreise-Info 5 Tage, Anreisezeit erfragen Anreisedaten-Aufgabe 7 Tage, Anreisemail 5 Tage vorher identisch (T24)
Automatisch, aber Preis geändert bzw. Kalender veraltet keine Automatik, Aufgabe mit Befunden identisch (T17)
Familienbesuch Unterlagen, Zahlungen, Mails „Entfällt“; Aufgaben je Aufenthalt „Familie“ wirken identisch (T09, T21)

6a. Neue v0.11-Konfigurationsgegenstände (noch nicht als implementiert anzusehen)

  • Je Mandant zunächst ein aktives IMAP-Postfach, Aliasadressen möglich; Datenmodell perspektivisch mehrere Postfächer.
  • KI-Extraktion: versionierte Prompts mit Platzhaltern und strukturiertem Schema, kleines Primärmodell und optional größeres Prüfmodell, programmatische Kritikalitätsregeln und zu kalibrierende Schwellwerte. Zentral administrierbar; kein grafischer Prompt-Editor als MVP-Pflicht.
  • Signierte Gastlinks: Laufzeit/Status und Formularberechtigungen ohne Gastregistrierung; Sicherheitsgrenzen nicht durch Geschäftskonfiguration abschaltbar.
  • Gastkommunikation: Bausteine für tatsächlich keinen/aktiven/abgelaufenen Klärungsblock sowie bereits verbindliche Portalbuchungen.

7. Lücken und widersprüchliche Stellen

Stelle Beschreibung Empfehlung
Buchungsmodell am Portal und Profil „Was kommt über dieses Portal?“ und das Profil je Eingangsart können sich widersprechen. Modell aus den Eingangsarten ableiten oder einen Hinweis im Portalformular zeigen.
Alte Spalten properties.hold_hours, pre_reservation_enabled, arrival_info_days_before u. a. werden nicht mehr gelesen. Nach erfolgreicher Migration auf Produktion entfernen.
Aufgaben je Aufenthalt nur je Wohnung, nicht je Portal ausreichend für 1–3 Wohnungen
Feste Fristen Vorbereitung, Anreisedaten-Prüfung, Auszahlungsprüfung einstellbar machen, wenn Erfahrungswerte vorliegen
Gültigkeit der Auskunft dieselbe Einstellung wie das Angebot bewusst so (E-026)

v0.11-Grenze: Die oben als neu markierten Parameter beschreiben die künftige fachliche Soll-Konfiguration; die dokumentierten Screenshots, Artisan-Berichte und Tests der Pakete 1–9 belegen ausschließlich den v0.10-Bestand.