SPEC-2026-002 – Strukturierte und kompakte Dashboard-KPIs¶

Status: Entwurf
Proposal-Status: accepted
Kategorie: specification
Erstellt: 2026-07-06
Stand: 2026-07-06

Anlass¶

Die Dashboard-KPIs erscheinen derzeit erst nach einem Rechenlauf als ungegliederte Kartenfolge. Dadurch fehlt im unberechneten Initialzustand eine sichtbare Ergebnisstruktur, und die große Kartenhöhe erschwert den schnellen Überblick.

Ausgangsproblem¶

vor der ersten Berechnung:
  keine sichtbaren KPI-Felder

nach der Berechnung:
  alle KPIs in einer durchgehenden Kartenliste
  keine fachlichen Gruppenüberschriften
  hohe Karten und große Abstände

Relevanter bestehender Stand¶

docs/specification/user-interface-and-reporting/reporting.md definiert die anzuzeigenden KPIs und verbietet eigene Berechnungen im Reporting.
docs/specification/user-interface-and-reporting/frontend-mvp.md verlangt einen unberechneten Initialzustand ohne vertrauenswürdiges AnalysisResult.
frontend/assets/js/single-analysis-controller.js rendert die berechneten KPI-Karten in #kpi-grid.
frontend/assets/js/baseline-integrity.js setzt den Initialzustand zurück und entfernt berechnete Ergebnisse.
frontend/assets/js/kpi-assessment-ui.js ergänzt ausschließlich vorhandene Engine-Assessments.

Betroffene führende Dokumente¶

keine fachliche Formel- oder Datenvertragsänderung
Reporting-Vertrag bleibt unverändert
Frontend-MVP bleibt inhaltlich unverändert: Initialzustand ohne AnalysisResult

Vorgeschlagene Änderung¶

Vor der ersten Berechnung wird eine vollständige KPI-Platzhalterstruktur mit dem Wert — angezeigt.
Platzhalter dürfen keine Berechnung, Bewertung oder Datenqualität suggerieren.
Berechnete KPI-Karten werden fachlich gruppiert:
Objekt & Investition
Rendite & Ertrag
Finanzierung & Tragfähigkeit
Cashflow & Liquidität
Vermögen & ETF
Datenqualität
Die Dashboard-Karten werden visuell kompakter, ohne KPI-Werte, Hinweise oder Engine-Assessments zu verändern.
Andere Ergebnisbereiche und die Berechnungsengine bleiben unverändert.

Entscheidungsmehrwert¶

Die sichtbare Struktur erklärt bereits vor dem Rechenlauf, welche Ergebnisse Immohai liefert. Nach der Berechnung können Anwender Finanzierung, Rendite, Liquidität und ETF-Vergleich schneller erfassen.

Auswirkungen auf Architektur, Roadmap und Spezifikation¶

Architektur: keine Änderung
Roadmap: keine Prioritätsänderung
Fachmodell: keine Änderung
Reporting-Vertrag: keine Änderung der Pflicht-KPIs oder Quellen
Frontend-Darstellung: Änderung

Auswirkungen auf Formeln und KPIs¶

Keine. Werte, Definitionen, Schwellen, Ratings und Assessment-Gründe werden unverändert aus AnalysisResult dargestellt.

Auswirkungen auf Datenverträge und Versionen¶

PropertyInput: unverändert
AnalysisResult: unverändert
PropertyRecord: unverändert
Modellversion: unverändert
Engine-Version: unverändert
Schemaversionen: unverändert

Auswirkungen auf UI, Reporting und Speicherung¶

neue rein visuelle KPI-Gruppenüberschriften
leere Platzhalterkarten im unberechneten Zustand
kompaktere Kartenabmessungen und Typografie
keine Speicherung von Platzhaltern oder Layoutzuständen
gespeicherte Snapshots bleiben unverändert

Auswirkungen auf Tests und Referenzfälle¶

Zu prüfen:

Initialzustand bleibt Noch nicht berechnet und besitzt kein AnalysisResult.
Platzhalter sind sichtbar und enthalten ausschließlich —.
Nach Berechnung bleiben alle vorhandenen KPI-Karten und Assessments vorhanden.
Gruppenüberschriften erscheinen in stabiler Reihenfolge.
lokale Browserabnahme und Contract Check bleiben erfolgreich.

Legacy- und Migrationsfolgen¶

Keine. Bestehende PropertyRecords und AnalysisResults werden nur anders dargestellt.

Risiken und offene Fragen¶

Risiko: zu schmale Karten können längere Bewertungsbegründungen schwer lesbar machen.
Gegenmaßnahme: responsive Mindestbreite und unveränderte vollständige Inhalte.

Offene Frage bis Browserabnahme: endgültige Kartenbreite im realen Desktop-Layout.

Prüfergebnis¶

Der Vorschlag wurde gegen Governance, Reporting-Vertrag, Frontend-MVP, AnalysisResult, KPI-Assessments, gespeicherte Snapshots, aktive Browsersteuerung und Regressionstests geprüft.

keine neue Berechnung
keine neue KPI-Definition
keine Schwellen- oder Ratingänderung
keine Datenvertrags- oder Versionsänderung
keine Migration
keine Änderung der Reportquelle

Die Platzhalter liegen bewusst in einem separaten Initialzustands-Grid. #kpi-grid bleibt bis zum Rechenlauf leer, sodass kein scheinbar berechnetes Ergebnis entsteht. Nach einem AnalysisResult werden ausschließlich die vorhandenen Controller-Karten neu angeordnet.

Entscheidung¶

Angenommen. Umsetzung als rein visuelle Frontend- und Teständerung ohne Modell-, Engine- oder Schemaversionserhöhung.

Zieldokumente¶

frontend/assets/js/dashboard-kpi-layout.js
frontend/assets/css/dashboard-kpi-layout.css
frontend/assets/js/legal-footer.js
scripts/check-dashboard-kpi-layout.mjs
.github/workflows/contract-check.yml
docs/changes/proposals/specification-additions.md

Integrationscommit¶

Offen bis erfolgreichem Contract Check und Browserreview.