XOLIB Datei-Landkarte¶

Stand: 2026-03-22 | Druckversion (1-2 Seiten A4)

Wo finde ich was?¶

Strategische Dokumente¶

Dokument	Pfad	Beschreibung	Aktuell?
CLAUDE.md	`/CLAUDE.md`	Zentrale Arbeitsanweisung, Sprint-Status, Metriken, TODOs	Ja — Single Source of Truth
Masterplan	`docs/XOLIB-MASTERPLAN.md`	Gesamtprojekt: Architektur, TODOs, Risiken, Pipeline	Ja
STRATEGY.md	`docs/STRATEGY.md`	Strategischer Kompass: Data Moat, Revenue, Exit, Funding	Ja — Metriken aktualisiert 22.03
CROSS-TENANT-INTELLIGENCE.md	`docs/CROSS-TENANT-INTELLIGENCE.md`	Cross-Tenant Learning, 5-Phasen-Plan, DSGVO	Ja
SOLL-SCHEMA.md	`docs/SOLL-SCHEMA.md`	Ziel-Datenarchitektur v1.6, 21 Domains, 14 Prinzipien	Ja — Nordstern
ADRs (decisions/)	`docs/decisions/index.md`	19 ADRs in Einzeldateien (Datenschutz, H3, Benchmarks, Strategie)	Ja
BLOCK-MAP.md	`docs/BLOCK-MAP.md`	Layout-Zuordnung aller Admin-Seiten (F-Pattern, Miller's Law)	Ja
GLOSSARY.md	`docs/GLOSSARY.md`	100+ DE-Hausverwaltungs-Begriffe mit Prisma-Mapping	Ja

Code-Dokumentation¶

Dokument	Pfad	Beschreibung
.claude/rules/	`.claude/rules/*.md`	4 Regel-Dateien: general, backend, frontend, git
.claude/skills/	`.claude/skills/*/SKILL.md`	7 Skills: requirements, architecture, frontend, backend, qa, deploy, help

Daten¶

Datensatz	Pfad lokal	Pfad Server	Status
Zensus 2022 (7 Kategorien)	—	ExternalDataPoint DB	1,22 Mio Punkte geladen
OSM Medical POIs	—	ExternalDataPoint DB	27.689 Punkte geladen
UBA Luftdaten	—	ExternalDataPoint DB	492 Stationen
immocation Masterclass	`data/immocation/`	—	~220 Dateien, 1.5 GB, lokal
immocation Tools	`data/immocation-tools/`	—	Vorlagenpaket, 1.3 GB, lokal
Wegweiser Kommune	—	—	OFFEN — Account-Registrierung
INKAR CSV	—	—	OFFEN — Upload auf VPS
Grundsteuer GENESIS	—	—	OFFEN — Registrierung

Analysen & Research¶

Dokument	Pfad	Thema
IMMOCATION-ANALYSE.md	`docs/IMMOCATION-ANALYSE.md`	271 Dateien, Template-Gap-Analyse
IMMOCATION-DEEP-DIVE.md	`docs/IMMOCATION-DEEP-DIVE.md`	24 Formeln, 12 Entscheidungsbaeume, 30 Features
immocation-taxonomie-kompakt.md	`docs/immocation-taxonomie-kompakt.md`	170+ Vorlagen in 15 Kategorien
OPEN-DATA-INVENTAR.md	`docs/OPEN-DATA-INVENTAR.md`	Open-Data-Quellen DACH (10 Kategorien)
FEATURE-LANDKARTE-V2.md	`docs/FEATURE-LANDKARTE-V2.md`	39 Features (Wow x Moat x Machbarkeit)
SPRINT-PLAN.md	`docs/SPRINT-PLAN.md`	Sprint 0-4 (alle CODE DONE)
KLAERUNGSBEDARF.md	`docs/KLAERUNGSBEDARF.md`	13 Fragen geklaert (22.03.2026)
8 Deep Research Sessions	`docs/research/compass_artifact_*.md`	Datenquellen, Mietrecht, Foerderung
Projektkonzept v2	`docs/specs/projektkonzept-v2.md`	Urspruengliches Konzept (Feb 2026)
Business Plan v3 Prompt	`docs/specs/businessplan-v3-prompt.md`	IBB ProFIT Vorlage
Feature-Landkarte v2	`docs/specs/02-feature-landkarte-v2.md`	Feature-Bewertung
Business Plan v4	`docs/xolib_businessplan_IBB_v4.docx`	IBB-Antrag (aktiv)

UI/Design¶

Dokument	Pfad	Beschreibung
Design Tokens	`src/styles/design-tokens.css`	Light + Dark Mode, Farben, Spacing, Shadows
V6 Components CSS	`src/styles/v6-components.css`	~30 Klassen-Gruppen
V6 Komponenten	`src/components/v6/`	15+ Dateien (Sidebar, PageGrid, Atoms, Score Cards)
Styleguide (Live)	https://xolib.com/styleguide	User: xolib, PW: Demo1234!

Konzepte (noch nicht umgesetzt)¶

Dokument	Pfad	Beschreibung
CALENDAR-CONCEPT.md	`docs/CALENDAR-CONCEPT.md`	Kalender (Phase 1-7 done, Phase 8 offen)
CALENDAR-CONCEPT.pdf	`docs/CALENDAR-CONCEPT.pdf`	PDF-Version
HANDWERKER-MARKTPLATZ.md	`docs/HANDWERKER-MARKTPLATZ.md`	B2B2B Handwerker-Plattform
HANDWERKER-MARKTPLATZ.pdf	`docs/HANDWERKER-MARKTPLATZ.pdf`	PDF-Version
SUPER-ADMIN-KONZEPT.pdf	`docs/SUPER-ADMIN-KONZEPT.pdf`	SuperAdmin Panel Konzept

Spezifikationen¶

Dokument	Pfad	Beschreibung
Score-Spezifikation v2	`docs/specs/xolib_score_v2_spezifikation.docx`	Xolib Score Konzept
Gesamtpaket	`docs/specs/xolib_gesamtpaket.docx`	Feature-Uebersicht
Filteranalyse	`docs/specs/xolib_filteranalyse.pdf`	71 Filter (IS24/Immowelt/Xolib)

Feature-Spezifikationen¶

Feature	Pfad	Status
XOLIB-1 V6 Properties	`features/XOLIB-1-v6-properties.md`	In Progress
Feature Index	`features/INDEX.md`	Nur fuer zukuenftige Features

Tests¶

Ordner	Beschreibung
`e2e/`	57 Playwright E2E-Tests
`tests/lib/`	13 Unit-Tests (Vitest)
`tests/manual-tests.md`	Manuelle Test-Checkliste

Archiv (veraltet/obsolet)¶

Datei	Pfad	Grund
CLAUDE-REFERENCE.md	`docs/archive/`	Metriken veraltet, ersetzt durch CLAUDE.md
CODEBASE-INDEX.md	`docs/archive/`	Metriken veraltet, ersetzt durch CLAUDE.md
README.md	`docs/archive/`	Ersetzt durch CLAUDE.md
screenshots-ui-audit/	`docs/archive/`	Obsolet seit V6 Redesign
STRATEGY-old.md	`docs/archive/`	Aeltere Version aus docs/input/
Agent Outputs (3)	`docs/archive/_agent*.md`	Konsolidierungs-Zwischenergebnisse
Meeting 04.03.2026	`docs/archive/Meeting_04-03-2026.md`	Archiviert
Git Cleanup Plan	`docs/archive/_git_cleanup_plan.md`	Ausgefuehrt
generate-super-admin-pdf.py	`docs/generate-super-admin-pdf.py`	Script (kann archiviert werden)

Input-Dateien (nicht im Git, nur lokal)¶

Datei	Pfad	Beschreibung
Immoware24_Analyse.pdf	`docs/input/`	Wettbewerberanalyse
Rechtsform-Gutachten	`docs/input/`	GmbH + Holding fuer SaaS
UI-Audit PDF	`docs/input/`	53 Screenshots, Inkonsistenz-Analyse
Filteranalyse XLSX	`docs/input/`	Rohdaten der Filteranalyse
Meeting PDF	`docs/input/`	Strategie-Meeting (Scan)
Restyling-Stufenplan	`docs/input/`	8-Phasen UI-Plan
Detail-Plaene v2	`docs/input/`	Feature-Details
Immocation Paket.zip	`docs/input/`	1.5 GB Masterclass-Material
Immocation tools.zip	`docs/input/`	1.3 GB Vorlagenpaket
Datensatz XOLIB	`docs/input/`	129 MB Zensus-Rohdaten

Wo lege ich neue Dateien ab?¶

Typ	Ablageort
Feature-Spec	`features/XOLIB-{nr}-{name}.md`
Architektur-Entscheidung	`docs/decisions/ADR-NNN-titel.md` (Template: `docs/decisions/_template.md`)
Konzept-Dokument	`docs/`
Spezifikation (DOCX/PDF)	`docs/specs/`
Research/Deep-Research	`docs/research/`
Veraltet/Obsolet	`docs/archive/`
Input-Material (gross)	`docs/input/` (nicht im Git)
Lokale Rohdaten	`data/` (nicht im Git)
ETL-Adapter	`src/lib/etl/sources/`
Score-Engine	`src/lib/scores/`
Compliance-Engine	`src/lib/compliance/`
Template-Typ	`src/lib/templates/`
V6-Komponente	`src/components/v6/`
Admin-Seite	`src/app/admin/{modul}/page.tsx`
API-Route	`src/app/api/v1/{domain}/route.ts`
i18n-Keys	`src/i18n/en.json` + `src/i18n/de.json`
E2E-Test	`e2e/`
Unit-Test	`tests/`

Root-Verzeichnis (erlaubt)¶

CLAUDE.md               — Single Source of Truth
src/                    — Quellcode
docs/                   — Dokumentation
data/                   — Rohdaten (nicht im Git)
prisma/                 — Datenbank-Schema
public/                 — Static Assets
tests/                  — Unit-Tests
e2e/                    — E2E-Tests
scripts/                — Build/ETL-Skripte
features/               — Feature-Specs
*.config.*              — Config-Dateien (next, tailwind, ts, vitest, playwright, postcss, eslint)
*.json                  — package.json, tsconfig.json, package-lock.json
sentry.*.config.ts      — Sentry Config
deploy.sh, backup.sh    — Server-Skripte
auto-deploy-daemon.sh   — Auto-Deploy Cron
Caddyfile.xolib         — Reverse Proxy
ecosystem.config.js     — PM2 Config