SPEC-2026-006 – Kompakteres Dashboard, Datenqualität im Prüfbereich und explizite Case-Begründungen

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

Anlass

Nach der Einführung fachlicher KPI-Spalten bleibt das Dashboard auf Desktop noch zu hoch. Die Gruppe Cashflow & Liquidität enthält sechs Karten in einer langen Einzelspalte. Die Datenqualität steht isoliert als letzte KPI-Spalte, obwohl sie fachlich zur Plausibilitäts- und Ergebnisprüfung gehört. Im Szenariovergleich werden konkrete Befunde angezeigt, die Überschrift erklärt jedoch nicht unmittelbar, warum ein Case kritisch, grenzwertig, gut oder nicht bewertet ist.

Ausgangsproblem

Plausibilitätsprüfung:
  Kritisch und Warnungen sollen nebeneinander stehen
  Datenqualität steht räumlich getrennt im KPI-Bereich

Dashboard-KPIs:
  Karten sind noch zu hoch
  Cashflow & Liquidität benötigt zwei interne Spalten
  Datenqualität belegt eine eigene untere KPI-Spalte

Szenariovergleich:
  Befundliste ist vorhanden
  Bezug zu kritisch / grenzwertig / gut / unrated ist nicht eindeutig beschriftet

Relevanter bestehender Stand

• SPEC-2026-002 definiert sichtbare KPI-Platzhalter und fachliche KPI-Gruppen.
• SPEC-2026-003 definiert konkrete Befunde im Szenariovergleich.
• SPEC-2026-005 definiert KPI-Spalten und zusammengefasste Plausibilitätsbefunde.
• frontend/assets/js/dashboard-kpi-layout.js ordnet KPI-Karten in fachliche Spalten.
• frontend/assets/js/plausibility-summary-ui.js fasst Plausibilitätsmeldungen nach Schwere zusammen.
• frontend/assets/js/scenario-rating-findings-ui.js zeigt gespeicherte harte Befunde oder KPI-Assessment-Gründe.

Vorgeschlagene Änderung

1. Der obere Prüfbereich wird als dreispaltiger Desktopbereich dargestellt:
2. Kritisch
3. Warnungen
4. Datenqualität
5. Die Datenqualitätskarte wird aus dem unteren KPI-Raster in diesen Prüfbereich verschoben.
6. Vor der ersten Berechnung zeigt die Datenqualitätskarte dort weiterhin ausschließlich — und suggeriert kein Ergebnis.
7. Das KPI-Raster enthält danach fünf fachliche Gruppen:
8. Objekt & Investition
9. Rendite & Ertrag
10. Finanzierung & Tragfähigkeit
11. Cashflow & Liquidität
12. Vermögen & ETF
13. Cashflow & Liquidität belegt zwei Rasterspalten und ordnet seine sechs Karten intern zweispaltig an.
14. KPI-Karten werden durch geringere Mindesthöhe, Innenabstände und kompaktere Begleittexte verdichtet. Vollständige Werte, Gründe und Schwellen bleiben sichtbar.
15. Die Case-Rating-Befundliste erhält statusabhängige Überschriften:
16. Warum kritisch
17. Warum grenzwertig
18. Warum gut
19. Warum nicht bewertet
20. Die Anzeige nutzt weiterhin ausschließlich gespeicherte ScenarioRating- und kpi_assessments-Daten und berechnet kein Rating neu.

Entscheidungsmehrwert

Der wichtigste Prüfkontext steht kompakt am Anfang des Dashboards. Die Cashflow- und Liquiditätskennzahlen können ohne lange vertikale Spalte verglichen werden. Im Szenariovergleich ist unmittelbar erkennbar, welche Befunde den dargestellten Status erklären.

Auswirkungen auf Architektur, Roadmap und Spezifikation

Architektur: keine Änderung
Roadmap: keine Änderung
Fachmodell: keine Änderung
Reporting-Vertrag: keine Änderung von Werten, Quellen oder Pflichtinhalten
Frontend-Darstellung: Änderung

Auswirkungen auf Formeln, KPIs und Ratings

Keine. KPI-Werte, Datenqualitätsscore, Plausibilitätsregeln, Case Ratings, harte Befunde, Assessments und Schwellen bleiben unverändert.

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

• Datenqualitätskarte wird im DOM in den Prüfbereich verschoben
• KPI-Raster enthält 21 Karten; die 22. Karte bleibt als Datenqualität im Prüfbereich sichtbar
• Cashflow-Gruppe verwendet ein internes Zweispaltenraster
• Case-Befunde erhalten statusabhängige Erklärungsüberschriften
• keine Speicherung von Layoutzuständen
• gespeicherte Snapshots bleiben unverändert

Auswirkungen auf Tests und Referenzfälle

Zu prüfen:

• vor der Berechnung: 21 KPI-Platzhalter im Raster plus eine Datenqualitätskarte mit — im Prüfbereich
• nach der Berechnung: 21 echte KPI-Karten im Raster plus echte Datenqualitätskarte im Prüfbereich
• Kritisch und Warnungen stehen auf Desktop nebeneinander
• Cashflow & Liquidität enthält sechs Karten in zwei internen Spalten
• Szenariozeilen zeigen Warum kritisch, Warum grenzwertig, Warum gut oder Warum nicht bewertet
• vollständiger Browser- und Contract-Check bleibt erfolgreich

Legacy- und Migrationsfolgen

Keine.

Risiken und offene Fragen

Auf kleineren Bildschirmen wird der Prüfbereich responsiv einspaltig und die Cashflow-Gruppe auf eine interne Spalte reduziert, damit Lesbarkeit und vollständige Begründungstexte erhalten bleiben.

Prüfergebnis

Die Änderung wurde gegen die bestehenden Reporting-Proposals, AnalysisResult, Datenqualität, KPI-Assessments, Case Ratings und Browserabnahme geprüft. Sie verändert ausschließlich die Darstellung vorhandener Ergebnisse.

Entscheidung

Angenommen. Umsetzung als reine 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/css/plausibility-summary.css
frontend/assets/js/scenario-rating-findings-ui.js
frontend/assets/css/scenario-rating-findings.css
scripts/check-dashboard-kpi-layout.mjs
scripts/check-scenario-rating-findings.mjs
scripts/check-single-analysis-browser.mjs
docs/changes/proposals/specification-additions.md

Integrationscommit

Offen bis erfolgreichem Contract Check und Browserreview.