Pakete 8, 5 und 6: Beträge und Zahlungen, Ändern und Stornieren, A6 im Vorgang
Deploy FeWo mit PipelineManager / deploy (push) Successful in 4m44s

- Paket 8: Zahlungsarten (Gast an uns, laut Portal, Auszahlung, Erstattung),
  Portalbeträge als Angaben mit Quelle, Übersicht nach Zuständigkeit (R09).
- Paket 5: Ändern mit Folgenvorschau, vereinbart oder dem Gast vorgeschlagen
  (signierter Link), ein Stornoweg mit Grund und Erstattung, Portalstorno erst
  nach Bestätigung.
- Paket 6: eigene Nutzung, Besuch und Sperre als Vorgang mit Kurabgabe und
  Aufenthaltsbestätigung; Bestandsübernahme der Sperren mit identischem Export.
- Wirksame Einstellungen (Expertenansicht), Abnahmekatalog T01–T14, Ergebnis-,
  Abnahme- und Konfigurationsdokument.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-01 22:16:47 +01:00
1 parent 33f8f899d6
commit 3bcfc09417
77 files changed
+3638 -122

No files matched your search

Binary file not shown.

After

Width:  |  Height:  |  Size: 254 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 179 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 219 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 152 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 185 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 453 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 330 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

