# ZABAZINGO Cortex — Engine-Register

> Cortex ist der interne Markenname für alle KI- und Erkennungs-Engines, die in ZABAZINGO-Produkten Dokumente lesen, verstehen und durchsuchen. Diese Seite ist die **verbindliche Quelle** für die Engine-Namen. Externe Anbieternamen (Mistral, LlamaParse, Claude, …) erscheinen nie in einer Oberfläche, API-Antwort, einem Export oder Vertragstext — sie werden an der Darstellungsgrenze in Cortex-Codenames übersetzt.

## Zwei harte Regeln

1. **Kein Vendor-Name nach außen.** Welcher Anbieter eine Engine antreibt, ist Betriebs-Interna. Nutzer, Kunden, Partner, Screenshots und Exporte sehen ausschließlich `Cortex <NAME>`. Ein Anbieterwechsel darf an keiner sichtbaren Stelle auffallen.
2. **Marke ist ZABAZINGO.** `adam-eve` ist eine interne Plattform-/Tenant-Bezeichnung und wird **nicht** nach außen verwendet. Jede nutzersichtbare Wortmarke, jeder Title-Tag und jeder Doku-Verweis lautet ZABAZINGO.

Beide Regeln sind nicht stilistisch, sondern Betriebsrecht. Sie haben Vorrang vor Bequemlichkeit.

## Die Cortex-Familie

| Codename | Rolle (das sieht der Nutzer) | Stufe | Anbieter (intern, verborgen) |
|---|---|---|---|
| **Cortex SLATE** | Schnelle Basis-Texterkennung | Free OCR | PaddleOCR / Tesseract |
| **Cortex ONYX** | Hochpräzise Erkennung, auch Handschrift | Premium OCR | Mistral OCR |
| **Cortex PRISM** | Tabellen- und Struktur-Parsing | Premium OCR | LlamaParse |
| **Cortex SCRIBE** | Feld- und Vertragsextraktion | Extraktion | mistral-small |
| **Cortex LEX** | Klausel- und Risiko-Analyse | Analyse | Mistral |
| **Cortex ORACLE** | Semantische Suche („liest deine Cloud") | Suche | Claude |
| **Cortex ECHO** | Quer-Review und Verifikation | Review | Gemini |

Namensschema: ein kurzes, großgeschriebenes Einzelwort aus dem Tresor-/Mineral-/Orakel-Feld — passend zur warm-dunklen ZABAZINGO-CI mit Bronze-Akzent. Die Anbieter-Spalte steht ausschließlich in dieser internen Doku.

## Was jede Engine leistet

- **SLATE** — der kostenlose Schnell-Leser. Solide Druckschrift-Erkennung ohne Zusatzkosten, Standard für jeden Upload.
- **ONYX** — der Premium-Leser. Hohe Genauigkeit auch bei Handschrift, schlechten Scans und Fotos. Greift, wenn SLATE nicht reicht oder der Nutzer Premium wählt.
- **PRISM** — der Struktur-Leser. Zerlegt Tabellen, Formulare und mehrspaltige Layouts in saubere, maschinenlesbare Struktur. Wird automatisch für Tabellen-/Mehrspalten-Dokumente bevorzugt.
- **SCRIBE** — die Feld-Extraktion. Liest aus erkannter Schrift die strukturierten Felder heraus (z. B. Vertragspartner, Laufzeit, Kündigungsfrist) — jeweils mit Konfidenz; unsichere Werte werden zur Prüfung markiert, nie still gesetzt.
- **LEX** — die Klausel- und Risiko-Analyse. Erkennt kanonische Vertragsklauseln (Auto-Verlängerung, kurze Fristen, Preiserhöhung, Pönale, Haftung, Exklusivität, Datenschutz, lange Bindung) und stuft das Risiko ein.
- **ORACLE** — die semantische Suche über den gesamten Tresor („liest deine Cloud"). Beantwortet natürliche Suchanfragen über alle Dokumente.
- **ECHO** — die unabhängige Zweitmeinung. Quer-prüft und verifiziert Ergebnisse anderer Engines.

## Architektur — eine Quelle der Wahrheit

Die Übersetzung von Anbieter-ID zu Codename liegt an genau einer Stelle:

```
cloud-adam-eve/lib/engine-codenames.mjs   (Register + Auflösung)
```

Das Register bildet jede Anbieter-/Modell-ID auf einen Cortex-Eintrag ab und stellt drei Helfer bereit:

- `codename(vendorId)` → reiner Codename, z. B. `"mistral-ocr-latest"` → `"ONYX"`. Drop-in überall, wo bisher eine rohe Engine-ID ausgegeben wurde.
- `engineLabel(vendorId)` → volles Label, z. B. `"Cortex ONYX"`, für Überschriften und Badges.
- `sanitizeKeys(obj)` → schreibt Objekte um, deren **Schlüssel** Anbieternamen sind (Provider-/Genauigkeits-Maps, über die das UI iteriert): `{ mistral: true }` → `{ ONYX: true }`.

Die Auflösung ist tolerant (Teilstring, längster Treffer zuerst), sodass sowohl `mistral-ocr-latest` als auch ein blankes `mistral` korrekt landen. Unbekannte IDs fallen sicher auf den Familiennamen `CORTEX` zurück — nie auf einen Anbieternamen.

## Anbieter wechseln — die Ein-Zeilen-Prozedur

Wird ein Anbieter ersetzt (z. B. ONYX läuft künftig nicht mehr über Mistral OCR):

1. Im Register `VENDOR_MAP` die betroffene Zeile auf die neue Anbieter-ID zeigen lassen.
2. Den `vendor`-Vermerk des Cortex-Eintrags aktualisieren (nur interne Doku-Notiz).
3. Diese Doku-Tabelle in der Anbieter-Spalte nachziehen.

Codename, UI, API, Exporte und Verträge bleiben unverändert. Genau das ist der Zweck: **außen ändert sich nichts.**

## Neue Engine aufnehmen

1. Eintrag in `ENGINES` mit Codename (Tresor-/Mineral-/Orakel-Wort), `tier`, `label`, `blurb`, `vendor`.
2. Zeile(n) in `VENDOR_MAP` für die Anbieter-/Modell-IDs.
3. Diese Tabelle erweitern.
4. Falls eine neue Stufe entsteht: Produkt-/Preis-Stufe gegen die bestehenden Tiers prüfen.

## Geltungsbereich

Cortex-Namen gelten für jedes ZABAZINGO-Produkt, das diese Engines nutzt — Tresor/Dokumente, Verträge, Belege und alle künftigen. Tritt irgendwo ein roher Anbietername auf (UI-Text, API-Feld `engine`, Status-/Genauigkeitstabelle, Export, Audit-Text), ist das ein Defekt und wird über das Register behoben, nicht durch lokales Umschreiben.