GitLaw ⚖️

Bewerbung als AI Software Engineer: portfolio.html — Stellenanforderungen 1:1 gemappt auf Code-Pfade in diesem Repo (RAG, MCP-Server, Knowledge Graphs, Cloud-ready Container, DSGVO-Compliance).

See also:

• portfolio.html — Portfolio-Page für Bewerbungen
• AGENTS.md — repo priorities and low-interruption collaboration rules
• GITLAW_COMPANY_THESIS_DE.md
• GITLAW_EXECUTION_PLAN_DE.md
• GITLAW_FOUNDER_ROADMAP_DE.md

Alle 5.936 deutschen Bundesgesetze — durchsuchbar, AI-erklärbar auf Deutsch, mit Musterbriefen.

Zwei Welten unter einem Dach:

• GitLaw — kostenlos für alle Bürger:innen. Open Source (AGPL-3.0). Donations-finanziert. → gitlaw.app bzw. gitlaw-xi.vercel.app
• GitLaw Pro — Anwält:innen-Tier mit Branding, Akten, KI-Recherche-Verifikation, Fristen, Cloud-Sync, mehrsprachige Mandantenaufnahme (DE/VI/TR/AR/EN) und erster agentischer Workflow-Grundlage. → gitlaw-xi.vercel.app/#/pro/preise · ab €19/Mo Lite · €79 Solo · €149/RA Kanzlei

1,3 Mio. Zeilen Recht · 98.367 semantische Vektoren · 31 Musterbriefe (20 Bürger + 11 Anwält:innen) · UI + Core-Workflows auf Deutsch · Pro-Intake-Form in 5 Sprachen (DE/VI/TR/AR/EN) für Kanzleien mit mehrsprachiger Klientel.

---

🆓 GitLaw — Bürger:innen-Version

Features

• 🔍 Alle Gesetze durchsuchen — Fuzzy + semantisch (FAISS, 98K Vektoren)
• 💡 AI-Erklärungen — 112 Paragraphen in einfacher Sprache
• 💬 Chat mit Folgefragen — personalisiert für 12 Profile · antwortet auf Deutsch (Runtime-Sprachwahl über OpenAI möglich, nicht statisch übersetzt)
• 📝 20 Musterbriefe — Widerruf, Reklamation, Kündigung, DSGVO …
• 📰 Gesetz des Tages + 🏠 Themen-Buttons
• ♿ A-/A+ Schriftgröße · 🌙 Darkmode · Themen-Buttons statt Tippen

Top Musterbriefe (Suchvolumen / Monat)

Brief	Suchen/Mo
🛒 Widerruf Online-Kauf	40K
🔧 Reklamation	25K
🏠 Kündigung Mietvertrag	22K
🚗 Einspruch Bußgeld	20K
💧 Widerspruch Nebenkosten	18K
+ 15 weitere	150K+

---

💼 GitLaw Pro — für Anwält:innen

Eigenständiger Bereich unter /#/pro — Beta, Invite-only.

Was es macht

