Xolib Score -- Claude Code Prompts¶

Format: Markdown Dateien:

Datei	Beschreibung
`claude_code_prompt_xolib_score.md`	Haupt-Implementierungs-Prompt v2.0 -- 6 Phasen sequenziell
`xolib_score_claude_code_prompt.md`	Alternativer Prompt v1+v2+Hash-Chaining+UI -- Schrittweise Anleitung
`xolib_score_ergaenzung_prompt.md`	Ergaenzungsprompt -- explizite Kategorie-Zuordnung + VersionBadge UI

Was mit den Prompts implementiert wurde¶

Die drei Prompt-Dateien bilden zusammen die vollstaendige Implementierungsanleitung fuer das Xolib Score System. Sie wurden an Claude Code uebergeben, um das Feature von Datenbankschema bis UI zu bauen.

Haupt-Prompt (claude_code_prompt_xolib_score.md)¶

Definiert 6 Phasen: (1) Datenbankschema -- PropertyScore, PropertyScoreHistory, ScoreFactor, EnergyReading als Prisma-Modelle. (2) Score Calculator -- gewichtete Berechnung mit 5 Kategorien, Normalisierung, Konfidenz-Berechnung. (3) Background Job -- naechtliche Neuberechnung um 02:00 Uhr via Cron. (4) API-Endpunkte -- GET/POST fuer Score-Abruf und manuelle Trigger. (5) UI-Komponenten -- Score-Dashboard, Kategorie-Aufschluesselung, Trend-Charts. (6) Hash-Chaining -- SHA-256 Integritaetssicherung fuer Bank-API-Kompatibilitaet.

Alternativer Prompt (xolib_score_claude_code_prompt.md)¶

Gleicher Scope, aber als Schritt-fuer-Schritt-Anleitung formuliert statt als Phasen-Modell. Betont zusaetzlich die Integration mit bestehenden Modellen (Property, Unit, Tenancy, Payment, Ticket, ServiceProvider, Document, OperatingCost) und die Nutzung der bestehenden KpiDonutGrid-Komponente.

Ergaenzungsprompt (xolib_score_ergaenzung_prompt.md)¶

Schliesst zwei Luecken der urspruenglichen Implementierung:

Explizite Kategorie-Zuordnung -- ordnet neue Datenpunkte den Score-Kategorien zu: Energieausweis und Wartungsvertraege in Substanz (je 10%), Energieverbrauch und Verbrauchstrend in Technologie (35%+15%), BK-Abweichung und Zahlungstrend in Ertrag (15%+10%), Dokument-Checkliste und Abrechnungspuenktlichkeit in Compliance (30%+15%), Handwerker-Rating, Nachbearbeitung und Sentiment in Instandhaltung (20%+15%+15%).
V1/V2/V3 VersionBadge -- UI-Komponente im ScoreFactorDrawer, die pro Faktor anzeigt ob er heute verfuegbar (V1), in 6-12 Monaten (V2) oder langfristig (V3) messbar ist. Nutzt das bestehende dataVersion-Feld ('v1_manual' | 'v2_auto' | 'v3_iot').

Entstandene Dateien¶

src/lib/score/calculator.ts -- Hauptberechnung (44KB)
src/lib/score/normalization.ts -- Normalisierungsregeln
src/lib/score/integrity.ts -- Hash-Chain-Verifizierung
src/lib/score/trigger.ts -- Automatische Neuberechnung
Prisma-Modelle: PropertyScore, PropertyScoreHistory, ScoreFactor, EnergyReading, WorkerRating

Architektur-Prinzipien (aus allen drei Prompts)¶

Score nie synchron berechnen -- immer async via Background Job
Fehlende Daten senken Konfidenz, nicht den Score
Score nicht manuell ueberschreibbar
Bank-API-Kompatibilitaet von Tag 1 (Schema, Hash-Chaining, Audit Trail)
i18n auf allen Komponenten und API-Responses
TypeScript strict, keine any-Types