chore: initialize knowledgebase repository

Empty repo scaffolding for a source-cited hierarchical KB on
migration, crime statistics, and social benefits in Germany.

.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+__pycache__/
+.pytest_cache/
+.venv/
+venv/
+raw/**
+!raw/.gitkeep
+!raw/MANIFEST.yaml
+*.xlsx
+*.xls
+*.pdf
+*.pyc
+.mypy_cache/
+.ruff_cache/

README.md

@@ -0,0 +1,50 @@
+# Knowledgebase: Migration, Kriminalität, Sozialleistungen (Deutschland)
+
+Faktenbasierte, hierarchische Knowledgebase. Jede Zahlenaussage trägt Quelle und Datum. Begriffe werden nur in der Definition der jeweiligen Quelle verwendet.
+
+## Was diese KB nicht ist
+
+- Keine politische Bewertung, keine Handlungsempfehlung, keine Schlussfolgerung der Form „deshalb muss …“.
+- Keine Gleichsetzung von *Ausländer*, *Migrant*, *Zuwanderer* (BKA-Lagebild), *Schutzsuchende*, *Person mit Migrationshintergrund*.
+- Keine Umdeutung von PKS-Tatverdächtigen in Täter oder Verurteilte.
+- Kein Ersatz für die Originalstatistik. Kanonisch sind die amtlichen Tabellen; diese KB ist ein nachvollziehbarer Extrakt.
+
+## Leseordnung
+
+1. [Qualitätsregeln](kb/_meta/QUALITY_RULES.md)
+2. [Glossar / Definitionen](kb/definitions.yaml)
+3. [Quellenregister](kb/sources/SOURCES.md)
+4. Themenknoten unter `kb/01-` bis `kb/07-`
+5. Widersprüche: `kb/_widersprueche/`
+
+## Stand Welle 1
+
+| Bereich | Status |
+|---|---|
+| Hierarchie 01–07 | angelegt |
+| Quellenregister | angelegt |
+| PKS Tatverdächtige nach Staatsangehörigkeit | Befüllung geplant / siehe Knoten |
+| Bürgergeld nach Staatsangehörigkeit | Befüllung geplant / siehe Knoten |
+| Asylanträge 2015–aktuell | Befüllung geplant / siehe Knoten |
+| Übrige Unterknoten | `stub` |
+
+## Format
+
+- Markdown mit YAML-Frontmatter je Knoten (`_index.md`)
+- Zeitreihen als YAML unter `series/`
+- Quellen zentral in `kb/sources/sources.yaml`
+- Roh-PDF/XLSX lokal in `raw/` (nicht im Git)
+
+## Werkzeuge
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+python -m pytest tests -v
+python scripts/validate_kb.py
+```
+
+## Lizenzhinweis zu Daten
+
+Amtliche Auszüge aus Destatis/GENESIS unterliegen der [Datenlizenz Deutschland – Namensnennung – Version 2.0](https://www.govdata.de/dl-de/by-2-0). BKA, BAMF und BA: Quellenangabe der jeweiligen Publikation. Diese Repository-Struktur selbst: interne Arbeitsgrundlage.

raw/MANIFEST.yaml

@@ -0,0 +1,7 @@
+# Lokale Rohdateien (gitignored). Nach Download sha256 hier eintragen.
+# Lizenz amtlicher Auszüge: Datenlizenz Deutschland – Namensnennung – Version 2.0
+# soweit Destatis/GENESIS; BKA/BAMF/BA: amtliche Publikationen, Quellenangabe Pflicht.
+
+version: 1
+retrieved_default: "2026-08-21"
+files: []

requirements.txt

@@ -0,0 +1,7 @@
+pydantic>=2.7
+pyyaml>=6.0
+pytest>=8.0
+httpx>=0.27
+python-frontmatter>=1.1
+openpyxl>=3.1
+pdfplumber>=0.11