Bereich	Funktion
Daily Companion	Dashboard mit Fristen-Übersicht, Mandant:innen-Eingängen, „Diese Woche gespart"-Widget, persönlicher Begrüßung
Recherche mit 3-Stufen-Belegen	KI-Antwort mit verifizierten Zitaten + Folgefragen mit Kontext-Verlauf (mehrere Vertiefungen hintereinander, einzeln speicherbar) + (1) kuratierte BGH/BVerfG-Leitsätze + (2) Live-Lookup OpenLegalData (1.000+ Treffer/§) + (3) Deep-Links Beck/dejure/openjur
Verwandte Paragraphen	Aus dem Citation-Graph (94K Knoten / 200K Edges): jeder zitierte § zeigt im Drawer automatisch wer ihn zitiert + was er zitiert. § 185 → § 188 + § 192 + § 11 — ohne Cross-Reading.
Anti-Halluzinations-Badges	Strukturierte Verifikations-Stati: ✓ verifiziert · ⚠ Gesetz unbekannt · ⚠ § nicht gefunden · 🚨 aufgehoben (weggefallen). Erkennt auch Range-Marker (§§ 2 bis 3f weggefallen deckt § 3 NetzDG ab). 53/53 Eval-Cases passing in CI.
Word-Export (.docx)	Editierbares Word-Dokument neben dem PDF — direkt in Word/Office weiterarbeiten ohne Copy-Paste. Briefkopf, Verifikations-Status pro Zitat, Page-Footer.
Mandant:innen-Akten	CRUD mit Frist-Tracker (Calc aus Bescheid-Datum, §§ 187/188 BGB-konform), Mandant:in-E-Mail, Status, Such- & Filter-Tabs
Mandatsart-Checklisten (Sprint 1)	11 Migrations-Mandatsarten · 108 kuratierte Pflicht-Unterlagen · Status pro Item (erhalten / ausstehend / Problem) · „nur fehlende Pflicht"-Filter
8-Stati-Workflow + Sachstand-Generator (Sprint 1)	Klar definierte Übergangs-Regeln (unterlagen_fehlen → … → verfahren_abgeschlossen) · 32 Antwort-Templates DE+VI für Mandant und Mittelsperson · Generator setzt Mandantenname, Behörde, Frist, Aktenzeichen automatisch ein
Behörden-DB (Sprint 1)	17 Berliner Migrations-Stellen vorbefüllt (LEA, BAMF, VG Berlin, Botschaften Vietnam) — Combobox-Suche statt Freitext
59 Schreiben-Templates	5 allgemein + 12 Notariat + 12 Migration + 10 Familien + 10 Sozial + 10 Steuer + Custom mit {{placeholder}}
Branded PDF-Export	Logo + Kanzlei-Anschrift + Disclaimer-Footer auf jedem Dokument
Mandant:innen-Intake	QR-Code für Erstanfragen-Formular in 5 Sprachen (DE/VI/TR/AR/EN, RTL für Arabisch), inkl. Dringlichkeit + Frist-Hinweis + Anhangs-Metadaten (Kategorie/Sprache/interner Dateiname), Antwort landet in Akte
CSV-Akten-Import	Auto-Spalten-Erkennung aus DATEV / RA-Micro / advoware / Excel — Mapping → Bulk-Create
Audit-Log	Lückenlose Aktions-Chronologie, BHV-tauglich als PDF exportierbar
DSGVO-Schutz-Modus	Auto-Anonymisierung vor jeder KI-Anfrage: 14 PII-Pattern (Namen, Adressen, IBAN, BIC, Steuer-ID, SV-Nr., Aktenzeichen, Geb-Datum, Firmen) + Whitelist gegen Falsch-Anonymisierung von Rechtsbegriffen
Cloud-Sync	Tenant-gebundener Auto-Push an Upstash-Redis Frankfurt über signierte Pro-Session statt nur ratebarem Kanzlei-Schlüssel
Pro Session + RBAC	Signierte Pro-Session mit tenantId + role, serverseitige API-Gates für Recherche, Sync, Upload
Dokument-Vault (Beta)	Serverseitiger Dokumentpfad mit Tenant-Bindung als erster Schritt zum finalen EU-Storage
Getesteter Kernloop	Zuletzt intern verifiziert mit 9 PASS / 0 BETA / 0 FAIL; Sessions, Sync, Vault, Research, OCR und Translation fuer Textdokumente laufen im Live-Check
Personal Welcome-Pages	/#/bao, /#/rubin, /#/werner, /#/jasmin — 1-Klick-Login + Branding pre-loaded
AVV-Vorlagen-PDF	Mustertext-Generator auf eigenem Briefkopf
Wöchentliches Auto-Update	GitHub-Action prüft jeden Sonntag mit OpenAI Structured Outputs ob neue BGH-Urteile zu den Top-30 § → öffnet PR mit Diff

Preise

Tier	Preis	Wofür
Solo Lite	€19/Mo	Reinschnuppern, 5 Akten + 10 Recherchen/Mo
Solo ⭐	€79/Mo	Standard-Solo-Anwält:in, alles unbegrenzt
Kanzlei	€149/RA/Mo	Server-Sync, Rollen, ab 2 Anwält:innen
Notariat-Add-on	+€50/Mo	12 Notar-Templates (Vollmacht, Erbschein, Pflichtteil etc.)

