Files
LarsandClaude Opus 5.5 6862dec201
Deploy FeWo mit PipelineManager / deploy (push) Successful in 5m11s
v0.11 U6: Bring your own key für die KI-Auswertung (Anthropic, OpenRouter)
- 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>
2026-11-03 14:19:13 +01:00

25 KiB
Raw Permalink Blame History

v0.11 – Umsetzungsplan

Stand: 03.11.2026 · Status: zur Prüfung und Freigabe. Die Umsetzung wird gesondert beauftragt. · Bezug: Soll-Ist-Analyse · Technische Zielarchitektur · normativ Communication Handler (CH-01–CH-18, S1–S6, M01–M12)


1. Management-Zusammenfassung

Umfang: sechs Pakete. Zwei davon sind kleine Grundlagenpakete (Konfiguration, Gate und Fakteneingang), eines betrifft die Reservierung, drei den Communication Handler (Rückfrage und Link, Posteingang, KI). Grob geschätzt hat das etwa den Umfang der Pakete 1–9 der v0.10 zusammen. Der größte Einzelblock ist der Communication Handler (U4–U6).

Wesentliche Architekturentscheidungen:

  • Keine neue Engine; CaseAutomation und CaseActivities bleiben führend.
  • Alle neuen Parameter laufen im bestehenden ProcessSetting. Der Kanalmanager ist eine Oberfläche über den vorhandenen Speicherorten.
  • Die eigene Webseite wird ein Kanal-Datensatz eigener Art nur für die Konfiguration; Vorgänge bleiben A1.
  • Gastdaten bleiben in guests und bookings; neu ist ein Nachweisprotokoll je Angabe.
  • Die Klärungsreservierung ist ein Hold mit Zweck clarification in der vorhandenen Belegungsmechanik.
  • Die KI liefert nur Kandidaten an den Fakteneingang.

Wesentliche Risiken:

  1. Das Gate G2a und die Klärungsreservierung verändern das Verhalten für Webseiten-Anfragen ohne Anschrift sichtbar (K1; vom Betreiber mit B1 bestätigt).
  2. Den Postfachabruf auf „alle Mails“ umzustellen berührt den Portal-Schnellweg; das wird mit einem Modus je Postfach abgesichert.
  3. LLM-Qualität, Kosten und Datenschutz sind erst mit echten Testnachrichten belastbar (M05, Go-live).
  4. Ohne Queue-Worker müssen Abruf und Extraktion begrenzt im Scheduler laufen.

Tatsächliche Implementierungsblocker: keine mehr. Der Betreiber hat B1–B4 am 03.11.2026 entschieden (§3.1). Offen sind nur technische Entscheidungen (§3.2) und Go-live-Bedingungen (§3.3).

2. Pakete im Überblick

Paket Inhalt Abhängig von Größe Abnahmefälle
U1 Neue Parameter, Webseite als Kanal, Kanalmanager, „Wirksame Einstellungen“ – M M12 (Konfigurationsteil)
U2 Informationsbedarf, Gate G2a, gemeinsamer Fakteneingang, Neubewertung – M M01, M06 (Teil), M03 (Teil)
U3 Klärungsreservierung V0/V1 U1, U2 S–M M11 (Reservierungsteil), M12 (Bestandsschutz)
U4 Beschaffungsvorgang, Rückfrage, Folgefrage, Erinnerung, Ergänzungslink, Zustandstexte U1–U3 L M02 (Formular), M03, M08, M09, M11
U5 Postfächer, Nachrichteneingang, Zuordnung, Klärungsansicht, Antwortbezug U2, U4 (Message-ID) L M02 (E-Mail), M04, M07, M10
U6 KI-Extraktion (klein → Regeln → groß), Prompts, Schema, Messung U5 M–L M05, M06

