ADR 0006: Future Admin-Datenmanagement und Marktmietdatenbasis

Status: Accepted
Datum: 2026-07-02

Kontext

Immohai soll spaeter Marktmieten aus einer vom Nutzer gelieferten Datenbasis ableiten. Diese Datenbasis kann viele Vergleichsobjekte enthalten, z. B. aus CSV- oder Excel-Dateien.

Diese Aufgabe ist fachlich und technisch eine Datenpflegeaufgabe. Sie gehoert nicht in die normale Einzelanalyse, weil die Einzelanalyse schnell und fokussiert bleiben soll.

Entscheidung

Excel-/CSV-Import, Rohdatenvalidierung, Dublettenkontrolle, Ausreisserpruefung und Aktualisierung der Marktmietdatenbasis werden spaeter in einem separaten Admin-/Datenbereich umgesetzt.

Die normale Einzelanalyse nutzt nur gepruefte und aggregierte Werte aus der Marktmietdatenbasis.

Zieltrennung:

/app
  Einzelanalyse
  Ergebnisdashboard
  Reports

/admin
  Datenimport
  Import-Historie
  Marktmietdaten
  Datenqualitaet
  Aggregationen
  Quellenverwaltung

Begruendung

Diese Trennung reduziert Komplexitaet in der Analysemaske und verhindert, dass Rohdaten unmittelbar in Investitionsberechnungen einfließen.

Vorteile:

- Quick Mode bleibt schlank.
- Rohdaten koennen vor Nutzung validiert werden.
- Datenqualitaet und Confidence bleiben nachvollziehbar.
- Import-Historie und Quellenstand koennen dokumentiert werden.
- Spaetere Datenbanklogik bleibt vom Bewertungsformular getrennt.

Datenfluss

Zielarchitektur:

Excel / CSV
→ Admin Import
→ MarketRentImportBatch
→ MarketRentRawRecord
→ Normalisierung
→ MarketRentRecord
→ Quality Checks
→ MarketRentAreaStats
→ Einzelanalyse nutzt aggregierte Werte

Die Single-Property-Engine darf nicht direkt auf Rohdaten zugreifen.

Konsequenzen

Positive Konsequenzen

- klare fachliche Trennung zwischen Bewertung und Datenpflege
- bessere Testbarkeit der Marktmietlogik
- spaeter einfacher auf Backend und Datenbank uebertragbar
- keine Ueberladung der Quick-Mode-Eingabemaske

Negative Konsequenzen

- echte Marktmieten-Nutzung benoetigt spaeter Backend oder lokale Persistenz
- Adminbereich braucht eigenes UI-Konzept
- Import-Workflow wird ein eigener Entwicklungsblock

Nicht Teil des aktuellen MVP

- Login
- persistente Datenbank
- echter Dateiupload
- produktiver Adminbereich
- Speicherung echter Marktmiet-Rohdaten

Aktueller Stand

Aktuell vorbereitet:

- Spezifikation Admin-Datenmanagement
- Spezifikation Marktmieten-Import
- CSV-Template
- synthetische Testdaten
- Marktmieten-Aggregator als reines Datenmodul

Verweise

docs/specification/product-domains-and-workflows/admin-data-management.md
docs/specification/product-domains-and-workflows/market-rent-import.md
frontend/assets/js/market-rent-aggregator.js
frontend/assets/config/market-rent-import-template.csv