Files
fewo-stommer/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P7_P9.md
T
LarsandClaude Opus 5.5 234e642e4d Pakete 7 und 9 abgeschlossen: Wirksamkeit, Browserbefunde, Gesamtabnahme
- Wirksame Einstellungen: Antwort auf Anfragen, Aufenthalt je Wohnung,
  Dokument und beide Abschlüsse je Vorgang
- Schritte vor dem Aufenthalt entfallen nach der Abreise; direkt bestaetigte
  Vorgaenge zeigen keine Auskunft; "Als Naechstes" ohne fremden Detailtext
- Automatische Wunschbestaetigung nur mit freigegebenen Vertragstexten
- Taeglicher Lauf bewertet auch bereits abgeschlossene Vorgaenge kaufmaennisch
- Dokumente: UMSETZUNGSERGEBNIS_P7_P9, END_TO_END_ABNAHME (T01-T25),
  KONFIGURATION_UND_WIRKSAMKEIT, GESAMTABNAHME_v0.10, STATUS; Screenshots

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 08:51:24 +01:00

17 KiB
Raw Blame History

Umsetzungsergebnis Pakete 7 und 9

Stand: 02.11.2026 · Branch feature/aufenthalt (aufbauend auf develop = Pakete 1–6 und 8, Commit 3bcfc09) · Grundlage: UMSETZUNGSPLAN_v0.10 §5.8, §5.10, Abnahmekriterien 7.x und 9.x, Abschlussauftrag vom 02.11.2026. Die normative Prozessarchitektur v0.10 wurde nicht verändert.

Begleitdokumente: GESAMTABNAHME_v0.10 (Bewertung ohne Codekenntnisse), END_TO_END_ABNAHME (T01–T25), KONFIGURATION_UND_WIRKSAMKEIT.


1. Stand je Paket

Paket Stand Einschränkungen
7 – Haltefrist 0: Auskunft und Buchungswunsch umgesetzt Die Auskunft gilt so lange, wie die Einstellung „Gültigkeit Angebot/Auskunft“ sagt (eine eigene Frist gibt es nicht, E-026). Der Buchungswunsch reserviert nichts, bis bestätigt ist.
9 – Aufenthalt und Abschluss umgesetzt Keine Melde- und Abgabefelder (rechtlich offen, P04). Keine Personal- oder Dienstleisterplanung, nur Aufgaben am Vorgang. Die Frist der Auszahlungsprüfung ist fest: Abreise + 14 Tage.
Abschnitt 5 – Zahlungsstatus bei Portalzahlung behoben Gespeicherte Status werden nur über cases:recheck-payment-status korrigiert (Vorschau, dann --apply).
Abschnitt 6 – Testbetrieb geprüft und ergänzt Der Nachweis lief über einen echten, isolierten SMTP-Empfänger (T23). Ein Gerät mit Mailprogramm habe ich nicht geprüft.

Tests: 700 Tests mit 4200 Zusicherungen sind grün; vorher waren es 685. Neu sind die Durchgangstests T16–T25 mit Sonderfällen (EndToEndStayAcceptanceTest) und T23 (TestOperationSmtpAcceptanceTest). Pint ist sauber. Die Browserprüfung lief auf einer Datenbankkopie (Abschnitt 5).


2. Geschäftsfunktionen

Paket 7 – Anfrage ohne Haltefrist

