Zum Inhalt

SPEC-2026-011 – Investment Rating und Datenqualität in der Ergebnisübersicht

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

Anlass

Investment Rating, Bewertungsgrund und Datenqualität sind aktuell über mehrere Dashboardbereiche verteilt. Das Rating erscheint als einzelne Statuspille und zusätzlich nochmals in der unteren Bewertungslegende. Der Bewertungsgrund bleibt zu allgemein und nennt bei einem kritischen Ergebnis nicht unmittelbar die auslösenden Hauptbefunde.

Ausgangsproblem

Ergebnisübersicht:
  Investment Rating nur als einzelne Statusanzeige
  Bewertungsgrund häufig nur generisch
  Datenqualität räumlich vom Ergebnis getrennt

Unterer Dashboardbereich:
  vollständige Investment-Rating-Legende wiederholt die Information
  zusätzlicher Platzbedarf ohne neuen Ergebniswert

Relevanter bestehender Stand

  • AnalysisResult.investment_rating enthält Rating, generischen Grund, Komponenten und harte kritische Befunde.
  • AnalysisResult.data_quality_assessment enthält Score und Status.
  • frontend/assets/js/result-summary-layout.js rendert die Base-Case-Zusammenfassung.
  • frontend/assets/js/dashboard-kpi-layout.js verschiebt die Datenqualitätskarte derzeit in den Plausibilitätsbereich.
  • frontend/assets/js/single-analysis-controller.js rendert im unteren Dashboard eine vollständige Bewertungslegende.

Vorgeschlagene Änderung

  1. Die Datenqualität steht oben rechts in der Ergebnisübersicht.
  2. Unter der Überschrift wird ein zweispaltiger Ergebnisbereich dargestellt:
  3. links: Base-Case-Zusammenfassung
  4. rechts: Investment Rating mit GREEN, YELLOW, RED und UNRATED
  5. Genau das aktive Rating wird mit der zugehörigen bestehenden Ampelfarbe hinterlegt.
  6. Nicht aktive Ratingstufen werden neutral ausgegraut.
  7. Der Bewertungsgrund listet die wichtigsten vorhandenen Befunde kommasepariert auf.
  8. Die Befundliste wird ausschließlich aus bereits gespeicherten Ratingdaten abgeleitet:
  9. harte kritische Befundcodes zuerst
  10. andernfalls grenzwertige, kritische oder unzureichende Ratingkomponenten
  11. bei GREEN die bestehende positive Ratingbegründung
  12. Es wird keine neue Ratinglogik berechnet.
  13. Die untere Investment-Rating-Legende entfällt vollständig.
  14. Modellgrenzen bleiben im bestehenden eigenen Dashboardabschnitt erhalten.

Entscheidungsmehrwert

Rating, Hauptgründe und Datenqualität sind ohne Scrollen gemeinsam erfassbar. Die aktive Ampel ist eindeutig, während nicht zutreffende Stufen sichtbar bleiben, aber visuell zurücktreten. Kritische Entscheidungen werden durch konkrete Auslöser statt durch einen generischen Satz begründet.

Auswirkungen auf Architektur, Roadmap und Spezifikation

Architektur: keine Änderung
Roadmap: keine Änderung
Fachmodell: keine Änderung
Reporting-Vertrag: keine Änderung der gespeicherten Ratingwerte
Frontend-Darstellung: Änderung

Auswirkungen auf Formeln, KPIs und Ratings

Keine. Investment Rating, Komponenten, harte Befunde und Datenqualität werden unverändert aus AnalysisResult übernommen.

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 in den oberen Ergebnisheader verschoben
  • neue kompakte Investment-Rating-Matrix neben der Base-Case-Zusammenfassung
  • untere Investment-Rating-Legende wird entfernt
  • keine Speicherung von UI-Zuständen
  • bestehende Snapshots bleiben kompatibel

Auswirkungen auf Tests und Referenzfälle

Zu prüfen:

  • Datenqualität steht im Ergebnisheader und nicht im Plausibilitätsbereich
  • Base-Case-Zusammenfassung enthält Cashflow, ETF-Vergleich und konkrete Bewertungsgründe
  • Bewertungsgründe sind kommasepariert
  • genau eine Ratingstufe ist aktiv
  • aktive Ratingstufe verwendet die richtige Ampelfarbe
  • drei nicht aktive Stufen sind ausgegraut
  • untere Bewertungslegende ist nicht mehr vorhanden
  • Browser- und Contract-Checks bleiben erfolgreich

Legacy- und Migrationsfolgen

Keine. Fehlen Detailbefunde in älteren Snapshots, wird der gespeicherte generische Ratinggrund angezeigt.

Risiken und offene Fragen

Bei sehr vielen Befunden wird die Anzeige auf die wichtigsten eindeutigen Punkte begrenzt. Die vollständigen Detailbefunde bleiben weiterhin in KPI-Karten, Plausibilitätsprüfung und Szenariovergleich sichtbar.

Prüfergebnis

Die Änderung wurde gegen Ratingkomponenten, harte Befundcodes, Datenqualität, bestehende Dashboardstruktur und Browserabnahme geprüft. Sie verändert ausschließlich die Darstellung vorhandener Analyseergebnisse.

Entscheidung

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

Zieldokumente

frontend/index.html
frontend/assets/js/result-summary-layout.js
frontend/assets/css/result-summary-layout.css
frontend/assets/js/dashboard-kpi-layout.js
frontend/assets/css/dashboard-kpi-layout.css
frontend/assets/js/single-analysis-controller.js
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.