Reihenfolge: U1 ∥ U2 → U3 → U4 → U5 → U6. Nach U4 ist der Nutzen schon im Betrieb verfügbar: Die fehlende Anschrift wird automatisch per Link beschafft, Antworten per E-Mail trägt die Vermieterin bis U5 von Hand ein.


3. Offene Punkte, geordnet

3.1 Implementierungsblocker – am 03.11.2026 entschieden

Die Tabelle zeigt die ursprüngliche Frage und die Entscheidung des Betreibers. Es bestehen keine offenen Blocker mehr.

# Paket Frage Warum blockierend Entscheidung des Betreibers
B1 U3 Eingangsverhalten unvollständiger Anfragen (K1): Bekommt eine unvollständige Anfrage künftig statt der Angebots-Haltefrist (heute 48 h ab Eingang) nur die Klärungsreservierung (15/180 min oder 0)? Und entsteht bei Vervollständigung kein neuer Hold, bis das Angebot gesendet wird? Der Code reserviert heute jede Anfrage beim Eingang. v0.11 P01 Nr. 4 und CH §2a Nr. 1 legen das nahe, ändern aber sichtbares Bestandsverhalten. Bestätigt. Unvollständige unverbindliche Anfragen erhalten nur die konfigurierte Klärungsreservierung. Eine Angebots-Vorreservierung entsteht erst über den bestehenden Angebotsprozess, nicht allein durch das Ergänzen fehlender Daten. Vollständige Anfragen bleiben unverändert.
B2 U3 Anschrift im Webformular: Bleibt sie optional (dann laufen die meisten Webseiten-Anfragen über Rückfrage und Kurzblock) oder wird sie über den Kanal „Eigene Webseite“ zur Pflicht (dann bleibt das 48-h-Verhalten für die Webseite)? Bestimmt Formular, Kanalparameter und Regressionsumfang. Bestätigt. Vollständige Anschrift im Webformular als Kanaleinstellung konfigurierbar; Standard zunächst optional.
B3 U2 Gate auch vor der Auskunft unter Vorbehalt (Angebots-Hold 0)? Die v0.11 nennt das Gate „vor eigenem verbindlichem Angebot“. Bei Hold 0 entsteht die Bindung erst mit der Bestätigung des Buchungswunsches. Sonst kommt ein Vertrag ohne Anschrift zustande. Entschieden: Das vollständige Angebots-Gate gilt vor einem eigenen verbindlichen Angebot und vor einer verbindlichen Buchungswunschbestätigung, automatisch wie manuell. Die ausdrücklich unverbindliche Auskunft unter Vorbehalt bleibt mit unvollständigen Gastdaten möglich.
B4 U2 „Vollständige Postanschrift“: Straße mit Hausnummer, PLZ, Ort und Land? Feldliste des Gates. Bestätigt. Die vollständige Anschrift umfasst das Land. „Deutschland“ darf als änderbarer Formularstandard angeboten werden, ist aber keine ungeprüfte Tatsachenannahme: Ein leeres Feld gilt als fehlend und wird nie still gefüllt. Der Name ist Vor- und Nachname.

Die Altersaufteilung ist ausdrücklich offen und nicht Teil des Gates; sie blockiert nichts.

3.2 Technische Entscheidungen (in der Umsetzung, siehe Zielarchitektur §7)

T1 Webseite als Kanal · T2 Nachweisprotokoll case_facts · T3 technische Standardwerte (Rückfragemodus „Freigabe“, Folgefragen 2, Erinnerung alle 24 h, Link 14 Tage) · T4 LLM über HTTP-Client, Anbieter konfigurierbar · T5 Abrufmodus je Postfach · T6 Antwortbezug über Message-ID und Betreffkennung, Plus-Adresse optional · T7 Eingang im Testbetrieb gekennzeichnet.

Zusätzlich vor U6: Die Aufnahme eines Anbieter-SDK ist nicht vorgesehen. Falls doch gewünscht, braucht das eine Freigabe, weil sich die Abhängigkeiten ändern.

