SPEC-2026-005 – KPI-Spalten und zusammengefasste Plausibilitätsbefunde¶

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

Anlass¶

Die fachlichen KPI-Gruppen werden derzeit als horizontale Abschnittsüberschriften über einem gemeinsamen Raster dargestellt. Dadurch laufen die Karten jeder Gruppe über mehrere Zeilen und die fachliche Zuordnung ist visuell weniger eindeutig als gewünscht. Zusätzlich erscheint jeder Plausibilitätsbefund in einer eigenen Karte, wodurch der Bereich unnötig viel vertikalen Platz benötigt.

Ausgangsproblem¶

Dashboard-KPIs:
  Gruppenüberschrift über voller Breite
  Karten derselben Gruppe laufen horizontal und anschließend in die nächste Zeile
  fachliche Gruppen sind nicht als geschlossene Spalten erkennbar

Plausibilitätsprüfung:
  ein Feld je Einzelbefund
  wiederholte Überschriften Kritisch bzw. Warnung
  hoher vertikaler Platzbedarf

Relevanter bestehender Stand¶

SPEC-2026-002 definiert sechs fachliche KPI-Gruppen und sichtbare Platzhalter vor der Berechnung.
frontend/assets/js/dashboard-kpi-layout.js ordnet vorhandene KPI-Karten derzeit in einem flachen Grid mit Gruppenüberschriften an.
frontend/assets/js/single-analysis-controller.js rendert jeden Plausibilitätsbefund als eigenes Element.
Werte, Schwellen und Befundschwere werden vollständig aus AnalysisResult übernommen.

Vorgeschlagene Änderung¶

Jede KPI-Gruppe wird als eigene vertikale Spalte gerendert.
Die Spalte enthält oben genau eine Gruppenüberschrift und darunter ausschließlich die zugehörigen KPI-Karten.
Die sechs bestehenden Gruppen bleiben unverändert:
Objekt & Investition
Rendite & Ertrag
Finanzierung & Tragfähigkeit
Cashflow & Liquidität
Vermögen & ETF
Datenqualität
Vor der Berechnung erscheinen dieselben Spalten mit leeren Kartenwerten —.
Das Layout ist responsiv: sechs Spalten auf großen Desktopbreiten, drei bzw. zwei Spalten auf kleineren Ansichten und eine Spalte mobil.
Plausibilitätsbefunde werden nach Schweregrad zusammengefasst:
ein Feld Kritisch mit allen kritischen Befunden als Bulletpoints
ein Feld Warnungen mit allen Warnungen als Bulletpoints
optional ein Feld Hinweise mit allen übrigen Meldungen
Doppelte Meldungstexte werden innerhalb einer Schweregruppe nur einmal angezeigt.

Entscheidungsmehrwert¶

Die KPI-Zuordnung ist über die gesamte Höhe einer Spalte eindeutig. Die Plausibilitätsprüfung wird kompakter und unterstützt das schnelle Erfassen der wesentlichen kritischen und warnenden Befunde.

Auswirkungen auf Architektur, Roadmap und Spezifikation¶

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

Auswirkungen auf Formeln, KPIs und Ratings¶

Keine. KPI-Werte, KPI-Assessments, Plausibilitätsbefunde, Schweregrade, Schwellen und Ratings 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¶

neue DOM-Container je KPI-Gruppe
sichtbare Spaltenstruktur für Platzhalter und berechnete Werte
zusammengefasste Plausibilitätsfelder mit Listen
keine Speicherung von Layoutzuständen
gespeicherte Snapshots bleiben unverändert

Auswirkungen auf Tests und Referenzfälle¶

Zu prüfen:

vor der Berechnung sind sechs KPI-Spalten und 22 Platzhalter sichtbar
nach der Berechnung sind sechs KPI-Spalten und 22 echte KPI-Karten sichtbar
jede KPI-Karte befindet sich genau in der vorgesehenen Gruppe
kritische Befunde erscheinen gemeinsam in einem Feld
Warnungen erscheinen gemeinsam in einem Feld
Einzelmeldungen bleiben vollständig erhalten und werden nur bei identischem Text dedupliziert
Browser- und Contract-Checks bleiben erfolgreich

Legacy- und Migrationsfolgen¶

Keine.

Risiken und offene Fragen¶

Sehr schmale Desktopfenster können bei sechs Spalten zu schlecht lesbaren Karten führen. Das Raster reduziert deshalb responsiv die Spaltenanzahl und erzwingt keine horizontale Mindestbreite für alle sechs Gruppen.

Prüfergebnis¶

Die Änderung wurde gegen SPEC-2026-002, Reporting-Vertrag, bestehende KPI- und Plausibilitätsdaten sowie 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/js/single-analysis-controller.js
frontend/assets/css/single-analysis.css
scripts/check-dashboard-kpi-layout.mjs
scripts/check-single-analysis-browser.mjs
docs/changes/proposals/specification-additions.md

Integrationscommit¶

Offen bis erfolgreichem Contract Check und Browserreview.