Zum Inhalt

SPEC-2026-003 – Konkrete Befunde im Szenariovergleich

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

Anlass

Im Szenariovergleich wird derzeit zwar das gespeicherte Case Rating samt allgemeiner Begründung angezeigt, bei einem roten oder gelben Case bleibt jedoch unklar, welche konkreten Befunde das Rating ausgelöst haben.

Ausgangsproblem

Case Rating: RED
Begründung: Der Case enthält mindestens einen harten kritischen Befund.

Fehlend:
  welcher harte Befund vorliegt
  ob mehrere harte Befunde gleichzeitig vorliegen

Relevanter bestehender Stand

  • docs/specification/user-interface-and-reporting/reporting.md verlangt je Case das gespeicherte ScenarioRating und dessen Begründung.
  • ScenarioRating.hard_critical_findings speichert die harten kritischen Befundcodes.
  • ScenarioResult.kpi_assessments enthält bereits die fachlichen Gründe für kritische und grenzwertige KPI-Bewertungen.
  • frontend/assets/js/result-visualization-ui.js rendert aktuell nur Ampel und allgemeine Ratingbegründung.

Betroffene führende Dokumente

Der bestehende Reporting-Vertrag wird nicht geändert. Die konkrete Befundliste präzisiert die bereits geforderte Begründung des Case Ratings und verwendet ausschließlich gespeicherte Engine-Ergebnisse.

Vorgeschlagene Änderung

  1. Die Spalte Case Rating zeigt unter Ampel und allgemeiner Begründung eine Liste konkreter Befunde.
  2. Bei RED werden die gespeicherten hard_critical_findings in verständliche deutsche Bezeichnungen übersetzt.
  3. Bei YELLOW werden vorhandene grenzwertige oder kritische Gründe aus kpi_assessments angezeigt.
  4. Bei GREEN wird ausdrücklich angezeigt, dass keine kritischen oder grenzwertigen Befunde vorliegen.
  5. Bei UNRATED bleibt die fehlende belastbare Bewertung sichtbar.
  6. Die UI berechnet kein Rating neu und verändert keine Schwelle.

Entscheidungsmehrwert

Die Nutzer können direkt erkennen, ob ein Case beispielsweise wegen unzureichender Kapitaldienstdeckung, kritischem Liquiditätsbedarf, zu hohem LTV oder deutlichem ETF-Nachteil rot bewertet wurde.

Auswirkungen auf Architektur, Roadmap und Spezifikation

Architektur: keine Änderung
Roadmap: keine Änderung
Reporting-Vertrag: Präzisierung der bestehenden Begründungsdarstellung
Fachmodell: keine Änderung

Auswirkungen auf Formeln und KPIs

Keine. Die Anzeige nutzt ausschließlich vorhandene Felder:

ScenarioRating.scenario_rating
ScenarioRating.reason
ScenarioRating.hard_critical_findings
ScenarioResult.kpi_assessments

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

  • verständliche Befundliste in der rechten Spalte des Szenariovergleichs
  • keine Speicherung zusätzlicher Daten
  • gespeicherte Snapshots bleiben unverändert
  • unbekannte Befundcodes bleiben sichtbar und werden nicht verschwiegen

Auswirkungen auf Tests und Referenzfälle

Zu prüfen:

  • alle bekannten harten Befundcodes besitzen verständliche Labels
  • mehrere Befunde werden vollständig und ohne Duplikate angezeigt
  • gelbe Cases zeigen vorhandene grenzwertige KPI-Gründe
  • grüne Cases zeigen keinen erfundenen Befund
  • bestehender Szenariovergleich und Browserlauf bleiben erfolgreich

Legacy- und Migrationsfolgen

Keine. Ältere Snapshots ohne hard_critical_findings zeigen weiterhin die allgemeine Ratingbegründung.

Risiken und offene Fragen

Lange Befundlisten erhöhen die Zeilenhöhe. Die Case-Rating-Spalte erhält daher eine lesbare Mindestbreite und kompakte Listendarstellung.

Prüfergebnis

Der Vorschlag wurde gegen Reporting-Vertrag, ScenarioRating, KPI-Assessments, Snapshot-Kompatibilität und die bestehende Renderer-Verantwortung geprüft. Es ist keine neue fachliche Ableitung erforderlich.

Entscheidung

Angenommen. Umsetzung als reine Darstellung vorhandener Befunde ohne Modell-, Engine- oder Schemaversionserhöhung.

Zieldokumente

frontend/assets/js/scenario-rating-findings-ui.js
frontend/assets/css/scenario-rating-findings.css
frontend/assets/js/legal-footer.js
scripts/check-scenario-rating-findings.mjs
.github/workflows/contract-check.yml
docs/changes/proposals/specification-additions.md

Integrationscommit

Offen bis erfolgreichem Contract Check und Browserreview.