- 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>
25 KiB
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;
CaseAutomationundCaseActivitiesbleiben 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
guestsundbookings; neu ist ein Nachweisprotokoll je Angabe. - Die Klärungsreservierung ist ein Hold mit Zweck
clarificationin der vorhandenen Belegungsmechanik. - Die KI liefert nur Kandidaten an den Fakteneingang.
Wesentliche Risiken:
- 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).
- Den Postfachabruf auf „alle Mails“ umzustellen berührt den Portal-Schnellweg; das wird mit einem Modus je Postfach abgesichert.
- LLM-Qualität, Kosten und Datenschutz sind erst mit echten Testnachrichten belastbar (M05, Go-live).
- 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:
ProcessSettingum die sieben Fälle der Zielarchitektur §3.1 erweitern (Standard, Frage, Eingangsarten,normalize,describe).- Migration
channels.kind(portal/website) und je Wohnung ein Webseiten-Kanal.Channel::portals()-Scope einführen;active()an den operativen Stellen durchportals()ersetzen (Sync,FetchPortalMail,ProcessPortalMail::channelFor,MonitorChannels,CreateChannelTasks,ChangeBookingZ. 424,CalendarClearance,ChannelController,DigestReport,BookingStats,ICalRuleEngine). ProcessProfile::caseTypeFor: A2 nur beikind = portal.CreateReservationundProcessSettings::forBookinglesen beisource = websiteden Webseiten-Kanal als Einstellungsebene.origin_channel_idbleibt leer.- 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.
- Ressource „Kanäle“, in der einfachen Ansicht sichtbar (
- „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.
0bleibt0; Profil eingefroren. - Regression:
CaseCoreTest(Vererbung, wirksame Einstellungen), T12/T24 inEndToEndAcceptanceTest, 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:
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.DocumentComposer::commonFindings: Blocker ausCaseRequirementsfür das Angebot.SubmitBookingWish::findingsbzw.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.CaseActivities: „Angaben vervollständigen“ mit Liste;CaseAutomation::documentBlockersliestCaseRequirements.- Tabelle
case_facts; AktionContributeCaseFactsmit Feldklassen und Phasenregeln (Zielarchitektur §3.3); neue AufgabenartenFactConflictundChangeRequest. ProvideGuestContactaufContributeCaseFacts(source: landlord)umstellen; die doppelte Fortsetzungslogik wird durchadvanceersetzt, der Moduswechsel bleibt.CreateReservation::guestForschreibtcase_facts(source: website_form).- 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 undPortalBookingTest.
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:
- Migration
bookings.hold_purpose(Standardoffer). CreateReservationundTakeOverPortalInquiry: Fallunterscheidung vollständig / V1-qualifiziert / nicht qualifiziert (Zielarchitektur §3.4). Minuten nachdata_request_modedes Profils;0= kein Hold.ExpireReservations: nuroffer-Holds beenden; abgelaufene Klärungsreservierung im Verlauf vermerken, den Vorgang offen lassen.AutoOffer: Der Blocker „nicht mehr vorgemerkt“ gilt nur füroffer-Holds.Booking::clarificationState(); Anzeige im Vorgang („Zeitraum zur Klärung vorläufig reserviert bis …“ bzw. „nicht reserviert“).- Architekturtest: Außer
CreateReservation,TakeOverPortalInquiry,SendOffer, Paket-5-Aktionen undReleaseReservationschreibt niemandhold_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
0mö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);
SendOffersetztoffermit unveränderter Frist.
Voraussetzungen: U1 (Parameter), U2 (CaseRequirements); B1, B2 entschieden.
U4 – Datenbeschaffung: Rückfrage, Erinnerung, Ergänzungslink
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:
- Tabelle
data_requests; AktionRequestCaseData(Erstrückfrage, Folgefrage); Befehlcases:data-requests(Erinnerungen, Grenzen, Aufgabe „Gast antwortet nicht“). - Auslösung:
CaseAutomation/CaseActivitieserkennen „Angaben fehlen für die nächste Aktion“ und rufenRequestCaseDataauf.- Im Modus
approvalentsteht die Aufgabe „Rückfrage freigeben“ mit Vorschau, Freigabe per Klick. - Im Modus
manualgibt es die Aufgabe mit Kopiertext; das bisherige „Gast um Kontaktdaten bitten“ geht darin auf.
- Im Modus
- Mailables
DataRequested,DataRemindermit Textbausteinen jeclarificationState(), Phase und Eingangsart (M11). Die Betreffkennung des Vorgangs wird für U5 vorbereitet. - Ergänzungslink: Routen, Controller, Livewire- oder Blade-Formular im Theme-System (Basistheme), minimale Einsicht (K4),
ContributeCaseFacts(source: guest_link), „neuen Link anfordern“. - Antwort stoppt die laufende Erinnerung; bleibt etwas offen, folgt eine gezielte Folgefrage; Zähler werden nie zurückgesetzt.
- 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:
- Tabelle
mailboxesmit Übernahme vontenants.mailbox_*; die Einstellungsseite „System › Betrieb“ bearbeitet künftig das Postfach. Modusportal_onlyals Standard, bisfullje Mandant bewusst eingeschaltet wird. - Tabelle
inbound_messages;FetchPortalMailspeichert zuerst und verarbeitet dann. Portal-Absender gehen weiter durchProcessPortalMail(verknüpft überinbound_message_id). booking_messages.message_idinLogBookingMailfüllen; Vorgangskennung im Betreff der Rückfragen.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.- Filament-Ressource „Posteingang“ (Klärungsansicht) mit Absenderhinweisen und den Aktionen Zuordnen, Als Anfrage anlegen, Ignorieren.
- 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_onlyals Standard, die unveränderte Verarbeitung danach und den vollständigen Lauf vonPortalMailTestundCaseIntakeTest. - 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_onlyverhä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:
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.
- Bring your own key: Anbieter Anthropic oder OpenRouter, Schlüssel sowie kleines und großes Modell je Mandant über „System › KI-Anbindung“, gespeichert im
- Prompt-Dateien mit Version und Platzhaltern, JSON-Schema, Validierung, einmalige Wiederholung.
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).- Scheduler-Schritt
messages:extract(begrenzt je Lauf, Zeitlimit); bei Ausfall bleibtneeds_review. - Klärungsansicht zeigt Kandidaten mit Beleg und „übernehmen“/„verwerfen“.
ai:evaluatemit 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:
- automatisches Angebot für Webseiten-Anfragen (U2/U3);
- Portal-Schnellweg per Mail (U5);
- iCal-Sync und Sperraufgaben (U1, Scope-Umstellung);
- 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.