- MailboxReader::folder(): „Posteingang“, „Inbox“ oder leer → INBOX (so
heißt der Posteingang auf dem IMAP-Server); andere Namen ohne Beachtung
der Groß-/Kleinschreibung; unbekannter Ordner → Meldung mit den
vorhandenen Ordnern statt „Call to a member function query() on null“.
Gilt für Portal-Abruf, vollständigen Abruf und „Postfach prüfen“.
- Verschlüsselung: Platzhalter „Standard (SSL)“ statt eines zweiten „SSL“;
Hinweis am Ordnerfeld.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Vorgang: „Angebot prüfen und senden“ wird erst angeboten, wenn alle
Pflichtangaben da sind („erst wenn alle Angaben da sind“); ebenso wartet
„Buchungswunsch bestätigen?“. Die harte Sperre in SendOffer, AutoOffer
und DecideBookingWish bestand bereits; jetzt stimmt auch die Anzeige.
- System › Betrieb: „Postfach prüfen“ (Verbindung, Anzahl Nachrichten der
letzten Tage, nichts wird gelesen oder markiert) und Stand des Abrufs.
- Posteingang zeigt letzten erfolgreichen Abruf und letzten Fehler.
- Vorgang: neuer Bereich „Eingegangene E-Mails“ mit Lesen und Erkanntem;
„Mailverlauf“ heißt jetzt „Gesendete E-Mails“.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Jeder Mandant verbindet unter „System › KI-Anbindung“ seinen eigenen
Zugang: Anbieter (Anthropic oder OpenRouter), API-Schlüssel, Modell für
die erste Auswertung und für die Prüfung – keine Modellkennung im Code,
kein zentraler Betreiberschlüssel (FEWO_AI_API_KEY entfällt).
- Gespeichert im bestehenden TenantService (ai_guest_mail): Schlüssel
verschlüsselt, nie wieder angezeigt, nie in Meldungen; Anbieter/Modelle
in settings, Prüfergebnis in check_status/check_message/checked_at.
- Feste Endpunkte je Anbieter (AiProvider), nicht konfigurierbar.
OpenRouter mit response_format json_schema (strict) und
provider.require_parameters.
- „Verbindung prüfen“ testet beide Modelle. Ein abgelehnter Zugang
(401/402/403) schaltet die Auswertung für den Mandanten ab, meldet es im
Postfach der Verwaltung; Nachrichten bleiben zur Prüfung im Posteingang.
- Zweistufige Extraktion und ihre Sicherheitsregeln unverändert.
- Zielarchitektur §3.8, Umsetzungsplan U6, Bericht, Drehbuch, Status.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Umsetzungsergebnis mit Rückverfolgung CH-01–18, S1–S6, E-032–038,
M01–M12, Entscheidungen, Einschränkungen und Go-live-Bedingungen.
- Abnahme auf dem Testsystem: benötigte Dienste, Testkonfiguration,
Drehbuch ohne manuelle Ersatzschritte.
- Der bestehende InboxTest (Postfach der Vermieterin) war versehentlich
überschrieben worden; wiederhergestellt, die U5-Tests heißen jetzt
GuestMailInboxTest.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Kleines Modell (claude-haiku-5-5) extrahiert Fakten mit Belegstelle und
Konfidenz; programmatische Prüfung (Gültigkeit, Belegstelle im Original,
Widerspruch zum gespeicherten Wert oder in der Nachricht, Plausibilität,
Kritikalität nach Feld und Phase). Widerspruch oder fehlgeschlagene
Prüfung → Prüfmodell (claude-opus-5-5, serverseitiger Fallback bei
Ablehnung) unabhängig von der Konfidenz; solche Fakten nie automatisch.
- Nur geprüfte, bisher fehlende Angaben gehen an den Fakteneingang (Quelle
„llm“); Zeitraum/Personen nur als Änderungswunsch (M06); Rest als
Vorschlag im Posteingang („Vorschläge übernehmen“).
- Versionierte Prompts mit Platzhaltern, JSON-Schema mit eigener
Validierung und einer Wiederholung; Ausfall/Ablehnung → sicherer
Rückfall zur Vermieterin. HTTP-Client, kein SDK (laut Plan).
- Dienst „KI: Gästekommunikation“ verdrahtet, standardmäßig aus;
Schlüssel je Mandant oder FEWO_AI_API_KEY; Verbrauch in service_usages.
- messages:extract alle fünf Minuten; ai:evaluate misst Fehlwerte und
übersehene Angaben getrennt (M05).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- mailboxes (Modell für mehrere, eines aktiv): Übernahme des bisherigen
Postfachs als „nur Portal-Mails“; Modus „alle Nachrichten“ für ein
eigenes Postfach; Adresse als Antwortadresse der Rückfragen.
- inbound_messages: jede Nachricht zuerst gespeichert, einmal je
Message-ID, mit Testbetriebs-Kennzeichen (M10). Portal-Mails laufen
unverändert über den Portalpfad (CH-08).
- MessageMatcher (CH-13, ohne Scoring): Antwortbezug; Vorgangsnummer nur
mit dem Gast als Absender; sonst Absender + Wohnung + beide Termine eines
einzigen offenen Vorgangs. Ein offener Vorgang des Absenders allein
genügt nicht (nur Hinweis). Alles andere → Klärung (M04).
- Ausgehende Mails speichern ihre Message-ID; Antwort stoppt Erinnerungen.
- Filament „Posteingang“: lesen, Vorgang zuordnen, als neue Anfrage
anlegen, ignorieren, erledigt.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- data_requests: ein Beschaffungsvorgang je Vorgang mit Modus
(automatisch / Freigabe / manuell), getrennten Zählern für Folgefragen
und Erinnerungen ohne Rücksetzen, Antwortfrist ≠ Reservierungsfrist.
- RequestCaseData: fragt nach, was für das nächste Angebot, die
Wunschbestätigung oder (bei verbindlichen Buchungen) administrativ fehlt;
ohne E-Mail keine Rückfrage. Teilantwort → gezielte Folgefrage, Schweigen
→ Erinnerungen, an der Grenze Aufgabe für die Vermieterin. Nie ein Hold.
- Mail DataRequested mit Texten nach tatsächlichem Sperrstatus (M11);
Dokumentart „Rückfrage“ – im Live-Betrieb ohne Freigabe nur nach Klick.
- Signierter, versionierter Ergänzungslink (/angebot/angaben): Lesen
schreibt nicht, Absenden über den Fakteneingang, idempotent.
- Vorgang: „Rückfrage an den Gast senden“ / „Rückfrage beenden“;
Eingangsbestätigung nennt die Klärungsreservierung korrekt.
- Zeitplan: cases:data-requests alle fünf Minuten.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- bookings.hold_purpose (offer wie bisher / clarification).
- RequestHold: vollständige Anfrage → Angebots-Hold unverändert;
unvollständig, aber Wohnung, Zeitraum, verwendbare E-Mail und freier
Zeitraum → nur Klärungsreservierung (15 min automatisch / 180 min
Freigabe oder manuell, 0 = keine); sonst nichts (B1). Auch für
Portalanfragen ohne Gastdaten.
- ExpireReservations beendet nur Angebots-Holds; ein abgelaufener
Klärungsblock gibt nur den Kalender frei, der Vorgang bleibt offen.
- Vervollständigen erzeugt keinen Hold; erst SendOffer setzt den
unveränderten Angebots-Hold. AutoOffer prüft danach nur die Verfügbarkeit.
- Booking::clarificationState() liefert den tatsächlichen Sperrstatus.
- Architekturtest: nur die bestehenden Reservierungsschritte schreiben Holds.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- CaseRequirements: Vor einem eigenen verbindlichen Angebot und vor der
verbindlichen Bestätigung eines Buchungswunsches müssen Vor- und
Nachname, E-Mail, vollständige Anschrift mit Land, Personenzahl und
Zeitraum vorliegen – harter Blocker, auch von Hand (G2a, B3). Die
Auskunft unter Vorbehalt bleibt ohne dieses Gate.
- ContributeCaseFacts (S5): jede Angabe mit Herkunft und Ergebnis in
case_facts; fehlend → übernommen, gleich → bestätigt, abweichend vom
Gast → Prüfaufgabe (Kartei bleibt), Vermieterin maßgeblich, Zeitraum und
Personen → Änderungswunsch; idempotent; danach einmal CaseAutomation.
- ProvideGuestContact und Webformular nutzen den Fakteneingang.
- Land als ISO-Code mit „Deutschland“ als änderbarem Formularstandard;
guests.country ohne stillen Standardwert (B4).
- Testdaten bestehender Tests um Anschriften ergänzt.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Eigene Webseite als Kanal eigener Art (channels.kind = website), nur zur
Konfiguration: Webseiten-Anfragen bleiben direkt (A1) ohne Kanalbezug;
der Eintrag nimmt an Sync, Export, Überwachung und Sperraufgaben nicht teil
(active()/Property::channels() nur Portale, Feed nur für Portale).
- Neue Einstellungen im bestehenden ProcessSetting: Klärungsreservierung
automatisch/Freigabe (15/180 min, 0 = keine), Rückfragemodus,
Erinnerungen, Folgefragen, Erinnerungsabstand, Linkgültigkeit,
Anschrift im Webformular verlangen (Standard: nein).
- „Kanäle“ in der einfachen Ansicht: Webseite und Portale an einer Stelle,
Verweis auf „Ihre Standards“; „Wirksame Einstellungen“ mit Spalte
„Eigene Webseite“ und Herkunft „Webseite“.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Planung zur Prozessarchitektur v0.11 (Communication Handler,
Datenbeschaffung, Klärungsreservierung, zentraler Kanalmanager) mit sechs
Umsetzungspaketen U1–U6. Betreiberentscheidungen B1–B4 vom 03.11.2026
eingearbeitet; Präzisierungen zur Zuordnung direkter Gast-Mails (CH-13)
und zur KI-Eskalation unabhängig von der Modellkonfidenz.
Keine Codeänderung.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Vorgang: Die Kopfaktionen werden nach jeder Aktion neu aufgebaut, damit der
große Schalter gleich den nächsten Schritt zeigt (Filament baut sie vor der
Aktion auf).
- In Folgejahr kopieren: Reicht eine bestehende Saison (z. B. Neujahr über den
Jahreswechsel) nur über Beginn oder Ende der Kopie, wird die Kopie dort
gekürzt statt ganz übersprungen; sonst blieb z. B. Januar bis März ohne Preis.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 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>
- Haltefrist 0: unverbindliche Auskunft mit signiertem Link "Buchung anfragen",
erneute Prüfung unter Sperre, automatische oder manuelle Bestätigung, Absage
bei vergebenem Zeitraum, Ablauf unbeantworteter Auskünfte
- Aufenthalt: Anreisedaten, Aufgaben je Wohnung, gebuchte Leistungen,
Abweichungen und Folgeaufgaben als Aufgaben am Vorgang
- Abschluss getrennt: Aufenthalt abgeschlossen / kaufmännisch abgeschlossen,
Nachläufer (Forderung, Auszahlung) bleiben sichtbar
- Zahlungsstatus nur aus Geld auf unserem Konto; Altbestand per Vorschau-Befehl
- Verlauf weist Testzustellungen als solche aus
- Abnahmetests T16-T25, T23 über isolierten SMTP-Empfänger
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 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>
Neue hierarchische Struktur der fachlichen Sollbeschreibung (README, Prozesslandkarte,
Buchungsarchetypen, Abwicklungsprofile, Entscheidungen, Offene Fragen, Querschnitt,
Szenarien, V01/V02, Referenzen); die Fassung 0.9 bleibt in der Git-Historie.
Obsidian-Fensterzustand (workspace.json) wird nicht mehr versioniert.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
EnforceMailTestMode prueft jede Mail unmittelbar vor dem Versand (MessageSending,
jeder Mailer): im Testbetrieb gehen An/Cc/Bcc nur an die Testadresse, ohne
Testadresse wird nichts versendet; der Modus wird je Mail frisch gelesen.
Ersetzt alwaysTo am Standard-Mailer. Tests inkl. Pruefung, dass kein Code am
Mailer vorbei versendet.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Portalbuchungen und -anfragen aus Kalender und Mail werden ueber PortalIntake
zum Vorgang (nur bei sicherer Erkennung), Dubletten ueber Buchungsnummer,
gleiches Portal mit gleichen Naechten und Spiegelung; Unsicheres wird geklaert.
Portalstorno und -aenderung als Aufgabe am Vorgang ohne stille Stornierung.
Schalter je Kanal (Aus als Standard, Beobachten, Anlegen, Anlegen + weiter),
Eingangsprotokoll, Bestandsuebernahme mit Vorschau/Bericht/Ruecknahme,
Sperrnachweis in drei Stufen.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Eine Zusammenstellung vor jedem Dokument (Angebot, Bestaetigung, Buchungsunterlagen
extern), Dokumentart je Vorgangsart, Freigaben fuer Vorlagen und Dokumentarten,
Schutz vor unvereinbarten Bedingungen bei Portalbuchungen (E-004), kein doppelter
Versand, Absicherung Hold 0 bis Paket 7, A6-Aufenthaltsbestaetigung vorbereitet.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Buchung ist der einheitliche Vorgang: Eingangsart, Vorgangsart A1–A6, eingefrorenes
Abwicklungsprofil, gespeicherter Verlauf (booking_events); Gast, Personen und Beträge
dürfen unbekannt sein, Platzhalter-Gäste werden migriert und nicht mehr angelegt
- Einstellungen in Ebenen: Vermieterstandard (So arbeite ich), Abweichung der Wohnung
(Experte), Abweichung je Portal und Eingangsart; ersetzt booking_model als Steuergröße
- Ein Weg für extern verbindliche Buchungen (TakeOverExternalBooking) statt
RecordPortalBooking und "Akte anlegen"; Portalpreis als belegte Gesamtposition
- Startseite "Zu erledigen", neue Vorgangsseite mit nächstem Schritt, Automatik-Schalter,
"Beenden" mit Storno statt Statusumschaltung; Status von Hand nur im Expertenmodus
- Migration übernimmt bisheriges Verhalten unverändert (abweichende Wohnungswerte bleiben
als Abweichung), Bericht: php artisan process:settings-report
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Lightbox: feste Bildgroesse aus dem Seitenverhaeltnis, beim Blaettern wird das grosse Foto erst geladen und dann eingeblendet
- Seebad-Vergleich: Pfeile neben Sommer/Winter entfernt (passten nicht zur Ziehrichtung)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Akte anlegen aus einer importierten Portal-Reservierung (Belegung bleibt durchgehend belegt, Kalendereintrag wird Spiegelung)
- Akte: Standardprozess (Portal/Vorlage/Storno/Anlagen), Meilensteine mit Aktivitaeten und Aktionshinweis, chronologischer Verlauf
- Kanalformular: Abschnitt Standardprozess je Buchungstyp mit Anzeige, was die Vorlage mitbringt
- Portalpreis als gemeinsame Logik (PortalPrice)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Buchung erfassen: Buchungsweg Portal (Referenz, Portalpreis, ohne Kontaktdaten), Prozess bestaetigen/Vertrag sofort/nur erfassen
- Buchungsakte: Kontaktdaten eintragen (automatisch oder manuell weiter), Gast um Kontaktdaten bitten, Status von Hand aendern, Archivieren
- Liste: Filter Kanal, Anreisezeitraum, Kontaktdaten fehlen; Spalten ausblendbar; Archiv
- Klaerung: verstaendlichere Texte, eigenstaendige Belegung mit Kanal gilt als geklaert (Gitea #4)
- Akte per Button aus Liste und Belegungsplan erreichbar
- Menue: Gruppen Verwaltung (Tagesgeschaeft) und Einrichtung (Konfiguration), einfache Ansicht auf 8 Punkte
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Stornoregel (Stufen nach Tagen vor Anreise, Mietpreis oder Gesamtpreis, Ersatzmieter-Gebuehr), je Vertragsvorlage,
beim Angebot eingefroren, als Platzhalter im Vertrag
- Stornierung (Gast-Link oder Verwaltung) berechnet die Kosten, legt einen Stornofall an; Verwaltung Stornierungen
mit Vorschlag, Festlegung, Saldo, Abrechnung und Erlass; Gast sieht die Kosten vorab auf der Storno-Seite
- Vertragsanlagen als eigene versionierte Dokumente mit Bedingung (immer, Zusatzleistung, Portal, von Hand),
je Angebot ausgewaehlt und eingefroren; Zusatzleistungen in der Buchung erfassbar
- FeWo-direkt-Installation legt die Stornoregel aus Paragraf 13 an
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Buchungsseite zeigt Art des Vorgangs, Verlaufsleiste und den naechsten Schritt in Klartext
- Vertragsabschnitt (Vorlage, Dokumente mit Pruefsumme, Zustellung) und Vertragstext-Ansicht
- Reiter Aufgaben und Mailverlauf (jede Mail zur Buchung wird protokolliert)
- Stornieren in der Verwaltung informiert Gast und Vermieter und legt eine Aufgabe fuer Stornokosten an
- Stornierte/abgelehnte/abgelaufene Buchungen aus der Hauptliste, Filter Archiv anzeigen
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Vorlage = kompletter Vertragstext plus Anlage mit Platzhaltern ({{ mieter }}, {{ anreise }}, {{ wohnung.x }}),
eigene Vertrags-PDF, Anzeige auf der Angebotsseite; Text und Wohnungsdaten werden beim Angebot eingefroren
- Wohnungsdaten (WLAN, Codes, ...) als Vertragsdaten der Wohnung statt im Vorlagentext
- Je Portal eigene Vorlage fuer Anfragen und fuer beim Portal verbindliche Buchungen; direkte Bestaetigung
nutzt dieselbe Aufloesung; Bestaetigungsmail ohne Zahlungsanweisung bei Portalzahlung
- Befehl contracts:install-fewo-direkt legt die FeWo-direkt-Vorlage aus dem Vertragstext des Vermieters an
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Zahlungen werden nicht mehr automatisch angemahnt: faellige Anzahlung/Restzahlung werden Aufgaben
(Zahlungen & Wuensche, Tages-/Wochenuebersicht); Mail nur per Klick; je Portal und Buchungstyp abschaltbar
- Freigabe-Link in der Eingangsbestaetigung, Storno-Link in der Buchungsbestaetigung; je Wohnung
Wunsch / sofort / sofort bis Frist; Stornowuensche und Kosten bleiben Aufgabe des Gastgebers
- Vertragsvorlagen mit Versionen (je Angebot, Portal oder Wohnung waehlbar), benutzte Versionen gesperrt;
Angebot und finaler Vertrag als unveraenderliche PDF mit SHA-256, Vertrag wird nie neu geschrieben
- Anreise-Mail je Wohnung einstellbar (Standard 3 Tage), neue Textfelder Schluessel/Parken/Ankunftstag
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Angebotsbedingungen und Zahlungsdaten werden je Version eingefroren (offer_terms, offer_hash)
- Annahme in einer gesperrten Transaktion, idempotent, mit Nachweis; Mail- und Portalfehler
machen eine gespeicherte Buchung nicht ungueltig (Postfach, Nachversand)
- Je Wohnung: manuelle/automatische Angebote, optionale Vorreservierung
- Automatische Freigabe abhaengig von aktuellen Importen und Feed-Abruf bei Sofortbuchungsportalen
- Deutsche Fehlerseiten, Buchungsseite zeigt Angebots- und Zustellstatus
- Dokumentation: BOOKING-E2E-*.md, BOOKING-COMPLIANCE-HANDOVER.md
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Weitere Adressen einer Website (z. B. www.stommer.info) leiten per 301 auf die
Hauptadresse um; vorher blockierte der Browser Skripte, Schriften und Videos,
die von der Hauptadresse kamen (kein Titelvideo, Ersatzschrift)
- Site::origin() nimmt verbindlich das Feld domain
- Videos: Abspielgeschwindigkeit 0,5x bis 1x, gilt im Titelbereich und Rundgang
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Webseite > Videos (Datei, Standbild, Kapitel mit Raum im Grundriss); Upload bis 100 MB
- Titelbereich: Video statt Foto (stumme Schleife, respektiert Bewegung reduzieren/Save-Data)
und naechste freie Termine mit Gesamtpreis (NextFreeStays)
- Neuer Baustein Rundgang (Video) mit waehlbarer Anordnung; Grundriss springt ins Video
- Buchungsseite: Preis unter dem Kalender, Formular rechts, Ablauf als Grafik
- Seebad: Fahrkarten, Fahrplan-Kapitel, Sonnenaufgang als einmaliges Ereignis
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>