Hocks Mieterportal: 5 Module (Dashboard, Mietkonto, Schadensmeldungen, Dokumente, Nachrichten), Docker-Setup, eigenes Branding

2026-10-02 10:02:19 +02:00
commit 38d5099a2c
91 changed files with 17062 additions and 0 deletions
@@ -0,0 +1,35 @@
+# Hocks Mieterportal
+
+Mieterportal für die Verwaltung von 50 Wohnungen in 3 Häusern — analog zum Schulportal der Hocks-Gruppe.
+
+## Module
+
+1. **Dashboard** – persönliche Übersicht (Mieter) bzw. Kennzahlen, Belegung und Einnahmen (Verwaltung)
+2. **Mietkonto & Zahlungen** – Buchungsverlauf, offene Forderungen, Nebenkosten; Verwaltung sieht Zahlungsstatus aller 50 Wohnungen
+3. **Schadensmeldungen** – Tickets erfassen, priorisieren und Status pflegen
+4. **Dokumente** – Verträge, Abrechnungen, Hausordnung; zentraler Such- und Filterzugriff
+5. **Nachrichten** – Direktkommunikation Mieter ↔ Verwaltung
+
+Der Rollenwechsel Mieter ↔ Verwaltung erfolgt über die Schaltfläche in der Seitenleiste. Alle Demo-Daten werden lokal im Browser (localStorage) gespeichert.
+
+## Lokale Entwicklung
+
+```bash
+npm install
+npm run dev        # http://localhost:3000
+npm run build      # Produktionsbuild nach dist/
+```
+
+## Docker
+
+```bash
+docker build -t mieterportal .
+docker run -d -p 8080:80 --name mieterportal mieterportal
+# oder:
+docker compose up -d --build
+```
+
+Der Container liefert das gebaute Frontend über Nginx (SPA-Routing inklusive).
+Für den Betrieb unter `https://mieterportal.hocks.eu` einfach einen Reverse Proxy
+(Traefik, nginx, Caddy) davor setzen — Beispiel-Labels für Traefik inkl. Let's Encrypt
+liegen in der `docker-compose.yml`.