3.3 Go-live-Freigabebedingungen (blockieren die Umsetzung nicht)

# Bedingung Betrifft
G1 Rechtlich geprüfte Texte: Rückfrage, Folgefrage, Erinnerung, Zustandstexte (Klärungsblock 0/aktiv/abgelaufen, Portalbuchung), Linkseite U4
G2 Endgültige Werte: Rückfragemodus je Kanal, Erinnerungsabstand, Folgefragen-Obergrenze, Linklaufzeit, Klärungsminuten je Kanal (z. B. 0 für träge iCal-Portale) U1, U4
G3 Eigenes Postfach je Mandant eingerichtet; Zustellung von Antworten (Plus-Adresse ja/nein) geprüft U5
G4 Datenschutz: Lesen aller Mails des Postfachs, Speicher- und Löschfristen (kein 30-Tage-Wert beschlossen), Datenschutzhinweise U5, U6
G5 LLM-Anbieter: Auftragsverarbeitung, Speicherort, kein Training; Kosten je Nachricht U6
G6 Kalibrierung von Konfidenz und Eskalationsschwelle an repräsentativen, anonymisierten Nachrichten; gemessene Rate übersehener Angaben akzeptiert (M05) U6
G7 Kriterien für verlässliche Portal-Mailereignisse (CH-11) bestätigt U5
G8 Sicherheitsprüfung der Gastlinks und des Posteingangs; Abnahme M01–M12 auf dem Testsystem; Regression v0.10 (T01–T25) alle

3.4 Spätere Erweiterungen (nicht beauftragt)

Parallele Angebotsvarianten, Angebotsänderung vor Annahme mit neuem Angebot, Fristverlängerung, automatische Vertragsänderung und Teilstorno nach Vertragsschluss, mehrere aktive Postfächer, Messenger und Social Media, generative Antworten, Gastkonto, V2/V3 des Klärungsblocks, Altersaufteilung, Leads (V02).


4. Pakete im Detail

U1 – Parameter, Webseite als Kanal, Kanalmanager

Ziel: Alle Kanäle einschließlich der eigenen Webseite werden an einer Stelle verwaltet (E-037, M12). Die v0.11-Parameter sind einstellbar und wirksam sichtbar.

Wiederverwendung:

  • ProcessSetting, ProcessSettings, ProcessProfile;
  • ProcessSettingFields (Formularfelder je Einstellung);
  • ChannelForm, HandlingSettings, EffectiveSettings, process:settings-report.

Änderungen:

  1. ProcessSetting um die sieben Fälle der Zielarchitektur §3.1 erweitern (Standard, Frage, Eingangsarten, normalize, describe).
  2. Migration channels.kind (portal/website) und je Wohnung ein Webseiten-Kanal. Channel::portals()-Scope einführen; active() an den operativen Stellen durch portals() ersetzen (Sync, FetchPortalMail, ProcessPortalMail::channelFor, MonitorChannels, CreateChannelTasks, ChangeBooking Z. 424, CalendarClearance, ChannelController, DigestReport, BookingStats, ICalRuleEngine).
  3. ProcessProfile::caseTypeFor: A2 nur bei kind = portal. CreateReservation und ProcessSettings::forBooking lesen bei source = website den Webseiten-Kanal als Einstellungsebene. origin_channel_id bleibt leer.
  4. Oberfläche:
    • Ressource „Kanäle“, in der einfachen Ansicht sichtbar (FollowsAdminMode);
    • Eintrag „Alle Kanäle (Ihre Standards)“ verweist auf „So arbeite ich“;
    • Bereiche „Ablauf“, „Datenbeschaffung und Klärungsreservierung“, „Anbindung“; bei der Webseite ohne Anbindung;
    • Schalter „Anschrift im Formular verlangen“ nach B2.
  5. „Wirksame Einstellungen“: Spalte „Eigene Webseite“ und neue Zeilen.