Schritt Verhalten
Anfrage Bei „Reservieren? nein“ entsteht eine Anfrage ohne Reservierung. Der Kalender bleibt frei. Der Gast liest im Formular und in der Eingangsmail, dass er eine Auskunft bekommt.
Auskunft „Unverbindliche Auskunft prüfen und senden“ geht automatisch oder per Klick, je nach wirksamer Einstellung. Sie läuft über die Zusammenstellung aus Paket 3 (Dokumentart „Auskunft unter Vorbehalt“, Arbeitsfassung bis zur Freigabe). Gast-Mail und Gastseite sagen: „Dies ist noch keine Buchung und keine Reservierung“, mit dem Prüfstand (Datum, Uhrzeit). Es gibt keinen Annahmelink, nur „Buchung anfragen“. Eine neue Auskunft ersetzt die alte: Der alte Link funktioniert nicht mehr, und ein Wunsch darauf verfällt.
Buchungswunsch Der Gast bestätigt die Bedingungen und klickt „Buchung anfragen“. Unter Sperre (Wohnung + Vorgang) wird erneut geprüft: ganzer Zeitraum frei, Kalenderimporte aktuell (vorher wird ein Abruf versucht), Preis wie in der Auskunft, Gastdaten vollständig, Zusammenstellung der Bestätigung ohne Prüfpunkte. Festgehalten werden Zeitpunkt, gehashte Adresse, genannter und heutiger Preis sowie die Befunde.
Entscheidung Automatisch und alles in Ordnung: Die Buchung wird sofort verbindlich, Vertrag und Bestätigung gehen hinaus. Sonst entsteht die Aufgabe „Buchungswunsch bestätigen?“ mit den Befunden, und der Gast erhält „eingegangen, noch nicht verbindlich“. Der Dialog bestätigt zum Preis der Auskunft, zum niedrigeren heutigen Preis oder sagt ab. Ein höherer Preis braucht eine neue Auskunft.
Konflikt Ist der Zeitraum inzwischen belegt (eigene Buchung, anderer Gast, Kalenderimport), entsteht keine Buchung. Der Gast bekommt eine freundliche Absage, die Vermieterin eine Mail und einen Postfacheintrag. Bei einem offenen Wunsch zeigt die Aufgabe live „Zeitraum inzwischen belegt – bitte absagen“.
Wiederholung, alter Link, Ablauf Ein zweiter Klick bleibt ohne Wirkung. Ein alter oder abgelaufener Link zeigt einen verständlichen Hinweis. Eine unbeantwortete Auskunft endet nach Ablauf als „ohne Buchung beendet“, die Vermieterin wird benachrichtigt.
Widerspruch L5 Er ist beseitigt: Ohne Haltefrist ist die Auskunft der vorgesehene Weg. „Stattdessen verbindliches Angebot mit Reservierung senden“ bleibt als bewusste Entscheidung im einzelnen Vorgang, mit ausdrücklicher Bestätigung.

Paket 9 – Aufenthalt

Bereich Verhalten
Vorbereitung (täglicher Lauf) Aufenthalte der nächsten 14 Tage werden vorbereitet, einmal je Vorgang und Aufgabe, egal wie oft der Lauf läuft. Pflichtaufgaben je Aufenthalt und Termine passen sich an, wenn sich der Zeitraum ändert.
Anreisedaten Fehlen Kontakt (E-Mail oder Telefon) oder die Anreisezeit (falls die Wohnung danach fragt), entsteht rechtzeitig die Aufgabe „Anreisedaten beim Gast erfragen“: 2 Tage vor dem Versand der Anreise-Information. Bei Portalbuchungen steht der Hinweis „ggf. im Portal nachsehen“ dabei. Liegen die Angaben vor („Anreisedaten eintragen“), schließt sich die Aufgabe selbst.
Leistungen und Dienstleister Aufgaben je Wohnung werden eingestellt, z. B. Schlüsselübergabe am Anreisetag oder Endreinigung am Abreisetag durch „Reinigung Müller“, je nach Art des Aufenthalts. Gebuchte Leistungen unseres eigenen Preises werden zu „Bereitstellen: 3 × Wäschepaket“. Stornierungen lassen die Vorbereitungsaufgaben entfallen.
Portal übernimmt Ist die Anreise-Information Sache des Portals, steht dort „durch FeWo-direkt (angekündigt) – eine Zustellung ist damit nicht nachgewiesen“. Es geht keine eigene Mail hinaus, und es gibt keine Mahnungen.
Während des Aufenthalts „Abweichung oder Aufgabe festhalten …“ kennt drei Arten. Eine Abweichung oder ein Problem muss vor dem Abschluss geklärt sein. Eine Leistung wird vorbereitet. Eine Folgeaufgabe hält den Abschluss nicht auf. „Aufgabe erledigen …“ kennt drei Ergebnisse: erledigt, übergeben an jemanden oder entfällt; immer mit Notiz im Verlauf. Erledigte Aufgaben bleiben im Ablauf als Nachweis sichtbar.

Paket 9 – Zwei Abschlüsse

