sleepwalker86/facility-manager repository overview

⁠🏠 Facility Manager - Hausverwaltung

Eine moderne, modulare Web-Anwendung zur Verwaltung von Zwei- und Mehrfamilienhäusern. Verwaltet Gebäude, Wohneinheiten, Mieter, Mietverhältnisse, Zähler und Zählerstände mit umfangreichen Analysefunktionen.

⁠📋 Inhaltsverzeichnis

• Schnellstart⁠
• Hauptfunktionen⁠
• Installation⁠
• Erste Schritte⁠
• Technische Dokumentation⁠

⁠🚀 Schnellstart

⁠Mit Docker (Empfohlen)

# 1. Repository klonen oder Projektordner öffnen
cd facility_manager

# 2. Docker Compose starten
docker-compose up -d

# 3. Anwendung öffnen
# Öffnen Sie http://localhost:5055 im Browser

⁠Ohne Docker

# 1. Virtuelle Umgebung erstellen
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# oder: venv\Scripts\activate  # Windows

# 2. Abhängigkeiten installieren
pip install -r requirements.txt

# 3. Anwendung starten
python run.py

# 4. Anwendung öffnen
# Öffnen Sie http://localhost:5055 im Browser

⁠✨ Hauptfunktionen

⁠🏢 Gebäudeverwaltung

• Verwaltung mehrerer Gebäude mit vollständigen Adressdaten
• Detailansichten mit Zähler-Analysen und Diagrammen
• Übersicht aller Wohneinheiten pro Gebäude

⁠🚪 Wohneinheiten

• Verwaltung von Wohnungen, Garagen, Kellern und Stellplätzen
• Größenangaben in m²
• Status-Tracking (vermietet/leer)
• Detailansichten mit Verbrauchsanalysen

⁠👥 Mieterverwaltung

• Vollständige Kontaktdaten (Name, E-Mail, Telefon, Mobil)
• Adressverwaltung
• Übersicht aller Mietverhältnisse pro Mieter

⁠📄 Mietverhältnisse

• Verbindung zwischen Mieter und Wohneinheit
• Start- und Enddatum (unbefristet möglich)
• Monatsmiete und Kaution
• Verbrauchsanalyse für den Mietzeitraum

⁠⚡ Zählerverwaltung

• Wohneinheitszähler: Zähler für einzelne Wohneinheiten
• Hauptzähler: Gebäudezähler für Dokumentation (nicht für Abrechnung)
• Zählertypen: Strom, Wasser, Gas, Heizung, Garten
• Unterkategorien: z.B. Kaltwasser, Warmwasser, Strom Bezug/Einspeisung
• Zählertausch mit Historie-Erhaltung
• Umfangreiche Filterfunktionen

⁠📊 Zählerstände & Analysen

• Erfassung von Zählerständen mit Datum
• Markierung geschätzter Werte
• Automatische Verbrauchsberechnung
• Jährliche Verbrauchsanalysen pro Zähler
• Gebäude-Analysen mit Diagrammen:
  • Verbrauch über Zeit (Liniendiagramm)
  • Verbrauch nach Zählertyp (Balkendiagramm)
  • Vergleich Hauptzähler vs. Wohneinheitszähler
• Detailansichten für alle Entitäten mit Verbrauchsdaten

⁠🎨 Benutzeroberfläche

• 4 Themes zur Auswahl:
  • Modern Blue (Standard)
  • Indigo
  • Modern Purple
  • Dark Mode
• Mobile-First Design mit Bootstrap 5
• Responsive Tabellen und Diagramme
• Intuitive Navigation mit Icons

⁠🔒 Sicherheit

• CSRF-Schutz für alle Formulare und API-Endpunkte
• Sichere Datenübertragung