Migrationen: zwei, idempotent, rückwärtskompatibel (Standard portal).

Risiken:

  • Eine vergessene active()-Stelle würde den Webseiten-Kanal synchronisieren oder als Portal anzeigen.
  • Die Ressourcenumbenennung ändert die Navigation.

Tests:

  • Neu: Webseiten-Kanal überschreibt den Mandantenstandard für Webseiten-Anfragen; Vorgang bleibt A1 und direkt; Webseiten-Kanal erscheint in keinem Sync, keiner Sperraufgabe, keinem Export und keiner Überwachung (je ein Test über die Scope-Stellen); neue Parameter erben bzw. 0 bleibt 0; Profil eingefroren.
  • Regression: CaseCoreTest (Vererbung, wirksame Einstellungen), T12/T24 in EndToEndAcceptanceTest, Kanal-, Sync-, Export- und Postfach-Tests vollständig.

Voraussetzungen: keine.

U2 – Informationsbedarf, Gate G2a, Fakteneingang, Neubewertung

Ziel:

  • Vor einem eigenen Angebot und vor einer verbindlichen Buchungswunschbestätigung (B3) müssen alle Pflichtangaben vorliegen; das gilt nicht übergehbar (E-032, M01). Die Auskunft unter Vorbehalt bleibt mit unvollständigen Angaben möglich.
  • Alle Quellen übernehmen Angaben über einen Eingang mit Herkunft, Konflikt und Änderungswunsch (S5, CH-03, E-038).
  • Danach folgt genau eine Neubewertung (S6).

Wiederverwendung:

  • DocumentComposer, DocumentFinding::blocker, CaseAutomation::advance;
  • CreateReservation::guestFor (Regeln für abweichende Angaben);
  • BookingTask::openOnce, CaseLog.

Änderungen:

  1. App\Process\CaseRequirements (Zielarchitektur §3.2) mit der Feldliste nach B4. Formulare können „Deutschland“ als änderbaren Standard anbieten; ein leeres Land gilt als fehlend.
  2. DocumentComposer::commonFindings: Blocker aus CaseRequirements für das Angebot. SubmitBookingWish::findings bzw. DecideBookingWish: dieselbe Prüfung vor der verbindlichen Bestätigung (B3); die automatische Bestätigung unterbleibt, die manuelle ist gesperrt. Die Auskunft (SendInformation) bleibt ohne Angebots-Gate.
  3. CaseActivities: „Angaben vervollständigen“ mit Liste; CaseAutomation::documentBlockers liest CaseRequirements.
  4. Tabelle case_facts; Aktion ContributeCaseFacts mit Feldklassen und Phasenregeln (Zielarchitektur §3.3); neue Aufgabenarten FactConflict und ChangeRequest.
  5. ProvideGuestContact auf ContributeCaseFacts(source: landlord) umstellen; die doppelte Fortsetzungslogik wird durch advance ersetzt, der Moduswechsel bleibt. CreateReservation::guestFor schreibt case_facts(source: website_form).
  6. Die Dialoge „Kontaktdaten eintragen“ und „Angaben ergänzen“ zeigen die Herkunft der vorhandenen Werte.

Migrationen: case_facts.

Risiken und Regressionen:

  • Tests, die Angebote für Gäste ohne Anschrift senden (Webformular-Fälle in GuidedCaseHandlingTest, EndToEndAcceptanceTest, BookingRequestPageTest, DocumentCompositionTest), müssen Anschriften liefern. Das ist eine erwartete, fachlich gewollte Änderung.
  • Die ProvideGuestContact-Umstellung berührt Portalbuchungen (A3/A4: Unterlagen nach Kontaktdaten). Abgesichert durch T04/T05 und PortalBookingTest.

