fix: broken links, pre-commit hooks, package rename

Author: m.buchhorn-roth

.husky/pre-commit

@@ -0,0 +1,16 @@
+#!/bin/sh
+# Pre-commit quality gates
+
+echo "⏳ TypeScript type check..."
+npx tsc --noEmit || { echo "❌ TypeScript errors — commit blocked"; exit 1; }
+
+echo "⏳ ESLint..."
+npm run lint || { echo "❌ ESLint errors — commit blocked"; exit 1; }
+
+echo "⏳ Markdownlint..."
+npx markdownlint "**/*.md" --ignore node_modules --ignore ".husky" || { echo "❌ Markdown lint errors — commit blocked"; exit 1; }
+
+echo "⏳ Link check (staged files only)..."
+python3 scripts/check_links.py || { echo "❌ Broken links found — commit blocked"; exit 1; }
+
+echo "✅ All checks passed"

.markdownlint.json

@@ -0,0 +1,12 @@
+{
+  "default": true,
+  "MD009": false,
+  "MD013": false,
+  "MD022": false,
+  "MD024": false,
+  "MD032": false,
+  "MD033": false,
+  "MD036": false,
+  "MD041": false,
+  "MD060": false
+}

README.md

@@ -1,8 +1,8 @@
-# 📋 CASSA DRV — Digitaler Wissensassistent für die Rentenversicherung
+# 📋 CASSA RELIEF — Digitaler Wissensassistent für die e-Akte
 
 **Compliance-Assured Structured Semantic Analysis** für die Deutsche Rentenversicherung — Interaktive 3D-Visualisierung eines Sozialrecht-Knowledge-Graphs mit GraphRAG und Chat-API.
 