Aussage Wann Was bleibt
Aufenthalt abgeschlossen (Status „Abgeschlossen“) Automatisch in der Nacht nach der Abreise, sobald keine Aufgabe des Aufenthalts mehr offen ist (Leistung, Abweichung, gemeldete Portaländerung). Sonst „Aufenthalt abschließen …“ von Hand: Offene Aufenthaltsaufgaben werden mit Notiz als erledigt bzw. übergeben vermerkt. Offenes Geld hält den Abschluss nicht auf. Offene Forderungen werden zur Aufgabe „Offenen Betrag nach der Abreise klären“, sofern keine Mahnaufgabe läuft. Eine ausstehende Portalauszahlung wird zu „Auszahlung des Portals prüfen“ (fällig Abreise + 14 Tage, bis dahin „wartet“). Schäden sind Folgeaufgaben. Alles bleibt am selben Vorgang und in „Zu erledigen“.
Kaufmännisch abgeschlossen (settled_at) Automatisch, sobald nichts mehr offen ist. Offen heißt hier: ein Betrag vom Gast, eine Überzahlung, eine fehlende oder unvollständige Auszahlung, widersprüchliche Auszahlungsangaben, ein unbekannter Portalpreis, eine bei A6 vereinbarte, unbezahlte Zahlung oder eine offene Geldaufgabe (Mahnung, Stornokosten, Erstattung, Auszahlung, Forderung). Von Hand „Kaufmännisch abschließen …“ nur mit Begründung, z. B. „Differenz 5,51 € akzeptiert“. Gilt auch für stornierte Vorgänge (Stornokosten, Erstattung). Kommt später eine neue Geldaufgabe hinzu, öffnet sich der automatische Abschluss wieder, mit Eintrag im Verlauf.

Die Vorgangsseite zeigt beide Aussagen als Aktivität mit den offenen Punkten. Der Satz oben lautet z. B. „Aufenthalt abgeschlossen, kaufmännisch noch offen“.

Abschnitt 5 – Zahlungsstatus

Aussage Wo sie steht
Gast hat laut Portal bezahlt Zahlungsart „laut Portal ans Portal“. Verlauf: „Laut FeWo-direkt hat der Gast 979,51 € an das Portal gezahlt – noch kein Geld bei uns“. Aktivität: „Zahlung des Gastes an FeWo-direkt“, übernimmt das Portal.
Portal plant eine Auszahlung Angabe „angekündigte Auszahlung“ (Paket 8); Aktivität „Auszahlung von … auf unser Konto“ (wartet).
Geld vom Portal ausgezahlt Zahlungsart „Auszahlung vom Portal“. Verlauf: „Auszahlung von FeWo-direkt auf unserem Konto eingegangen“. Die Aufgabe „Auszahlung prüfen“ schließt sich.
Zahlung des Gastes bei uns eingegangen Nur das ändert den Status (Bestätigt → Anzahlung erhalten → Bezahlt). Erledigte Mahnaufgaben schließen sich mit der Zahlung.
Weitere Forderungen oder Erstattungen offen Punkte des kaufmännischen Abschlusses, Aufgaben „Offenen Betrag klären“ bzw. „Erstattung prüfen“.

Erinnerungen und Mahnungen gibt es nur, wenn wir selbst kassieren (unverändert). Bestehende Daten werden nicht still umgedeutet: php artisan cases:recheck-payment-status zeigt betroffene Vorgänge, --apply korrigiert sie mit Begründung im Verlauf.

Abschnitt 6 – Testbetrieb

  • Alle neuen Mails laufen über den Laravel-Mailer und damit durch die eine Schranke EnforceMailTestMode: Auskunft, Buchungswunsch (Gast und Vermieterin), Absage und Aufenthaltsbestätigung. Die bestehende Prüfung MailTestModeGateTest findet keinen Versandweg daran vorbei.
  • T23 schickt den ganzen Ablauf über echtes SMTP an einen isolierten Empfänger: automatisch, manuell, geplant (Anreise-Information), mit Cc und Bcc an fremde Adressen und aus der Warteschlange. Eine Mail, die im Livebetrieb eingereiht und nach dem Zurückschalten in den Testbetrieb versendet wird, geht ebenfalls nur an die Testadresse. Keine Originaladresse erscheint im SMTP-Umschlag.
  • Im Verlauf steht bei umgeleiteten Mails „E-Mail im Testbetrieb an die Testadresse (nicht an den Gast)“, bei Fakten wie „Bestätigung gesendet“ der Zusatz „Testbetrieb: nur an die Testadresse, nicht an den Gast“. Maßgeblich ist der Umleitungsvermerk in der Mail selbst; damit gilt das auch bei der Server-Vorgabe FEWO_MAIL_REDIRECT_TO.
  • iCal-Import, -Export und Abgleich sind vom Testbetrieb unabhängig. Testvorgänge verändern Portalbelegungen nur über den normalen Export bzw. über Portalaufgaben, die jemand von Hand erledigen muss.

