Designprinzipien

Dies sind die Prinzipien der jinflow.core analytischen Engine — des generischen Frameworks, das Domain Packs fuer spezifische Branchen (z.B. Gesundheitswesen, Weinbau, Logistik) instanziieren. Vier Kernwerte definieren die Identitaet; achtzehn Prinzipien setzen sie um.

---

Die vier Werte

Wert	Motto	Unterstuetzende Prinzipien
Deklarativ	Du deklarierst was erkannt werden soll. Die Engine erledigt den Rest.	#9 YAML-to-SQL Compilation, #3 Contract-First, #8 Metadata-Driven, #16 Pragmatic Generalization
Transparent	Nichts ist verborgen. Alles ist abfragbar und wiederherstellbar.	#4 No Silent Filtering, #6 Rebuildable by Default, #17 Calibrated Not Just Tested, #1 Layered Architecture
Unabhaengig	Welten, Tenants und Ebenen blockieren sich nicht gegenseitig.	#18 Parallel Evolution, #7 Processing and Exploration are Independent, #5 Tenant Isolation, #2 Source-System Agnosticism
Menschlich	Menschen entscheiden. KI unterstuetzt. Wissen wird erfasst.	#10 Human-in-the-Loop, #11 AI as SME, #12 AI as Colleague, #13 No AI in Data Path, #14 Privacy, #15 Tri-Lingual

Die 18 Prinzipien unten sind die Umsetzung. Diese 4 Werte sind die Identitaet. Wenn eine Designentscheidung mit den Prinzipien uebereinstimmt aber einen Wert verletzt, gewinnt der Wert.

---

Die 18 Prinzipien

1. Geschichtete Architektur

Bronze ist Struktur. Silver ist Domain-Wahrheit. Gold ist Konsum. Drei Medallion-Ebenen mit strikten Verantwortungsgrenzen.

2. Quellsystem-Agnostizismus

Einmal dispatchen, bei Bronze. Dann vergessen woher die Daten kamen.

3. Contract-First

Versionierte JSON-Schemas definieren jede Grenze.

4. Kein stilles Filtern

Ungueltige Zeilen werden markiert, nie verworfen.

5. Tenant-Isolation

Schema-pro-Tenant. Daten vermischen sich nie.

6. Standardmaessig wiederherstellbar

Die analytische Datenbank ist ephemer.

7. Verarbeitung und Exploration sind unabhaengig

Sie teilen einen Contract, keine Laufzeitumgebung.

8. Metadatengesteuert, nicht hardcodiert

Schema annehmen, nicht Inhalt.

9. YAML-zu-SQL-Kompilierung

Ein Compiler-Muster fuer alles.

10. Mensch im Kreislauf standardmaessig

Das System erkennt und erklaert. Menschen entscheiden und handeln.

11. KI als Fachexperte

KI erfasst Domain-Wissen. Die Pipeline fuehrt es aus.

12. KI als Programmier-Kollege

Die Codebasis ist KI-nativ.

13. Keine KI im Datenpfad

Null LLM-Aufrufe in Produktion. dbt Builds sind deterministisches SQL.

14. Privacy by Design

Alle IDs sind pseudonymisierte Token.

15. Dreisprachig von Tag Eins

Jeder benutzersichtbare String existiert in DE/FR/EN.

16. Pragmatische Generalisierung

80% generisch, 20% domain-spezifisch. So beibehalten.

17. Kalibriert, nicht nur getestet

Synthetische Tenants tragen absichtlich injizierte Defekte.

18. Parallele Evolution (P/T-Worlds)

Pipeline und Instrumente entwickeln sich kontinuierlich und unabhaengig.

---

Wo diese Prinzipien leben

• jinflow.core besitzt Prinzipien 1–13 und 16–17
• Domain Packs fuegen Prinzipien 14–15 als domain- und regulatorische Einschraenkungen hinzu