- 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>
id, typ, titel, status, version
| id | typ | titel | status | version |
|---|---|---|---|---|
| START | navigation | FewoPortal – Prozessarchitektur | fachliche-sollfassung-zur-freigabe | 0.11 |
FewoPortal – Prozessarchitektur v0.11
Vollständig konsolidierte fachliche Sollfassung · 03.11.2026 · Freigabestatus: Entwurf zur Betreiberfreigabe
Dies ist die vollständige aktuelle Fachspezifikation für FewoPortal und kein separates Änderungspaket. Sie vereint die weiterhin gültigen Prozessregeln der v0.10 mit den beschlossenen Ergänzungen zu Informationsbeschaffung, Communication Handler, KI-Extraktion, optionaler Klärungsreservierung und zentraler Kanalverwaltung. Die Implementierung der neu ergänzten v0.11-Fähigkeiten ist damit nicht nachgewiesen. Der tatsächliche Code-Stand und die rechtlichen Go-live-Freigaben sind getrennt zu prüfen.
Lesen und anwenden
- Prozesslandkarte und Führungsprinzip
- A1–A6: Buchungsarchetypen
- Abwicklungsprofile, Dokumente und zentraler Kanalmanager
- P01 – Eingang und Verfügbarkeit → P02 – Konditionen und Verbindlichkeit → P03 – Verwaltung/Abrechnung → P04 – Aufenthalt → P05 – Abschluss
- Gates und Nachweise und Communication Handler / Datenbeschaffung – CH-01 bis CH-18
- Zentrale Konfiguration und Wirksamkeit, Entscheidungsregister und Offene Punkte
- Referenzszenarien mit eigener Website, Eigenbelegung, Destination Solutions und FeWo-direkt
Eine zusammenhängende Lesefassung mit allen derzeit maßgeblichen Fachtexten steht unter 00_GESAMTSPEZIFIKATION_v0.11.md. Die Einzeldateien bleiben die führenden editierbaren Kapitel.
Querschnitt
| Dokument | Gegenstand |
|---|---|
| Communication Handler und Datenbeschaffung | Eingangs-/Ausgangskanäle, IMAP, KI-Kaskade, sichere Gastlinks, Nachfassen, Faktenübernahme und Abnahmen M01–M12 |
| Gates und Nachweise | Phasenabhängige Voraussetzungen, fehlende und widersprüchliche Angaben |
| Belegungskonflikte | iCal, Portalverzögerung, reservierbare Zeiträume, exklusive Sperren |
| Preis und Zahlung | Konditionen, Abrechnung, Zahlungen, Portaldaten |
| Sonder- und Supportprozesse | Änderungen, Storno, Ausnahmen und zentrale Unterstützungsfunktionen |
| V02 – Vermarktung und Gästebindung | Fachliche Schnittstelle; kein Loyalty-MVP |
Unveränderliche Grenzen gegenüber v0.10
- Bestehende Angebots-Vorreservierung: Nicht neu konzipiert. Die Einstellungen
Angebots-Hold = 0(Auskunft unter Vorbehalt) undKlärungsblock = 0(keine kurzzeitige Sperre während der Datenbeschaffung) sind zwei verschiedene Werte. - Neue Klärungsreservierung: Optional und ausschließlich für noch unverbindliche unvollständige A1/A2-Anfragen. Bei V1 Mindestqualifikation Wohnung, eindeutiger Zeitraum, verwendbarer E-Mail-Kontakt und positive Verfügbarkeitsprüfung. Nur der tatsächliche Sperrstatus darf gegenüber dem Gast behauptet werden.
- Verbindliche externe Direktbuchungen: Bleiben trotz fehlender Gastangaben wirksam; keine nachträgliche eigene Angebotsannahme, kein Klärungsgate.
- iCal und bestehende Portalparser: Bestehende Buchungsereignisregeln und operative Synchronisationslogik behalten ihre Geltung; der Communication Handler ergänzt Quellen/Informationen und blockiert sie nicht.
- Nur ein Buchungsvorgang je Geschäftsfall, keine neue Prozessengine/Queue. Der zentrale Kanalmanager ist eine führende gemeinsame Verwaltung der Konfiguration, nicht eine zweite Buchungsengine.
Geltung, Dokumente und Archiv
- Die im Hauptverzeichnis, unter
V01_Buchung_und_Aufenthalt/,Querschnitt/undSzenarien/dokumentierten Regeln bilden zusammen die aktuelle v0.11-Sollfassung. Die aktiven Kapitel haben die Versionskennung0.11, auch wenn ihr fachlicher Inhalt aus v0.10 übernommen wurde. - Die Dateien unter
Referenzen/sind Quellen- und Belegmaterial, keine eigenständigen neuen Normen. Ihr historisches Versionsdatum bleibt unverändert. - Die vollständige Original-v0.10 mit Originaldokumenten, Audit, damaligen Umsetzungs-/Abnahmeprotokollen, Screenshots und Vault-Dateien liegt unverändert als Historie/Prozessarchitektur_v0.10_ORIGINAL.zip bei. Sie ist nicht parallel gültig. Ihre technischen und rechtlichen Prüfstände belegen nur v0.10.
- Die Beschlussquelle für den neuen Bereich liegt in Historie/CH_Entscheidungsstand_2026-11-03_v4.md. Die normative aktuelle Regel ist die CH-Querschnittsdatei.
- Die Konsolidierungsprüfung erklärt Herkunft, Änderungen und technische Freigabevorbehalte. Es wurde kein aktueller Repository-Code geprüft.
Offene Nachweise vor produktivem Go-live
Die v0.11 ist als Fachspezifikation selbstständig nutzbar. Für Umsetzung und produktive Freigabe bleiben die in Offene Fragen benannten fachlich bereits abgegrenzten Validierungen offen: Code-Ist-Abgleich, Betriebs-/KI-Parameter, rechtliche und datenschutzrechtliche Kommunikation/Links sowie Regressionstests der bestehenden iCal-/Portal-/Angebotsprozesse. Diese Punkte sind kein Auftrag, bereits beschlossene Geschäftsgrundsätze neu zu diskutieren.