v0.11 U6: Bring your own key für die KI-Auswertung (Anthropic, OpenRouter)
Deploy FeWo mit PipelineManager / deploy (push) Successful in 5m11s

- 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>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-03 14:19:13 +01:00
1 parent 6f9aa46943
commit 6862dec201
20 files changed
+752 -95

No files matched your search

@@ -10,7 +10,7 @@ ## 1. Benötigte externe Dienste (vom Betreiber bereitzustellen)
|---|---|---|
| **Eigenes IMAP-Postfach** für die Gästekommunikation, z. B. `anfragen@…` bei Strato | Antworten der Gäste und Portal-Mails lesen (CH-01, CH-05) | Zugangsdaten unter System › Betrieb; „Was wird gelesen?“ = „Alle Nachrichten“; „Adresse dieses Postfachs“ = die Postfachadresse. Das Postfach darf nur für Anfragen und Antworten dienen. |
| **SMTP** (wie bei T23) | Rückfragen und Angebote versenden | ist eingerichtet; Testbetrieb lässt nur die Testadresse zu |
| **KI-Zugang** (Anthropic API) | Auswertung der Antworten (CH-14) | Schlüssel als `FEWO_AI_API_KEY` in `shared/.env`, danach `bash scripts/deploy.sh staging artisan optimize`. Betreiberbereich › Mandant › Dienste: „KI: Gästekommunikation“ einschalten. |
| **Eigener KI-Zugang des Mandanten** (Anthropic oder OpenRouter, Bring your own key) | Auswertung der Antworten (CH-14) | Betreiberbereich › Mandant › Dienste: „KI: Gästekommunikation“ einschalten. Danach in der Verwaltung des Mandanten **System › KI-Anbindung**: Anbieter, API-Schlüssel, Modell für die erste Auswertung und für die Prüfung eintragen, „Verbindung prüfen“. Kein zentraler Schlüssel nötig. |
| **Testpostfach**, das die Testadresse empfängt und von dem aus geantwortet werden kann | Rückfragen empfangen und beantworten | System › Betrieb › Testadresse |
| Scheduler (n8n, vorhanden) | `channels:fetch-mail` jede Minute, `cases:data-requests` und `messages:extract` alle fünf Minuten | läuft über den vorhandenen Auslöser; nichts zu tun |
@@ -29,7 +29,8 @@ ## 2. Testkonfiguration
3. **Kanäle › Eigene Webseite:** zunächst nichts ändern, die Standards gelten. Für Fall 7 vorübergehend die Klärungsreservierung „automatisch“ auf `0` setzen.
4. **Kanäle › FeWo-direkt:** Absender der Buchungs-E-Mails eingetragen (z. B. `fewo-direkt.de`).
5. **Preise:** Für die Testzeiträume sind Saisons hinterlegt (Lücke Januar bis März 2027 vorher schließen, siehe Status vom 02.11.2026).
6. **Wirksame Einstellungen** (Expertenansicht) prüfen: In der Spalte „Eigene Webseite – Anfrage“ stehen 15 Minuten (automatisch) bzw. 180 Minuten (Freigabe) und der Rückfragemodus „Automatisch“.
6. **KI-Anbindung:** „Verbindung prüfen“ zeigt „Verbindung in Ordnung“. Gegenprobe: einen falschen Schlüssel speichern und prüfen. Erwartet wird „Prüfung fehlgeschlagen“, die Auswertung ist aus, und Nachrichten bleiben im Posteingang. Danach den richtigen Schlüssel wieder eintragen.
7. **Wirksame Einstellungen** (Expertenansicht) prüfen: In der Spalte „Eigene Webseite – Anfrage“ stehen 15 Minuten (automatisch) bzw. 180 Minuten (Freigabe) und der Rückfragemodus „Automatisch“.
## 3. Drehbuch (etwa 90 Minuten)
@@ -42,7 +43,7 @@ ## 3. Drehbuch (etwa 90 Minuten)
| **3** | Zweite Anfrage ohne Anschrift. Den **Link** „Angaben ergänzen“ öffnen, nur die Straße senden, dann den Rest; das Formular zweimal absenden; einen älteren Link öffnen (M02 Link, M03, M09). | Nach der Teilantwort kommt eine gezielte Folgefrage mit neuem Link; der alte Link sagt „nicht mehr aktuell“. Doppeltes Absenden erzeugt nichts doppelt. Danach geht das Angebot hinaus. |
| **4** | Dritte Anfrage ohne Anschrift; nicht antworten. Im Vorgang die nächste Erinnerung ablesen. Zum Abkürzen „Wie oft wird höchstens erinnert?“ = 1 und „Nach wie vielen Stunden …“ = 1 setzen (M08). | Nach einer Stunde kommt eine Erinnerung, nach einer weiteren Stunde die Aufgabe „Fehlende Angaben selbst beim Gast nachfragen“. Die Klärungsreservierung ist nach 15 Minuten abgelaufen und wurde durch nichts verlängert; der Vorgang bleibt offen. |
| **5** | Vom Testpostfach eine **neue Mail ohne Bezug** an das Postfach senden: „Haben Sie im Dezember frei?“ (M04). | Posteingang „zu klären“, kein Vorgang. „Als neue Anfrage anlegen“ erzeugt die Anfrage; sie fragt nach der Anschrift. |
| **6** | Auf eine Rückfrage antworten: „Telefon 0171 1234567. Können wir einen Tag länger bleiben?“ (M05, M06). | Telefon übernommen. Aufgabe „Änderungswunsch des Gastes prüfen“; der Zeitraum ist **unverändert**. Optional: Betreiber führt `php artisan ai:evaluate` aus und notiert die Rate übersehener Angaben. |
| **6** | Auf eine Rückfrage antworten: „Telefon 0171 1234567. Können wir einen Tag länger bleiben?“ (M05, M06). | Telefon übernommen. Aufgabe „Änderungswunsch des Gastes prüfen“; der Zeitraum ist **unverändert**. Optional: `php artisan ai:evaluate <Mandanten-ID>` ausführen (nutzt den Zugang des Mandanten) und notiert die Rate übersehener Angaben. |
| **7** | Klärungsreservierung „automatisch“ der Webseite auf `0`, erneut ohne Anschrift anfragen (M11, M12). | Kein Kalendereintrag. Die Rückfrage sagt „noch nicht für Sie reserviert“, ohne Reservierungsbehauptung. Danach den Wert zurücksetzen. |
| **8** | Portalbuchung: FeWo-direkt-Buchungsmail an das Postfach weiterleiten bzw. die vorhandene Testmail aus T04 verwenden (M07, M12, E-036). | Wie bisher: Sperre bzw. Vorgang „Beim Portal fest gebucht“. Keine Klärungsreservierung, kein Angebot. Fehlt nur die Anschrift, heißt die Rückfrage „Ihre Buchung ist verbindlich bestätigt …“. iCal-Abgleich läuft unverändert. |
| **9** | **Regression v0.10:** Drehbuch der Gesamtabnahme v0.10 §8 in Kurzform (Annahme, Auskunft und Buchungswunsch, Ändern, Storno, Aufenthalt) (M10). | Unverändert; neu ist nur, dass Angebot und Wunschbestätigung die vollständige Anschrift verlangen. |
@@ -18,7 +18,7 @@ # Umsetzungsergebnis v0.11 – integrierter MVP
## 1. Ergebnis in Kürze
- Alle sechs Pakete sind umgesetzt; ein durchgehender Integrationstest deckt die ganze Kette ab: Website-Anfrage ohne Anschrift → Klärungsreservierung → Rückfrage per Mail → Antwort des Gastes per E-Mail → Zuordnung über den Antwortbezug → KI-Auswertung → Fakteneingang → automatisches Angebot mit unverändertem Angebots-Hold → Annahme → verbindliche Buchung.
- **Tests:** 759 grün, vorher 702. Neu sind 57 Tests in 7 Dateien; 11 bestehende Testdateien wurden angepasst (Anschriften in Testdaten, siehe §5).
- **Tests:** 766 grün, vorher 702. Neu sind 64 Tests in 8 Dateien; 11 bestehende Testdateien wurden angepasst (Anschriften in Testdaten, siehe §5).
- Die Architekturgrenzen sind eingehalten:
- keine zweite Ablaufsteuerung (`CaseAutomation`/`CaseActivities` bleiben führend);
- Angebots-Hold und Annahmefristen unverändert;
@@ -36,13 +36,14 @@ ## 2. Was gebaut wurde
| U3 | Klärungsreservierung (`hold_purpose`), Ablauf ohne Vorgangsende, Angebot danach nur bei freiem Zeitraum | `RequestHold`, `CreateReservation`, `TakeOverPortalInquiry`, `ExpireReservations`, `Booking::clarificationState` |
| U4 | Beschaffungsvorgang mit Rückfrage, Folgefrage, Erinnerung, Grenzen; Mail nach tatsächlichem Sperrstatus; signierter Ergänzungslink | `RequestCaseData`, `DataRequest`, `DataRequested`, `GuestDataController`, `cases:data-requests` |
| U5 | Postfächer (`mailboxes`), Nachrichteneingang (`inbound_messages`), Zuordnung nach CH-13, „Posteingang“, Message-ID der ausgehenden Mails | `ReceiveInboundMessage`, `MessageMatcher`, `InboundMessageResource`, `MailboxReader::fetchAll`, `LogBookingMail` |
| U6 | KI-Kaskade (klein → Regeln → groß), Prompts v1, Schema, Vorschläge im Posteingang, Messbefehl | `ExtractMessageFacts`, `MessageExtractor`, `RiskAssessment`, `LlmClient`, `messages:extract`, `ai:evaluate` |
| U6 | KI-Kaskade (klein → Regeln → groß), Prompts v1, Schema, Vorschläge im Posteingang, Messbefehl; **BYOK** je Mandant (Anthropic oder OpenRouter, Seite „KI-Anbindung“, Verbindungsprüfung) | `ExtractMessageFacts`, `MessageExtractor`, `RiskAssessment`, `LlmClient`, `messages:extract`, `ai:evaluate` |
**Migrationen** (alle rückwärtskompatibel, keine wurde auf einem Server ausgeführt):
- `2026_11_06_090000` Kanalart;
- `…100000` Faktenprotokoll, Hold-Zweck, `guests.country` ohne Standardwert;
- `…110000` Beschaffungsvorgänge und Message-ID;
- `…120000` Postfächer und Nachrichteneingang.
- `…120000` Postfächer und Nachrichteneingang;
- `…130000` KI-Zugang je Mandant (BYOK).
## 3. Rückverfolgbarkeit
@@ -59,7 +60,7 @@ ## 3. Rückverfolgbarkeit
| **CH-09/12** Portal-Mail mit Gastdaten, beliebige Reihenfolge | Portal-Mail mit Vorgangsbezug wird ausgewertet (Quelle Portal-Mail) | `CaseFactIntakeTest` (Portal ergänzt Personenzahl), `CaseIntakeTest` unverändert grün |
| **CH-10** keine pauschale Rangfolge | Regel je Feld und Phase statt Quellenrang | `CaseFactIntakeTest` |
| **CH-11** iCal-Abgleich unverändert | keine Änderung an Sync, Regeln, Export | Kanal- und Sync-Tests unverändert grün |
| **CH-14** zweistufige KI, Kritikalität im Programm, Konfidenz nicht maßgeblich | `RiskAssessment`, `ExtractMessageFacts` | `MessageExtractionTest` (Widerspruch trotz Konfidenz 0,99 → Prüfung, keine Übernahme) |
| **CH-14** zweistufige KI, Kritikalität im Programm, Konfidenz nicht maßgeblich; austauschbare Modellanbindung | `RiskAssessment`, `ExtractMessageFacts`, `AiAccess`, `AiProvider` | `MessageExtractionTest` (Widerspruch trotz Konfidenz 0,99 → Prüfung, keine Übernahme), `AiAccessTest` (BYOK, OpenRouter, abgelehnter Schlüssel, feste Endpunkte) |
| **CH-15/16/17** Rückfrage, Folgefrage, Erinnerung; Zähler ohne Reset; Grenzen; eine offene Rückfrage | `DataRequest`, `RequestCaseData::answered/remindDue` | `DataRequestTest::test_reminders_follow_their_limit…`, `…partly_and_then_fully` |
| **CH-18** signierter, versionierter Link, Lesen schreibt nicht, idempotent | `GuestDataController` | `DataRequestTest::test_foreign_outdated_and_unsigned_links_change_nothing` |
| **S1–S6** | `RequestCaseData` (S1), `ReceiveInboundMessage` (S2), `MessageMatcher` und Extraktion (S3), `DataRequested` und Link (S4), `ContributeCaseFacts` (S5), `CaseAutomation::advance` (S6) | `V011EndToEndTest` |
@@ -108,8 +109,10 @@ ## 4. Technische Entscheidungen in der Umsetzung
- Hat der Mandant nur eine Wohnung, ist die Wohnung damit bestimmt. Bei mehreren muss der Wohnungsname in der Nachricht stehen.
7. **Portalanfragen (A2) ohne Gastdaten** reservieren beim Eingang nichts mehr: B1 gilt auch für sie. Die Angebots-Reservierung entsteht wie bisher mit dem Angebot.
8. **KI:**
- Kleines Modell `claude-haiku-5-5`, Prüfmodell `claude-opus-5-5`, beide per Konfiguration austauschbar.
- Für das Prüfmodell ist der serverseitige Fallback bei Ablehnung aktiv (`fallbacks: "default"`). Eine Ablehnung gilt trotzdem als Fehlschlag, und die Nachricht geht an die Vermieterin.
- **Bring your own key:** Jeder Mandant wählt unter „System › KI-Anbindung“ Anbieter (Anthropic oder OpenRouter), Schlüssel, kleines und großes Modell. Es gibt keinen zentralen Schlüssel und keine Modellkennung im Code; die Endpunkte sind fest je Anbieter (`AiProvider`).
- Ein abgelehnter Schlüssel (401/402/403) schaltet die Auswertung für den Mandanten ab und meldet es; die Nachrichten bleiben im Posteingang (Test `AiAccessTest`).
- OpenRouter wird genutzt, weil der Betreiber es ausdrücklich vorgibt. Es ist ein OpenAI-kompatibler Zugang; erzwungen werden das Schema (`strict`) und nur Anbieter, die es unterstützen (`provider.require_parameters`).
- Bei Anthropic ist für Modelle der Opus-Familie der serverseitige Fallback bei Ablehnung aktiv (`fallbacks: "default"`). Eine Ablehnung gilt trotzdem als Fehlschlag, und die Nachricht geht an die Vermieterin.
- Die Anbindung läuft laut Plan über den HTTP-Client. Ein offizielles PHP-SDK gibt es; seine Aufnahme wäre eine Abhängigkeitsänderung und bräuchte eine Freigabe.
- Die Prompt-Anweisungen sind englisch, Werte und Oberfläche deutsch.
- Bekannte Werte gehen nur maskiert an den Anbieter.
@@ -129,7 +132,7 @@ ## 6. Einschränkungen
- **Kalibrierung:** Der mitgelieferte Messsatz hat erst 4 Nachrichten. Schwellen (Eskalation 0,2, Mindestkonfidenz 0,85) und Prompt v1 sind Startwerte.
- **Texte** der Rückfrage, Folgefrage, Erinnerung und der Linkseite sind Arbeitsfassungen ohne rechtliche Freigabe.
- **Aufbewahrung:** Nachrichtentexte und Faktwerte sind verschlüsselt gespeichert, werden aber noch nicht vom Anonymisierungslauf erfasst. Eine Löschfrist ist nicht beschlossen.
- **API-Schlüssel je Mandant:** Das Datenfeld ist vorhanden, eine Oberfläche nicht. Auf dem Testsystem gilt `FEWO_AI_API_KEY`.
- **KI-Zugang:** nur über die Seite „KI-Anbindung“ des Mandanten (BYOK); ein zentraler Schlüssel ist nicht vorgesehen.
- **Postfach-Zugangsdaten** werden auf „System › Betrieb“ gepflegt und in den Postfach-Datensatz übernommen. Die alten Mandantenspalten bleiben bis zur Produktivmigration als Rückfall.
- **Plus-Adressen** werden nicht genutzt; die Zuordnung läuft über Message-ID und Vorgangsnummer.
- Nicht Teil des MVP laut v0.11: parallele Angebote, automatische Vertragsänderungen und Teilstorno, mehrere aktive Postfächer, Messenger, generative Antworten, Gastkonto.
@@ -15,6 +15,10 @@ ## 1. Leitentscheidungen
5. **Reservierungen nutzen die vorhandene Belegungsmechanik.** Die Klärungsreservierung ist ein Hold mit eigenem Zweck (`hold_purpose`) und wird nicht als neuer Status abgebildet.
6. **Synchron und begrenzt.** Es gibt keine Queue-Worker (Strato). Abruf, Zuordnung, Extraktion und Erinnerungen laufen als begrenzte Scheduler-Schritte. Jeder Schritt ist idempotent und setzt bei einem Abbruch wieder auf.
7. **Keine neue Abhängigkeit ohne Freigabe.** Die LLM-Anbindung läuft über den Laravel-HTTP-Client hinter einer kleinen Schnittstelle.
8. **Bring your own key:**
- Jeder Mandant verbindet seinen eigenen KI-Zugang: Anbieter, Schlüssel, kleines und großes Modell.
- Es gibt keinen zentralen Betreiberschlüssel und keine im Code verdrahteten Modellkennungen.
- Die Endpunkte sind je Anbieter fest hinterlegt.
## 2. Komponenten und Datenfluss
@@ -213,7 +217,7 @@ ### 3.7 KI-Extraktion (C)
- `RuleExtractor`: bestehender Portalparser und einfache Muster;
- `LlmExtractor`: kleines Modell;
- `ReviewLlmExtractor`: großes Modell, sieht Original und Erstextraktion.
- Die Modellanbindung `LlmClient` läuft über den HTTP-Client; Anbieter, Modell und Endpunkt kommen aus der Konfiguration (austauschbar).
- Die Modellanbindung `LlmClient` läuft über den HTTP-Client mit dem **Zugang des Mandanten** (`AiAccess`, siehe 3.8). Unterstützte Anbieter sind Anthropic (Messages API) und **OpenRouter** (Chat Completions mit `response_format: json_schema`, `strict`, `provider.require_parameters`). Die Endpunkte stehen fest im Enum `AiProvider` und lassen sich nicht über Konfiguration umlenken.
- **Prompts** liegen versioniert als Dateien unter `resources/prompts/extraction/<version>.md`, mit Platzhaltern wie `{{phase}}`, `{{requested_fields}}`, `{{known_values_masked}}`, `{{message}}`. Das JSON-Schema liegt daneben (`schema.json`). Die genutzte Version wird an jedem Ergebnis gespeichert.
- **Ausgabe:** schema-validiert. Fakten mit `field`, `value`, `evidence` (Zitat) und `confidence`; Änderungsabsichten; Unsicherheiten. Bei ungültigem Schema wird einmal wiederholt, danach geht die Nachricht in die Klärung.
- **Programmatische Risikoprüfung** (`App\Communication\Extraction\RiskAssessment`):
@@ -226,11 +230,29 @@ ### 3.7 KI-Extraktion (C)
- **Ergebnis:** `ContributeCaseFacts(source: llm)`. Die KI schreibt nie selbst.
- **Betrieb:**
- Schalter `ai_guest_mail` wird `isWired`;
- Schlüssel je Mandant (`Tenant::services`), Verbrauch in `ServiceUsage`;
- Schlüssel, Anbieter und Modelle je Mandant (`TenantService` des Dienstes `ai_guest_mail`), Verbrauch in `ServiceUsage`;
- je Lauf höchstens N Nachrichten, Zeitlimit je Aufruf;
- bei Ausfall bleibt die Nachricht `needs_review` (sicherer Rückfall).
- **Messung (M05):** Der Befehl `ai:evaluate` führt einen Satz anonymisierter Testnachrichten mit Sollwerten aus und meldet getrennt Fehlwerte und übersehene Angaben. Er läuft ohne Netz in den Tests mit aufgezeichneten Antworten, mit Netz nur bewusst.
### 3.8 KI-Zugang je Mandant (Bring your own key)
- **Ort:** Seite „System › KI-Anbindung“. Sie ist nur sichtbar, wenn der Betreiber den Dienst „KI: Gästekommunikation“ für den Mandanten eingeschaltet hat.
- **Felder:** Anbieter (Anthropic oder OpenRouter), API-Schlüssel, Modell für die erste Auswertung, Modell für die Prüfung. Die Modelle sind Pflicht; der Code gibt keine vor.
- **Speicherung:** im bestehenden `TenantService` des Dienstes `ai_guest_mail`.
- Schlüssel in `api_key`, verschlüsselt und `hidden`.
- Anbieter und Modelle in `settings`.
- Prüfergebnis in `check_status`, `check_message` und `checked_at`.
- **Anzeige:** Der Schlüssel wird nie wieder angezeigt. Ein leeres Feld behält ihn, „Schlüssel entfernen“ löscht ihn.
- **Keine Schlüssel in Meldungen:** Fehlermeldungen enthalten den Schlüssel nie, auch wenn der Anbieter ihn zurückspiegelt.
- **Verbindung prüfen:** Je eine minimale Anfrage mit strukturierter Ausgabe an beide Modelle; das Ergebnis wird gespeichert.
- **Abgelehnter Zugang** (HTTP 401/402/403):
- Der Zugang gilt als ungültig, und die Auswertung ist für diesen Mandanten aus, bis er gespeichert oder erneut geprüft wird. Es gibt keine Wiederholungsschleife.
- Die Vermieterin bekommt einen Hinweis im Postfach der Verwaltung.
- Die Nachrichten bleiben im Posteingang zur Prüfung.
- **Unvollständiger Zugang:** Fehlt der Zugang oder ist er unvollständig, wird nichts gesendet (`extraction_status = disabled`).
- **Wiederholung:** Nur vorübergehende Fehler werden wiederholt (Verbindung, 429, 5xx).
## 4. Datenmodelländerungen (Übersicht)
| Änderung | Rückwärtskompatibilität |
@@ -243,6 +265,7 @@ ## 4. Datenmodelländerungen (Übersicht)
| `mailboxes` (neu) mit Übernahme von `tenants.mailbox_*` | Alte Spalten bleiben bis nach der Produktivmigration lesbar (wie bei `properties.hold_hours`) |
| `inbound_messages` (neu), `portal_emails.inbound_message_id` (nullable) | Portalpfad unverändert |
| `BookingTaskKind`: `FactConflict`, `ChangeRequest`, `DataRequestApproval`, `GuestUnresponsive` | Enum-Erweiterung |
| `tenant_services.settings`, `check_status`, `check_message`, `checked_at` (BYOK) | nullable; Schlüssel bleibt in `api_key` |
## 5. Sicherheit und Datenschutz (technisch)
@@ -268,7 +291,7 @@ ## 7. Technische Entscheidungen im Rahmen der Umsetzung
| T1 | Webseite als Kanal | `channels.kind = website`, nur Konfiguration (§3.1) |
| T2 | Nachweis je Angabe | `case_facts` als Protokoll, Daten bleiben in `guests`/`bookings` |
| T3 | Technische Standards für offene Parameter | Rückfragemodus `approval`, Folgefragen 2, Erinnerungsabstand 24 h, Link 14 Tage; überschreibbar, Go-live-Freigabe |
| T4 | LLM-Anbindung | HTTP-Client, Anbieter konfigurierbar; Vorschlag kleines/großes Modell aus derselben Modellfamilie |
| T4 | LLM-Anbindung | HTTP-Client; BYOK je Mandant: Anthropic oder OpenRouter, kleines und großes Modell frei wählbar (keine Vorgabe im Code), feste Endpunkte |
| T5 | Abruf im Modus `full` | Ungelesen lassen, UID-Merkpunkt je Postfach, Deduplizierung per Message-ID |
| T6 | Antwortadresse | Message-ID-Bezug und Vorgangskennung im Betreff sicher; Plus-Adresse zusätzlich, wenn der Anbieter sie zustellt |
| T7 | Eingang im Testbetrieb | normal verarbeiten, sichtbar gekennzeichnet; Versand bleibt über die Schranke umgeleitet |
@@ -274,7 +274,11 @@ ### U6 – KI-Extraktion
**Wiederverwendung:** `TenantService` (`ai_guest_mail`, `api_key`), `ServiceUsage`, `TenantFeatures`, `PortalMailParser` als `RuleExtractor`, Fakteneingang.
**Änderungen:**
1. `Extractor`-Schnittstelle, `RuleExtractor`, `LlmExtractor`, `ReviewLlmExtractor`, `LlmClient` (HTTP, konfigurierbarer Anbieter und konfigurierbares Modell).
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`.
+3 -2
View File
@@ -17,7 +17,8 @@ ## Aktueller Stand (03.11.2026)
- **Datenbeschaffung:** Rückfrage, Folgefrage, Erinnerung, signierter Ergänzungslink; Texte nach tatsächlichem Sperrstatus.
- **Posteingang:** eigenes Postfach im Modus „alle Nachrichten“, Zuordnung nach CH-13, Klärungsansicht.
- **KI-Auswertung:** kleines Modell → Regeln → Prüfmodell; nur geprüfte Angaben gehen über den Fakteneingang. Der Dienst ist je Mandant standardmäßig aus.
- **Tests:** 759 grün.
- **KI-Zugang:** Bring your own key je Mandant (Anthropic oder OpenRouter, Seite „System › KI-Anbindung“, Verbindungsprüfung), kein zentraler Schlüssel.
- **Tests:** 766 grün.
Dokumente:
- [Umsetzungsergebnis v0.11](Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_V011.md) (Rückverfolgung, Entscheidungen, Einschränkungen, Go-live-Bedingungen);
@@ -25,7 +26,7 @@ ## Aktueller Stand (03.11.2026)
- Planung: [Soll-Ist](Prozessarchitektur/Implementierungsstände/V011_SOLL_IST_ANALYSE.md), [Zielarchitektur](Prozessarchitektur/Implementierungsstände/V011_TECHNISCHE_ZIELARCHITEKTUR.md), [Umsetzungsplan](Prozessarchitektur/Implementierungsstände/V011_UMSETZUNGSPLAN.md).
**Nächste Schritte:**
1. Abstimmung mit dem Betreiber: Auslieferung von `feature/aufenthalt` über `develop` auf das Testsystem (vier neue Migrationen), eigenes IMAP-Postfach, KI-Schlüssel (`FEWO_AI_API_KEY`).
1. Abstimmung mit dem Betreiber: Auslieferung von `feature/aufenthalt` über `develop` auf das Testsystem (vier neue Migrationen), eigenes IMAP-Postfach, KI-Zugang des Mandanten unter „System › KI-Anbindung“ (Dienst vorher im Betreiberbereich einschalten).
2. Fachliche Abnahme nach dem Drehbuch, danach die Go-live-Bedingungen G1–G8.
3. Weiterhin aus v0.10: echte Mietbedingungen und Bank, Rechtsprüfung, Bedienprobe.