Zum Inhalt

kora Platform Documentation

kora ist eine mandantenfähige Chatbot-Plattform für die Tourismus- und Verwaltungs-Domäne. Kern ist eine Retrieval-Augmented-Generation- Pipeline (RAG) mit erweiterbarer Konnektor-Infrastruktur für externe Wissensquellen.

Aktueller Stand (2026-05-09)

Phase A (Tenant-Datenmodell) ✅, Phase B teilweise ✅, Defense-in-Depth-Saga ✅ (~52h, 13 Karten, 13 Saga-Lehren), Cleanup-Folge-Serie 1-3 ✅. Restmenge ~140-180h bis v1.0.0-Release — Detail in Roadmap und SaaS-Detail-Plan-Synthese.

Schnellstart pro Rolle

  • Endnutzer (Chatbot-User): Doku in Vorbereitung — siehe AVS-Handbuch als Pattern-Vorlage.
  • Administrator (Tenant-Verwaltung): Doku in Vorbereitung — siehe AVS-Admin-Handbuch als Pattern-Vorlage.
  • Operator (Self-Hosting): Runbooks + Disziplinen + References in der Operator-Sektion.
  • Entwickler (API-Integration): API/SDK-Doku in Vorbereitung.
  • Architekt (interne Architektur): Architektur-Sektion mit Multi-Tenancy- Fundament, SaaS-Detail-Plan, Defense-in-Depth.
  • Methodik: Saga-Lehren als produkt-weite Konstitution; Code-Review-Template; Doku-IA-Audit.

Architektur-Pillars

kora-platform kombiniert drei orthogonale methodische Pillars:

  1. Multi-Tenancy-Fundament — Drei-Schichten-Modell (Vendor / Operator / Tenant), Postgres-RLS auf 13 Tabellen, Qdrant-Collection-per-Chatbot, Dual-Realm-Keycloak. Detail: architektur/multitenancy-fundament.md.
  2. Defense-in-Depth — 7-Layer-Topologie L5 → α → Cache → L2 → LLM-Stream-with-Inline-L3 → L4 mit inkrementeller Pattern-Prüfung (LookAheadBuffer K=16) und Hard-Stop-Correction-SSE statt Post-Hoc-Replace. Detail: architektur/sicherheit/defense-in-depth.md.
  3. Saga-Methodik — 13 produkt-weite Lehren als Konstitution für künftige Sicherheits- und Architektur-Initiativen. Detail: methodik/saga-lehren.md.

Verhältnis zur AVS-Dokumentation

AVS ist der erste Kunde und aktuelle Operator der kora-Plattform. Die AVS-spezifische Bedienungs- und Betriebs-Dokumentation (End-User-Handbuch, Admin-Handbuch, AVS-spezifische Keycloak- und Deployment-Anleitungen) liegt unter docs.avs.luki-net.org und gilt als Pattern-Vorlage für die generischen kora-Endnutzer- und Administratoren-Sektionen, die in Karte C (Customer-Handbuch-Inhalt, ~81-120h) befüllt werden.

Zielgruppen

Diese Dokumentation richtet sich an Entwickler, Architekten und Operator, die die kora-Plattform erweitern, integrieren oder in eigener Infrastruktur betreiben. Sie beschreibt die Plattform- Konzepte produktneutral — ohne kundenspezifische Details.