Tests:

  • M01: Webseiten-Anfrage ohne Anschrift. Kein Angebot automatisch, keines von Hand, auch nicht mit Bestätigung; mit Anschrift geht es durch.
  • B3:
    • Auskunft unter Vorbehalt mit unvollständigen Angaben möglich;
    • Buchungswunsch ohne Anschrift → keine automatische Bestätigung, manuelle Bestätigung gesperrt, Aufgabe „Angaben vervollständigen“;
    • mit Anschrift → Bestätigung wie bisher.
  • B4:
    • leeres Land → fehlend;
    • vom Gast bestätigter vorbelegter Standard → vorhanden;
    • nie stilles Auffüllen der Kartei.
  • Fakten:
    • leer → übernommen;
    • gleich → bestätigt;
    • abweichend vom Gast → Konflikt, Kartei unverändert;
    • abweichend von der Vermieterin → übernommen mit previous_value;
    • in P3 Telefon → übernommen, Zeitraum → Änderungswunsch, Buchung unverändert (M06-Kern);
    • gemeinsame Kartei mehrerer Vorgänge → Konflikt.
  • Idempotenz: zweimal dieselbe Übermittlung → ein Eintrag, eine Neubewertung (M03-Teil).
  • Externe Buchung ohne Gastdaten bleibt verbindlich (E-036).

Voraussetzungen: keine (B3, B4 entschieden).

U3 – Klärungsreservierung

Ziel: Optionaler Kurzblock für unvollständige unverbindliche Anfragen (E-033, G1a). Die Angebots-Vorreservierung bleibt unverändert.

Wiederverwendung: hold_expires_at, Booking::occupying, AvailabilityChecker, iCal-Export, ExpireReservations, AutoOffer, SendOffer.

Änderungen:

  1. Migration bookings.hold_purpose (Standard offer).
  2. CreateReservation und TakeOverPortalInquiry: Fallunterscheidung vollständig / V1-qualifiziert / nicht qualifiziert (Zielarchitektur §3.4). Minuten nach data_request_mode des Profils; 0 = kein Hold.
  3. ExpireReservations: nur offer-Holds beenden; abgelaufene Klärungsreservierung im Verlauf vermerken, den Vorgang offen lassen.
  4. AutoOffer: Der Blocker „nicht mehr vorgemerkt“ gilt nur für offer-Holds.
  5. Booking::clarificationState(); Anzeige im Vorgang („Zeitraum zur Klärung vorläufig reserviert bis …“ bzw. „nicht reserviert“).
  6. Architekturtest: Außer CreateReservation, TakeOverPortalInquiry, SendOffer, Paket-5-Aktionen und ReleaseReservation schreibt niemand hold_expires_at.

Migrationen: eine Spalte.

Risiken:

  • Sichtbare Verhaltensänderung für Anfragen ohne Anschrift (B1/B2).
  • Kurzblöcke erscheinen im iCal-Export und können in trägen Portalen länger sichtbar sein (in der v0.11 bekannt; Kanalwert 0 möglich).

Tests:

  • vollständige Anfrage → Hold wie bisher (Regression);
  • unvollständige mit Automatik → 15 min, mit Freigabe → 180 min, Kanalwert 0 → kein Hold;
  • ohne E-Mail → kein Hold;
  • belegter Zeitraum → keine Reservierung (bestehende Ausnahme);
  • Ablauf → Vorgang offen, Kalender frei;
  • Vervollständigung nach Ablauf → Angebot nur bei freiem Zeitraum;
  • Portalbuchung → nie Klärungsreservierung (M12-Teil);
  • SendOffer setzt offer mit unveränderter Frist.

Voraussetzungen: U1 (Parameter), U2 (CaseRequirements); B1, B2 entschieden.

Ziel:

  • Fehlende Angaben werden nach wirksamem Modus automatisch, nach Freigabe oder manuell beim Gast angefragt (S1, S4, CH-04, CH-15–CH-18).
  • Antworten über den Link gehen an den Fakteneingang.