60-Tage-Geld-zurück-Garantie: wenn nicht ≥ €1.000 Zeit gespart, volle Rückerstattung.

→ Details + Vergleich vs. RA-Micro/DATEV/Beck: gitlaw-xi.vercel.app/#/pro/preise

---

📊 Zahlen

Metrik	Stand
Gesetze	5.936
Zeilen	1.303.451
Korpus-Paragraphen (Graph-Knoten)	94.178
Extrahierte Cross-References (Graph-Edges)	200.464 (199K intra-law · 1.163 cross-law)
FAISS-Vektoren	98.367
Bürger-Musterbriefe	20 (16 frei, 4 Premium)
Anwalts-Musterbriefe (Pro)	59 (5 Allgemein + 12 Notariat + 12 Migration + 10 Familie + 10 Sozial + 10 Steuer)
Verifizierte BGH/BVerfG-Leitsätze	40 zu Top-30 Paragraphen (BGB · StGB · AufenthG · SGB · StPO · GewSchG)
Live-Rechtsprechungs-Index	150 K+ Urteile über OpenLegalData-Proxy
Citation-Eval (CI)	53/53 hand-gelabelte Cases · 100% Pass-Rate
Sprachen	5 Pro-Intake (DE/VI/TR/AR/EN) + 6 Bürger (DE/Leicht/TR/AR/EN/UK)
Aktualisierung	Wöchentlich automatisch (Gesetze + Leitsätze)

---

🛠 Tech-Stack