3. Technische Entscheidungen

Entscheidung Begründung
Keine neuen Status. Auskunft und Wunsch sind Felder am Vorgang (information_*, wish_*), der Status bleibt „Anfrage“ bis zur Bestätigung. Der Aufenthaltsabschluss nutzt den vorhandenen Status „Abgeschlossen“, der kaufmännische Abschluss ein Datum (settled_at). Auftrag §4.4: keine zusätzliche Statusmaschine; Gates bleiben abgeleitet (G00).
SubmitBookingWish und DecideBookingWish binden über ConfirmBooking::bind unter derselben Wohnungssperre wie alle Buchungswege. Zwei Wünsche oder Wunsch und Portalimport können nie beide zur Buchung werden.
Aufgaben sind nicht mehr nur eine je Art (booking_tasks.subject, eigener Titel, Zuständigkeit). Jede Art sagt selbst, ob sie den Aufenthalt (blocksStay) oder das Kaufmännische (isCommercial) aufhält. Leistungen, Abweichungen und Nachläufer ohne zweite Vorgangsverwaltung (§4.2).
CaseClosure leitet offene Punkte aus Aufgaben und CaseMoney ab und wird nach Zahlung, Aufgabenwechsel, Storno und Abschluss neu bewertet. Kein Punkt verschwindet beim Abschluss; der Abschluss erfindet keine Beträge.
Statusregel nur über paidToUs(), Verlaufstext je Zahlungsart im Zahlungsmodell. Abschnitt 5; die Zahlungsübersicht aus Paket 8 bleibt unverändert.
Nach der Abreise gelten offene Schritte vor dem Aufenthalt als „entfällt“ (Unterlagen, Kontakt, Anreise-Info). Gefunden in der Browserprüfung: Ein vergangener Aufenthalt bot sonst noch „Bestätigung senden“ an.

4. Abnahmekriterien

ID Kriterium Nachweis Ergebnis
7.1 Haltefrist 0: Kalender frei, Auskunft mit „Buchung anfragen“, ohne Annahmewirkung T16, Screenshot T16-gast-auskunft.png erfüllt
7.2 Wunsch automatisch, frei: bestätigt, Vertrag und Zahlungsplan T18, T24 erfüllt
7.3 Wunsch manuell: Aufgabe „Buchungswunsch bestätigen?“ T16, Screenshots T16-buchungswunsch-*.png erfüllt
7.4 Zwischenzeitlich belegt: keine Buchung, Absage, Hinweis T17, T18 erfüllt
9.1 Fehlende Anreisedaten erzeugen rechtzeitig eine Aufgabe; Portalnachricht „durch Portal (angekündigt)“ T19, T20, T24, Sonderfälle erfüllt
9.2 Abschluss mit Nachläufer: Vorgang abgeschlossen, Forderung bleibt als Aufgabe sichtbar T22, Screenshot T22-kaufmaennisch-offen.png erfüllt
§4.4 Aufenthalt und Kaufmännisches getrennt; Portalauszahlung hält den Aufenthalt nicht auf T20, T22 erfüllt
§5 „Laut Portal bezahlt“ ist kein „Anzahlung erhalten“; Altbestand nur auf Anfrage T20, Test existing_payment_statuses_… erfüllt
§6 Testbetrieb über echtes SMTP, Cc/Bcc, Warteschlange, Verlauf T23 erfüllt