Wiederverwendung:

  • P7-Linkmuster (InformationController, Version, ensureCurrent, Transaktion, „bereits erledigt“);
  • Mailer mit Testbetriebs-Schranke und LogBookingMail;
  • BookingTask, TenantRunner, Scheduler.

Änderungen:

  1. Tabelle data_requests; Aktion RequestCaseData (Erstrückfrage, Folgefrage); Befehl cases:data-requests (Erinnerungen, Grenzen, Aufgabe „Gast antwortet nicht“).
  2. Auslösung: CaseAutomation/CaseActivities erkennen „Angaben fehlen für die nächste Aktion“ und rufen RequestCaseData auf.
    • Im Modus approval entsteht die Aufgabe „Rückfrage freigeben“ mit Vorschau, Freigabe per Klick.
    • Im Modus manual gibt es die Aufgabe mit Kopiertext; das bisherige „Gast um Kontaktdaten bitten“ geht darin auf.
  3. Mailables DataRequested, DataReminder mit Textbausteinen je clarificationState(), Phase und Eingangsart (M11). Die Betreffkennung des Vorgangs wird für U5 vorbereitet.
  4. Ergänzungslink: Routen, Controller, Livewire- oder Blade-Formular im Theme-System (Basistheme), minimale Einsicht (K4), ContributeCaseFacts(source: guest_link), „neuen Link anfordern“.
  5. Antwort stoppt die laufende Erinnerung; bleibt etwas offen, folgt eine gezielte Folgefrage; Zähler werden nie zurückgesetzt.
  6. Hinweis- und Aktionsfläche im Vorgang: Stand der Rückfrage, Zähler, nächste Erinnerung, „jetzt erinnern“, „Rückfrage beenden“.

Migrationen: data_requests.

Risiken:

  • Mailtexte sind rechtlich nicht freigegeben (G1). Bis dahin laufen sie als Arbeitsfassung über die bestehende Dokumentfreigabe-Logik und werden nie automatisch versendet, solange sie nicht freigegeben sind.
  • Doppelte Rückfragen bei parallelen Auslösern werden durch eine Sperre und „höchstens eine offene Rückfrage“ verhindert.

Tests:

  • M02 (Formular, auch teilweise);
  • M03 (doppeltes Absenden, Mehrfachaufruf, GET schreibt nicht);
  • M08 (Teilantwort → Folgefrage, Zähler ohne Reset, Grenzen → Aufgabe, keine Fristverlängerung);
  • M09 (abgelaufener, fremder und veralteter Link, Konflikt mit geändertem Wert);
  • M11 (Texte bei 0, aktiv mit echter Uhrzeit, abgelaufen, fehlgeschlagen; nie eine unbegründete Reservierungsbehauptung);
  • Modi automatic/approval/manual;
  • ohne E-Mail → Aufgabe;
  • Testbetrieb → Versand nur an die Testadresse (M10-Teil);
  • Portalbuchung: Rückfrage ohne Klärungs- oder Angebotstexte.

Voraussetzungen: U1–U3; Arbeitsfassungen der Texte (G1 erst zum Go-live).

U5 – Posteingang, Zuordnung, Klärungsansicht

Ziel: Ein aktives Postfach je Mandant (Modell für mehrere), alle Mails erfasst, dedupliziert, deterministisch zugeordnet oder zur Klärung gestellt (CH-01, CH-05–CH-08, CH-11–CH-13, M04, M07, M10).

Wiederverwendung: MailboxReader (webklex), ProcessPortalMail, PortalIntake::caseByReference, PortalEmail-Ansicht, Inbox, Settings, Testbetriebs-Logik.

