Architektur¶
Diese Sektion enthält die produkt-weiten Architektur-Konzepte der kora-Plattform: Multi-Tenancy-Fundament, Detail-Plan-Synthese für v1.0.0 SaaS, Konnektor-Roadmap und das post-v1.0.0-Modul Knowledge- Hub. Sicherheits-Architektur (Defense-in-Depth) liegt als Unter-Section.
Dokumente¶
| Dokument | Zielversion | Inhalt |
|---|---|---|
| Multi-Tenancy-Fundament | v1.0.0 | Haupt-Architektur: Drei Rollenschichten (Vendor/Operator/Tenant), Chatbot-Entität, Templates, Konnektor-Subsystem, Keycloak-Setup, Deployment, Parallel-Entwicklungs-Strategie, Go-Live |
| v1.0.0 SaaS-Detail-Plan-Synthese | v1.0.0 | Operative Restmenge auf Karten-Granularität: 11 offene Roadmap-Blöcke + 4 neue Sub-Karten (DSGVO-1/2/3 + CI-1). Schätzungs-Kalibrierung aus changelog-Historie, Saga-Lehren-Mapping, Risiko-Bewertungs-Matrix |
| Konnektor-Roadmap | v1.0.0+ | Priorisierte Mehr-Jahres-Planung für Konnektor-Implementierungen über 4 Wellen, Permission-Framework-Phasierung, SDK-Stufe 2 für AVS, Deprecation-Policy |
| Knowledge-Hub-Modul | v2.0.0 | Such-First-UI neben dem Chatbot. Bewusste Lernphase nach 2-3 Monaten AVS-Feedback aus v1.0.0-Produktivbetrieb |
| Defense-in-Depth Architektur | live | 7-Layer-Topologie L5 → α → Cache → L2 → LLM-Stream-with-Inline-L3 → L4 plus Mermaid-Flowchart und BPMN-Prozessmodell |
Lese-Reihenfolge für neue Beitragende¶
- Multi-Tenancy-Fundament zuerst — enthält das Gesamt-Konzept und alle Rollen-Definitionen, auf die die anderen verweisen
- v1.0.0 SaaS-Detail-Plan-Synthese als operativer Restmenge-Plan auf Karten-Granularität — synthese für die offenen Roadmap-Blöcke und drei neue DSGVO-Achsen
- Defense-in-Depth Architektur als Sicherheits-Pillar — gilt produkt-weit und wirkt orthogonal zu allen anderen Layers
- Konnektor-Roadmap als Ergänzung zum Fundament — plant den Konnektor-Ausbau über mehrere Releases
- Knowledge-Hub-Modul nur relevant, wenn v2.0.0-Arbeit beginnt
Methodische Konstitution (Saga-Lehren) liegt in der Methodik-Sektion. Pre-flight-Discovery, Code-Reviews und Release-Bilanzen liegen im Audit-Trail.
Status & Versionierung¶
Alle Architektur-Dokumente sind konsolidierte Arbeitsstände nach der vollständigen Konzept-Dialog-Phase (April 2026). Änderungen werden im Repo-Versionsverlauf dokumentiert — Git ist die Historie. Wesentliche Architektur-Entscheidungen werden in der Änderungshistorie am Anfang jedes Dokuments festgehalten, nicht nur als Git-Commit.
Was in dieser Sektion nicht liegt¶
- AVV-Entwurf (liegt rechtlich-organisatorisch separat)
- Implementierungs-Details (gehören in Code-Kommentare,
CLAUDE.md, oder in die AVS-architecture/-Docs) - Operativ-Runbooks (liegen in der Operator-Sektion)
- Projekt-Status / Release-Planung (siehe Roadmap)
Architektur-Dokumente sind Entscheidungs-Doku, keine Implementation- Guides.