Zum Inhalt

Immohai Dokumentation

Immohai bewertet private Immobilieninvestitionen gegenüber einer ETF-Alternative unter Best-, Base- und Stress-Annahmen.

Aktueller Stand

Modell:                         0.6.2
Berechnungsengine:              frontend-mvp-0.2.5
PropertyInput-Schema:           0.5.1
AnalysisResult-Schema:          0.1.1
PropertyRecord-Schema:          0.1.1
RentEstimate-Schema:            0.1.0
Default-Assumptions:            0.2.1
Szenariopresets:                0.2.1
Objektprofile:                  0.2.1
Marktmiet-Importschema:         0.3.0
Datenqualitäts-Schema:          0.2.0
Datenqualitätsmethode:          analysis-dq-0.2.0

Produktiv deployt:

Modell:                         0.6.2
Berechnungsengine:              frontend-mvp-0.2.5
Integrationscommit:             353df78a332b0200b3bc1acf93fb806737c28877

Pull Request #12 schließt vor der Architekturprüfung verbleibende Runtime-, Herkunfts- und Legacy-Lücken. Dieser Korrekturstand ist noch nicht gemergt oder deployt.

Eine fachliche Wahrheit

Immohai verwendet keine parallelen Wahrheiten. Jede verbindliche Aussage besitzt genau ein führendes Dokument. Die Zuordnung steht in:

docs/governance/documentation-system.md

Für das deterministische Berechnungsmodell gilt:

1. docs/calculations/model-specification.md
2. docs/specification/data-quality-and-validation/data-model.md
3. docs/specification/model-and-calculations/calculation-interfaces.md
4. weitere führende Spezifikationen des jeweiligen Themas
5. maschinenlesbare Schemas und Modellkonfiguration
6. Implementierung und Tests
7. UI und Reports

docs/specification/model-and-calculations/calculations.md ist ausschließlich ein Überblick und definiert keine parallelen Formeln.

Zielarchitektur

Einzelanalyse ─┐
               ├──> PropertyInput -> ScenarioInput[] -> Single-Property-Engine -> AnalysisResult
Batch-Analyse ─┘                                                               ↓ bewusste Übernahme
                                                                         Meine Objekte

Separater Mietdatenfluss:

RentObservation
-> RentReferenceDataset
-> published innerhalb eines definierten Scope
-> RentEstimate
-> Einzel- oder Batch-Analyse

Grundsätze

Quick und Expert verwenden dieselbe Engine.
Rohdaten werden nie direkt berechnet.
Nur ein validiertes und berechenbares PropertyInput erreicht die Engine.
Szenario-Slider werden vor der Berechnung im PropertyInput gespeichert.
Der Szenarioresolver liest kein DOM.
Base bleibt bei Presets und eigenen Slidern unverändert.
Nur scenario_adjustable-Felder ändern sich zwischen Szenarien.
ETF-Rendite bleibt zwischen den Immobilien-Szenarien konstant.
Best, Base und Stress erhalten jeweils ein ScenarioRating.
Nur AnalysisResult erhält das vollständige Investment Rating.
AnalysisResult bindet den exakten PropertyInput-Snapshot.
Datenqualität wird nach der finalen Herkunftsauflösung bewertet.
PropertyRecords sind versionierte Snapshots.
Legacy-Records werden nicht still migriert.
Öffnen eines Snapshots rechnet nicht automatisch neu.
Reports und Vergleiche rechnen keine Fachwerte oder Ratings neu.

Zentrale Dokumente

docs/governance/documentation-system.md
docs/governance/change-control.md
docs/calculations/model-specification.md
docs/specification/data-quality-and-validation/data-model.md
docs/specification/model-and-calculations/calculation-interfaces.md
docs/specification/data-quality-and-validation/data-quality-assessment.md
docs/specification/model-and-calculations/kpi-assessments.md
docs/specification/data-quality-and-validation/validation.md
docs/specification/user-interface-and-reporting/reporting.md
docs/specification/product-domains-and-workflows/saved-objects.md
docs/roadmap/roadmap.md
docs/roadmap/current-status.md
docs/operations/deployment.md
docs/operations/browser-acceptance.md

Änderungssteuerung

Neue oder geänderte Anforderungen werden zunächst als einzelne nicht verbindliche Proposals erfasst:

docs/changes/proposals/architecture/
docs/changes/proposals/roadmap/
docs/changes/proposals/specification/

Der verbindliche Prozess steht in docs/governance/change-control.md.

Aktueller Fokus

Pull Request #12 vollständig prüfen und mergen
Integrationscommit deployen
Browserabnahme durchführen und dokumentieren
anschließend Architektur-Proposals einzeln bewerten

Öffentliche Seiten

App:                https://immohai.ohaisoft.com
Dokumentation:      https://docs.immohai.ohaisoft.com
Developer Playbook: https://playbook.ohaisoft.com