Änderungen:

  1. Tabelle mailboxes mit Übernahme von tenants.mailbox_*; die Einstellungsseite „System › Betrieb“ bearbeitet künftig das Postfach. Modus portal_only als Standard, bis full je Mandant bewusst eingeschaltet wird.
  2. Tabelle inbound_messages; FetchPortalMail speichert zuerst und verarbeitet dann. Portal-Absender gehen weiter durch ProcessPortalMail (verknüpft über inbound_message_id).
  3. booking_messages.message_id in LogBookingMail füllen; Vorgangskennung im Betreff der Rückfragen.
  4. MessageMatcher (Reihenfolge Zielarchitektur §3.6); eine Antwort an einen Beschaffungsvorgang führt zum Stand „Antwort eingegangen“, Erinnerungen ruhen. Ohne KI (vor U6) entsteht die Aufgabe „Antwort prüfen und Angaben übernehmen“ mit vorbereitetem Dialog.
  5. Filament-Ressource „Posteingang“ (Klärungsansicht) mit Absenderhinweisen und den Aktionen Zuordnen, Als Anfrage anlegen, Ignorieren.
  6. Kennzeichnung test_mode; Anzeige „im Testbetrieb eingegangen“.

Migrationen: mailboxes (mit Datenübernahme), inbound_messages, Spalten an booking_messages und portal_emails.

Risiken:

  • Regression des Portal-Schnellwegs. Abgesichert durch den Modus portal_only als Standard, die unveränderte Verarbeitung danach und den vollständigen Lauf von PortalMailTest und CaseIntakeTest.
  • IMAP-Laufzeit im Minutentakt: Begrenzung je Lauf, UID-Merkpunkt.
  • Datenschutz (G4).

Tests:

  • M04 (mehrdeutige oder allgemeine Mail → Klärung, kein Vorgang);
  • M07 (iCal vor Mail und umgekehrt; späte Mail ergänzt, keine zweite Anlage);
  • Antwortbezug über In-Reply-To;
  • Absender + Wohnung + Zeitraum eindeutig → zugeordnet;
  • nur Absender mit genau einem offenen Vorgang, ohne Antwort- oder Vorgangsbezug und ohne passende Wohnungs- und Zeitraummerkmale → keine automatische Zuordnung, sondern Klärung mit Hinweis (CH-13);
  • zwei offene Vorgänge desselben Gastes → Klärung;
  • gleiche Mail zweimal → einmal;
  • Testbetrieb gekennzeichnet (M10);
  • portal_only verhält sich exakt wie heute.

Voraussetzungen: U2 (Fakteneingang), U4 (Message-ID, Betreffkennung); G3 für die Probe auf dem Testsystem.

U6 – KI-Extraktion

Ziel: Unstrukturierte Gast- und Portalnachrichten werden zu Kandidaten mit Beleg und Konfidenz. Programmatische Regeln entscheiden über Übernahme, Eskalation oder Klärung (CH-14, E-035, M05, M06).

Wiederverwendung: TenantService (ai_guest_mail, api_key), ServiceUsage, TenantFeatures, PortalMailParser als RuleExtractor, Fakteneingang.

Änderungen:

  1. Extractor-Schnittstelle, RuleExtractor, LlmExtractor, ReviewLlmExtractor, LlmClient (HTTP).
    • Bring your own key: Anbieter Anthropic oder OpenRouter, Schlüssel sowie kleines und großes Modell je Mandant über „System › KI-Anbindung“, gespeichert im TenantService (Schlüssel verschlüsselt, nie wieder angezeigt).
    • Feste Endpunkte; Verbindungsprüfung beider Modelle.
    • Ein abgelehnter Zugang schaltet die Auswertung sicher ab.
    • Kein zentraler Schlüssel, keine Modellkennungen im Code.
  2. Prompt-Dateien mit Version und Platzhaltern, JSON-Schema, Validierung, einmalige Wiederholung.
  3. RiskAssessment (Kritikalität aus Feldklasse, Phase und Abweichung; Eskalationsschwelle konfigurierbar; Mindestbedingungen für die Übernahme inkl. wörtlichem Belegabgleich). Widersprüche, Änderungsabsichten in P2/P3 und fehlgeschlagene Plausibilitätsprüfungen lösen unabhängig von der Modellkonfidenz die weitere Prüfung aus und werden nie automatisch übernommen. Die endgültigen Schwellen folgen aus der Kalibrierung (G6).
  4. Scheduler-Schritt messages:extract (begrenzt je Lauf, Zeitlimit); bei Ausfall bleibt needs_review.
  5. Klärungsansicht zeigt Kandidaten mit Beleg und „übernehmen“/„verwerfen“.
  6. ai:evaluate mit anonymisiertem Nachrichtensatz; Bericht über Fehlwerte und übersehene Angaben.

