App-Shell, Navigation und Analysemodi¶

Status: verbindlicher Zielentwurf
Spezifikationsversion: 1.1.0
Modellbezug: 0.6.2
Stand: 2026-07-05

1. Zweck¶

Diese Spezifikation definiert den allgemeinen App-Rahmen von Immohai:

globale Navigation
Hauptbereiche der App
Quick-/Expert-Switch
wiederverwendbare Frontend-Patterns
Abgrenzung des Adminbereichs

Sie definiert keine Berechnungsformeln und keine Datenverträge.

2. Hauptnavigation¶

Einzelanalyse
Batch-Analyse
Meine Objekte
Dokumentation

Separater administrativer Bereich:

Admin / Marktmiet-Daten

Der Adminbereich wird nicht als persönlicher Analysebereich dargestellt.

3. Einzelanalyse¶

Die Einzelanalyse enthält:

Quick Mode
später Expert Mode
Eingaben
optionale Quellenreferenz
optionale Mietschätzung
optionale Szenario-Slider
Ergebnisbereiche
bewusstes Speichern
Reportvorschau

4. Quick und Expert Mode¶

Quick Mode:
  wenige Eingaben
  sichtbare Defaults
  sichtbare Herkunft
  sichtbare Szenarioeinstellungen

Expert Mode:
  vollständige Annahmen
  fachlicher Status
  Szenario-Policies
  Best-/Stress-Overrides

Beide Modi erzeugen dasselbe PropertyInput und verwenden dieselbe Engine.

5. Szenarioeinstellungen¶

Der Nutzer kann wählen:

versionierte Presets
eigene Best-/Stress-Slider

Die UI schreibt die Einstellung vor dem Rechenlauf in:

PropertyInput.scenarios.control_mode
PropertyInput.scenarios.controls

Der Szenarioresolver liest keine Slider direkt aus dem DOM.

6. Ergebnisnavigation¶

Aktuelle Bereiche:

Dashboard
Finanzierung
Cashflow
ETF & Vermögen

Der Szenariovergleich zeigt Case Ratings für Best, Base und Stress. Das Investment Rating der Gesamtanalyse wird davon klar getrennt dargestellt.

7. Wiederverwendbare UI-Muster¶

AppHeader
NavigationMenu
ModeSwitch
InputPanel
ScenarioControlPanel
KpiCard
AssessmentBadge
DataTable
FilterToolbar
Pagination
ReportPreview

UI-Komponenten dürfen keine eigene Fachlogik enthalten.

8. Zustände¶

not_calculated
calculated
calculated_with_warnings
dirty_after_calculation
failed

Formularänderungen nach einem Rechenlauf markieren den Stand als unberechnet. Sie verändern den vorhandenen AnalysisResult-Snapshot nicht.

9. Responsive Verhalten¶

Desktop:
  Eingabe und Ergebnisse nebeneinander, soweit Platz vorhanden

Mobil:
  Eingabe, Szenarioeinstellungen und Ergebnisse untereinander
  Tabellen horizontal scrollbar

10. Barrierearme Grundlagen¶

semantische Formulare
zugeordnete Labels
Tastaturbedienung
sichtbare Fokuszustände
Status nicht nur über Farbe
verständliche Fehlermeldungen

11. Abgrenzung¶

Diese Datei definiert nicht:

Formeln
KPI-Schwellen
Ratingregeln
Datenqualitätsmethode
PropertyInput-Felder
Reportinhalte

Dafür gelten die jeweiligen führenden Spezifikationen.