-> **[▶ Live-App öffnen](https://ma3u.github.io/cassa-drv/)**
+> **[▶ Live-App ö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)
 
@@ -50,8 +50,8 @@ CASSA demonstriert, wie ein **Knowledge Graph** mit **GraphRAG** die Komplexitä
 
 ```bash
 # Repository klonen
-git clone https://github.com/ma3u/cassa-drv.git
-cd cassa-drv
+git clone https://github.com/ma3u/cassa-relief.git
+cd cassa-relief
 
 # Abhängigkeiten installieren
 npm ci
@@ -60,7 +60,7 @@ npm ci
 npm run dev
 ```
 
-Öffne [http://localhost:5173/cassa-drv/](http://localhost:5173/cassa-drv/) im Browser.
+Öffne [http://localhost:5000/cassa-relief/](http://localhost:5000/cassa-relief/) im Browser.
 
 ## Build & Deploy
 
@@ -74,7 +74,7 @@ npm run lint      # ESLint
 
 Das Projekt wird automatisch via GitHub Actions deployed:
 - Push auf `main` → Build → Deploy auf GitHub Pages
-- URL: `https://ma3u.github.io/cassa-drv/`
+- URL: `https://ma3u.github.io/cassa-relief/`
 
 ---
 
@@ -93,7 +93,7 @@ Die Landing Page zeigt 4 konkrete Beispiele, wo Vector RAG versagt:
 
 CASSA implementiert eine OpenAI-kompatible Chat-API:
 
-```
+```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
@@ -106,7 +106,7 @@ GET  /health              # Health Check
 
 ## Projektstruktur
 
-```
+```text
 src/
 ├── App.tsx                           # Haupt-SPA mit allen Sektionen
 ├── components/

RELIEF_DEMO_PLAN.md

@@ -168,7 +168,7 @@ Bezogen auf den konkreten CASSA RELIEF Use Case — 47 Dokumente (Fotos, Scans,
 
 ### Phase 1: Textextraktion (OCR & Parsing)
 
-#### [IBM Granite-Docling-258M](https://huggingface.co/ds4sd/docling-ibm-granite-258m-preview) (Sep 2025, Apache 2.0)
+#### [IBM Granite-Docling-258M](https://github.com/DS4SD/docling) (Sep 2025, Apache 2.0)
 
 Der aktuell beste Open-Source-Ansatz für den RELIEF-Use Case. Das Modell ist mit nur **258M Parametern** speziell für Dokumentenkonvertierung trainiert — nicht auf einen allgemeinen LLM adaptiert. Es liefert **DocTags**, die Layout, Tabellenstruktur, Formeln und Code vollständig erhalten, und übertrifft dabei deutlich größere Systeme in Benchmarks. Für RELIEF zentral: Es verarbeitet sowohl digitale PDFs (ohne OCR-Overhead) als auch **Fotos und Screenshots** (mit integrierter Vision) — also genau die Qualitätsprobleme #1–#4 aus dem Demo-Fall.
 
@@ -228,7 +228,7 @@ Für Personennamen (Thomas Becker, Leila Kaya) in deutschen Verwaltungstexten li
 
 ### Empfohlene RELIEF-Pipeline (vollständig lokal, DSGVO-konform)
 
-```
+```text
 Eingang (Foto/Scan/PDF/Screenshot)
         ↓
 [Granite-Docling-258M]  → DocTags / Markdown-Text
@@ -249,7 +249,7 @@ Strukturierte E-AKTE (xdomea 3.0-konform)
 
 | Modell/Tool | Aufgabe | Stärke im RELIEF-Kontext | Lizenz |
 |---|---|---|---|
-| **[Granite-Docling-258M](https://huggingface.co/ds4sd/docling-ibm-granite-258m-preview)** | OCR + Layout | Fotos, Screenshots, Scans → strukturierter Text | Apache 2.0 |
+| **[Granite-Docling-258M](https://github.com/DS4SD/docling)** | OCR + Layout | Fotos, Screenshots, Scans → strukturierter Text | Apache 2.0 |
 | **[GLiNER-PII-Large](https://huggingface.co/knowledgator/gliner-pii-large-v1.0)** | NER/PII | IBAN, Geburtsdatum, Zero-Shot | Apache 2.0 |
 | **[Presidio](https://microsoft.github.io/presidio/)** | Redaktions-Framework | Modularer Stack, Docker-ready | MIT |
 | **[spaCy `de_core_news_lg`](https://spacy.io/models/de#de_core_news_lg)** | NER Deutsch | Deutsche Eigennamen (PER, LOC) | MIT |
@@ -340,12 +340,12 @@ Beispiel für den Demo-Fall:
     → Bescheid erstellen
 ```
 
-#### 2. [BRML](https://docs.oasis-open.org/ruleml/ruleml-specification/v1.03/ruleml-specification-v1.03.html) / [DMN 1.4](https://www.omg.org/spec/DMN/) — Geschäftsregeln
+#### 2. [BRML](https://ruleml.org/) / [DMN 1.4](https://www.omg.org/spec/DMN/) — Geschäftsregeln
 
 Die **Entscheidungslogik** (Rechenregeln, Prüfregeln, Schwellenwerte) wird in maschinenlesbare Regelformate überführt:
 
 - **[DMN](https://www.omg.org/spec/DMN/) (Decision Model and Notation)**: OMG-Standard für Entscheidungstabellen — z.B. Regelbedarfsstufentabelle (§20 SGB II), Freibetragsberechnung (§11b SGB II)
-- **[RuleML](https://docs.oasis-open.org/ruleml/ruleml-specification/v1.03/ruleml-specification-v1.03.html) / BRML**: XML-basierte Geschäftsregelsprache für komplexe Regelketten mit Bedingungen und Ausnahmen
+- **[RuleML](https://ruleml.org/) / BRML**: XML-basierte Geschäftsregelsprache für komplexe Regelketten mit Bedingungen und Ausnahmen
 - **Entscheidungstabellen**: Jede Zeile eine Regel, jede Spalte eine Bedingung — lesbar für Juristen und Fachkräfte
 
 Beispiel DMN-Entscheidungstabelle für Freibeträge (§11b SGB II):

eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  { ignores: ['dist', 'node_modules'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+)