# Jinkendo – KI-Gateway, Providerzugriff & Privacy Blueprint **v0.1 · 16.10.2026 · Spezial-Blueprint 2 nach Phase 3.3 · technischer Entwurf, keine Implementierung** ## 1. Geltung und Nachweis Dieser Blueprint beschreibt den produktlokalen Übergang von autorisiertem Anwendungskontext zu einem KI-Modell und zurück. Er konkretisiert Providerrollen, Datenminimierung, vollständige Egressprüfung, Maskierung, Transport, Antwortvalidierung und Fehlerbehandlung. Primäres Vorbild ist Kanshōs Privacy Gateway. Mitais Prompt-/Platzhalter-/Workflow-System bleibt die primäre vorgelagerte Laufzeit; dessen eigener Spezial-Blueprint folgt gesondert. Grundlage sind [Referenzarchitektur A v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/A_Jinkendo_Technical_Reference_Architecture.md), [Foundation B v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/B_Implementation_Blueprint_Application_Foundation.md), [Entscheidungen C v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/C_Technical_Decisions_Open_Issues.md), [Auth-/Session-/Scope-Blueprint](C:/Dev/jinkendo-phase3-3-auth-session-scope-blueprint-2026-10-16/Jinkendo_Auth_Session_Scope_Blueprint.md) und [Release-/Betrieb-/Recovery-Blueprint](C:/Dev/jinkendo-release-betrieb-recovery-blueprint-2026-10-16/Jinkendo_Release_Betrieb_Recovery_Blueprint.md). Beschlossene ADRs bleiben maßgeblich, besonders ADR-02/04/09/10/12/13/14. [ADR-09](C:/Dev/jinkendo-architecture-consolidation-phase2-v0.2-2026-10-15/05_Architecture_Decision_Register.md) erlaubt produktbezogen lokale Verarbeitung oder autorisierte minimierte Weitergabe an geeignete Anbieter. Er erteilt keine pauschale Providerfreigabe und schwächt Kanshōs eigene Privacy-Invarianten nicht ab. Dieser Blueprint trifft keine neue rechtliche Bewertung und aktiviert keinen Anbieter. **Nachweis:** V = vorgeschlagene technische Ausgestaltung; I = vorhandene statisch nachgelesene Implementierungsreferenz; T = tatsächlich bestandener Test mit Stand, Umfang und Umgebung; K = noch nicht integrierte/getestete Kombination. Dieses Dokument samt Code-/Payloadbeispielen ist **V/K**. Produktquellen und Testassertionen sind I; es wurden keine Anwendungstests oder Modellaufrufe ausgeführt. Keine Produktionsreife und keine vollständige semantische Erkennung werden behauptet. Es entstehen keine gemeinsame KI-Plattform, zentrale Tenant-Datenbank, SSO-, Billing- oder Worker-Infrastruktur. Bestehende Anwendungen bleiben unverändert. Die tatsächliche spätere Umsetzung betrifft nur ein ausdrücklich benanntes Zielrepository. ### 1.1 Verträge und Defaults | Verbindlicher Vertrag | Bevorzugter technischer Default | |---|---| | Nur aktuell autorisierte Daten aus dem expliziten Scope, für registrierten Zweck | Produktlokaler `ModelGateway`; pro Anfrage materialisierter unveränderlicher Kontext | | Class-A-/Local-only-Inhalte verlassen ihre erlaubte Vertrauenszone nicht | Externe Generate-Aufrufe mit Klasse A verweigern; B minimieren/maskieren; C kontrolliert generisch | | Persönlicher Egress durchläuft die vollständige Pipeline; kein Direktaufruf oder Ausfallbypass | Kanshō-Manifest, lokale semantische Detection, bestätigte Registry und Prüfung des endgültigen Payloads | | Detect, Generate und Tools sind getrennte Empfänger-/Zweckverträge | Lokaler explizit registrierter Detect-Endpunkt; externer Generate-Adapter nur bei geeigneter Route | | Kein ungeprüftes Downgrade, kein Export lokaler Mappings oder Sessiondaten | Kein automatischer Modell-/Providerfallback, kein Remote-Klartext-Detect im neuen Standard | | Anbieterfähigkeit wird belegt und technisch erzwungen, nicht aus einem Boolean geraten | Versionierte Providerprofile und Policybelege; OpenRouter als vorhandener Adapterkandidat | | Kein Netzaufruf in offener Fachtransaktion; Audit und fachlicher Ergebniswrite atomar | Drei kurze DB-Phasen um lokale Verarbeitung/HTTP herum | | Antwort bleibt untrusted; keine selbstständigen Tools/DBwrites | Vollständig gepufferte Text-/JSONantwort; lokale Validierung und Rehydration | | Ressourcen und Mehrfachausführung begrenzt; unbekannte Kosten nicht null | Ein Generate-Versuch pro Call; persistente lokale Call-ID/Idempotenz; Verbrauchsport für nächsten Blueprint | Timeouts, Größen, Dateinamen, Transportadapter und Chunkgrößen sind begründet anpassbare Defaults. Datenraum-/Privacy-/Releaseverträge bleiben bestehen. Eine begründete lokale Anpassung mit passenden Tests erfordert keinen neuen ADR oder zusätzlichen allgemeinen Freigabezyklus. ## 2. Vorhandene Mechanismen und gezielte Anpassung Ausgangspunkt sind [Phase-3.1-Wissenselemente](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/A01_knowledge_elements.json), [Quellen](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/sources.json), [Tests](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/tests.jsonl) und Kanshōs führende [Guardrails](C:/Dev/Kansho/docs/architecture/functional/guardrails.md:175). Nachgelesen wurden gezielt die relevanten Funktionen; keine neue Gesamtanalyse der Repositories. | Referenz I | Wiederverwenden | Erforderliche Zielanpassung V/K | |---|---|---| | Kanshō KI-KAN-09: [Gateway](C:/Dev/Kansho/backend/privacy_gateway.py:1044), [Maskierung](C:/Dev/Kansho/backend/privacy_gateway.py:705), [Pre-Egress-Gate](C:/Dev/Kansho/backend/privacy_gateway.py:1257) | Reihenfolge vor Modellaufruf, requestbezogenes Manifest, spanbasierte Ersetzungen und lokale Rückübersetzung | Alle tatsächlich versandten Nachrichten/Felder erfassen; keine nachträglichen ungescannten Ergänzungen; Snapshot-/Payloadbindung für vorab geprüfte Mappings | | Kanshō: [Manifesttypen](C:/Dev/Kansho/backend/privacy_gateway.py:149), [Antwortprüfung](C:/Dev/Kansho/backend/privacy_gateway.py:897) | Aktive Ersetzungen, Alias-/Oberflächenformtrennung und interne Prüffassung | Mappings nur im lokalen Callkontext; ausschließlich tatsächlich ausgegebene/aktive Tokens rehydrieren, keine fremden/inaktiven Tokens nachschlagen | | Kanshō KI-KAN-10: [Providerrollen](C:/Dev/Kansho/backend/providers.py:160), [Transport](C:/Dev/Kansho/backend/providers.py:242), [Profilprüfung](C:/Dev/Kansho/backend/provider_settings.py:48) | Getrennte Detect-/Generate-Konfiguration, kleiner HTTP-Adapter, Usage/Finishreason | Keine pauschale Vertrauensannahme für private IPs/`.local`; keine ZDR-Zusage aus lokalem Default; exakte Endpunkt-/Routenprüfung; keine Providerfehlertexte an Clients | | Kanshō KI-KAN-11: [Kontextaufbau](C:/Dev/Kansho/backend/context_builder.py:67), [Budgetprüfung](C:/Dev/Kansho/backend/prompt_budget.py:243) | Zweckbezogene Materialisierung und explizite Größen-/Kontextgrenze | Zugriffs- und Quellenrevisionen binden; Zeichenschätzung nicht als exakten Tokenizer oder Privacybeweis behandeln | | Mitai KI-MIT-09/10: [Promptausführung](C:/Dev/mitai-jinkendo/backend/prompt_executor.py:166), [Modellcallback](C:/Dev/mitai-jinkendo/backend/prompt_executor.py:290) | Übergabepunkt nach vollständiger Platzhalterauflösung/Frageergänzung | Callback ruft ausschließlich Gateway auf; keine direkte Providerclosure, aufgelösten Werte/Promptvolltexte nicht automatisch debuggen; JSONschema tatsächlich validieren statt nur JSON parsen | | Shinkan KI-SHK-08: [REST-Client](C:/Dev/shinkan-jinkendo/backend/openrouter_chat.py:95), [Textblöcke](C:/Dev/shinkan-jinkendo/backend/openrouter_chat.py:50) | Kleiner Adapter statt zusätzlichem Agentenframework; bekannte Textvarianten | Refusal/Tool-/Reasoningblöcke unterscheiden; unbekannte Formen verweigern; keine Raw-HTTP-/Providerfehlerschnipsel weiterreichen | | Kairo KI-KAI-14: [Secretreferenzprüfung](C:/Dev/kairo-jinkendo/backend/config_service.py:17) | Konfiguration ohne rohe Secretwerte | Produktlokaler Providerprofiladapter, keine eigene zweite Connection innerhalb der Fach-UoW übernehmen | Kanshō dokumentiert ausdrücklich, dass technische Detectionabdeckung keine semantische Vollständigkeitsgarantie ist und neue unbekannte Identitäten ungelöste Fälle erzeugen können. [Guardrails 22.2](C:/Dev/Kansho/docs/architecture/functional/guardrails.md:682). Bestehende Remote-Detect-/Lernmodusübergänge sind produktlokal dokumentierte Ausnahmen; der neue Standard übernimmt sie nicht automatisch. Er ändert sie im Bestand auch nicht. Kein `KANSHO_ALLOW_REMOTE_DETECT`- oder Fake-Provider-Runtimeflag wird als allgemeiner Familienmechanismus eingeführt. ## 3. Komponenten und Schnitt zur Prompt-/Workflow-Laufzeit ```text Fachroute → Fachservice / ContextMaterializer → Prompt-/Workflow-Renderer → ModelGateway → PurposePolicy / aktuelle Accessprüfung → vollständige Textinventur / Minimierung / Detect / Registry → MaskingManifest / finale Payloadprüfung / DispatchPermit → genau ein registrierter ProviderTransport → Envelope-/Inhalts-/Schema-/Privacyprüfung / lokale Rehydration → frische Autorisierung / Fachservice-Ergebniswrite oder sichere Ausgabe ``` | Baustein | Aufgabe | |---|---| | `modules/ai_gateway/service.py` | Gesamtablauf und Phasensteuerung; keine Prompt-DB-/Workflowengine neu entwickeln | | `contracts.py`, `policies.py` | Typisierte Calls/Ergebnisse, Zweck-/Datenklassen-/Ausgabeverträge | | `privacy/inventory.py` | Alle endgültigen Textkanäle und kontrollierten technischen Felder erfassen | | `privacy/detect.py`, `mask.py`, `response.py` | Kanshō-Mechanismen angepasst an unveränderliche Calls und vollständige Abdeckung | | `profiles.py`, `routing.py` | Aktuelle Profil-/Policyrevision, Empfängerrolle, Eignung und Capabilityprüfung | | `transports/openrouter.py`, optional `local_detect.py` | Protokolladapter mit strengem Endpoint, Secretinjektion und begrenztem HTTP | | `repository.py` | Callledger und Audit auf explizitem Transaktionshandle | | Fach-/Promptadapter | Scoped Quellen materialisieren, Vorlage rendern, Outputtyp registrieren; Gateway konsumieren | `create_app(settings, providers)`/Lifespan der Foundation verdrahten diese Adapter. Nur Transportmodule dürfen Modell-HTTP ausführen. Direkte Provider-SDK-/HTTP-Aufrufe in Renderern, Feature-Routern, Diagnosen, Lern-/Precomputejobs oder Workflownodes sind kein zulässiger zweiter KI-Pfad. Andere fachliche HTTP-Integrationen werden dadurch nicht zu Modelladaptern erklärt. Mitai liefert nach Auflösung aller Variablen und Augmentierungen `RenderedPrompt`, nicht bereits einen externen Call. Das Gateway darf vor Versand keinen fachlichen Promptteil auslassen. Ergebnis-/Formatinstruktionen werden **vor** der vollständigen Egressinventur ergänzt. Der nachfolgende Workflow-Blueprint muss dieselben DTOs und Fehler-/Idempotenzverträge verwenden. Jeder Modellnode und jeder erneute Aufruf erhält eine eigene Call-ID und durchläuft erneut das Gateway; eine alte Maskierungsfreigabe gilt nicht für neue Nodeinputs. Erster Implementierungsschnitt: Textnachrichten, keine externen Tools/Plugins, keine Bilder/Audio-/Dateiuploads oder Remote-URLs, keine autonomen Agenten. Nicht registrierte Modalitäten werden verweigert. Spätere Erweiterungen benötigen denselben Empfänger-, Inhalts-, Test- und Datenschutzvertrag; sie werden nicht durch `dict[str, Any]` still akzeptiert. ## 4. Datenklassen, Identität und Quellenvertrag `RequestContext` kommt unverändert aus Phase 3.3: geprüfter Principal, expliziter Scope und Request-ID. `profile_id`, Rollen, Policyklasse, Provider-URL und `privacy_checked=true` aus einem Browserbody sind keine Autorität. Ein Fachzweck ist in einer immutable Registry registriert und bestimmt Mindestschutz, erlaubte Quellen, Modellprofil und Ausgabeschema serverseitig. | Klasse | Anwendung im Gateway | |---|---| | A / Local only | Externer Generate verweigert; Geheimnisse, vollständige Identityregistry/Mapping und nicht erforderliche Rohdaten gehören nicht in den externen Kontext. Ein lokaler Fachfallback ist eine eigene registrierte Funktion. | | B / persönlicher Kontext | Nur notwendige autorisierte Daten, vollständige lokale Detection/Registry-/Maskierungsprüfung, geeignete externe Route. Pseudonymisierung ist keine behauptete Anonymisierung. | | C / generischer Kontext | Nur tatsächlich nicht persönliche freigegebene Inhalte. Gemeinsamer Gateway-/Endpoint-/Fehlerpfad bleibt bestehen; C ist kein Umbenennen persönlicher Daten. | Materialisierung klassifiziert Quellen/Felder anhand des Produktvertrags. Enthält eine Anfrage erforderliche Local-only-Bestandteile, darf sie nicht durch bloße Gesamtkennzeichnung B/C passieren. A-Felder müssen vor externem Rendering begründet ausgeschlossen sein; sonst Blockade. Bekannter Personenbezug in vermeintlichem C führt zur strengeren B-Prüfung, sofern für den Zweck zugelassen, andernfalls Ablehnung. Fehlende/unklare Klassifikation wird nicht C. Im ersten Schnitt ist C auf registrierte generische Vorlagen-/Katalogquellen begrenzt. Freier Usertext, persönliche Historie oder materialisierte Personendaten sind mindestens B; ein generischer Zweckname stuft sie nicht herunter. Ein lokaler vorgelagerter ForbiddenContentGuard verweigert bekannte Secrets, Private-Keyblöcke, credentialhaltige URLs/DSNs und als Local-only definierte direkte Identifikatorfelder vor Weiterverarbeitung. Dafür werden konkrete Struktur-/Secretregeln verwendet, keine Food-/Namensheuristiken als Ersatz für semantische Detection. Auch diese Prüfung behauptet keine vollständige Erkennung unbekannter Geheimnisse in beliebigem Freitext. `SourceBinding` enthält lokal Objekttyp/-ID, erwartete Version, Owner-/Scopebindung und ausgewählte Felder. Alle Quellen werden mit derselben AccessPolicy und scoped Repositoryabfragen geladen, einschließlich RAG-/Graph-/Memory-/Toolresultatquellen. Öffentlicher/globaler Katalog ist eine ausdrücklich erlaubte Quellenart, kein Join auf fremde private Daten. Bereits erzeugter Modelltext bleibt untrusted Eingabe und erhält keine höhere Anweisungspriorität. Der Dispatcher lädt niemals „alle Profile“ als Kontext. Minimierung ist eine Produktfeld-/Quellenauswahl, kein bloßes `strip()` oder pauschales Abschneiden. Bei Budgetüberschreitung wird abgebrochen oder im Fachadapter ein ausdrücklich anderer kompakter Kontext neu erzeugt; dieser durchläuft erneut die gesamte Pipeline. Keine unsichtbare providerseitige Kontextkompression. ## 5. Python-Verträge und lokale Identitäten Illustrative Schnittstellen V/K. Importpfade für `RequestContext`, `ScopeRef` und Foundation-UoW werden im Zielprojekt aus den vorhandenen Verträgen übernommen. Inhalte sind im Speicher vertraulich, auch wenn `repr=False` ihre versehentliche Repräsentation reduziert. ```python from dataclasses import dataclass, field from typing import Literal, Protocol from app.core.context import RequestContext @dataclass(frozen=True, slots=True) class SourceBinding: kind: str source_id: str version: str selected_fields: tuple[str, ...] @dataclass(frozen=True, slots=True) class PromptMessage: role: Literal["system", "developer", "user", "assistant", "tool"] content: str = field(repr=False) @dataclass(frozen=True, slots=True) class RenderedPrompt: template_id: str template_revision: str messages: tuple[PromptMessage, ...] = field(repr=False) sources: tuple[SourceBinding, ...] @dataclass(frozen=True, slots=True) class GatewayCall: call_id: str execution_id: str node_key: str purpose: str rendered: RenderedPrompt = field(repr=False) result_spec_id: str @dataclass(frozen=True, slots=True) class UsageReport: input_tokens: int | None output_tokens: int | None reported_cost: str | None currency: str | None status: Literal["reported", "estimated", "unknown"] @dataclass(frozen=True, slots=True) class ModelResult: call_id: str content: str = field(repr=False) result_spec_id: str usage: UsageReport class ModelGateway(Protocol): async def complete(self, context: RequestContext, call: GatewayCall) -> ModelResult: ... ``` Ein `RenderedPrompt` ist ein internes Ergebnis des autorisierten Render-/Materialisierungsadapters, kein frei deserialisiertes APIobjekt. `purpose`, ResultSpec und Vorlagenrevision werden gegen registrierte serverseitige Definitionen geprüft. ResultSpec legt `text` oder ein konkretes Pydanticmodell, maximale Länge, erlaubte Werte und rehydrierbare Textpfade fest. `ModelResult.content` ist bei JSON eine validierte kanonische JSONzeichenkette; Fachadapter erhält anschließend das explizite lokale DTO. Keine rohen Providerdicts. Providertransport erhält **weder** `RequestContext` noch `SourceBinding` oder Manifest. Er bekommt eine interne `SealedEgress`-Struktur: Call-ID, registrierte Route-/Profil-/Policyrevision, unveränderliche Bodybytes, Bytehash, Größenlimit, Deadline und eine kurzlebige interne `DispatchPermit`. Diese Objekte werden ausschließlich durch die Gatewaypipeline erstellt, nicht aus einem Clientflag. Sie sind lokale Programmgrenzen, kein Kryptografiebeweis gegen kompromittierten Servercode. Hier bezeichnet `SealedEgress` den **Generate**-Ausgang. Die vorgelagerte lokale Detection verwendet einen getrennten typisierten `LocalDetectInput(call_id,inventory_revision,text_fields)` und `LocalDetectTransport`: nur nach T1/ForbiddenContentGuard, nur zum eligible lokalen Detectprofil, ohne Registry-/Rehydrationstabelle und ohne externe Generate-Permit. Der lokale Detectadapter validiert Ziel, Größen, Rolle und Antwortschema, bevor er Coverage liefert. Er kann keine Generate-Route auswählen. So entsteht kein zirkuläres „vor Detection bereits vollständig maskiert“-Erfordernis und kein als Detect getarnter externer Klartextpfad. Der kleine Detect-Port präzisiert die Rückgabe. Coveragebereiche werden **lokal vom Adapter** aus tatsächlich erfolgreich verarbeiteten Chunks aufgebaut, nicht aus einer Modellbehauptung übernommen. Spans werden am exakt gebundenen Text validiert. ```python @dataclass(frozen=True, slots=True) class TextField: path: str revision: str text: str = field(repr=False) @dataclass(frozen=True, slots=True) class LocalDetectInput: call_id: str inventory_revision: str text_fields: tuple[TextField, ...] = field(repr=False) @dataclass(frozen=True, slots=True) class DetectedSpan: field_path: str start: int end: int observed: str = field(repr=False) entity_type: Literal["PERSON", "PLACE", "ORG", "PROJECT"] @dataclass(frozen=True, slots=True) class DetectionCoverage: inventory_revision: str detector_profile_revision: str processed_ranges: tuple[tuple[str, int, int], ...] spans: tuple[DetectedSpan, ...] = field(repr=False) class SemanticDetector(Protocol): async def detect(self, request: LocalDetectInput) -> DetectionCoverage: ... ``` Die lokale `MaskingManifest`-Variante übernimmt Kanshōs aktive Ersetzungen, Typen, Vorkommen und Rehydrationstabelle, ergänzt aber zwingend Call-ID, Subject/Scope-Namespace, genaue Inventur-/Payloadrevision, Detection-/Registry-/Reviewrevision und technische Coverage. Keine dieser Zuordnungen wird in externe Metadaten oder globale mutable Variablen gelegt. Gleichzeitige A-/B-Calls besitzen getrennte Manifeste; kein globales `last_trace` als Quelle persönlicher Ergebnisse. ## 6. Providerprofile, Trust Zones und Eignung Ein Profil ist produktlokal versioniert und enthält ausschließlich Konfiguration/Secretreferenzen. Konkrete erforderliche Felder: | Gruppe | Felder / Regel | |---|---| | Identität | `profile_id`, `revision`, `adapter_kind`, Rolle `detect|generate`, Status `disabled|unverified|eligible` | | Ziel | Exakte erlaubte Scheme/Host/Port/Path-Kombination, TLS-/CAprofil, explizite Netzwerk-/Adressgrenze, `trust_zone_id` | | Modell | Registrierte Modell-ID, erlaubte Rollen/Modalitäten, Contextwindow/Tokenizer bzw. Schätzverfahren, Ausgabegrenze, unterstützte Formate | | Privacy | Policy-ID/-revision, erlaubte Zwecke/Datenklassen, erforderlicher ZDR-/No-training-/Region-/Loggingzustand, Belegreferenzen und `checked_at`/`valid_until` | | Adapter | Erzwungene Requestparameter, erlaubte Upstreamprovider/Endpoints, Redirect-/Retry-/Transformverhalten, Transportlimitprofil | | Secret | Ausschließlich `credential_ref`; Rohwert nur im Secret-/Transportadapter, nicht im Profil-Response oder Log | Ein Boolean `zdr=true` ohne Beleg/Adapterfähigkeit reicht nicht. Eignung erfordert passende aktuelle Policy, dokumentierte tatsächliche Account-/Endpointkonfiguration und technische Erzwingbarkeit der geforderten Einschränkungen. Unbekannt/abgelaufen → Route nicht eligible. Default für erneute technische Belegprüfung sieben Tage und bei Profil-/Provideränderung; lokale Gründe können andere Fristen verlangen. Dies ist ein veränderbarer technischer Prüfzyklus, keine neue Familienfreigabe. Aktuelle Bedingungen des konkret gewählten Empfängers sind gemäß ADR-09 vor realer persönlicher Nutzung zu prüfen. Diese Lieferung aktiviert keinen Provider und liest keine Account-/Keyeinstellungen. Tests verwenden synthetische Profile/Keys. Fehlt ein realer Beleg, bleibt der betreffende Pfad geschlossen; andere Appfunktionen können weiterlaufen. ### 6.1 Detect, Generate und lokale Empfänger **Detect:** bevorzugt ein bereits vorhandener lokaler, ausdrücklich registrierter semantischer Detector. Er sieht nur den für Detection notwendigen finalen Text, keine vollständige Identityregistry, Sessioncredentials oder DBsecrets. Bestätigte lokale Identitäten werden im Gateway angewendet. Eine lokale IP oder `.local` beweist keine Vertrauenszone: Betreiber-/Zugriffs-/Logginggrenze, konkretes Ziel und Netzweg müssen zum Profil passen. **Generate:** nur maskierter/minimierter B-Kontext bzw. kontrolliertes C, passendes Modell und Providerpolicy. Kein derselbe Key als stiller Fallback zwischen Rollen. **Tools/Websuche/Embeddings/Transkription:** eigene spätere Zweck-/Empfängerpfade; im ersten Schnitt nicht aktiviert. OpenRouter-ZDR ist keine Freigabe aller zusätzlich einschaltbaren Tools. Neuer Standard: kein externer Klartext-Detect, auch nicht allein wegen `APP_ENV=development`. Persönliche Development-/Testdaten bleiben persönlich; CI arbeitet synthetisch. Kanshōs ausdrücklich beschriebene Übergänge bleiben dortige Bestandsregeln und werden im Reuseadapter als Abweichung dokumentiert. Es entsteht kein neuer Runtime-„Privacy aus“-Schalter und kein notwendiger neuer Detectdienst in diesem Auftrag. Ohne vorhandenen geeigneten Detect-/Reviewadapter bleibt B-Egress geschlossen. ### 6.2 Endpunkt- und Secretgrenze Keine URL, Base-URL, Proxyadresse oder Callbackadresse aus Fach-/Browserinput. Nur registrierte Adapterziele; HTTPS mit Zertifikatsprüfung extern, HTTP ausschließlich für explizit erlaubte kontrollierte lokale Empfänger. Keine Userinfo/Secrets in URLs, keine frei wählbaren Header, keine Redirects. `openrouter.ai` wird exakt geprüft; ein Anzeigename oder `endswith('openrouter.ai')` ist keine Zielautorität. DNS-Auflösung und tatsächlicher Verbindungsweg müssen die registrierte Zielgrenze einhalten. Netzwerkregeln des vorhandenen Containers/Hosts begrenzen den Adapter zusätzlich; DNS-Rebinding auf Loopback/Metadata-/fremde private Ziele darf kein neues Ziel öffnen. Eine pauschale Freigabe aller RFC1918-/Link-local-Adressen ist ausgeschlossen. Erforderliche lokale Adressen werden ausdrücklich registriert. Kann ein Adapter seine Verbindungsgrenze nicht gewährleisten, wird er nicht als eligible markiert. HTTPX verwendet `trust_env=False`, keine impliziten Proxy-/CAumgebungswechsel, und ein ausdrücklich konfiguriertes TLS-/CAprofil. Client wird im Lifespan wiederverwendet und geschlossen; Keys werden nur für das konkrete legitime Authheaderziel injiziert. Provider-APIkeys sind notwendige Transportcredentials dieses Empfängers, keine erlaubten Modellkontextfelder. App-/DB-/Sessionsecrets und Mappingdaten gehen niemals in Payload, Attribution oder URL. [HTTPX Umgebungsvariablen](https://www.python-httpx.org/environment_variables/). ### 6.3 Konkreter OpenRouter-Adapter OpenRouter ist ein vorhandener Adapterkandidat, kein Architekturzwang. Für entsprechend freigegebenen B-Egress setzt der Adapter insbesondere: ```json { "model": "registered-model-id", "messages": [{"role": "user", "content": "Freigegebener maskierter Text"}], "max_tokens": 2048, "stream": false, "provider": { "only": ["registered-upstream-slug"], "allow_fallbacks": false, "require_parameters": true, "data_collection": "deny", "zdr": true } } ``` Platzhalter-IDs werden aus dem passenden eligible Profil eingesetzt; keine aktuelle Modell-/Providerempfehlung oder bereits erteilte Freigabe. Keine Modellfallbackliste, Auto-Router, Tools, Plugins oder dynamischen Presets. Providerseitige Kontextkompression/zusätzliche Transformation ist für persönliche Payloads nicht zugelassen; die konkrete Deaktivierung muss der eingesetzte Adapter nachweisen. Der Gatewayadapter setzt Filter selbst; ein Renderer darf sie nicht überschreiben. Die Parameter `only`, `allow_fallbacks`, `require_parameters` und `data_collection` werden in der [OpenRouter-Routingdokumentation](https://openrouter.ai/docs/guides/routing/provider-selection) beschrieben. Bei fehlender geeigneter Route wird abgebrochen. Ein Providername allein belegt keine verlangte Region; wenn Region verpflichtend ist, braucht das Profil einen passenden tatsächlich erzwingbaren Endpoint-/Routingnachweis. `provider.zdr=true` ist separat erforderlich; ein lokaler No-training-Boolean bzw. `data_collection` allein wird nicht als vollständiger Retentionsnachweis dargestellt. OpenRouter beschreibt ZDR für Inferenzrouting, weist Tools/Plugins eigene Policies zu und zählt bestimmte In-memory-Caches nicht als Retention. Daher bleibt die konkret benötigte Schutzwirkung zu prüfen. [OpenRouter ZDR](https://openrouter.ai/docs/guides/features/zdr). Das sind begrenzte technische Gegenprüfungen, keine Aussage, jeder aktuelle Endpoint erfülle Jinkendos Anforderungen. ## 7. Ablauf und sichere Transaktionsgrenzen ### 7.1 Phase T1: autorisierte Aufnahme In einer kurzen Foundation-UoW: aktuelle Session/Principal, Scope, Fachcapability und gegebenenfalls Entitlement prüfen; alle ausgewählten Quellen samt Version/Owner-/Scopegrenze materialisieren; unveränderlichen lokalen Snapshot erzeugen. Call-ID/Idempotenz registrieren und sicheren Auditmetadatensatz schreiben. Kein Modell-/Detector-/HTTP-Aufruf in dieser Transaktion. Der Renderer verarbeitet nur diesen autorisierten Snapshot und freigegebene Vorlagen-/Formatinstruktionen. Die Berechtigung wird nicht aus den später vom Renderer eingetragenen `SourceBinding`-Strings geglaubt. Der Materialisierungsadapter erzeugt und bindet sie serverseitig. Nicht benötigte Felder werden vor Rendering ausgeschlossen. Eine nachträglich hinzugefügte Quelle verlangt erneute autorisierte Aufnahme. ### 7.2 Lokale Verarbeitung ohne offene DB-Transaktion Vollständige Vorlage inklusive System-/Developer-/Historien-/Userteilen und statischem Outputvertrag fertigstellen. Inventur/Minimierung/Budgetprüfung durchführen. Für B den gesamten endgültigen Text lokal untersuchen, bestätigte eigene Registry ergänzen, offene Konflikte behandeln, requestbezogen maskieren. Payload einschließlich Adapterparameter fertigstellen und final validieren/sealen. Reihenfolge und Bindung stehen in Abschnitt 8/9. Ein Reviewbedarf wird als `privacy_review_required` an den Fachadapter zurückgegeben. Generate wurde dann nicht aufgerufen. Vorhandene lokale Reviewmechanismen dürfen verwendet werden; fehlt ein geeigneter Adapter, bleibt dieser Fall geschlossen. Dieser Blueprint baut kein neues allgemeines Reviewportal und verlangt keine pauschale Bestätigung jeder Anfrage. ### 7.3 Phase T2: aktueller Dispatchentscheid Unmittelbar vor Transport erneut unter kurzer UoW prüfen: aktueller Principal/Sessionsgeneration/Kontostatus, Scope/Mitgliedschaft, Fachrecht, alle Quellenversionen, Vorlagenrevision, aktive Policy-/Registry-/Providerprofilrevision und gegebenenfalls genau gebundene Reviewentscheidung. Weicht benötigter Kontext ab, `context_changed` statt Versand eines alten Snapshots. Keine stillschweigende Neuzusammenstellung nach der Privacyprüfung. Bei Erfolg Dispatchintent samt Call-/Payload-/Routenbindung und erforderlichem Audit committen; kurzlebige interne Permit erzeugen, Default zwei Sekunden bis Beginn des Sendens. Hat das Warten auf Transportkapazität diese Frist überschritten, erneute T2-Prüfung vor Senden. Wiederholungen dieser kurzen **lokalen Prüfung** sind keine weiteren Modellversuche. Widerruf vor dem Dispatchentscheid sperrt den Call. Zwischen DBcommit und externem Netzwerk besteht keine verteilte Transaktion. Eine Sperre unmittelbar nach dem Dispatchentscheid kann bereits freigegebene Bytes nicht zuverlässig zurückholen. Der Vertrag benennt deshalb diesen Autorisierungszeitpunkt, bindet den exakten Snapshot, hält das Zeitfenster klein und prüft nachher erneut. Es wird keine unmögliche Atomarität mit dem Provider behauptet. ### 7.4 Transport und Phase T3 Genau ein Generate-Versuch mit den geprüften Bytes; Antwort begrenzt einlesen, validieren und lokal rehydrieren. Danach erneut aktuelles Konto/Scope/Objekt-/Ausgaberecht prüfen. Bei Entzug oder Quellenkonflikt keine persönliche Antwort anzeigen oder als Fachergebnis speichern. Verbrauchs-/Fehlermetadaten des bereits erfolgten Aufrufs dürfen der Server unter eigenem engen Auditvertrag abschließen; sie geben keine Fachrechte zurück. Wenn ein Fachergebnis gespeichert wird, verwenden Ausgaberecht, erwartete Objektversion, Ergebniswrite, Callabschluss und Audit dieselbe Foundation-Transaktion. Erst nach Commit Erfolg zurückgeben. Für reine Anzeige erhält T3 einen atomaren Metadatenabschluss plus aktuelle Lesefreigabe; das Ergebnis lebt nur im Antwortspeicher. Ein danach erfolgter Scopewechsel wird zusätzlich durch die Frontend-epoch abgefangen. Fachservice/Workflow hält über den Gatewayawait keine DB-UoW offen. Der Gateway-HTTPpfad ist tatsächlich asynchron (`httpx.AsyncClient`); synchrone Psycopg-UoWs laufen über klar abgegrenzte Threadbridge-Funktionen, beispielsweise `anyio.to_thread.run_sync`. Kein blockierender SQLaufruf direkt im Eventloop und keine Connection über `await` weiterreichen. Abbruch beendet lokale Arbeit/Transport soweit möglich; ein bereits angestoßener Providercall kann trotzdem verarbeitet/berechnet worden sein. ## 8. Vollständige Detection und Maskierung ### 8.1 Inventur vor Detection Der Adapter definiert eine geschlossene Payloadschema-Version. Für den ersten Schnitt enthält sie Modell-ID, erlaubte Textnachrichten, begrenzte numerische Parameter, Streamflag, kontrollierte Providerfilter und gegebenenfalls einen registrierten statischen Outputschema-Vertrag. Keine frei ergänzbaren `metadata`, `user`, Promptsuffixe, Plugins oder Tools. Die Textinventur enumeriert **alle** endgültigen Nachrichtentexte: System, gegebenenfalls unterstützter Developerkanal, User, frühere Assistanttexte sowie jeder neu zusammengesetzte Kontext/Formattext. Tooltexte und weitere Felder sind entweder ausdrücklich unterstützt und vollständig inventarisiert oder verweigert; unbekannte Kanäle werden nicht ignoriert. Statische JSONschemabeschreibungen sind ebenfalls im Textinventar. Technische Schlüssel/Modell-/Provider-IDs stammen ausschließlich aus einer kontrollierten nicht persönlichen Registry; keine dynamischen persönlichen JSONkeys oder Schemas vom Browser. Externe `$ref`-/URLauflösung ist nicht erlaubt. Inventareintrag: stabiler lokaler Feldpfad, Textrevision, lokale Quellenbindung, UTF-8-Bytegröße und Coveragebereiche. Derselbe Textstand wird für Detection und Maskierung verwendet. Unicode-/Zeilenendenaufbereitung findet, falls überhaupt nötig, **vor** dieser Bindung statt. Danach keine Normalisierung, die Spans verschiebt. ### 8.2 Semantische Detection, Registry und Review Kanshōs requestbezogene Span-/Registrytrennung wird übernommen. Jeder notwendige Detect-Chunk muss tatsächlich erfolgreich verarbeitet und sein Ergebnis lokal am Originaltext geerdet sein: Feldpfad, Start/Ende als Python-Codepointindizes, beobachteter Text und Typ passen exakt. Schemafehler, abgeschnittene Antwort, Lücken oder Timeout verweigern B-Generate. Überlappende Chunks werden mit lokalen Offsets zusammengeführt; Randfälle dürfen weder verschwinden noch doppelt Identitäten bestätigen. `PERSON`, `PLACE`, `ORG`, `PROJECT` sind die vorhandenen Ausgangstypen. Erweiterung nur bei konkretem Produktbedarf. Bestätigte eigene Identitäten/Aliase bleiben lokale Autorität. Ein Detect-Ergebnis erzeugt keine dauerhaft bestätigte Identität. Homonyme werden pro Vorkommen behandelt; keine neuen globalen Food-/Wetter-/Großschreibungswortlisten und kein Regexfallback, der einen semantischen Detectausfall als erfolgreich ausgibt. `coverage_complete=true` bedeutet ausschließlich vollständige technische Verarbeitung des gebundenen Inventars. `semantic_identity_guaranteed=false` bleibt ausdrücklich erhalten. Ein Nulltreffer beweist nicht Identitätsfreiheit. Bekannte offene Konflikte oder erforderliche unbestätigte Entscheidungen blockieren bis zur gebundenen lokalen Klärung. Falls die konkrete Produktpolicy darüber hinaus eine geprüfte vollständige Freigabe persönlicher Eingabe verlangt, muss dieser Review-/Prüfadapter vorhanden sein; ein Fake „alles sicher“ ist unzulässig. Diese Grenze wird nicht durch neue Heuristiken verdeckt. Vorab berechnete Treffer/Reviews sind nur wiederverwendbar, wenn Subject/Scope, sämtliche Feld-/Payloadrevisionen, Quellen, Registry-/Detector-/Policyrevision und Ablauf exakt passen. Ein Boolean `full_detection_coverage=true` aus dem Aufrufer reicht nicht. Ein bloßer Review des letzten Nutzersatzes deckt nicht automatisch Systemtext, Historie, RAG und spätere Renderergänzungen ab. Nicht abgedeckte Felder durchlaufen weiterhin Detection. Ändert sich die Vorlage oder ein nachgelagerter Nodeinput, gilt der alte Nachweis nicht. ### 8.3 Pseudonyme und lokales Manifest Spanersetzungen aus Kanshō werden von hinten nach vorne auf den gebundenen Text angewandt. Überlappungen werden deterministisch aufgelöst oder als unklar verweigert; bestätigte Alias-/Identitätsregeln bleiben getrennt von unbestätigten Treffern. Nur tatsächlich eingesetzte Ersetzungen werden aktiv. Der Manifestnamespace ist mindestens Produkt + Scope + Subject + Call; ein Token aus B wird nie über A aufgelöst. Vorhandenes Syntaxmuster `[[PERSON:01]]` bleibt als lokaler Adapterdefault möglich. Tokens sind innerhalb des Calls konsistent. Bestätigte lokale Identität kann intern über Calls stabil sein; extern wird standardmäßig pro Call neu zugeordnet, damit kein globales Personenkennzeichen entsteht. Kontextübergreifende stabile externe Pseudonyme sind keine Foundationpflicht. Aliase enthalten keine zusätzlichen Krankheiten, Herkunfts- oder Beziehungsinformationen. Untrusted Eingabe darf die reservierte Identitätstokensyntax nicht selbst als Mappingbefehl einschleusen. Default: entsprechende rohe Tokens in neuen Quell-/Usertexten mit `reserved_identity_syntax` verweigern. Ein später tatsächlich benötigter Literaladapter kann sie eindeutig getrennt kodieren und muss getestet sein; kein stilles Verschlucken legitimen Inhalts. Vertrauenswürdige Vorlagen erzeugen konkrete aktive Tokens nur über den Manifestadapter. Rehydrationstabelle enthält nur autorisierte **aktive** Tokens des Calls, nicht die ganze Profilregistry. Bestätigte Aliase können kanonisch, unbestätigte Requesttreffer in beobachteter Schreibweise rehydriert werden, entsprechend Kanshō. Kein Provider, Debugclient oder fremder Scope erhält diese Tabelle. Standardlebensdauer ist die Anfrage; nach Abschluss/Abbruch Referenzen freigeben. Persistente Quelldaten/Registries bleiben lokale Produktdaten und werden nicht als temporäre Diagnose gelöscht. ## 9. Finales Egress-Gate und unveränderlicher Transport Nach Maskierung werden alle erlaubten Provider-/Formatparameter ergänzt, ein striktes endgültiges Payloadschema validiert und sämtliche ausgehenden Textfelder gegen das Manifest geprüft. Bekannte zu maskierende Identitätsvorkommen müssen ersetzt, technische Felder kontrolliert, Class-A-Felder entfernt und alle notwendigen Coverage-/Reviewbindungen gültig sein. Fehlender Beleg oder eine nicht unterstützte Zusatzoption sperrt den Versand. Der Registry-Safety-Net-Adapter prüft die erwarteten zu schützenden Vorkommen im vollständigen Inventar, nicht ausschließlich bereits erfolgreich als `manifest.replacements` eingetragene Treffer. Eine zuvor ausgelassene bekannte Identität darf nicht dadurch unsichtbar werden, dass sie nie als aktive Ersetzung registriert wurde. Vorkommensbezogene Homonym-/Reviewregeln bleiben dabei bestehen; unbekannte semantisch übersehene Identitäten werden weiterhin nicht als garantiert erkannt dargestellt. Serialisierung: deterministische JSONbytes in UTF-8, `ensure_ascii=False`, kompakte Separatoren, stabile Schlüsselreihenfolge, `allow_nan=False`; ungültige Surrogate oder nicht erlaubte Werte verweigern. Der interne Bytehash bindet **genau** diese Bytes an Route/Profil/Policy/Manifest/Call. Der Transport sendet `content=sealed.body` mit festem JSON-Content-Type, nicht erneut `json=`. Keine SDK-/Middleware, die anschließend Promptteile/Tools/Metadaten anhängt. Die einzige anschließende Ergänzung sind kontrollierte Transportheader, insbesondere der für genau diesen Empfänger benötigte Provider-Authheader. Keine Principal-/Profil-IDs, Cookie-/Sessionheader, freie Useragentzusätze oder rohe Quellnamen als Attribution. Request-ID/Call-ID bleibt lokal, sofern kein explizit geprüfter Transportvertrag eine nicht persönliche Korrelation benötigt. Finaler Endpoint und tatsächlicher Verbindungsweg sind Teil des Gates. Vor `.send` verlangt der Adapter gültige Permit, passende Profil-/Policyrevision, Hash/Größe und freie Kapazität. Re-Rendering oder Änderung an Body, Schema, Modell, Route, Schlüsselzuordnung oder Prompt nach dem Gate macht den Seal ungültig. Ein Sendversuch konsumiert die interne Permit. Ein zweiter Generate benötigt eine neue explizite Callentscheidung; der Workflow kann nicht dieselbe Permit beliebig wiederverwenden. Secretreferenzen liefern eine begrenzte Credentialversion zusätzlich zum Rohwert; die Version ist an die Route/Permit gebunden, der Rohwert bleibt nur im Transport. Eine zwischenzeitlich geänderte Zuordnung darf nicht denselben geprüften Call an ein anderes Konto/Ziel schicken. Der interne Status `sent_or_unknown` und ein begrenzter Providerrequestbezug können lokal gespeichert werden; ein möglicherweise vom Provider gelieferter Freitextbezug wird nicht ungeprüft als ID übernommen. Eine spätere Antwortprüfung kann einen bereits erfolgten Datenversand nicht rückgängig machen. Deshalb müssen Canary-/Wiretests den tatsächlichen Adapterausgang untersuchen und nicht nur prüfen, dass eine Maskierungsfunktion aufgerufen wurde. ## 10. Transportgrenzen, Abbruch und Wiederholungen ### 10.1 Ressourcenprofil | Einstellung | Technischer Ausgangswert | |---|---| | Gesamter Gatewaylauf einschließlich Detect/Queue/Generate | 90 Sekunden monotone Deadline; Fachzwecke dürfen begründet andere begrenzte Werte wählen | | HTTP connect / pool / write / read inactivity | 5 / 2 / 10 / 30 Sekunden, jeweils zusätzlich zur verbleibenden Gesamtdauer | | Parallelität | Zwei Gatewayläufe je Backendprozess, begrenzte Warteschlange 16; voller Eingang 503 | | Eingabepayload | Maximal 64 KiB UTF-8 über sämtliche Textteile; Modellkontext zusätzlich prüfen | | Detect-Chunks | Default 4.000 Codepoints mit begrenzter Überlappung 200; maximal 32 Chunks; vollständige Coverage Pflicht | | Ausgabe | Default maximal 2.048 Outputtokens; tatsächliches Modellprofil und Zweck können kleinere Grenzen setzen | | Providerresponse | Maximal 2 MiB decodierte Bodybytes und begrenzte Message-/Textlänge; Chunks zählen statt erst unbeschränkt `.json()` zu laden | | Idempotenz-/Callmetadaten | Default sieben Tage, an produktbezogene Audit-/Abrechnungszwecke anpassen | HTTPX unterscheidet Connect-/Read-/Write-/Pooltimeouts; Readtimeout ist eine Inaktivitätsgrenze pro empfangenem Chunk und keine Gesamtlaufzeit. Die zusätzliche monotone Deadline wird z. B. mit `anyio.fail_after` umgesetzt; Netzwerkressourcen werden bei Abbruch geschlossen. [HTTPX Timeouts](https://www.python-httpx.org/advanced/timeouts/). Ein langsamer kontinuierlicher Bytestrom darf das Gesamtbudget nicht unbegrenzt verlängern. Connectionpool und Admissionlimit sind explizit begrenzt. Bei mehreren Prozessen werden Limits budgetiert; ein Prozesslimit ist keine zugesicherte globale Kontenquote. Tokenbudget nutzt Modellprofil, reservierte Ausgabe und Sicherheitsmarge. Wenn nur eine konservative Zeichenschätzung verfügbar ist, wird sie so bezeichnet; unbekanntes Modellfenster oder Grenzverletzung führt zu lokalem Abbruch, nicht zu blindem Versand. Automatische Kürzung/Kompression nach dem Egress-Gate ist verboten. ### 10.2 Fehlerzustand und Kostenunsicherheit Kein automatischer Generate-Retry, Reparaturprompt oder Modell-/Providerwechsel. Das gilt für 429/5xx, ungültiges JSON, Refusal, Verbindungsabbruch und Antwortvalidierungsfehler. Die erste erzeugte Antwort bleibt nicht durch eine heimliche zweite ersetzt. Eine bewusst angeforderte neue fachliche Ausführung erhält eine neue Call-ID und durchläuft Autorisierung/Privacy/Budget erneut. `not_sent` ist nur zulässig, wenn der eigene Adapter sicher keinen Sendversuch begonnen hat. Nach Eintritt in den Transport ist bei Timeout/Abbruch der konservative Zustand `sent_or_unknown`, sofern kein engerer Nachweis existiert. Eine Exception oder Clientdisconnect bedeutet nicht „Provider hat nichts verarbeitet/keine Kosten“. Der Adapter speichert bekannte Usage, ansonsten `unknown`; keine erfundene Nullbuchung oder stille Freigabe einer möglichen Verbrauchsreservierung. Bekannte HTTP-429-Antwort wird in ein sicheres begrenztes Retry-After übersetzt; der Client erhält keine automatische Wiederholungsanweisung für denselben Write. SDK-/Transportretrys werden ausdrücklich deaktiviert (Default null); kein versteckter `HTTPTransport(retries=...)` oder aus Providerbibliotheken übernommener Retry. Reine lokale T2-Neuprüfung und spätere lesende Statusabfrage sind davon getrennt. ## 11. Antwortvalidierung, JSON und Streaming 1. Envelope streng prüfen: HTTPstatus, Content-Type, Bodylimit, eine erwartete Choice, bekannte Contentblöcke und Finishreason. Unbekanntes Format, versteckte Toolcalls oder `finish_reason=length` bei erforderlichem vollständigem Ergebnis werden nicht als erfolgreiches Fachresultat behandelt. Refusal ist ein eigenes Ergebnis/Fehlercode, kein normaler Textblock. 2. Reasoning-/Thinking-/Toolblöcke werden nicht als sichtbarer Text ausgegeben oder in spätere Prompts übernommen. Nur ausdrücklich unterstützte Textblocktypen normalisieren; keine generische Rekursion durch alle Dictionarywerte. 3. Für JSON: vollständige strikte JSONsyntax und das registrierte Pydantic-Ausgabemodell einschließlich Grenzen/Enums/`extra='forbid'` tatsächlich validieren. Kein bloßes `json.loads(schema_ignored)` und kein automatischer Repaircall. Default keine Markdown-Codefenceheuristik; ein bewusst benötigter Wrapperadapter ist eine getestete begrenzte Variante. 4. Privacy-/Tokenintegrität prüfen. Unbekannte, fremde oder inaktive Identitätstokens verweigern; keine freie Registryauflösung. Erkennbare unzulässige Identitätsvermutung/PII gemäß Produktpolicy blockiert die Antwort, ohne erneuten Generate. Homonyme bleiben vorkommensbezogen, keine globale Wortersetzung. 5. Nur bekannte aktive Tokens lokal rehydrieren. Eine interne normalisierte Prüffassung ist nicht die sichtbare Fassung. Akzeptierter modellseitiger Klartext behält seine Oberflächenform; nach Demasking keine semantische/grammatische Umschreibung des Journaltextes. Das folgt Kanshōs bestehender Trennung. JSONkeys, IDs, URLs, Datum-/Zahlenwerte oder später gedachte Toolargumente werden nicht unkontrolliert rehydriert; ResultSpec nennt erlaubte Textpfade. 6. Nach Rehydration erneut Ausgabelänge/JSONschema/zulässige Struktur prüfen und gemäß T3 autorisieren. Fachliche Plausibilität gehört zum konkreten Fachadapter; „valides JSON“ beweist weder Wahrheit noch aktuelle Gültigkeit. Kein Vorgriff auf ADR-16. Das Gateway validiert untrusted Ausgabe und verleiht ihr keine Befehlsgewalt. Quellen-/Modellanweisungen können weder Datenklasse, Endpoint, Scope, Zugriffspolitik noch Toolrechte erweitern. HTML/Markdown wird im Frontend nach vorhandenem sicherem Renderingvertrag behandelt; kein rohes `dangerouslySetInnerHTML` aus Modelltext. Links werden nicht serverseitig automatisch besucht. Auch der Browser darf keine modellseitigen Remote-Bilder, eingebetteten Inhalte oder Linkpreview-/Prefetchrequests automatisch laden. Default ist sichere Textdarstellung bzw. ein Renderer mit registrierten internen Medienreferenzen; aktive URLschemata werden verweigert. Identitätstokens in URLs/Markdown-Linkzielen werden nicht zu privaten Klartext-URLs rehydriert. Ein Modell darf lokale Demaskierung nicht in eine spätere Browserausleitung verwandeln. **Streamingdefault:** `stream=false`; vollständiges Ergebnis puffern und erst nach Validierung/Demaskierung freigeben. Falls ein konkretes Produkt Upstream-SSE benötigt, wird es begrenzt gesammelt und erst das vollständige geprüfte Ergebnis ausgegeben. Kein persönlicher Rohdelta-/Reasoningstream an Browser oder DebugUI. Fortschrittsanzeigen dürfen reine sichere Phasenereignisse senden, aber keine ungeprüften Tokens. Ein späteres echtes inkrementelles Freigabeverfahren braucht einen eigenen nachgewiesenen Vertrag; es wird hier nicht als bereits sicher angenommen. Verbindung zum Browser bei Scopewechsel/Logout schließen, alte Ergebnisse/Fehler nach epoch verwerfen. Der Caller setzt für lange KI-Operationen bewusst größere begrenzte Zeitbudgets, Default Client 105 Sekunden/Proxy 110 Sekunden bei Gatewaydeadline 90; der allgemeine Foundation-15-Sekunden-Default wird nicht global entfernt. Produktlokale längere Jobs sind Gegenstand des folgenden Workflowblueprints, kein neuer Worker in diesem Dokument. ## 12. Callledger, Idempotenz, Audit und Quotenport Persistente lokale Metadaten verhindern unbemerkte doppelte Generate-Ausführung. Logischer Datensatz `ai_calls`: | Feldgruppe | Inhalt | |---|---| | Identität/Owner | `call_id UUID PK`, `subject_id`, `scope_kind`, `scope_id`, `execution_id`, `node_key`, `purpose`; Owner-/Scopefilter bei jedem Lookup | | Inputbindung | Vorlagen-/ResultSpec-/Policy-/Profilrevisionen, Quellenversionsdigest und HMAC-Fingerprint der vollständigen semantischen Eingabe; keine Promptvolltexte | | Zustand | `prepared`, `awaiting_review`, `dispatching`, `validated`, `completed`, `blocked`, `failed_unsent`, `unknown`, `rejected_output`, `discarded_after_revoke` | | Versand/Nachweis | `dispatch_decided_at`, Beginn/Ende, sicherer Outcome-/Reasoncode, bekannte Modell-/Routen-ID, Technik-/Reviewcoverage und Maskierungszähler | | Ergebnis/Verbrauch | Optional erlaubte fachliche `result_ref`, validierter Usage-/Kostenzustand, optional späterer Reservierungsbezug; keine generelle Providerresponseablage | Ein Unique-Constraint über Subject + Scope + `execution_id/node_key` bindet eine logische Ausführung. IDs sind begrenzt/validiert und nicht frei als Pfade verwendbar. Gleicher Schlüssel mit anderer Eingabe → 409 `call_conflict`. Während Dispatch oder bei `unknown` wird kein zweiter Call gestartet. `awaiting_review` kann nur mit derselben aktuellen Inputbindung und legitimer lokaler Reviewentscheidung fortgesetzt werden; inhaltlich geänderte Anfrage ist eine neue Ausführung. Keine HTTPbody-Flags als Freigabe. Fingerprints werden mit einem separaten produktlokalen `AI_FINGERPRINT_KEY` als HMAC berechnet, damit gespeicherte Hashes kurzer persönlicher Texte kein einfaches Wörterbuchorakel bilden. Rohes Payload-SHA dient nur intern zur unmittelbaren Bytebindung und wird nicht als öffentlicher Debugwert persistiert. Fingerprint bindet Subject/Scope/Zweck, Input-/Vorlagen-/Quellen-/Policy-/Profilstand und Ergebnisformat, nicht die Cookiegeneration; spätere legitime Sessionerneuerung erzeugt keine neue logische Facheingabe. Aktuelle Autorisierung bleibt trotzdem bei jedem Lookup Pflicht. Der Ledger speichert die Fingerprint-Key-ID; benötigte alte Keyversionen bleiben über die Idempotenz-/Aufbewahrungsfrist verfügbar bzw. werden kontrolliert migriert. Fehlt nach Rotation/Restore eine benötigte Version, wird ein bestehender unbekannter Call nicht als neue freie Ausführung behandelt. Der Recovery-Schlüsselvertrag aus dem vorherigen Blueprint umfasst diesen Bedarf, ohne den Key in Datenarchiv oder Logs zu schreiben. Schema/Fremdschlüssel nutzen die lokalen Account-/Scope-IDtypen der Zielanwendung; für einen neuen Foundationaufbau die in Phase 3.3 vorgesehenen Konten. Kein universeller Tenantstore. Callabschluss/Ergebniswrite/Audit committen zusammen. Netzcall und DB können nicht atomar sein: Prozessabbruch nach Dispatchintent wird konservativ als ungeklärter Aufruf behandelt, nie automatisch erneut gesendet. Nach Neustart sind offene `dispatching`-Zeilen zu klären bzw. `unknown`; ein Ablaufdatum erteilt keine neue Generate-Erlaubnis. Die siebentägige Standardretention betrifft abgeschlossene ungebundene Metadaten. Laufende/ungeklärte Calls und durch Fach-/Workflowausführungen referenzierte Call-IDs behalten mindestens ihren gesperrten Idempotenz-/Outcometombstone; Cleanup darf sie nicht zu unbekannten „neuen“ Ausführungen machen. Für abgeschlossene Calls außerhalb des ausdrücklich zugesicherten Idempotenzfensters wird keine unbegrenzte Wiederabrufgarantie behauptet. Eine bewusst neue Generierung verwendet eine neue Ausführungs-ID. Ein bereits abgeschlossenes persistiertes Fachergebnis kann nach aktueller Autorisierung per `result_ref` erneut gelesen werden. Bei reiner Anzeige ohne gespeichertes Resultat gibt es keinen langlebigen Antwortcache; Wiederabruf desselben Calls liefert `result_unavailable`, keine kostenpflichtige Neugenerierung. Der Fachauftrag kann ausdrücklich eine neue Ausführung anfordern. Keine personenbezogenen globalen Antwort-/Promptcaches. ### 12.1 Auditgrenzen und Speicherung Pflichtmetadaten: Call-/Request-ID, lokale Subject-/Scopebindung, Zweck, verwendete Profil-/Policy-/Vorlagenrevision, lokale Dispatchentscheidung, Coverageart, `semantic_identity_guaranteed=false`, Zähler/Größen/Dauer, bekannter Usagezustand, Ausgabestatus und sicherer Reasoncode. Keine echten Labels, Aliase, Mappings, Cookie-/Provider-/DBsecrets, System-/Userpromptvolltexte oder Modellantworten in Log/APM/Exceptions/DebugUI. Providerfehlertexte können Eingaben spiegeln und werden daher nicht durch bloßes Abschneiden sicher. Der Gateway speichert standardmäßig keine Rohprompts, Rohantworten oder Manifestmappings. Fachlich bewusst bewahrte Originalquellen und akzeptierte Ergebnisse bleiben normale lokale Produktdaten mit eigener Autorisierung/Retention; Kanshōs Quellbewahrung wird dadurch nicht abgeschafft. Diagnoseberechtigung ist keine pauschale Freigabe privater Texte. Tests dürfen Wirebodies ausschließlich mit synthetischen Inhalten und für den Testlauf aufzeichnen. Fehlt der erforderliche Auditspeicher vor Dispatch, kein Versand. Scheitert der Abschluss nach möglichem Versand, wird kein zweiter Call zur „Reparatur“ erzeugt; Fehler und späterer Reconcile bleiben sichtbar. Das Release-/Recoveryverfahren aus dem vorherigen Blueprint muss auch Callledger und ungeklärte Zustände erhalten; Restore macht alte `dispatching`-Zeilen nicht erneut ausführbar. ### 12.2 Anschluss an Entitlements und Verbrauch `EntitlementPolicy` ist zusätzlich zur AccessPolicy erforderlich, soweit das Produkt die Funktion begrenzt. Für spätere harte Kontingente gilt der kleine lokale Port: ```python @dataclass(frozen=True, slots=True) class BudgetEnvelope: call_count: int upper_input_tokens: int | None upper_output_tokens: int | None maximum_cost: str | None cost_basis_revision: str | None class UsageBudgetPort(Protocol): def reserve(self, tx: object, context: RequestContext, call_id: str, upper_bound: BudgetEnvelope) -> str: ... def settle(self, tx: object, reservation_id: str, actual: UsageReport) -> None: ... def mark_unknown(self, tx: object, reservation_id: str) -> None: ... def release_unsent(self, tx: object, reservation_id: str) -> None: ... ``` Dieser Port ist noch keine Billing-/Quotenimplementierung. Der folgende Entitlements-/Quota-Blueprint konkretisiert Atomarität, Perioden und Buchungsregeln. Ein Produkt ohne harte Quoten braucht nur die technischen Limits und Usageerfassung; es darf deshalb keine zugesicherte Kontingentgarantie behaupten. Ein Produkt **mit** harter Grenze bleibt ohne passenden echten Adapter geschlossen. Mitais heutiges „nach Erfolg hochzählen“ wird nicht als sichere parallele Reservierung oder Abrechnung unbekannter Ergebnisse ausgegeben. Fehlende Usage ist `unknown`, nicht kostenfrei. Eine Schätzung ist keine zugesicherte Obergrenze. Der Adapter erhält im `BudgetEnvelope` nur tatsächlich belastbare obere Schranken, ansonsten `None`; er darf eine verpflichtende harte Token-/Kostengrenze dann nicht durch einen Schätzwert freigeben. Die Generate-Callanzahl kann für diesen Schnitt eindeutig mit eins begrenzt werden. Detect-/Toolverbräuche erhalten gegebenenfalls eigene Budgetzwecke und werden nicht unsichtbar in einen Generateerfolg eingerechnet. ## 13. Fach-API, Fehler und Frontendanschluss Es entsteht kein öffentliches „beliebigen Prompt an beliebige URL senden“-API. Fachmodule registrieren konkrete Operationen mit festem Zweck, ResultSpec und serverseitiger Quellenauflösung. Beispiel: `POST /api/v1//{resource_id}/generate` mit `{expected_version, instruction?}`; Session, CSRF/Origin und Scopeheader folgen Phase 3.3. `instruction` ist begrenzter untrusted Eingabetext und Bestandteil der Privacyinventur, keine übergeordnete Policy. `Idempotency-Key` ist eine begrenzte kanonische UUID des Fachauftrags; `node_key` setzt der Server. Die Call-ID wird serverseitig erzeugt. Bodyfelder wie `provider_url`, `api_key`, `data_class`, `profile_id`, `privacy_checked`, `precomputed_mappings`, `tools` und frei gewählte `model`-IDs sind im Fach-DTO nicht erlaubt. Ein zugelassener Modellwunsch wäre höchstens ein registrierter serverseitig erneut geprüfter Variantenbezeichner. FastAPI-Anschluss als Illustration V/K; das eigentliche Fachmodul implementiert den benannten Service. Synchrone DBphasen liegen innerhalb dessen expliziter Threadbridge, der Gatewayawait enthält keine offene DBverbindung: ```python from typing import Annotated from uuid import UUID from fastapi import APIRouter, Depends, Header, Request from pydantic import BaseModel, ConfigDict, Field from app.api.dependencies import scoped_context from app.core.context import RequestContext class GenerateInput(BaseModel): model_config = ConfigDict(extra="forbid", strict=True) expected_version: int = Field(ge=1) instruction: str | None = Field(default=None, max_length=2000) class GenerateOutput(BaseModel): call_id: str content: str router = APIRouter(prefix="/api/v1/feature") @router.post("/{resource_id}/generate", response_model=GenerateOutput) async def generate( resource_id: str, body: GenerateInput, request: Request, context: Annotated[RequestContext, Depends(scoped_context)], idempotency_key: Annotated[UUID, Header(alias="Idempotency-Key")], ): return await request.app.state.providers.feature_service.generate( context, resource_id, body, str(idempotency_key), ) ``` Eine optionale reine Statusroute `GET /api/v1/ai/calls/{call_id}` liefert nur `call_id,status,usage_status,result_ref?` nach aktuellem Recht und Subject-/Scopefilter. Fremder oder unsichtbarer Call: 404. Sie gibt keine Prompts/Manifestlabels/Providerfehler zurück und löst keinen neuen Modellaufruf aus. Ein Review-/Fortsetzungsendpunkt ist produktlokal; er verwendet einen serverseitig gebundenen kurzlebigen Reviewbeleg, nicht `confirmed=true` aus dem Client. Er ändert keinen bestehenden Datenstand ohne den entsprechenden Fach-/CSRF-/Versionsvertrag. | HTTP / stabiler Code | Bedeutung und Wirkung | |---|---| | 401 `session_invalid` | Kein aktueller Principal; kein Dispatch oder keine Ergebnisfreigabe | | 403 `capability_denied`, `scope_forbidden`, `ai_policy_denied` | Zugriff/Zweck/Datenklasse/Privacy nicht erlaubt; keine Daten nach außen | | 404 `not_found` | Fachquelle/Call fremd, unsichtbar oder fehlend | | 409 `context_changed`, `call_conflict`, `call_in_progress`, `call_outcome_unknown`, `result_unavailable` | Kontext oder Ausführungszustand benötigt bewusste neue Entscheidung; kein automatischer Callretry | | 409 `privacy_review_required` | Generate noch nicht gesendet; Produkt kann seinen bestehenden lokalen Reviewpfad öffnen | | 422 `validation_failed`, `prompt_budget_exceeded`, `reserved_identity_syntax`, `unsupported_modality` | Eingabe/Format/Limit vor Versand verweigert | | 429 `ai_rate_limited` | Explizites Kontolimit bzw. sichere normalisierte Providerbegrenzung; Retry-After begrenzt, keine automatische Mutation | | 502 `provider_invalid_response`, `output_invalid`, `model_refused` | Upstreamantwort/ResultSpec/Integrität nicht nutzbar; kein Repaircall | | 503 `ai_unavailable`, `privacy_detection_unavailable`, `ai_busy`, `policy_unavailable` | Fehlende Pflichtadapter/Eignung/Kapazität; keine unsichere Fallbackroute | | 504 `ai_deadline_exceeded` | Zeitlimit; Outcome kann bereits `sent_or_unknown` sein, kein Erfolg/keine Nullkostenbehauptung | RFC-9457-Problemformat mit sicheren Maschinen-/Requestcodes gemäß Foundation. Insbesondere keine Rohwerte in Feldfehlern, keine Unknown-Tokenlabels oder Providerantwortschnipsel in `detail`. Für alle persönlichen Erfolgs-/Fehler-/Statusantworten `Cache-Control: no-store`. Fach-DTOs nennen keine Authcredentials oder Backendproviderprofile. Frontend nutzt zentralen Cookie-/CSRF-/Scopeclient, setzt begrenzten KI-Timeout ausdrücklich, zeigt sichere Phasen-/Fehlermeldungen und verwirft alte Resultate/Fehler nach epoch. Ein 403/503 ist kein Logout; ein 504 löst keinen automatischen zweiten Generate aus. Kein persönliches Ergebnis im Service Worker, LocalStorage oder gemeinsamem Modellcache. Ausgabe wird mit dem jeweiligen sicheren Text-/Markdown-/Rich-Textadapter angezeigt. ## 14. Automatisierte Negativ- und Sicherheitsprüfungen Die Matrix ist ein Testauftrag, kein Ergebnisbericht. Verwendet werden synthetische Personen-/Orgdaten, eigene Call-/Providerprofile, Fakedetectoren, Wire-Capture-Transport und isoliertes echtes PostgreSQL mit begrenzter Runtime-Rolle. Keine realen Providerkeys, privaten Textbestände oder Live-Modellaufrufe. Testfakes werden nur über Testproviderverdrahtung bereitgestellt; der Runtimeaufbau kann sie nicht per Flag auswählen. Canaries erscheinen in **jedem erlaubten Textkanal**: System-/Developertext soweit unterstützt, User, Historie, Kontext/RAG, Registryalias und JSONschemabeschreibung. Unbekannte Zusatzfelder/Modalitäten erhalten eigene Ablehnungstests. Tests prüfen die an den Providertransport übergebenen endgültigen Bytes und alle erlaubten Transportmetadaten. Nicht nur den Aufruf einer Maskierungsfunktion mocken. Synthetische Wireaufzeichnung bleibt lokal im Test; keine Produktionsdebugfunktion daraus ableiten. | ID / Suite | Testfall | Zwingende Assertions | |---|---|---| | A01 `test_gateway_access.py` | Keine/abgelaufene Session, falscher Scope, fremdes Profil/Objekt, fehlende Capability | 401/403/404 vor jedem Detect-/Generatezugriff auf fremde Inhalte; keine Cross-Profilequelle | | A02 | Gemischte eigene/fremde RAG-/Eltern-/Memoryquellen | Jede Quelle scoped geprüft; keine fremden Inhalte/Counts in Kontext, Wire oder Fehler | | A03 | Sitzung/Mitgliedschaft/Recht nach T1 entzogen, Quelle/Vorlage geändert | T2 verhindert alten Dispatch; kein unverifizierter Neuaufbau | | A04 | Rechte-/Objektänderung während Generate | Keine unautorisierte Anzeige/Fachspeicherung; Callusage sicher abgeschlossen, kein zweiter Call | | A05 | Class A, unbekannte Klasse, persönlicher Text als C, vom Client behauptete Klasse | Local-only extern nie gesendet; C nicht als Bypass; Klassifikation serverseitig | | A06 | Bekannter Providerkey/Private-Keyblock oder credentialhaltige URL im Input | ForbiddenContentGuard blockiert vor Detect/Generate; keine Secretwerte in Fehlern oder Logs | | I01 `test_egress_inventory.py` | Canaries in sämtlichen Textkanälen und statischer Schema-/Formatinstruktion | Vollständige Inventur/Maskierung/Prüfung; erwarteter endgültiger Body ohne zu schützenden Canaryklartext | | I02 | Aufgelöster Platzhalter/Frageergänzung erst nach Nutzertextreview | Alte Coverage reicht nicht; fehlende finale Felder neu prüfen oder blockieren | | I03 | Geänderte Template-/Source-/Registry-/Policyrevision bei precomputed Mappings/Review | Alte Belege zurückweisen; bloßes `full_detection_coverage=true` reicht nicht | | I04 | Abgeschnittener/fehlender Detectchunk, UTF-8-/Unicodeoffset, Randüberlappung | Coverage-/Spangrounding korrekt; kein Generate bei technischer Lücke; kein stilles Truncation | | I05 | Detect-Timeout, Nulltreffer, ungültiges Detectschema, unbekannter Typ | Ausfall blockiert; Nulltreffer nicht als semantische Garantie; keine Heuristik-/Wortlistenrettung | | M01 `test_masking.py` | Vorkommensbezogener Homonymfall, Alias, überlappende Namen, Projektname | Nur passende geerdete Spans; bestätigte/unbestätigte Herkunft getrennt; kein globales Ersetzen aller gleichen Wörter | | M02 | Zwei parallele Subjects/Scopes mit gleich aussehenden Tokens | Getrennte Manifeste/Antworten, keine globalen Traces oder Cross-Profile-Rehydration | | M03 | Inaktives Mapping, fremder/erratener Token, reservierte Syntax aus Userquelle | Nur tatsächlich aktive eigene Tokens auflösbar; Injection/unknown Token verweigert | | M04 | Bekannter Alias vs. unbestätigter Treffer, akzeptierter Modellklartext | Kanonisch/beobachtet korrekt; Prüffassung nicht sichtbare Ausgabe; keine grammatische Umformung | | P01 `test_provider_policy.py` | Fehlendes/abgelaufenes Eignungsdokument, Boolean-ZDR ohne Beleg, ungeeignete Region/Endpoint | Nicht eligible, keine Generierung; keine pauschale Providerfreigabe | | P02 | OpenRouter-Payload, ungeeigneter Fallback, nur `data_collection` gesetzt | Gültiger vollständiger Profilvertrag setzt erforderliche Filter; kein Modell-/Providerfallback oder unerlaubter Transform | | P03 | URL aus Userinput, Suffixtrick, Redirect, DNS-Rebinding, Metadata-/fremde interne IP | Vor bzw. am Connect verweigert; kein Secret an fremdes Ziel; private IP allein ist keine Vertrauenszone | | P04 | Impliziter Proxy/CA aus Umgebung, falsches Zertifikat, fremder Authheader | `trust_env=False`/explizite CA wirksam; falsches TLS abgelehnt; nur richtiger Profilkey am Ziel | | P05 | Remote-Klartext-Detect per Devmodus/Flag, Fakeprovider im Runtimeaufbau | Kein Standardbypass; ungeeigneter B-Pfad geschlossen; Tests injecten Fakes ausschließlich lokal | | P06 | LocalDetectInput gegen Generate-/externes Detectprofil oder mit Registrydaten | Typ-/Rollen-/Trust-Zone-Grenze verweigert; lokaler Detect erhält nur erlaubte Textfelder | | T01 `test_transport.py` | Body/Modell/Profil/Policy nach Seal verändert, abgelaufene Permit | Kein Versand; Bytehash-/Revisions-/Zeitbindung greift | | T02 | Genau ein erlaubter Send, danach erneute Permitverwendung | Keine zweite Sendung; Wirebytes entsprechen finaler Prüfung, keine nachträglichen SDKfelder | | T03 | Connect-/Pool-/Read-/Writefehler, langsam kontinuierlicher Stream | Einzel-/Gesamtlaufzeitgrenzen; Ressourcen frei; nach möglichem Versand Outcome unknown statt kostenfrei | | T04 | 429/5xx, ungültiges JSON, Refusal, Disconnect nach Providerannahme | Kein versteckter Retry/Repaircall; sichere Fehler; keine Behauptung „Provider hat abgebrochen“ | | T05 | Queue/Pool voll, mehrere Prozesse, riesige Input-/Responsebody | Begrenzte Ablehnung und gemessene Limits; keine Poolumgehung oder unbeschränkte `.json()`-Allokation | | O01 `test_model_output.py` | Falsche Envelope/Choice/Finishreason, Reasoning/Toolblocks | Nur erlaubte Formate; keine versteckten Tools/Reasoninginhalte in Ergebnis/Historie | | O02 | Valides JSON mit falschem Schema/extra Feldern/NaN/Grenzwerten | Lokales striktes ResultSpec tatsächlich geprüft; keine TODO-Schemaannahme oder Repairgenerierung | | O03 | Unbekannter/inaktiver Token, unzulässige Identitätsvermutung | Ausgabe verworfen, keine fremde Lookupauflösung; Egress nicht nachträglich als ungeschehen erklärt | | O04 | Rehydration in JSONtext gegenüber Keys/IDs/Zahlen/URLs | Nur erlaubte Textpfade; Schema nach Rehydration nochmals gültig | | O05 | Persönlicher Upstreamdelta-/Fehlerstream vor Validierung | Kein Rohdelta an Browser/Debug; begrenztes Puffern bzw. Ablehnung, nur sichere Fortschrittsereignisse | | O06 | Modellantwort mit Remote-Bild/HTML/aktivem Link oder Identitätstoken in URL | Kein automatisches Browser-/Serverfetch und keine private Rehydration in Linkziele; sicherer Renderer | | C01 `test_gateway_calls.py` | Parallele gleiche Idempotenz, geänderter Fingerprint, alter Scope | Ein Send höchstens, 409 bei Konflikt; jeder Lookup aktuell autorisiert | | C02 | Prozessabbruch vor/nach Dispatchintent bzw. nach Ergebnis, vor Abschlusscommit | Keine automatische erneute Sendung; unknown/persistierte Resultreferenz korrekt | | C03 | Metadaten-/Auditfehler vor Dispatch vs. danach | Vorher kein Versand; nachher sichtbarer ungeklärter Zustand, keine Erfolgsausgabe oder heimliche Wiederholung | | C04 | Usage fehlt, echte Nullusage, abgeschätzte statt oberer Budgetgrenze | Unknown von null getrennt; harte Quoten nicht durch unbewiesene Schätzung freigeben | | C05 | Restore alter offener Calls, Fingerprintkeywechsel | Alte dispatching/unknown Calls werden nicht automatisch ausführbar; Idempotenz-/Key-ID-Vertrag bleibt nachvollziehbar | | L01 `test_ai_diagnostics.py` | Providerfehler enthält Canary/Prompt/Key, Exception/Repr/Log/APM | Keine sensitiven Spiegelungen in HTTP/Logs/DTOs; Maskierungszähler statt Labels | | L02 | Debugberechtigung, gespeicherte Fachquelle, temporäres Mapping | Debug exportiert keine Volltexte/Mapping; Fachquellbewahrung unverändert; Callmapping nur lokal | | F01 Frontend-/APItests | Fehlende CSRF/Scope, fremde Call-ID, extra Providerbodyfelder | Phase-3.3-/DTO-Verträge wirksam; keine generische freie Proxyroute | | F02 | Scopewechsel/Logout mit verspäteter KIantwort/401/504 | epoch verwirft alte Antworten/Fehler; kein Autoretry, 403/503 kein Logout | ### 14.1 Anschluss an vorhandene Testquellen I - [Kanshō Manifestfälle](C:/Dev/Kansho/backend/tests/test_privacy_manifest.py:70): aktive/inaktive Mappings, Homonyme, Alias-/Prüffassung und Rehydration übernehmen; um komplette Payload-/Scoped-/Wirebindung erweitern. - [Kanshō Span-/Pre-Egress-Test](C:/Dev/Kansho/backend/tests/test_privacy_response_integrity.py:102): Spangrounding, Überlappung und Blockade vor Provider als Ausgangsfälle. - [Kanshō Detectionverträge](C:/Dev/Kansho/backend/tests/test_privacy_detect.py:1): Fakes belegen Schema/Fail-Closed-Verhalten, ausdrücklich keine Livequalität. - Kanshō verwendet einen [eigenen pytest-Collector](C:/Dev/Kansho/backend/tests/conftest.py:49), der Testskripte über `main()` als je einen Fall sammelt. Eine Testdatei oder gefundene Hilfsfunktion beweist deshalb weder einzelne pytest-Coverage noch Erfolg. Im neuen Zielaufbau diese Fälle als einzeln benannte native pytest-Tests mit konkreter Pflichtcollection anlegen; Bestandscollector nicht pauschal kopieren. Integrationstests verwenden echten isolierten PostgreSQLzustand nach dem Releaseblueprint. Reine Transformationen laufen ohne DB/Netz, Transporttests mit Fake-/Wireadapter. Nach Einführung eines tatsächlichen lokalen Detectors ist eine separate synthetische Qualitätsauswertung mit benanntem Modell/Stand nötig; sie wird nicht aus Mocktest-Erfolg abgeleitet. Reale persönliche Providererprobung ist nicht Teil dieser Lieferung oder Pflicht-CI. ## 15. Implementierungsauftrag für Cursor und nachfolgende Blueprints **Dieser Abschnitt wird hier nicht ausgeführt.** Der spätere Auftrag benennt das Zielrepository und die erste tatsächliche KI-Funktion. Ohne konkrete Zielfunktion keine bestehende App als allgemeines Gatewayframework umbauen. 1. Foundation v0.3, Phase-3.3-Kontext/Access/UoW und Releaseblueprint beibehalten. Lokales Gatewaymodul mit explizitem Composition Root/Ports aufbauen; keine Cross-Repoimporte oder neue zentrale Inferenzplattform. 2. Kanshōs Maskierungsmanifest, Span-/Alias-/Registryregeln und Pre-Egress-Reihenfolge gezielt übertragen. Aktuelle Source-/Profil-/Policy-/Inventurbindung und Callisolation ergänzen. Vorhandene Globaldiagnose, Fake-Runtimeflags und pauschale Local-URL-Vertrauensprüfung nicht übernehmen. 3. Den einen Fachzweck mit erlaubten Quellen/Feldern, B/C-Regel, Vorlage und lokalem ResultSpec registrieren. Scoped Materialisierung über vorhandene Repositories; keine neue Prompt-/Workflowengine. Mitais späteren Adapter an `RenderedPrompt`/`ModelGateway.complete` binden. 4. Echte lokale Detect-/Reviewadapter und Profil-/Secret-/Eligibilityadapter anbinden, soweit vorhanden. Für Tests ausschließlich synthetische Fakes. Fehlende reale Eignung/Detection lässt persönlichen Egress geschlossen und wird als offen dokumentiert; keine echten Keys/privaten Texte zu „Smokezwecken“ verwenden. Kein neuer Detectdienst wird automatisch installiert. 5. Payloadinventur, technische Coverage, Spangrounding, aktive Manifestmaske und den finalen Byte-Seal implementieren. Unbekannte Zusatzfelder, Klasse A, reservierte Tokeninjektion und ungeklärte Konflikte sperren. Keine ungescannten Format-/Systemtexte nachreichen. 6. Async-HTTPadapter im Lifespan mit expliziten Endpunkten/TLS/Proxygrenzen, null Retries, Pool-/Admission-/Bodylimits und monotoner Gesamtdauer implementieren. Synchrone DBphasen in getrennten Threadbridge-UoWs; kein SQL-/HTTPmix in einer offenen Transaktion. OpenRouterparameter nur bei tatsächlich entsprechend eligible Profil verwenden. 7. Callledger/Uniqueconstraints und T1/T2/T3 mit aktuellem Recht, Quellen-/Profilrevision, Dispatchintent, Audit und konservativem unknown-Zustand implementieren. Ergebniswrite atomar mit fachlichem Audit. Reviewfortsetzung exakt binden; keinen booleschen Clientnachweis akzeptieren. 8. Envelope-, JSON-/Pydantic-, Token-/Privacyprüfung und lokale Rehydration implementieren. Kein Live-Rohstream oder Repaircall. Akzeptierten Journaltext nicht nachträglich umschreiben. Usage unbekannt korrekt erhalten, Quotenport nur bei realer Anforderung verdrahten. 9. Fachrouter/Statusroute mit Auth-/CSRF-/Scope-/Idempotenzvertrag und sicheren Problemcodes anbinden. Zentralen Frontendclient/epoch beibehalten, begrenzten KI-Timeout lokal setzen, Ausgabe sicher rendern; keine persönlichen Webcaches oder Providerkeys im Frontend. 10. Native Tests aus Abschnitt 14 tatsächlich sammeln/ausführen, Wirecanaries über alle Kanäle und negative Nebenpfade prüfen. In beiden Releasevarianten blockieren fehlende/rote KI-Pflicht-Gates vor Produktion. Produktionsmodus ebenfalls isoliert mit synthetischen Profilen prüfen; kein Devflag lockert Privacy. Ergebnisbericht nennt Commit, Image-/Policy-/Profil-/Detectorstand, Tests/Umgebung und offene Adapter. Nur tatsächliche bestandene Tests als T kennzeichnen. Der **nächste Prompt-/Platzhalter-/Workflow-Blueprint** konkretisiert Vorlagenversionierung, Registrierungen, Graph-/Nodezustände und Wiederaufnahme. Er konsumiert diesen Gatewayvertrag; jeder Modellnode erhält ihn, ohne Privacy und Providertransport nochmals zu erfinden. Der **anschließende Entitlements-/Verbrauch-/Quota-Blueprint** konkretisiert Reservierung/Abrechnung, insbesondere parallele und unbekannte Ergebnisse. Beide werden durch dieses Dokument nicht automatisch gestartet. Abnahme eines späteren ersten vertikalen Slices: autorisierte synthetische Quelle → vollständig gerenderter Prompt → lokale Detection/Maskierung → nachweislich geprüfte Wirebytes zum Fakeprovider → valides maskiertes Ergebnis → nur eigene lokale Rehydration → aktuell autorisierte Ausgabe/atomarer Fachwrite. Cross-Scope-Daten, Direct-HTTP-Bypass, unbekannter Outcome und ungültige Antwort müssen dabei sichtbar verweigert werden. Ein grüner Slice bleibt ein begrenzter Integrationsnachweis, keine universelle Detektions-/Produktreifezusage. ## 16. Prüfstand dieser Lieferung Erstellt wurde ausschließlich dieses neue Blueprintdokument. Produktrepos, Foundation, Auth- und Releaseblueprint blieben unverändert. Keine Codeimplementierung, Modell-/Live-APIaufrufe, produktiven Credentials/Datenbanken, privaten Testtexte, Paketinstallationen, Migrationen, Deployments oder Anwendungstestläufe. Dokumentprüfung umfasst lokale Referenzen/Zeilen, Python-/JSONbeispielsyntax und Konsistenz von Context-/Provider-/Payload-/Call-/Fehler-/Testverträgen. Das ist kein T-Nachweis für die geplante Lösung. Technische Providerdetails wurden begrenzt gegen offizielle OpenRouter-/HTTPX-Dokumentation geprüft; konkrete Account-/Endpointbedingungen und lokale Detectorqualität wurden nicht erhoben oder freigegeben. ### 16.1 Lokaler Quellstand Lesestand 16.10.2026. Hashes über vollständige Dateien; Git-HEAD allein ist kein Beleg eines sauberen Checkouts. - `Kansho`: Git-HEAD `89d149684eab9211d6ef21181d018de097a61783` - `shinkan-jinkendo`: Git-HEAD `f10c28e5cdcef52cc44e953a8494b4bbe35b77fe` - `mitai-jinkendo`: Git-HEAD `95453d548a2113555cd7e8f01fbbf267cbe34f3f` - `kairo-jinkendo`: Git-HEAD `ea0aa18b8dd9a55f663a996d74e63b7e3ee0dc16` | Gezielt verwendete Produktquelle | SHA-256 | |---|---| | [Kansho/backend/privacy_gateway.py](C:/Dev/Kansho/backend/privacy_gateway.py) | `0e729287b6a87ba1a8ef92c6dce27cc3c3e1e829b6958130e59b4e90ff2a3d74` | | [Kansho/backend/providers.py](C:/Dev/Kansho/backend/providers.py) | `86b6924d680ce8fe35e723f82226ac5c76bb7abe900fbdec1c20250de7af069f` | | [Kansho/backend/provider_settings.py](C:/Dev/Kansho/backend/provider_settings.py) | `c38b352b289bbe6cce46d5d8482f26aabc4af8e29b8e3e6cd8f16460f98a122f` | | [Kansho/backend/engine.py](C:/Dev/Kansho/backend/engine.py) | `79b86c6ff69ff87ea4e02c26203ac39beebccf2cce7078ed246ae73971488159` | | [Kansho/backend/context_builder.py](C:/Dev/Kansho/backend/context_builder.py) | `712cb720267b57ac7fe471d7ec2a7cb25d9cd41cf8a19d63a8b083599c96586a` | | [Kansho/backend/prompt_budget.py](C:/Dev/Kansho/backend/prompt_budget.py) | `b95a36a6cd9e0ee704cd88b495bf9475230cdf5f0a2cb711458f27382af2be78` | | [Kansho/backend/tests/test_privacy_manifest.py](C:/Dev/Kansho/backend/tests/test_privacy_manifest.py) | `b48e16b901668efcd31f1534575400836cd3f68e5bd658d711ac7429c23526c5` | | [Kansho/backend/tests/test_privacy_response_integrity.py](C:/Dev/Kansho/backend/tests/test_privacy_response_integrity.py) | `b98035d558007b84c268b6d1b03e28d5b3b35f1984f821b6bbce9e9e84e6ae38` | | [Kansho/backend/tests/test_privacy_detect.py](C:/Dev/Kansho/backend/tests/test_privacy_detect.py) | `7b1043509fbe173f02e6ef050e2527a7adb27919dfbc1265832533e5c9d50347` | | [Kansho/docs/architecture/functional/guardrails.md](C:/Dev/Kansho/docs/architecture/functional/guardrails.md) | `deadd95b5019fe807026616f6ff74a2467d9d951702c032573d59f27c125dc4b` | | [Kansho/docs/architecture/technical/privacy_gateway.md](C:/Dev/Kansho/docs/architecture/technical/privacy_gateway.md) | `496c8661f645b8935edc8ce46214cfda3becca2588125eae345a7a860d9a07c5` | | [shinkan-jinkendo/backend/openrouter_chat.py](C:/Dev/shinkan-jinkendo/backend/openrouter_chat.py) | `606941440d7a7dd0a971cc0606e4ed8a5ad07f0b454374dc25dab8dd5c8a149a` | | [mitai-jinkendo/backend/prompt_executor.py](C:/Dev/mitai-jinkendo/backend/prompt_executor.py) | `7e0e97047fe16d7b5efb92ccbe573b6459c4d32b41931aa9e33d6f00f14028da` | | [kairo-jinkendo/backend/config_service.py](C:/Dev/kairo-jinkendo/backend/config_service.py) | `5d4f4b75216fe5915874ee9db1776354bdf91f233286f29ea71ff112e2f5555e` | | [Kansho/backend/tests/conftest.py](C:/Dev/Kansho/backend/tests/conftest.py) | `15c8a860538203e2dd63ee459b187cfb9fb586585e32a4c665ed74646c3f5ed8` | | [Kansho/backend/pytest.ini](C:/Dev/Kansho/backend/pytest.ini) | `cb919d485cff5f19a829ec584bf12019b4d7b6c4eb03e9254d690416b6e38a94` | **Ende dieses Blueprintauftrags. Keine Implementierung und kein weiterer Blueprint werden automatisch gestartet.**