SPEC-2026-007 – Ergebnisübersicht als Bulletpoints und farbige KPI-Gruppenköpfe¶

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

Anlass¶

Die Ergebnisübersicht im Dashboard wird derzeit als Fließtext mit manuellen Zeilenumbrüchen dargestellt. Dadurch sind Rating, Cashflow, ETF-Vergleich, Bewertungsgrund und Datenqualität nur eingeschränkt scanbar. Die KPI-Gruppenüberschriften sind zwar fachlich gegliedert, heben sich visuell aber nur durch eine Unterstreichung ab.

Ausgangsproblem¶

Ergebnisübersicht:
  mehrere Aussagen im Fließtext
  wichtige Kennzahlen stehen nebeneinander
  Bewertungsgrund und Datenqualität wirken nachgeordnet

KPI-Gruppen:
  fachlich korrekt gegliedert
  Überschriften nur mit Trennlinie
  Gruppenzugehörigkeit könnte visuell stärker sein

Relevanter bestehender Stand¶

frontend/assets/js/single-analysis-controller.js rendert die Base-Case-Ergebnisübersicht in #summary.
frontend/assets/js/dashboard-kpi-layout.js erzeugt die fünf KPI-Gruppen.
frontend/assets/css/dashboard-kpi-layout.css steuert die Gruppenköpfe.
SPEC-2026-002, SPEC-2026-005 und SPEC-2026-006 definieren die sichtbare, gruppierte und kompakte KPI-Darstellung.

Vorgeschlagene Änderung¶

Die Ergebnisübersicht wird semantisch als Liste mit untereinander stehenden Bulletpoints dargestellt.
Die Liste enthält unverändert:
Investment Rating des Base Case
Cashflow vor Steuer im ersten Jahr
terminalen Vergleich nach modelliertem Exit gegenüber ETF
Bewertungsgrund
Datenqualität
Die Werte und Texte stammen weiterhin ausschließlich aus AnalysisResult und dem Base-Szenario.
Jeder KPI-Gruppenkopf erhält einen farbigen Hintergrund und einen farblich passenden Rahmen.
Die Farben verwenden die bestehende Immohai-Palette und dezente abgeleitete Pastelltöne; sie kodieren keine neue fachliche Bewertung.
Platzhalter- und Ergebniszustand verwenden dieselben Gruppenköpfe.

Entscheidungsmehrwert¶

Die wichtigsten Aussagen der Analyse lassen sich schneller erfassen. Die farbigen Gruppenköpfe verstärken die visuelle Zuordnung der KPI-Karten, ohne neue fachliche Bedeutungen einzuführen.

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. Rating, Cashflow, ETF-Vergleich, Bewertungsgrund, Datenqualität und alle KPI-Werte 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¶

semantische Bulletpoint-Liste in #summary
farbige KPI-Gruppenköpfe
keine Speicherung von Layoutzuständen
gespeicherte Snapshots bleiben unverändert

Auswirkungen auf Tests und Referenzfälle¶

Zu prüfen:

nach der Berechnung enthält die Ergebnisübersicht fünf Bulletpoints
Investment Rating, Cashflow, ETF-Vergleich, Bewertungsgrund und Datenqualität bleiben vollständig sichtbar
keine Fließtext-Trennung über <br> bleibt erforderlich
alle fünf KPI-Gruppenköpfe besitzen farbige Rahmen und Hintergründe
Browser- und Contract-Checks bleiben erfolgreich

Legacy- und Migrationsfolgen¶

Keine.

Risiken und offene Fragen¶

Die Farben dürfen nicht als Ampelbewertung missverstanden werden. Deshalb werden ausschließlich dezente Gruppierungsfarben verwendet; die tatsächlichen Bewertungen bleiben weiterhin über die bestehenden Assessment- und Ratingfarben gekennzeichnet.

Prüfergebnis¶

Die Änderung wurde gegen Reporting-Vertrag, AnalysisResult, Base-Szenario, KPI-Gruppierung und Browserabnahme geprüft. Sie verändert ausschließlich die Darstellung bestehender Ergebnisse.

Entscheidung¶

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

Zieldokumente¶

frontend/assets/js/result-summary-layout.js
frontend/assets/css/result-summary-layout.css
frontend/assets/js/kpi-assessment-ui.js
frontend/assets/css/dashboard-kpi-layout.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.