144 lines
14 KiB
Markdown
144 lines
14 KiB
Markdown
# 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](Querschnitt/Datenbeschaffung_und_Communication_Handler.md).
|
||
|
||
## 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.
|