feat: add yED tool, BPMN 2.0 compliance note, gE explanation, rewrite README for RELIEF

m.buchhorn-roth · m.buchhorn-roth · commit b386272ca7f8 · 2026-03-14T16:24:48.000+01:00
diff --git a/README.md b/README.md
@@ -1,37 +1,48 @@
-# 📋 CASSA RELIEF — Digitaler Wissensassistent für die e-Akte
+# CASSA RELIEF — KI-gestützte E-AKTE für die Grundsicherung
 
-**Compliance-Assured Structured Semantic Analysis** für die Deutsche Rentenversicherung — Interaktive 3D-Visualisierung eines Sozialrecht-Knowledge-Graphs mit GraphRAG und Chat-API.
+**Compliance-Assured Structured Semantic Analysis** — KI-gestützte Dokumentenklassifikation, Aktenpflege und Prozessmodellierung für die **gemeinsamen Einrichtungen (gE)** nach SGB II.
 
-> **[▶ Live-App öffnen](https://ma3u.github.io/cassa-relief/)**
+> **[▶ Live-Demo öffnen](https://ma3u.github.io/cassa-relief/)**
 
-![Knoten](https://img.shields.io/badge/Knoten-65+-blue) ![Beziehungen](https://img.shields.io/badge/Beziehungen-90+-green) ![SGB](https://img.shields.io/badge/SGB-5%2B-orange) ![Chat API](https://img.shields.io/badge/Chat_API-OpenAI--kompatibel-brightgreen)
+![SGB II](https://img.shields.io/badge/SGB_II-Grundsicherung-blue) ![BPMN](https://img.shields.io/badge/BPMN-2.0_konform-green) ![DSGVO](https://img.shields.io/badge/DSGVO-konform-orange) ![AI](https://img.shields.io/badge/KI-lokal_%2B_DSGVO-brightgreen)
 
 ---
 
-## Was ist CASSA DRV?
+## Was ist CASSA RELIEF?
 
-CASSA demonstriert, wie ein **Knowledge Graph** mit **GraphRAG** die Komplexität des Sozialrechts beherrschbar macht. Das Projekt zeigt die **Multi-Layered Ontologie-Architektur** für die Deutsche Rentenversicherung:
+**Gemeinsame Einrichtungen (gE)** sind die lokalen Jobcenter, in denen Bundesagentur für Arbeit und kommunale Träger gemeinsam die Grundsicherung für Arbeitsuchende nach SGB II umsetzen. Täglich bearbeiten Fachkräfte Anträge, Veränderungsmitteilungen und endgültige Festsetzungen auf Basis umfangreicher Fallakten.
 
-| Schicht | Name | Beschreibung |
-|---------|------|-------------|
-| 1 | **Normative Schicht** | Hierarchie der Rechtsquellen — EU-Recht, SGB I–XII, Rechtsverordnungen, GRA |
-| 2 | **Zeitliche Dimension** | Übergangsregelungen (§235 SGB VI), Rentenanpassungen, stufenweise Anhebungen |
-| 3 | **Prozedurale Schicht** | DRV-Geschäftsprozesse: Rentenantrag, EM-Prüfung, Reha, Widerspruchsverfahren |
-| 4 | **Fallbezogener Overlay** | Versichertendaten: Entgeltpunkte, Wartezeiten, Gutachten, Bescheide |
+**Das Problem:** Dokumente gelangen unstrukturiert in die E-AKTE — falsch klassifiziert, ohne Metadaten, in falscher Reihenfolge, mit ungeschwärzten Datenschutzdaten. Die manuelle Aktenerschließung bindet erhebliche Arbeitszeit, die für die eigentliche Leistungsbemessung fehlt.
+
+**RELIEF löst das** durch KI-gestützte Dokumentenverarbeitung entlang einer 4-stufigen Pipeline:
+
+| Schritt | Aufgabe | Technologie |
+|---------|---------|-------------|
+| 1 | **OCR & Parsing** | IBM Granite-Docling-258M — Fotos, Scans, PDFs → strukturierter Text |
+| 2 | **Klassifikation** | Dokumententyp, Metadaten, Aktenzuordnung per NLP |
+| 3 | **PII-Schwärzung** | GLiNER + Presidio — IBAN, Geburtsdaten, Namen (DSGVO-konform) |
+| 4 | **Prozessmodellierung** | BPMN 2.0 + DMN — Rechtsregeln maschinenlesbar, prüfbar, deploybar |
+
+### Demo-Fall: Familie Becker (BG-Nr. 412K-078263-B)
+
+Fünfköpfige Bedarfsgemeinschaft, 47 eingereichte Dokumente, 6 Rechtsprüfpunkte (§§ 7, 9, 11, 11b, 12 SGB II, vorläufige Entscheidung §41a SGB II). RELIEF klassifiziert alle Dokumente automatisch und erstellt prüfbare BPMN-Modelle für jeden Berechnungsschritt.
+
+---
 
 ## Features
 
-- **Interaktiver 3D-Knowledge-Graph** — 65+ Knoten, 90+ Beziehungen, 10 Knotentypen (Gesetze, Paragraphen, Regeln, Prozesse, Entitäten, GRA, Chat-API-Standards)
-- **Graph RAG vs. Vector RAG** — 4 konkrete Beispiele, wo Vector RAG bei gesetzesübergreifenden Fragen versagt
-- **Chat-API nach Industriestandards** — OpenAI-kompatible API mit GraphRAG-Erweiterungen (Zitationen, Sessions)
-- **Praxisszenarien** — Compliance-Analyse, Prozess-Engineering, Gesetzesfolgen-Analyse, Onboarding
-- **Detailpanel** — Klick auf jeden Knoten zeigt Paragraphendetails, Geschäftsregeln, Querverweise
-- **Standards & Compliance** — SGB I/IV/VI/IX/X, DSGVO, BSI IT-Grundschutz, GRA-Anweisungen
-- **Responsive Design** — Optimiert für Desktop und Tablet
+- **KI-Dokumentenklassifikation** — Kontoauszüge, Mietverträge, Lohnabrechnungen automatisch erkannt und sortiert
+- **BPMN 2.0-Prozessmodellierung** — Rechtsregeln aus SGB II als ausführbare Diagramme, kompatibel mit Camunda, yEd, BPMN.io
+- **DMN-Entscheidungstabellen** — Freibeträge (§11b), Regelbedarfe (§20), KdU (§22) als prüfbare Tabellen
+- **PII-Schwärzung** — Automatische Erkennung von Datenschutzdaten (DSGVO Art. 9, §67 SGB X)
+- **3D-Knowledge-Graph** — Interaktive Visualisierung der SGB-II-Rechtsstruktur mit GraphRAG
+- **Interaktiver BPMN-Viewer** — Prozessdiagramm direkt im Browser bearbeiten und exportieren
+- **Vollständig lokal betreibbar** — Keine Cloud-Abhängigkeit, DSGVO-konform
+- **Praxisszenarien** — 5 konkrete Anwendungsfälle aus der gE-Praxis
 
 ---
 
-## tech Stack
+## Tech Stack
 
 | Technologie | Version | Zweck |
 |-------------|---------|-------|
@@ -40,8 +51,8 @@ CASSA demonstriert, wie ein **Knowledge Graph** mit **GraphRAG** die Komplexitä
 | Vite | 7 | Build-Tool (SWC) |
 | Tailwind CSS | 4 | Styling (oklch Farbsystem) |
 | shadcn/ui | — | UI-Komponentenbibliothek (Radix UI) |
-| react-force-graph-3d | 1.29 | 3D-Graph-Visualisierung |
-| three.js | 0.175 | WebGL-Rendering |
+| react-force-graph-3d | 1.29 | 3D-Knowledge-Graph |
+| bpmn-js | — | BPMN 2.0 Viewer/Editor im Browser |
 | framer-motion | 12.6 | Animationen |
 
 ---
@@ -78,45 +89,46 @@ Das Projekt wird automatisch via GitHub Actions deployed:
 
 ---
 
-## Graph RAG vs. Vector RAG
+## BPMN 2.0-Kompatibilität
 
-Die Landing Page zeigt 4 konkrete Beispiele, wo Vector RAG versagt:
+CASSA exportiert Prozessmodelle im offenen **BPMN 2.0-Standard (OMG)**. Die generierten XML-Dateien sind direkt kompatibel mit:
 
-| Beispiel | Problem bei Vector RAG | Graph RAG Lösung |
-|----------|----------------------|-----------------|
-| **Multi-Hop Rentenanspruch** | Verknüpft nicht §35 → §50 → §235 → §56 | Traversiert alle relevanten Paragraphen |
-| **Gesetzesübergreifende Fristen** | Findet Reha-Fristen nicht in SGB X | Folgt Querverweisen über 3 Gesetze |
-| **Ausnahmeregel §53** | Übersieht vorzeitige Wartezeiterfüllung | Erkennt Ausnahme via Graph-Kante |
-| **Temporale Altersgrenze** | Gibt generisch 67 Jahre an | Hat strukturierte Übergangstabelle |
+| Tool | Typ | Einsatz |
+|------|-----|---------|
+| **Camunda Platform 8** | Engine | Ausführbare Prozesse, Workflow-Automation |
+| **BPMN.io** | Web-Editor | Bearbeitung im Browser, kostenlos |
+| **yEd Graph Editor** | Desktop-Editor | Professionelles Layout mit Auto-Algorithmen |
+| **Signavio / Celonis** | Enterprise | Process Mining, Legacy-Analyse |
+| **Drools** | Rules Engine | Komplexe Regelketten, Forward-Chaining |
 
-## Chat API
+---
 
-CASSA implementiert eine OpenAI-kompatible Chat-API:
+## KI-Modelle (lokal, Open Source)
 
-```http
-POST /api/v1/chat        # Multi-Turn Chat mit Session
-POST /api/v1/search       # Single-Turn Search (stateless)
-GET  /api/v1/chat/{id}/history  # Konversationsverlauf
-DELETE /api/v1/chat/{id}  # Session löschen
-GET  /docs                # Swagger UI
-GET  /health              # Health Check
-```
+| Modell | Aufgabe | Lizenz |
+|--------|---------|--------|
+| [IBM Granite-Docling-258M](https://github.com/DS4SD/docling) | OCR + Layout | Apache 2.0 |
+| [GLiNER-PII-Large](https://huggingface.co/knowledgator/gliner-pii-large-v1.0) | PII-Erkennung | Apache 2.0 |
+| [Presidio](https://microsoft.github.io/presidio/) | Schwärzungs-Framework | MIT |
+| [spaCy de_core_news_lg](https://spacy.io/models/de) | NER Deutsch | MIT |
 
 ---
 
 ## Projektstruktur
 
 ```text
 src/
-├── App.tsx                           # Haupt-SPA mit allen Sektionen
+├── App.tsx                              # Haupt-SPA mit allen Sektionen
 ├── components/
-│   ├── DRVKnowledgeGraph3D.tsx       # 3D-Graph (65+ Knoten, Sozialrecht)
-│   └── ui/                           # 45 shadcn/ui-Komponenten
-├── hooks/use-mobile.ts               # Mobile-Breakpoint-Hook
-├── lib/utils.ts                      # cn() Utility
-├── main.css                          # Tailwind v4, Design-Tokens
-├── index.css                         # DRV-Farbschema (oklch)
-└── styles/theme.css                  # Radix-Farbskalen
+│   ├── RELIEFKnowledgeGraph3D.tsx       # 3D-Graph SGB II (Grundsicherung)
+│   ├── DRVKnowledgeGraph3D.tsx          # 3D-Graph SGB VI (Referenz)
+│   ├── DataModelGraph3D.tsx             # Ontologie-Schema
+│   └── ui/                             # 45 shadcn/ui-Komponenten
+├── hooks/use-mobile.ts                  # Mobile-Breakpoint-Hook
+├── lib/utils.ts                         # cn() Utility
+├── main.css                             # Tailwind v4, Design-Tokens
+├── index.css                            # Farbschema (oklch)
+└── styles/theme.css                     # Radix-Farbskalen
 ```
 
 ## Lizenz
diff --git a/src/App.tsx b/src/App.tsx
@@ -175,8 +175,8 @@ function App() {
       icon: Users,
       title: "Fachkräftemangel in den gE",
       stat: "75.000",
-      statLabel: "Beschäftigte in gE",
-      description: "Aktenerschließung und Aktenpflege binden erhebliche Arbeitszeit der Fachkräfte. Jede Minute für manuelle Aktenarbeit fehlt bei der eigentlichen Leistungsbemessung.",
+      statLabel: "Beschäftigte in gE (gemeinsame Einrichtungen)",
+      description: "Gemeinsame Einrichtungen (gE) sind die lokalen Jobcenter, in denen Bundesagentur für Arbeit und kommunale Träger gemeinsam die Grundsicherung nach SGB II umsetzen. Aktenerschließung und Aktenpflege binden erhebliche Arbeitszeit der Fachkräfte. Jede Minute für manuelle Aktenarbeit fehlt bei der eigentlichen Leistungsbemessung.",
       trend: "Entlastung nötig",
       color: "oklch(0.45 0.12 200)"
     }
@@ -1602,13 +1602,20 @@ function App() {
             </Card>
           </motion.div>
 
-          {/* Tool cards for process modernization */}
-          <div className="grid md:grid-cols-2 lg:grid-cols-4 gap-4 mt-12">
+          {/* BPMN 2.0 compliance note + Tool cards for process modernization */}
+          <div className="mt-12">
+            <p className="text-sm text-muted-foreground text-center mb-6 max-w-3xl mx-auto">
+              CASSA exportiert Prozessmodelle im offenen <strong>BPMN 2.0-Standard (OMG)</strong> — kompatibel mit allen
+              gängigen Editoren. Die generierten XML-Dateien lassen sich direkt importieren, bearbeiten und als ausführbare
+              Workflows deployen.
+            </p>
+          <div className="grid md:grid-cols-2 lg:grid-cols-5 gap-4">
             {[
               { name: 'Camunda Platform 8', url: 'https://camunda.com/', desc: 'BPMN-Engine: Führt Geschäftsprozesse als ausführbare Modelle aus' },
               { name: 'Drools', url: 'https://www.drools.org/', desc: 'Business Rules Engine für komplexe Regelketten und Forward-Chaining' },
               { name: 'BPMN.io', url: 'https://bpmn.io/', desc: 'Open-Source-Editor für BPMN- und DMN-Diagramme (Web-basiert)' },
               { name: 'Celonis / Signavio', url: 'https://www.celonis.com/', desc: 'Process Mining: Analysiert Legacy-Systeme und extrahiert Prozessabläufe' },
+              { name: 'yEd Graph Editor', url: 'https://www.yworks.com/products/yed', desc: 'Professioneller Graph- und Diagrammeditor: Layout-Algorithmen für komplexe Prozessmodelle' },
             ].map((tool, i) => (
               <motion.div
                 key={i}
@@ -1631,6 +1638,7 @@ function App() {
               </motion.div>
             ))}
           </div>
+          </div>
         </div>
       </section>
       {/* ── SECTION: Praxisszenarien ── */}