Layer	Stack
Frontend	React 19 + TypeScript + Vite + Tailwind 4
Routing	HashRouter (GH-Pages-kompatibel) + react-router-dom 7
Bürger-RAG	LangChain + FAISS + OpenAI Embeddings
Pro-AI	OpenAI gpt-4o-mini mit JSON-Schema Structured Outputs
Pro-Backend	Vercel Serverless Functions + Upstash Redis (Frankfurt) + signierte Pro-Sessions
Citations-Verifikation	Lokal gegen 5.936 Markdown-Files (### § N-Heading-Lookup)
Rechtsprechung Stufe 1	Deep-Links zu Beck-Online / dejure.org / openjur.de
Rechtsprechung Stufe 2	30 kuratierte JSON-Files mit BGH/BVerfG-Leitsätzen aus rechtsprechung-im-internet.de (Public Domain), wöchentlich automatisch aktualisiert via GitHub-Action
Rechtsprechung Stufe 3	OpenLegalData-Proxy mit Upstash-Cache (60d TTL) — 150 K+ Urteile durchsuchbar
PDF	jsPDF (Branded Templates + AVV-Generator)
QR	qrcode.react (mit Vollbild-Modus für Termin)
ZIP	jszip (Akten-Bundle: PDFs + Audit + meta.txt)
CSV-Import	RFC 4180-Parser, UTF-8/Win-1252-Tolerant, Auto-Mapping für DATEV/RA-Micro/advoware
Anonymizer	14 Regex-Pattern + 50 Whitelist-Tokens, Auto-Modus persistiert in localStorage
Updates	GitHub Actions (Gesetze + BGH-Leitsätze)
Hosting	GitHub Pages (Bürger) + Vercel + Upstash Frankfurt (Pro + APIs)
Knowledge Graph	94K Paragraphen + 200K Cross-References, extrahiert via gitlaw_mcp/graph_builder.py, als per-law JSON-Shards in viewer/public/data/citation-graph/ ausgeliefert
MCP Cloud-Deploy	Fly.io (fly.toml) für SSE in Frankfurt + AWS Terraform IaC (deploy/aws/) für ECS Fargate
Observability	JSON-strukturierte Logs pro MCP-Tool-Call (request_id, latency_ms, status) — Datadog/Loki/Sentry/Axiom-fähig
Test-Eval	53 hand-gelabelte Citation-Cases in CI (real, halluziniert, edge-cases, multi-token-Abkürzungen, repealed-Erkennung)

---

🔌 MCP Server — GitLaw als Tool für jeden LLM-Client

Der gesamte Korpus + Citation-Verification ist als Model Context Protocol Server verfügbar (gitlaw_mcp/). Das heißt: Claude Desktop, Cursor, Continue oder jeder eigene Agent kann GitLaw-Tools nativ aufrufen — semantische Suche, Zitat-Verifikation, exakte Paragraphen-Lookups, Graph-Traversierung.

# Beispiel: ein LLM ruft verify_citation("§ 999 StGB") auf
{
  "verified": false,
  "reason": "paragraph_not_found",
  "law": { "name": "Strafgesetzbuch", "abbreviation": "StGB" },
  "hint": "StGB exists, but '§ 999' was not found."
}

Sechs Tools:

• search_laws — FAISS-Retrieval (98K Vektoren)
• verify_citation — Anti-Halluzination mit strukturierten Failure-Modes (53/53 Eval-Cases passing)
• lookup_paragraph — exakter Lookup
• list_laws — Korpus-Enumeration (4.852 Abkürzungen)
• find_related_paragraphs — Citation-Graph-Traversierung (94K Knoten / 200K Edges)
• hybrid_search — Vector + Graph kombiniert in einem Call

Plus die Resource gitlaw://law/{abbr} für ganze Gesetzestexte.

Drei Deploy-Pfade:

• stdio lokal — Claude Desktop / Cursor / eigene Agenten (Setup)
• HTTP/SSE auf Fly.io Frankfurt — push-to-deploy GitHub Action, scale-to-zero (fly.toml)
• AWS ECS Fargate via Terraform — VPC + ALB + EFS + Secrets Manager + Autoscaling, ~$31/Monat (deploy/aws/)

JSON-strukturierte Logs pro Tool-Call (request_id, latency_ms, status) — Datadog/Loki/Sentry/Axiom-fähig ohne Parser.

Demo ohne API-Key:

python -m gitlaw_mcp.demo

---

🤖 Agentic GitLaw Pro

GitLaw Pro wird bewusst nicht als generischer Legal-Chat gebaut, sondern als beaufsichtigter Multi-Agent-Workflow:

intake -> dokumente -> recherche -> entwurf -> freigabe

Aktuelle Agenten-/Workflow-Artefakte:

• GITLAW_AGENT_ARCHITECTURE_DE.md
• GITLAW_AGENT_VISUAL_MAP_DE.md
• GITLAW_AGENT_CODE_MAP_DE.md
• GITLAW_AGENT_EVAL_MATRIX_DE.md
• GITLAW_AGENT_EVAL_SUITE_DE.md
• GITLAW_AGENT_MANUAL_TEST_RUN_SHEET_DE.md
• GITLAW_AGENT_IMPROVEMENTS_DE.md
• GITLAW_5_MINUTE_AGENT_TEST_GUIDE_DE.md
• GITLAW_PILOT_READINESS_REPORT_DE.md
• GITLAW_CREWAI_AUTOMATION_PROMPT_EN.md
• GITLAW_CREWAI_AGENTS.yaml
• GITLAW_CREWAI_TASKS.yaml
• GITLAW_CREWAI_COMPARISON_DE.md

Aktueller Stand:

• REAL: Research Agent, Drafting-Grundflow, Workflow Recommendation Agent, Session/RBAC, tenant-bound sync, serverseitiger Dokumentpfad
• BETA: Intake-Klassifikation, OCR/Translation fuer schwierige Scan-PDFs, Citation Verification Layer, approved memory
• NEXT: tiefer Server-Persistenzkern, echter EU-Storage/Worker-Stack

Operativer Kontext:

• AGENTS.md
• GITLAW_COMPANY_THESIS_DE.md
• GITLAW_EXECUTION_PLAN_DE.md
• GITLAW_FOUNDER_ROADMAP_DE.md

Letzter ausgefuehrter Live-Check:

• PASS: 13
• BETA: 0
• FAIL: 0

---

🚀 Lokal starten

# Bürger:innen-Viewer
cd viewer && npm install && npm run dev

# Optional: lokale RAG-API
pip install langchain langchain-openai faiss-cpu
python rag/build_vectorstore.py
python -m uvicorn rag.server:app --port 8001

Pro-Tier lokal: http://localhost:5173/#/pro?invite=DEMO

---

📜 Lizenz

AGPL-3.0 für das gesamte Repository (Bürger-Viewer, Pro-Tier-Code, Gesetzes-Korpus, RAG-Stack).

Warum AGPL: anders als MIT oder Apache verpflichtet AGPL jeden, der die Software als Netzwerk-Service anbietet (auch Forks, auch SaaS-Rebrands), seine Änderungen ebenfalls Open Source zu stellen. Für ein Legal-Tech-Tool heißt das: wenn jemand das hier nimmt und als geschlossenes kommerzielles Produkt verkauft, verletzt er die Lizenz. Das schützt die Offenheit langfristig.

Wer eine kommerzielle Lizenz ohne AGPL-Copyleft-Pflichten will: mikel_ninh@yahoo.de schreiben.

Anwält:innen sehen unseren Code → Vertrauen. Falls die Firma stirbt → Code lebt weiter.

---

🗺 Roadmap

• 5.936 Gesetze + 98K Vektoren + Semantische Suche
• AI-Erklärungen + Chat + 12 Personas + 6 Sprachen
• 20 Musterbriefe + Premium-Paywall
• PDF + Share + Favoriten + Paragraph-Links
• Gesetz des Tages + Reform-Diffs
• Auto-Updates + RAG API
• GitLaw Pro Beta — Akten, Recherche-Verifikation, branded Templates, Frist-Calc, Cloud-Sync, AVV
• Notariat-Pack (12 Templates: Vollmacht, Erbschein, Pflichtteil, Patientenverfügung …)
• Migration-Pack (12 Templates: Aufenthaltstitel, Familiennachzug, Einbürgerung …) + Vietnamese Intake
• Familienrecht-Pack (10 Templates: Scheidung, Sorge, Unterhalt, Gewaltschutz …)
• Sozialrecht-Pack (10 Templates: SGB-II/V/VI/IX-Widersprüche, SG-Klagen, BerHG)
• Steuerrecht-Pack (10 Templates: Einspruch, AdV, Selbstanzeige § 371 AO, FG-Klage)
• Daily-Companion-Design mit personalisiertem Greeting + Wochenstatistik
• 3-Stufen-Rechtsprechung (Deep-Links + 40 kuratierte BGH-Leitsätze + OpenLegalData-Live)
• Wöchentliches Auto-Update der Leitsätze via GitHub-Action + OpenAI Structured Outputs
• CSV-Akten-Import aus DATEV / RA-Micro / advoware / Excel
• DSGVO-Schutz-Modus mit Auto-Anonymisierung (14 PII-Pattern + Whitelist)
• Mehrsprachiger Intake-Triage-Block (Dringlichkeit/Frist/Anhangsklassifikation vollständig in DE/VI/TR/AR/EN)
• Recherche-Verlauf mit Follow-up-Kontext (vertiefte Folgefragen + Einzel-Speichern/Prüfen/Export je Antwort)
• Personal Welcome-Pages für Beta-Tester (/#/bao, /#/rubin, /#/werner, /#/jasmin)
• Migrations-MVP Sprint 1 (Mai 2026, mit Bao Nguyen) — 11 Mandatsart-Checklisten · 8-Stati-Workflow · Sachstand-Generator DE+VI · Behörden-DB
• Migrations-MVP Sprint 2-4 — Auto-Versand · OCR-Klassifikation · Mittelspersonen-Datenmodell · Mandanten-Portal
• Mobile App (iOS/Android — vorerst PWA via Browser tauglich)
• Echtes RBAC (Partner:in vs. Associate-Rechte)
• Azure OpenAI EU-Region (für Großkanzlei-AVV-Anforderungen)
• Beck-Online SSO-Bridge (proprietary, prüfen)

---

🌐 Ökosystem — Digitale Demokratie

Dieses Projekt ist Teil eines Open-Source-Ökosystems für digitale Demokratie:

Projekt	Frage	Link
FairEint	Was sollte Deutschland anders machen?	GitHub · Live
GitLaw	Was steht im Gesetz?	GitHub · Live
Public Money Mirror	Wohin fließt das Steuergeld?	GitHub
SafeVoice	Wer wird online angegriffen?	GitHub

Alle Projekte: github.com/mikelninh · Unterstützen: Ko-fi · GitHub Sponsors

---

Beta-Anfrage GitLaw Pro: mikel_ninh@yahoo.de

„Demokratie sollte Open Source sein."