@@ -0,0 +1,69 @@
# Fachliche End-to-End-Abnahme
Wiederverwendbarer Katalog repräsentativer Geschäftsfälle. Jeder Fall ist aus Sicht der Vermieterin beschrieben und hat zwei Nachweise:
- einen automatisierten Durchgang über die echten Dialoge, Aktionen und Gast-Links, im Test `tests/Feature/EndToEndAcceptanceTest.php`, Methode `test_tNN_…`;
- wo sinnvoll eine Sichtprüfung im Browser, Screenshots unter `Abnahme/<Datum>/`.
Für weitere Pakete werden Fälle ergänzt und der Abschnitt „Durchführung“ neu datiert.
**Durchführung 01.11.2026**
- Stand: Branch `feature/abwicklung`, Pakete 1–6 und 8.
- Automatisiert: 15 Fälle, alle bestanden (Teil der Suite mit 685 grünen Tests).
- Browser: lokale Datenbankkopie mit Testdaten (Gäste `@example.test`), Testbetrieb aktiv, Versandweg „log“, Anmeldung mit Zwei-Faktor-Code.
- Testsystem: nicht genutzt, keine Deployment-Freigabe.
- Echte Gastnachrichten oder Portalbelegungen: keine.
**Status:** ✅ erfolgreich · ◐ teilweise · ✗ fehlgeschlagen · – noch nicht ausführbar
---
## Testfälle
| ID | Fall | Ausgangslage und Konfiguration | Anwenderhandlungen | Soll | Ist | Status | Nachweis |
|---|---|---|---|---|---|---|---|
| T01 | Eigene Anfrage, automatisch | Vermieterstandard „automatisch“, Vertragstexte und Bank hinterlegt | Gast fragt über die Webseite an | Angebot geht ohne Klick hinaus; Vorgang wartet auf den Gast; nichts unter „Zu erledigen“ | wie Soll (A1, Angebot gesendet, Aktivität „Gast nimmt an“ wartet) | ✅ | `test_t01_…` |
| T02 | Eigene Anfrage, manuell | Standard „Sie geben frei“; Portal „Ostseeklar“ mit Handsperre | „Neu → Anfrage“; „Angebot prüfen und senden“; Gast nimmt per Link an | Zu erledigen „Angebot prüfen und senden“; nach Annahme gebucht, Vertrag, Bestätigung, Sperraufgabe | wie Soll | ✅ | `test_t02_…` |
| T03 | Fehlende Gastdaten | automatisch; Anfrage per Telefon ohne E-Mail | „E-Mail-Adresse eintragen“ mit „automatisch weitermachen“ | verständliche Aufgabe, danach Angebot automatisch | wie Soll | ✅ | `test_t03_…` |
| T04 | FeWo-direkt-Direktbuchung | Kanal „Anlegen“, Zahlung über Portal | Buchungsmail kommt an; „Preis laut Portal eintragen“ 979,51 € | ein Vorgang A4, Portalpreis, keine eigenen Mahnungen | wie Soll | ✅ | `test_t04_…` |
| T05 | Destination Solutions | Portal ohne Automatik, Zahlung durch uns | „Neu → Buchung von einem Portal“ mit Nummer, Preis, Gast | A3 gebucht ohne Angebot; Unterlagen und Zahlungsplan durch uns; Anzahlung bewegt den Status | wie Soll | ✅ | `test_t05_…` |
| T06 | Doppelte Portalmeldungen | Kanal mit iCal-Regel und Mail-Absender | Mail, danach zweimal Kalenderabgleich | genau ein Vorgang, Kalendereintrag zugeordnet | wie Soll | ✅ | `test_t06_…` |
| T07 | Buchungsänderung | gebuchte eigene Buchung 07.–10.11. | „Buchung ändern …“ bis 12.11., vereinbart am Telefon | Vorschau zeigt Folgen; danach Zeitraum, Preis, Zahlungsplan, Portalaufgabe, Verlauf | wie Soll (Preis +130 €, „Neu belegt“, Aufgabe Ostseeklar) | ✅ | `test_t07_…`, `T07-aendern-folgen.png` |
| T08 | Stornierung | eigene Buchung mit 100 € Zahlung; Portalbuchung; offene Anfrage | „Stornieren …“ bzw. „Beenden …“; bei Portal „Stornierung bestätigen …“ | eigene: storniert mit Initiator, Grund, Kosten- und Erstattungsaufgabe; Portal: erst nach Bestätigung storniert; Anfrage: ohne Buchung beendet, kein Storno | wie Soll | ✅ | `test_t08_…`, `T08-zu-erledigen-portalstorno.png` |
| T09 | Familienbesuch | Kurabgabe 2,50 €; Leistung Wäschepaket 18 € | „Neu → Eigene Nutzung oder Besuch → Familie“, 5 Nächte, 3 Personen, Miete 0, 3 Wäschepakete, Kurabgabe 2 Personen | A6 mit 54 € + 25 € Kurabgabe = 79 €; Portale gesperrt; kein Vertrag, keine Mahnung, keine Bewertung | wie Soll | ✅ | `test_t09_…`, `T09-neu-besuch.png`, `T09-familienbesuch.png` |
| T10 | Wartungssperre | – | Belegungsplan „+ eintragen“ → Sperre; „Ändern oder verlängern …“; „Sperre aufheben …“ | ohne Gast, Vertrag, Zahlung; Verlängerung passt Portale an; Aufheben ist keine Stornierung, Portale werden freigegeben | wie Soll | ✅ | `test_t10_…`, `T10-sperre-aufheben.png` |
| T11 | Externe Zahlungen (R09) | FeWo-direkt-Buchung | Beträge laut Portal: 840 / −42 / 181,51 Sammelposten / 979,51 / −84,82 / 894,69 und 900,20 / Rate 588,90 fällig / 390,61 laut Portal bezahlt; später Auszahlung 894,69 € erfasst | Summe = Gesamtpreis; Abweichung 5,51 € ungeklärt angezeigt; offen bei uns 0; Konto erst nach Auszahlung; keine Doppelzählung | wie Soll | ✅ | `test_t11_…`, `T11-betraege-r09.png` |
| T12 | Einstellungshierarchie | Standard automatisch / 48 h; Wohnung 24 h; FeWo-direkt Anfrage „manuell“, Buchung Zahlung Portal | Anfrage über FeWo-direkt; im Vorgang auf „automatisch“ umstellen; Seite „Wirksame Einstellungen“ | jede Ebene wirkt mit richtiger Herkunft; die Vorgangsentscheidung gewinnt; Übersicht zeigt beides | wie Soll | ✅ | `test_t12_…`, `T12-wirksame-einstellungen.png` |
| T13 | Testbetrieb | Testbetrieb mit Testadresse, echter Mailer | ganzer Ablauf: Anfrage, Angebot, Annahme, Änderung mit Bestätigung, Storno mit Mail | jede tatsächlich versendete Nachricht geht nur an die Testadresse | wie Soll (≥ 6 Nachrichten, alle an test@example.com) | ✅ | `test_t13_…`, zusätzlich `MailTestModeGateTest` |
| T14 | Änderungen mit Zustimmung | gebuchte eigene Buchung | Vorschlag an den Gast; Gast nimmt per Link an; danach vereinbarte Änderung mit Bestätigung | Vorschlag ändert nichts bis zur Annahme; Annahme mit Zeitpunkt; Bestätigung einer vereinbarten Änderung ist keine Zustimmung | wie Soll | ✅ | `test_t14_…`, `T14-gast-aenderungsvorschlag.png` |
| T15 | Bestandsübernahme Sperren (6.3) | zwei manuelle Sperren, Exportkanal | `cases:adopt-blocks` Vorschau, `--apply`, nochmals `--apply` | zwei A6-Vorgänge, keine Dublette, Export identisch, keine Aufgaben oder Mails | wie Soll | ✅ | `test_existing_manual_blocks_…` |
---
## Nicht ausführbare oder nur teilweise geprüfte Punkte
| Punkt | Grund |
|---|---|
| Durchführung auf dem Testsystem stommer.info | keine Deployment-Freigabe; geprüft wurde auf einer lokalen Datenbankkopie |
| Echte FeWo-direkt-Mails und -Feeds | nur synthetische Muster (siehe Beobachtungsmodus aus Paket 4) |
| Darstellung auf Tablet und Smartphone | nicht geprüft |
| Bedienprobe mit der Vermieterin | steht aus (Abnahme 2.5) |
| Änderung extern (5.2) als eigener Durchgang | durch die Preislogik und T04/T11 abgedeckt, kein eigener Testfall |
---
## Erkannte Bedienungsprobleme
| Problem | Stand |
|---|---|
| Bei A6 erschien „Über: internal“, dazu der Schalter „Sie geben frei“ und eine Vorlagenangabe | behoben |
| Ein Portal mit Buchungsmodell „gemischt“ (Sofortbuchung), dessen Kalenderexport nie abgeholt wurde, hält automatische Angebote und sogar Gastannahmen an („Verfügbarkeit nicht sicher“). Das ist fachlich richtig, für Testdaten aber überraschend. | dokumentiert; bei Einrichtung eines Portals das Buchungsmodell bewusst wählen |
| Bei Portalzahlung zeigt der Status „Anzahlung erhalten“, der Verlauf „Anzahlung eingegangen“, obwohl nur laut Portal bezahlt ist | offen (Entscheidung, siehe Ergebnisdokument §7) |
| Der Dialog „Buchung ändern“ ist lang (Termin, Leistungen, Preis, Folgen, Grundlage) | offen – Vorschlag: Grundlage oben, Leistungen zuklappen |
| „Wirksame Einstellungen“: die Spalte „Wo einstellen?“ wiederholt sich je Zeile | offen, rein kosmetisch |
## Offene Arbeiten
1. Abnahme auf dem Testsystem nach Freigabe (Migration MariaDB, `cases:adopt-blocks` Vorschau mit echten Daten).
2. Bedienprobe mit der Vermieterin mit T02, T07, T09 und T10 als Drehbuch.
3. Statusbezeichnung bei Portalzahlung klären (mit B4 / Paket 9).
4. Texte Änderungsbestätigung, Änderungsvorschlag und Aufenthaltsbestätigung freigeben.
@@ -0,0 +1,88 @@
# Konfiguration und Wirksamkeit
Welche fachlichen Einstellungen es gibt, wo man sie vornimmt, wie sie sich vererben und wie man nachprüft, dass sie in einem konkreten Vorgang wirklich angewandt wurden. Stand 01.11.2026, Pakete 1–6 und 8.
---
## 1. Wo man die Wirksamkeit sieht
| Werkzeug | Zeigt |
|---|---|
| **System › Wirksame Einstellungen** (Expertenansicht) | Je Wohnung und Eingangsweg (direkte Anfrage, jedes Portal getrennt nach Anfrage und fester Buchung, A6) den Wert jeder Prozesseinstellung, der für einen **neuen** Vorgang gilt, mit Herkunft und dem Ort, an dem man ihn ändert. „Einen Vorgang prüfen“ zeigt das tatsächlich angewandte Profil eines Vorgangs und eine Umstellung im Vorgang. Direktaufruf: `…/admin/wirksame-einstellungen?vorgang=<ID>`. |
| **Vorgang › Technische Angaben** (Expertenansicht) | eingefrorenes Abwicklungsprofil mit Herkunft je Wert, Quellen und Kalenderdarstellungen |
| **Vorgang › Zusammenstellung** (Paket 3) | Vorlage mit Herkunft („eingestellt für FeWo-direkt (Verbindliche Buchung)“) |
| `php artisan process:settings-report` | alle Standards und Abweichungen als Text |
| `php artisan channels:intake-report` | was der Eingang je Portal erkannt hat (Paket 4) |
Nachweis im Test: `EndToEndAcceptanceTest::test_t12_settings_hierarchy_is_applied_and_visible`; Screenshot `Abnahme/2026-11-01/T12-wirksame-einstellungen.png`.
---
## 2. Vererbung
```
Grundeinstellung (im Code)
→ Ihr Standard System › So arbeite ich
→ Wohnung Wohnung bearbeiten › „Abweichende Abwicklung dieser Wohnung“ (Expertenansicht)
→ Portal je Eingangsart Portal bearbeiten › „Anfragen über dieses Portal“ / „Feste Buchungen über dieses Portal“
→ Vorgang Schalter „Läuft automatisch / Sie geben frei“ auf der Vorgangsseite
```
- **Leer heißt „erbt“.** Ein bewusst gesetztes „nein“, „0“ oder „manuell“ ist ein eigener Wert.
- **Eingefroren beim Eingang.** Ein Vorgang behält die Werte, die bei seinem Eingang galten. Spätere Änderungen gelten nur für neue Vorgänge. Ausnahme ist die Vertragsvorlage: Sie wird erst festgehalten, wenn das Dokument erstellt wird.
- **A6 fest.** Für eigene Nutzung, Besuch und Sperre stehen Unterlagen, Zahlungen und Gastmails unabhängig von jeder Einstellung auf „Entfällt“ (Herkunft „fest für diese Vorgangsart“).
- **Anfragen:** Unterlagen schicken immer wir (Herkunft „Grundeinstellung“), denn das Angebot ist unser eigenes.
- **Die Vorgangsart ergibt sich aus den wirksamen Werten.** Anfrage direkt = A1, über ein Portal = A2; feste Portalbuchung = A3 (wir zahlen und schicken Unterlagen), A4 (Portal zahlt), A5 (Portal schickt Unterlagen); intern = A6.
---
## 3. Einstellbare Prozessparameter
| Einstellung | Standard | Übersteuerbar auf | Wirkung |
|---|---|---|---|
| Bearbeitung neuer Vorgänge (automatisch / Sie geben frei) | Sie geben frei | Vermieter, Wohnung, Portal (Anfrage und Buchung), Vorgang | Ob Angebote und Unterlagen ohne Klick hinausgehen, sobald nichts fehlt und nichts zu prüfen ist |
| Reserviert eine Anfrage den Zeitraum? | ja | Vermieter, Wohnung, Portal (Anfrage) | Belegt den Zeitraum bis zum Ablauf. Bei „nein“ gibt es kein Angebot mit Annahmelink ohne ausdrückliche Bestätigung (Hold-0-Schutz bis Paket 7). |
| Gültigkeit Angebot / Reservierung | 48 Stunden | Vermieter, Wohnung, Portal (Anfrage) | Frist für Angebot und Reservierung |
| 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, Übersicht „laut Portal“ (Paket 8) |
| Wer schickt Anreise-Info und Bewertungsbitte? | Wir | Vermieter, Wohnung, Portal (Anfrage und Buchung) | Portal → keine eigenen Mails |
| Anreise-Info Tage vorher | 3 | Vermieter, Wohnung | Zeitpunkt der Anreisemail |
| Vertragsvorlage | Texte der Webseite | Wohnung, Portal (Anfrage und Buchung), Vorgang (Zusammenstellung) | Inhalt von Angebot, Bestätigung und Buchungsunterlagen |
**Weitere Einstellungen außerhalb dieser Hierarchie:**
| Einstellung | Wo | Ebene | Wirkung |
|---|---|---|---|
| Erkannte Buchungen automatisch übernehmen | Portal bearbeiten | Kanal | Aus / Beobachten / Anlegen / Anlegen und weiterbearbeiten (Paket 4) |
| Was kommt über dieses Portal? (Anfrage / Portalbuchung / gemischt) | Portal bearbeiten | Kanal | Sofortbuchungsschutz (`CalendarClearance`); „nur Anfragen“ lässt feste Buchungen klären |
| Zusätzlich von Hand sperren | Portal bearbeiten | Kanal | Portalaufgaben mit Nachweisstufe |
| Freigabe der Dokumentarten | System › So arbeite ich › Dokumente | Vermieter | Arbeitsfassungen gehen nie automatisch hinaus |
| Freigabe / Portalbedingungen einer Vorlage | Vorlagen › Freigabe | Vorlagenversion | Schutz vor unvereinbarten Bedingungen (Paket 3) |
| Kurabgabe je Person und Nacht | Wohnung › Preise | Wohnung | Position „Kurabgabe“ bei A6 |
| Testbetrieb / Testadresse | System › Betrieb | Vermieter (Server-Vorgabe `FEWO_MAIL_REDIRECT_TO` gewinnt) | Jede ausgehende Mail nur an die Testadresse |
| Anzahlungsfrist, Bewertung nach Tagen | System › Betrieb | Vermieter | Zahlungsplan, Bewertungsbitte |
---
## 4. Nachweis an konkreten Vorgängen (Abnahme 01.11.2026)
| Konstellation | Erwartung | Beobachtet |
|---|---|---|
| Standard „automatisch“, Wohnung „24 Stunden“, direkte Anfrage | automatisch (Ihr Standard), 24 h (Wohnung) | identisch (T12) |
| FeWo-direkt Anfrage „manuell“ | manuell, Herkunft Portal | identisch (T12) |
| FeWo-direkt feste Buchung ohne eigene Bearbeitungseinstellung | automatisch, Herkunft „Ihr Standard“ – erbt | identisch (T12) |
| FeWo-direkt feste Buchung, Zahlung Portal | A4 | identisch (T04, T12) |
| Anfrage über FeWo-direkt, im Vorgang auf „automatisch“ umgestellt | Vorgang automatisch, Hinweis „für diesen Vorgang umgestellt“ | identisch (T12, Seite „Wirksame Einstellungen“) |
| Familienbesuch | Unterlagen, Zahlungen, Gastmails „Entfällt (fest A6)“ | identisch (T09, Screenshot T12) |
---
## 5. Lücken und widersprüchliche Stellen
| Stelle | Beschreibung | Empfehlung |
|---|---|---|
| **Buchungsmodell am Portal und Abwicklungsprofil** | „Was kommt über dieses Portal?“ steuert noch den Sofortbuchungsschutz und den Hinweis „nur Anfragen“. Das Profil je Eingangsart steuert die Abwicklung. Beides kann sich widersprechen, z. B. Modell „nur Anfragen“, aber Abweichungen für feste Buchungen gepflegt. | Beim nächsten Paket das Modell aus den gepflegten Eingangsarten ableiten oder einen Hinweis im Portalformular zeigen. |
| **Alte Spalten** | `properties.hold_hours`, `pre_reservation_enabled` usw. und Kanal-Booleans werden seit Paket 1 nicht mehr gelesen, stehen aber noch in der Datenbank. | Nach erfolgreicher Migration auf Produktion entfernen. |
| **Kurabgabe** | Satz nur an der Wohnung, nicht in der Hierarchie; bei Gästen regulärer Buchungen nicht berechnet (die Verträge sagen „vor Ort“). | Bewusst so (B1); erweitern, falls auch reguläre Buchungen sie ausweisen sollen. |
| **Bearbeitungsart bei A6** | wird angezeigt, ist aber ohne Wirkung; bei A6 gibt es nichts Automatisches | ohne Handlungsbedarf |
| **Einstellungen im Vorgang** | Nur die Bearbeitungsart und die Vorlage (im Dokument) lassen sich je Vorgang umstellen, sonst nichts. | entspricht dem Plan |
@@ -0,0 +1,190 @@
# Umsetzungsergebnis Pakete 8, 5 und 6
Stand: 01.11.2026 · Branch `feature/abwicklung` (aufbauend auf `develop` = Pakete 1–4) · Grundlage: [UMSETZUNGSPLAN_v0.10](UMSETZUNGSPLAN_v0.10.md) §4.6, §5.6, §5.7, §5.9 und die Abnahmekriterien 5.x, 6.x, 8.x. Die normative Prozessarchitektur v0.10 wurde nicht verändert.
Begleitdokumente: [END_TO_END_ABNAHME.md](END_TO_END_ABNAHME.md) (fachliche Abnahme T01–T14) und [KONFIGURATION_UND_WIRKSAMKEIT.md](KONFIGURATION_UND_WIRKSAMKEIT.md).
---
## 1. Implementierungsstand je Paket
| Paket | Stand | Einschränkungen |
|---|---|---|
| **8 – Externe Beträge und Zahlungsstände** | umgesetzt | Kein Import von Portalbeträgen aus Mails oder Abrechnungen; erfasst wird von Hand. |
| **5 – Änderung, Storno, kontrollierter Abbruch** | umgesetzt | Kein Änderungsvorschlag an Portalgäste (geändert wird im Portal); keine PDF-Nachtragsurkunde, die Änderungsbestätigung ist eine Mail. |
| **6 – A6 im Vorgang** | umgesetzt | Der Kalender-Schnellweg ist ein Link je freiem Tag, keine Bereichsauswahl per Maus. |
Tests: **685 grün** (vorher 670; neu sind 15 fachliche Durchgangstests in `EndToEndAcceptanceTest`), Pint sauber. Die Abnahme über die Oberfläche lief im Browser auf einer Datenbankkopie. Ein Testsystem stand ohne Deployment-Freigabe nicht zur Verfügung.
---
## 2. Verfügbare Geschäftsfunktionen
### Paket 8 – Preise und Zahlungen
**Preis laut Portal eintragen.** Ein Dialog übernimmt den Gesamtpreis des Gastes als vereinbarten Preis. Aufklappbar folgen Einzelangaben mit Art, Bezeichnung, Betrag und bei Raten dem Fälligkeitsdatum:
- Übernachtung, Leistung, Rabatt, Gebühr/Steuer
- Sammelposten, nicht aufgeschlüsselt
- Provision / an das Portal gezahlt
- angekündigte Auszahlung, Rate laut Portal fällig
Zahlungen, die das Portal als bezahlt zeigt, lassen sich mit eintragen. Quelle und Stand werden gespeichert. Dieselbe Angabe ein zweites Mal wird nicht doppelt angelegt.
**Zahlungen mit Art.** Es gibt vier Arten:
- Gast hat an uns gezahlt
- Gast hat laut Portal ans Portal gezahlt
- Auszahlung vom Portal erhalten
- Erstattung an den Gast (wird automatisch abgezogen)
**Übersicht „Preis und Zahlungen“** im Vorgang:
- vereinbarter Gesamtpreis mit Herkunft
- je nach Zuständigkeit: „Noch offen – zahlt der Gast an uns“ oder „laut Portal bezahlt / noch beim Gast offen / Raten“
- angekündigte und erhaltene Auszahlungen; widersprüchliche Angaben stehen nebeneinander mit dem Hinweis „weichen um 5,51 € ab – ungeklärt“
- „Auf unserem Konto eingegangen“
- aufklappbar die Einzelangaben mit Summenprüfung („979,51 € = Gesamtpreis“)
**Zuständigkeit.** Zahlungserinnerungen entstehen nur, wenn wir die Zahlung einziehen. Bei Portalzahlung und bei A6 entstehen keine.
### Paket 5 – Ändern, Stornieren, Beenden
**„Buchung ändern …“** (bei A6 „Ändern oder verlängern …“) ändert Zeitraum, Personen, Leistungen und Preis. Vor dem Speichern zeigt der Dialog „Das ändert sich“ und „Folgen“:
- neu belegte bzw. wieder freie Nächte
- Aufgaben für Portale, die von Hand gesperrt werden
- alter und neuer Preis mit Differenz und Herkunft: neu berechnet (eigene Buchung, angepasste Positionen bleiben), neuer Betrag laut Portal (A3–A5) oder vereinbarte Miete mit Leistungen und Kurabgabe (A6)
- bisher bezahlt und danach offen; die Anzahlung bleibt, wenn sie bezahlt ist; neue Fälligkeit; Erstattungshinweis
**Zwei Wege:**
- *Mit dem Gast bereits vereinbart:* Die Änderung wirkt sofort und hält fest, wer sie wollte, warum, ab wann und auf welcher Grundlage (Telefon, E-Mail, persönlich, Portal). Auf Wunsch geht eine Bestätigung an den Gast. Sie informiert nur und gilt **nicht** als Zustimmung.
- *Dem Gast vorschlagen:* Bis zur Zustimmung ändert sich nichts. Der Gast bekommt einen signierten Link, nimmt an (mit Häkchen; Zeit und gehashte Adresse werden gespeichert) oder lehnt ab. Die Vermieterin wird informiert, der Vorschlag lässt sich zurückziehen.
**Folgen nach dem Speichern:**
- Kalender und Portalexport sind aktualisiert; Sperr- und Freigabeaufgaben entstehen.
- Der Zahlungsstatus wird neu berechnet.
- Bei Überzahlung entsteht die Aufgabe „Erstattung an den Gast prüfen“.
- Jede Änderung steht im Verlauf (`booking_changes`).
**„Stornieren …“ / „Beenden …“** wählt den Weg nach Lage:
| Lage | Ergebnis |
|---|---|
| Unverbindlich | Ohne Buchung beendet; Absage optional, Grund im Verlauf. |
| Eigene Buchung | Storniert mit Initiator, Grund und Erfasser. Stornokostenaufgabe nach der eingefrorenen Regel; Erstattungsaufgabe, wenn mehr gezahlt wurde als die Kosten. |
| Portalbuchung (A3–A5) | „Stornierung im Portal veranlassen“. Der Vorgang **bleibt gebucht** und der Zeitraum belegt, bis „Stornierung bestätigen …“ mit dem Häkchen „im Portal wirksam (geprüft)“ erledigt ist. Meldet das Portal die Stornierung selbst (Paket 4), heißt die Aktion „Stornierung übernehmen …“. |
| A6 | „Sperre aufheben …“ bzw. „Aufenthalt absagen …“: keine Stornierung, keine Kosten, keine Mails. Die Portale werden freigegeben. |
Der Stornolink des Gastes führt wie bisher zur Aufgabe am Vorgang und damit in denselben Stornoweg. „Status von Hand ändern“ bleibt in der Expertenansicht mit Pflichtbegründung und kann eine verbindliche Buchung nicht zurücksetzen.
### Paket 6 – Eigene Nutzung, Besuch, Sperre
**„Neu“ hat zwei zusätzliche Einstiege:**
- „Eigene Nutzung oder Besuch von Familie und Freunden“, mit der Frage „Wir selbst / Familie oder Freunde“
- „Eine Sperre ohne Gäste“
Erfasst werden Zeitraum und Anlass. Bei Besuch kommen Gäste, Personen, Leistungen, vereinbarte Miete (Standard 0 €), Kurabgabe-Personen und Befreiungen dazu.
**Schnellwege:**
- im Belegungsplan „+ eintragen“ an jedem freien Tag und „Eigene Nutzung / Sperre eintragen“;
- in der Liste „Sperrzeiten“ führt „Zeitraum sperren“ in denselben Dialog.
**Der A6-Vorgang:**
- belegt sofort; Portale werden gesperrt (Aufgaben oder Kalenderexport, im Export ohne Buchungsnummer und wie eine Sperre);
- hat eigene Aktivitäten: eingetragen, Portalsperren, Aufenthaltsbestätigung (optional), Zahlung ohne Erinnerungen, Aufenthalt bzw. Sperrzeit;
- ohne Mietvertrag, Mahnungen, Bewertungsanfrage, Anreisemail und Marketing; das A6-Profil setzt diese Zuständigkeiten fest auf „Entfällt“.
**Kurabgabe:**
- als eigene Position „Kurabgabe (N Personen × M Nächte)“;
- der Satz je Person und Nacht steht an der Wohnung unter Preise, Feld „Kurabgabe je Person und Nacht“;
- Befreiungen trägt man im Vorgang als Text ein;
- keine kommunale Tariflogik.
**Aufenthaltsbestätigung:** eine eigene Dokumentart mit PDF ohne Mietvertrag und Mail `StayConfirmed`. Sie wird über die Zusammenstellung aus Paket 3 versendet und ist eine Arbeitsfassung, bis sie freigegeben ist.
**Bestandsübernahme `cases:adopt-blocks`:**
- Ohne Zusatz ist es eine Vorschau; mit `--apply` werden die Sperren übernommen.
- Ein zweiter Lauf übernimmt nichts doppelt; `--revert=<Bericht>` macht die Übernahme rückgängig.
- Bisherige manuelle Sperren werden zu A6-Vorgängen. Die Sperre bleibt als gelöschte Spur erhalten.
- **Der Kalenderexport ist danach identisch:** gleiche Kennung `block-…`, gleiche Felder, gleicher Zeitstempel. Es entstehen keine Portalaufgaben und keine Mails.
### Übergreifend – Wirksame Einstellungen
Neue Expertenseite **System › Wirksame Einstellungen**:
- je Wohnung und Eingangsweg (direkte Anfrage, jedes Portal mit Anfrage und fester Buchung, A6) jede Prozesseinstellung mit wirksamem Wert, Herkunft und dem Ort, an dem sie eingestellt wird;
- „Einen Vorgang prüfen“ zeigt das tatsächlich angewandte, eingefrorene Profil und die Entscheidung im Vorgang.
Details stehen in [KONFIGURATION_UND_WIRKSAMKEIT.md](KONFIGURATION_UND_WIRKSAMKEIT.md).
---
## 3. Technische Konsolidierungen und Architekturentscheidungen
| Entscheidung | Begründung |
|---|---|
| **Kein neues Zahlungsmodell, sondern `payments.kind`** (`PaymentKind`). `Booking::paidAmount()` zählt nur Zahlungen des Gastes; `paidToUs()`, `paidViaPortal()` und `payoutsReceived()` sind getrennt. | Bestehende Zahlungen bleiben gültig (Standard „Gast an uns“), Mahnläufe und Status arbeiten weiter. Auszahlungen zählen nicht doppelt. |
| **Beträge als Angaben (`case_amounts`, `AmountKind`)**, nie verrechnet; `App\Pricing\CaseMoney` beantwortet die vier Geldfragen. | Vorgabe K01/E-014/E-015: keine Scheingenauigkeit, Widersprüche bleiben sichtbar. |
| **Eine Aktion `ChangeBooking`** mit `preview`, `apply`, `propose`, `accept`, `decline`, `withdraw`; Änderungen als `booking_changes` mit vorher/nachher und Folgen. | Ein Weg für A1–A6; Vorschau und Ausführung rechnen identisch. Kalender und Portalaufgaben folgen über den bestehenden `BookingObserver`. |
| **Gastzustimmung nur über den signierten Link** (`ChangeBasis::GuestLink` ist nur dort möglich). Eine Änderungsbestätigung setzt `confirmation_sent_at`, nicht `decided_at`. | Auftrag §5: Eine versendete Bestätigung ist keine Zustimmung. |
| **Portalstorno zweistufig** (`portal_cancellation_requested_at`, `CancelBooking::confirmOnPortal`). | Abnahme 5.5: erst storniert, wenn im Portal wirksam; nichts wird still freigegeben. |
| **A6 ist ein `Booking`** mit `intake = internal`, `internal_kind`, Quelle `internal`; das Profil setzt Unterlagen, Zahlungen und Gastmails fest auf `Responsibility::Nobody`. | Ein Vorgangskern, keine zweite Verwaltung. Die Sperrliste bleibt nur für Altbestand und Portalsperren. |
| **`bookings.export_uid`** für übernommene Sperren. | Der Portalexport bleibt identisch (Abnahme 6.3). |
| **Kurabgabe als `QuoteLineType::TouristTax`**, Satz an der Wohnung. | Empfehlung B1 und Auftrag: gepflegter Satz, Befreiung manuell, keine Rechtslogik. |
| **Befehle melden Fehler eines Mandanten sichtbar.** Der `TenantRunner` protokolliert Fehler nur; die Übernahmebefehle prüfen deshalb die Zahl der erfolgreichen Läufe. | Beim Test gefunden: Ohne diese Prüfung meldete ein Fehler „keine Sperren“. |
---
## 4. Erfüllte Abnahmekriterien
| ID | Kriterium | Nachweis | Ergebnis |
|---|---|---|---|
| 5.1 | Änderung nach Buchung (A1) mit Folgenvorschau; danach Kalender, Portalaufgaben, Zahlungsplan, Verlauf | T07; Screenshot `Abnahme/2026-11-01/T07-aendern-folgen.png` | erfüllt |
| 5.2 | Änderung extern (A4) mit Portalbetrag, keine Neuberechnung | `ChangeBooking::price` (Portalzweig); Dialogfeld „Neuer Gesamtpreis laut Portal“ | erfüllt (kein eigener Durchgangstest; durch T04/T11 und Vorschaulogik abgedeckt) |
| 5.3 | Abbruch unverbindlich | T08 (Anfrage) | erfüllt |
| 5.4 | Abbruch verbindlich mit Initiator, Grund, Kosten, Erstattung | T08 (eigene Buchung) | erfüllt |
| 5.5 | Abbruch extern: Portalaufgabe, erst storniert nach Wirksamkeit | T08 (Portalbuchung), `PortalBookingTest` | erfüllt |
| 5.6 | Storno durch Gast im selben Weg | bestehender `CancellationPolicyTest`, Aufgabe → „Stornieren …“ | erfüllt |
| 6.1 | Private Überlassung mit Gästen, Leistungen, Kurabgabe, ohne Vertrag/Bewertung/Marketing | T09; Screenshots T09 | erfüllt |
| 6.2 | Wartungssperre, verlängern, aufheben ohne Storno | T10; Screenshot T10 | erfüllt |
| 6.3 | Bestandsmigration, Export identisch | Test `test_existing_manual_blocks_become_cases_without_changing_the_portal_calendar` | erfüllt |
| 8.1 | R09 exakt erfassbar, nichts erfunden oder doppelt | T11; Screenshot T11 | erfüllt |
| 8.2 | Bezahlt laut Portal ≠ eingegangen; offen nur beim Einziehenden | T11, T04 | erfüllt |
---
## 5. Tests und verbleibende Risiken
- **Automatisiert:** 685 Tests, 3889 Zusicherungen, alle grün. Darunter T01–T14 und 6.3 als Durchgangstests über die echten Dialoge (Livewire) und die Gast-Links (HTTP).
- **Browser:** Chromium mit Zwei-Faktor-Anmeldung auf einer Kopie der lokalen Datenbank. Geprüft: Ändern mit Folgen, R09-Übersicht, Neu-Dialog Besuch, Familienbesuch, Sperre aufheben, Wirksame Einstellungen, Gastseite Änderungsvorschlag. Keine Konsolenfehler.
- **Gefunden und behoben:**
- A6 zeigte „Über: internal“;
- A6 zeigte den Schalter „Sie geben frei“ und eine Vorlage;
- Vergabe der Vorgangsnummer bei der Bestandsübernahme;
- verschluckte Fehler in Übernahmebefehlen;
- fehlende Imports durch Windows-Zeilenenden.
**Risiken:**
- Bei Portalzahlung springt der Status auf „Anzahlung erhalten / bezahlt“, sobald „laut Portal bezahlt“ eingetragen ist. Im Verlauf steht dann „Anzahlung eingegangen“, obwohl kein Geld auf unserem Konto ist. Die Übersicht ist korrekt, der Statusname missverständlich (→ §7).
- Ein Änderungsvorschlag reserviert die neuen Nächte nicht. Bei der Annahme wird die Verfügbarkeit neu geprüft und gegebenenfalls freundlich abgelehnt.
- Für die Änderungsbestätigung und die Aufenthaltsbestätigung ist die Mail jeweils eine Arbeitsfassung; sie braucht eine Prüfung bzw. Freigabe durch den Betreiber.
- Die Migration auf MariaDB ist nicht geprüft (wie schon bei den Paketen 1–4).
- Ein Testsystem wurde nicht genutzt; es gibt keine Deployment-Freigabe.
---
## 6. Migrationsbedarf und Auswirkungen auf Bestandsdaten
- Die Migration `2026_11_04_090000_create_amounts_changes_and_internal_cases` ist rein additiv. Bestehende Zahlungen werden zu „Gast an uns“.
- **Manuelle Sperren:** `php artisan cases:adopt-blocks` zuerst als Vorschau, dann mit `--apply`; vorher eine Datenbanksicherung. Der Bericht liegt unter `storage/app/private/block-adoptions/`, die Rücknahme geht mit `--revert`. Ohne diesen Lauf bleiben die Altsperren wie bisher wirksam; neue Sperren entstehen nur noch als A6-Vorgang.
- Portalbuchungen, die schon storniert wurden, bleiben storniert. Die neue Zweistufigkeit gilt nur für künftige Stornierungen.
---
## 7. Noch erforderliche fachliche Entscheidungen
| Frage | Vorschlag | Bis dahin |
|---|---|---|
| **Statusname bei Portalzahlung:** Soll „laut Portal bezahlt“ den Status „Anzahlung erhalten/Bezahlt“ setzen? | Eigene Bezeichnung „laut Portal bezahlt“ oder keinen Statuswechsel. Gehört fachlich zum Abschluss-Gate B4 (Paket 9). | Statuswechsel wie bei Gastzahlungen. |
| **B3 Änderung nach Verbindlichkeit:** Wann ist ein Vorschlag mit Zustimmung Pflicht (z. B. bei Preiserhöhung)? | Beide Wege sind da. Eine Pflichtregel braucht eine fachliche bzw. rechtliche Entscheidung. | Die Vermieterin wählt den Weg. |
| **Texte:** Änderungsbestätigung, Änderungsvorschlag, Aufenthaltsbestätigung | Prüfen und freigeben (Aufenthaltsbestätigung unter So arbeite ich › Dokumente). | Arbeitsfassungen. |
| **Kurabgabe-Satz** je Wohnung | Den Satz der Gemeinde eintragen (Wohnung › Preise). | Keine Berechnung ohne Satz. |
| **B1, B4, B5** | Unverändert offen; B1 ist mit dem gepflegten Satz praktisch beantwortet. | – |
Pakete 7 und 9 wurden nicht begonnen.
+2
View File
@@ -1,5 +1,7 @@
# Projektstand
**Pakete 8, 5 und 6 der Prozessarchitektur v0.10 (01.11.2026, Branch `feature/abwicklung`, nicht ausgeliefert):** **Beträge und Zahlungen** – Zahlungen mit Art (Gast an uns / laut Portal ans Portal / Auszahlung Portal / Erstattung), Portalbeträge als Angaben mit Quelle (`case_amounts`), Übersicht `App\Pricing\CaseMoney` trennt Gastforderung, Portalzahlung, Auszahlung und Kontoeingang; R09 exakt erfassbar. **Ändern und Beenden** – `ChangeBooking` mit Folgenvorschau, „mit dem Gast vereinbart“ (Grundlage, Zeitpunkt) oder „dem Gast vorschlagen“ (signierter Link, Annahme mit Nachweis); ein Stornoweg mit Initiator, Grund, Kosten- und Erstattungsaufgabe; Portalbuchungen erst storniert, wenn im Portal bestätigt. **A6** – Eigene Nutzung, Besuch und Sperre als Vorgang („Neu“, Belegungsplan „+ eintragen“), Kurabgabe als Position (Satz an der Wohnung), Aufenthaltsbestätigung ohne Mietvertrag, keine Mahnung/Bewertung/Marketing; Altsperren per `cases:adopt-blocks` (Vorschau, `--apply`, `--revert`, Export identisch). **System › Wirksame Einstellungen** zeigt je Eingangsweg und Vorgang die angewandten Werte. **685 Tests grün** (inkl. Abnahmekatalog T01–T14). Dokumente: [UMSETZUNGSERGEBNIS_P5_P6_P8](Prozessarchitektur/UMSETZUNGSERGEBNIS_P5_P6_P8.md), [END_TO_END_ABNAHME](Prozessarchitektur/END_TO_END_ABNAHME.md), [KONFIGURATION_UND_WIRKSAMKEIT](Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md).
**Ein Eingang für alle Kanäle – Paket 4 der Prozessarchitektur v0.10 (03.11.2026, Branch `feature/eingang`, nicht ausgeliefert):** Portalbuchungen und -anfragen kommen über einen Eingang (`App\Channels\Intake\PortalIntake`, aufgerufen nach jedem Kalenderabgleich und aus `ProcessPortalMail`): sicher erkannte Buchungen (Buchungsmail mit Nummer, Kalenderregel „Reservierung dieses Portals“) werden zum Vorgang ohne Angebot/Annahme, Anfrage-Mails zur A2-Anfrage; Dubletten über Buchungsnummer → gleiches Portal mit gleichen Nächten → Spiegelung, nie nach bloßer Überschneidung; Unsicheres wird unter „Zu erledigen“ geklärt („Klären: Was ist das?“). Stornomail, verschwundener oder geänderter Kalendereintrag eines gebuchten Vorgangs → Aufgabe am Vorgang, keine stille Stornierung. Schalter je Kanal `channels.case_intake` (Aus = Standard, Beobachten, Anlegen, Anlegen + weiter); Eingangsprotokoll (System › Eingangsprotokoll, `channels:intake-report`); Bestandsübernahme `channels:adopt-occupations` (Vorschau, `--apply`, `--revert`). Portalaufgaben mit Nachweisstufe (veranlasst / im Portal gesehen / bestätigt). **662 Tests grün**, Browserprüfung durchgeführt. Ergebnis und Aktivierungsweg: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md).
**Dokumentenzusammenstellung und Vorlagensteuerung – Paket 3 der Prozessarchitektur v0.10 (02.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Vor jedem Dokument dieselbe Zusammenstellung (`App\Documents\DocumentComposer`, Ansicht `filament/document-composition`): Empfänger, Zeitraum, Preis mit Herkunft, Leistungen, Stornoregel, Vorlage mit Herkunft, Anlagen, Hinweise (fehlt / bitte prüfen / Info), E-Mail- und PDF-Vorschau. Dokumentart je Vorgang automatisch (`App\Enums\DocumentKind`): Anfrage → Angebot mit Annahmelink, eigene Buchung → Bestätigung mit Mietvertrag, beim Portal verbindlich (A3/A4) → **Buchungsunterlagen ohne Annahmelink** (`BookingDocumentation`). Unterlagen verbindlicher Vorgänge nur über `SendBookingDocuments` (automatisch nur ohne Prüfpunkte, von Hand mit bestätigten Hinweisen, einmalig per Sperre); Angebote mit `expected_version` gegen Doppelversand; ohne Vorreservierung (Hold 0) kein Angebot ohne ausdrückliche Entscheidung. Vorlagen haben Freigabe und „gibt nur Portalbedingungen wieder“ (entfallen bei Textänderung); die Buchungsunterlagen extern sind eine Arbeitsfassung bis zur Freigabe unter So arbeite ich › Dokumente. **648 Tests grün**, Browserprüfung durchgeführt. Ergebnis, offene Freigaben (FeWo-direkt-Vorlage FW-01, Unterlagentext) und Empfehlung Paket 4: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md).