5. Prüfungen und Risiken

  • Automatisiert: Die gesamte Suite ist grün (700/4200). Die Abnahmefälle laufen über die echten Dialoge (Livewire), die Gast-Links (HTTP) und den täglichen Lauf.
  • Browser: Chromium mit Zwei-Faktor-Anmeldung auf einer Kopie der lokalen Datenbank, Server lokal, Mails nur ins Log. Geprüft habe ich: Gastseite Auskunft, Vorgang mit Buchungswunsch und Entscheidungsdialog, Aufenthalt mit offener Reinigung und Abweichung, „Aufgabe erledigen“ mit Übergabe, abgeschlossener Aufenthalt mit offenem Betrag, Wohnungseinstellung „Aufenthalt vorbereiten“, Wirksame Einstellungen und Zu erledigen. Es gab keine Konsolenfehler. Gefunden und behoben:
    • Direkt bestätigte Vorgänge zeigten Auskunft und Wunsch als „erledigt“.
    • Ein vergangener Aufenthalt bot „Bestätigung senden“ an.
    • „Als Nächstes“ zeigte einen Detailtext eines anderen Schritts.
    • Das Formular der Aufenthaltsaufgaben war zu schmal.
  • Migration: Auf SQLite habe ich vor, zurück und wieder vor geprüft. Auf MariaDB ist sie nicht geprüft: Lokal steht keine MariaDB zur Verfügung, und ohne Freigabe gibt es keine Auslieferung. Der neue Eindeutigkeitsschlüssel wird vor dem Entfernen des alten angelegt, damit der Fremdschlüssel unter MariaDB einen Index behält.
  • Risiken: In Abschnitt 6 der GESAMTABNAHME; die wichtigsten:
    • Die Rechtsprüfung des Buchungswunsches als Antrag des Gastes steht aus.
    • Echte Mietbedingungen statt Mustertext fehlen noch (die Gastseite zeigt „[MUSTER …]“).
    • Die Migration ist auf MariaDB nicht geprüft.
    • Die Bedienprobe hat nicht stattgefunden.

6. Migrationsbedarf

  • Die Migration 2026_11_05_090000_create_information_wish_and_stay_closure ist additiv. Neue Spalten gibt es an bookings, properties (stay_tasks, asks_arrival_time) und booking_tasks (subject, title, responsible). Der Eindeutigkeitsschlüssel der Aufgaben wird auf (Vorgang, Art, Gegenstand) erweitert.
  • Bestandsvorgänge:
    • Noch nicht abgeschlossene, schon abgereiste Aufenthalte schließt der nächste tägliche Lauf. Ihre offenen Geldpunkte werden zu Nachläufern. Bisher wurden nur vollständig bezahlte Aufenthalte abgeschlossen.
    • Schon abgeschlossene oder stornierte Vorgänge (Abreise im letzten Jahr) bewertet der tägliche Lauf ebenfalls. Ist nichts offen, gelten sie als kaufmännisch abgeschlossen, mit Eintrag „System (automatisch)“ im Verlauf. Sonst zeigen sie die offenen Punkte.
  • Nach der Auslieferung: zuerst php artisan cases:recheck-payment-status als Vorschau, --apply nur nach Durchsicht. Aufgaben je Wohnung und „Anreisezeit erfragen“ einstellen.

7. Offene Entscheidungen

Frage Vorschlag Bis dahin
Buchungswunsch rechtlich: Ist der Klick „Buchung anfragen“ mit bestätigten Bedingungen der Antrag, den unsere Bestätigung annimmt (BGB §§ 145 ff., 305)? Texte von Gastseite und Mails prüfen lassen. Der Text lautet: „Der Vertrag kommt erst mit unserer Buchungsbestätigung zustande.“
Gültigkeit der Auskunft: Eigene Frist, oder wie bisher die Frist von Angebot und Reservierung? Beibehalten (E-026: keine Preisbindefrist). Gleiche Einstellung wie Angebote.
Auszahlungsprüfung: Wann ist eine Portalauszahlung überfällig? Je Portal einstellbar machen, wenn die Erfahrungswerte bekannt sind. Fest: Abreise + 14 Tage.
Melde- und Abgabefelder, Kurabgabe bei Mietgästen Nach rechtlicher Klärung (Offene_Fragen) als Felder am Vorgang. Die Kurabgabe wird nur bei A6 berechnet; Gäste zahlen vor Ort.
B3: Pflicht zur Gastzustimmung bei Preiserhöhung nach Verbindlichkeit wie in Paket 5 Die Vermieterin wählt den Weg.
Abschluss automatisch über Nacht (B4, jetzt entschieden) Vom Betreiber in der Bedienprobe bestätigen lassen. Umgesetzt wie in Abschnitt 2 beschrieben.

Die Pakete 1–9 der v0.10 sind damit umgesetzt. Weitere Ausbauschritte stehen in GESAMTABNAHME_v0.10 §7.