Migrationen: Spalten bzw. Tabelle für Extraktionsergebnisse an inbound_messages (Prompt-Version, Modell, Rohergebnis, Kandidaten).

Risiken: Qualität und Kosten (G5, G6); Modelländerungen beim Anbieter, abgefedert durch Prompt-Version und Evaluationslauf; personenbezogene Daten beim Anbieter (G5).

Tests (ohne Netz, aufgezeichnete Antworten):

  • Schema-Verstoß → Wiederholung, dann Klärung;
  • hohe Kritikalität oder niedrige Konfidenz → großes Modell;
  • Widerspruch oder fehlgeschlagene Plausibilität bei hoher Modellkonfidenz → trotzdem großes Modell und keine automatische Übernahme;
  • großes Modell widerspricht → Klärung;
  • Beleg nicht im Original → keine Übernahme;
  • M06 (Telefon übernommen, Änderungswunsch nur als Aufgabe);
  • Ausfall → sicherer Rückfall;
  • Schalter aus → keine Aufrufe;
  • Verbrauch gezählt.

Voraussetzungen: U5; Anbieter-Zugang für das Testsystem; G5/G6 erst zum Go-live.


5. Testplanung und Regression

Abnahmefälle M01–M12 → Pakete:

M Paket Art
M01 U2 Feature-Test und Browserprobe
M02 U4 (Link), U5/U6 (E-Mail) Feature
M03 U2, U4, U5 Feature (Idempotenz)
M04 U5 Feature
M05 U6 Evaluationslauf mit Fehlerraten
M06 U2, U6 Feature
M07 U5 Feature (auf CaseIntakeTest aufbauend)
M08 U4 Feature mit Zeitreise
M09 U4 Feature (signierte URLs)
M10 U4, U5 Feature und Probe auf dem Testsystem (echtes SMTP/IMAP)
M11 U3, U4 Feature (Texte je Zustand)
M12 U1, U3 Feature

Regression nach jedem Paket:

  • volle Testsuite (heute 702 Tests);
  • End-to-End-Abnahme T01–T25 der v0.10, insbesondere T03/T04/T05 (Kontaktdaten und Portalbuchungen), T12/T24 (Wirksamkeit), T17 (Buchungswunsch) und T23 (Testbetrieb über SMTP).

Besonders gefährdete Bestandsfunktionen:

  1. automatisches Angebot für Webseiten-Anfragen (U2/U3);
  2. Portal-Schnellweg per Mail (U5);
  3. iCal-Sync und Sperraufgaben (U1, Scope-Umstellung);
  4. Kontaktübernahme bei Portalbuchungen (U2).

Abnahme je Paket:

  • Testsuite grün;
  • neue Fälle grün;
  • Kurzbericht im Stil der bisherigen UMSETZUNGSERGEBNIS_*.md;
  • Probe auf dem Testsystem im Testbetrieb.

Merge und Auslieferung erfolgen nur nach Freigabe.

6. Nicht Teil dieses Plans

Siehe §3.4 sowie die Architekturgrenzen des Auftrags: keine zweite Engine, keine Warteschlange oder Nachrückautomatik, keine Änderung von Angebots-Vorreservierung und Annahmefristen, kein Eingriff in die regelbasierte iCal-Ereignisverarbeitung, keine automatische Änderung geschützter Vertragsdaten.