Skip to content

Elocaro 0.2.0

Choose a tag to compare

@TheR00st3r TheR00st3r released this 12 Nov 08:18
· 108 commits to main since this release
78fadb2

Hinzugefügt

Hinzugefügt

  • Datensicherung in der App (Verwaltung → System → Datensicherung): mehrere Ziele (S3, Azure Blob, SFTP, Google Drive, lokal), je Ziel eigener Zeitplan (täglich oder wöchentlich), Aufbewahrung und Status; Zugangsdaten und Passwort verschlüsselt in der Datenbank, Verbindungstest, „Jetzt sichern“, Liste der Sicherungen und Wiederherstellung per Klick (mit Bestätigung, die App startet danach neu). Google Drive wird über „Mit Google verbinden“ (Geräte-Code, nur Zugriff auf selbst angelegte Dateien) eingerichtet; den dafür nötigen OAuth-Client bringen die veröffentlichten Images mit (Release-Secrets, als BuildKit-Secret eingebaut, nicht im Quelltext); beim selbst gebauten Image trägt man ihn in der App oder der .env ein (Anleitung in docs/betrieb.md). Die Ersteinrichtung bietet „Aus einer Datensicherung wiederherstellen“ für einen neuen Server. Die Sicherung nach deploy/.env läuft ohne gespeicherte Einstellungen unverändert weiter (Refs #162).
  • MCP-Schnittstelle (/mcp, nur lesend, standardmäßig aus mit Mcp__Enabled=true): KI-Assistenten wie Claude, GitHub Copilot und Cursor können Objekte, Verträge, Mieterkonten, offene Posten, Belege, Umsätze, Zähler, Dokumente, Aufgaben und Fristen abfragen. Anmeldung über neue persönliche Zugriffstoken (Konto & Sicherheit → Zugriffstoken): nur der Hash wird gespeichert, mit Ablauf, widerrufbar, auf die Bereiche Stammdaten und Finanzen beschränkbar. Ein Token gibt nie mehr her als das Konto selbst: die Rechte werden bei jeder Anfrage neu bestimmt, Sperren, Rollenwechsel und entzogene Rechte gelten sofort; nur Administrator und Verwalter mit eingerichteter Zwei-Faktor-Anmeldung. Jeder Aufruf steht im Audit-Protokoll. Anleitungen für Claude, VS Code/Copilot, Cursor und ChatGPT in docs/mcp.md.
  • Verbrauchsinformation (Mieterportal und Mail): Der Heizverbrauch wird zusätzlich witterungsbereinigt mit dem Vorjahresmonat verglichen (Verbrauch je Gradtag der gewählten Wetterstation). So lässt sich prüfen, ob der Verbrauch unabhängig vom Wetter gestiegen ist. Nur zur Anzeige. Im Mieterportal zeigt ein Säulendiagramm je Zählerart den Verbrauch der letzten Monate gegen den Vorjahresmonat, bei der Heizung mit der witterungsbereinigten Änderung als Pfeil.
  • Heizkosten beim Mieterwechsel ohne Zwischenablesung: Statt der Platzhaltertabelle verteilt Elocaro den Heizverbrauch nach den Monatsgradtagen (VDI 3807) einer Wetterstation des Deutschen Wetterdienstes. Die Werte werden automatisch abgerufen (DegreeDays__Enabled), die Station wählt man je Objekt in den Heizungseinstellungen. Ohne Station gilt weiter der Platzhalter.

Geändert

  • Umgestellt auf .NET 11 (EF Core und Npgsql auf RC.3, die Laufzeit kommt aus dem aspnet:11.0-Image).
  • Updates laufen über die veröffentlichten Images: deploy/update.sh <Version> sichert, lädt die Images aus GHCR und startet neu, ohne Bau auf dem Server (docs/betrieb.md, Abschnitt Update).
  • Der Backup-Container ist jetzt eine kleine ASP.NET-Core-API (src/Elocaro.Backup) statt eines Shell-Skripts: gleiche Befehle auf der Konsole (run --rm backup backup|snapshots|restore|verify), gleiche Statusdatei, zusätzlich eine interne API mit Token für die App. Bestehende Installationen: BACKUP_API_TOKEN in deploy/.env eintragen; Image und Build-Kontext haben sich geändert (docker compose … up -d --build backup).
  • Konto-Seiten überarbeitet: Übersicht mit Profil und Navigationszeilen, Zurück-Link oben, Logo führt zur App. Zugriffstoken werden in einem Dialog erstellt; das neue Token lässt sich mit einer Schaltfläche kopieren, die Liste zeigt Karten statt einer Tabelle.

Sicherheit

  • Die Zwei-Faktor-Pflicht galt nicht für Adressen mit Dateiendung: Ein Konto ohne eingerichtete Zwei-Faktor-Anmeldung konnte CSV-, DATEV-, Anlage-V- und PDF-Exporte abrufen. Ausgenommen sind jetzt nur noch echte statische Dateien.
  • Benutzerverwaltung: Wer kein Administrator ist, kann sich und anderen nicht mehr die Rolle Administrator geben, niemanden als Administrator einladen, Administratorkonten weder ändern noch sperren oder entsperren, die eigene Rolle und die eigenen Rechte nicht ändern und keine Rechte vergeben, die er selbst nicht hat. Das prüft der Server, die Oberfläche bietet es nicht mehr an.
  • Änderungen an Rolle oder Rechten melden das betroffene Konto ab, auch in offenen Seiten. Die neuen Rechte gelten ab der nächsten Anmeldung. Bisher galten entzogene Rollen in offenen Seiten weiter.
  • Bilder über 50 Megapixel (FileStore__MaxImageMegapixels) werden beim Hochladen abgelehnt. Eine kleine Datei mit riesigen Bildmaßen konnte sonst den Speicher des Servers füllen. Dazu Speicherlimits für app und gotenberg in deploy/docker-compose.yml (APP_MEM_LIMIT, GOTENBERG_MEM_LIMIT).
  • Ersteinrichtung nur noch mit Einrichtungscode: Bisher wurde Administrator, wer eine neue Installation zuerst aufrief. deploy/install.sh erzeugt den Code (ELOCARO_SETUP_CODE in deploy/.env) und zeigt ihn an; ist keiner eingetragen, schreibt die App beim Start einen ins Protokoll, solange es kein Konto gibt. Bestehende Installationen mit Konten sind nicht betroffen. Gleichzeitige Anfragen legen nicht mehr mehrere Administratoren an.
  • Ausgehende Mails: Der Text von Einladungen, Anmelde-, Passwort- und Signatur-Links wird nach der Zustellung oder dem endgültigen Fehlschlag entfernt, auch rückwirkend; Empfänger, Betreff, Zeitpunkt und Status bleiben als Nachweis. Solche Mails lassen sich nicht erneut senden, Einladung oder Link werden neu ausgelöst.
  • Der Vollexport enthält den Text ausgehender Mails nicht mehr, denn darin standen gültige Anmeldelinks. Der Versandnachweis bleibt im Export.
  • Ausgehende Mails werden nach 3 Jahren gelöscht (Mail__RetentionDays), solche zu Abrechnungen und Mahnungen nur geleert. Das Anonymisieren einer Person bereinigt auch ihre Mails, die Auskunft nennt sie.
  • Container: no-new-privileges und cap_drop: ALL für alle Dienste von deploy/docker-compose.yml; nur Postgres, Backup und Caddy behalten die Capabilities, die sie brauchen.
  • /health nennt öffentlich nur noch den Gesamtstatus. Den Zustand einzelner Prüfungen (u. a. Datensicherung) sehen nur noch angemeldete Konten mit dem Recht System.
  • Antiforgery-, Zwei-Faktor- und Status-Cookie sind jetzt Secure.
  • Neue Aktion Konto & Sicherheit → Auf allen Geräten abmelden: beendet alle Sitzungen des Kontos und macht „Dieses Gerät merken“ ungültig.
  • Das eigene Konto lässt sich auch serverseitig nicht mehr sperren, bisher verhinderte das nur die Oberfläche.
  • Offene Seiten prüfen die Sitzung jede Minute statt alle 5 Minuten.
  • Optional lassen sich neue Data-Protection-Schlüssel mit einem Zertifikat außerhalb der Datenbank verschlüsseln (DataProtection__CertificatePath, siehe docs/betrieb.md). Das Zertifikat muss getrennt gesichert werden.
  • GitHub Actions sind auf Commit-Hashes festgelegt.
  • Anonymisierte Mails erscheinen im Dashboard nicht mehr als „nicht zustellbar“.

Geändert

  • Paket-Updates: Quartz.NET 4.7 (neue Migration UpgradeQuartzSchemaTo47 ergänzt die Spalte fixed_delay, ohne sie startet der Planer nicht), MudBlazor 9.12, Scriban 7.6, SkiaSharp 4.155; Test-Pakete bunit 2.14 und xunit.v3 4.0.3.
  • Statische Analyse: Meziantou.Analyzer und Banned-API-Prüfung (DateTime.Now u. a. verboten, Zeit über TimeProvider), NuGetAudit für alle Pakete und ein CI-Schritt für anfällige Pakete. Details in docs/entwicklung.md.
  • Einstellungen → Module: Die Auswahl innerhalb der Bereiche (z. B. Staffelmiete, DATEV-Export) steht jetzt direkt in der Kachel des Moduls statt auf einem zweiten Reiter.
  • Heizkosten-Einstellungen für Laien: Oben steht eine Zusammenfassung („Aktuell gilt …“), die Fragen sind in einfacher Sprache gestellt (Energieträger, „Erzeugt dieselbe Anlage auch das Warmwasser?“, Anteil nach Verbrauch mit Schnellwahl 70/60/50 %), Selteneres (Energieinhalt, Emissionsfaktor, Wetterstation) steht aufklappbar darunter, und eine kurze Erklärung nennt, was für die Heizkosten gebraucht wird.
  • Heizkosten: Die Wetterstation für die Gradtage wird nach der Postleitzahl des Objekts vorgeschlagen (nächste Station vorausgewählt, Liste nach Entfernung sortiert, mit Kilometerangabe). Die Positionen der Postleitzahlen liegen als Tabelle bei (GeoNames, CC BY 4.0), es wird nichts abgerufen.
  • Einrichtungsassistent: Die Frage nach den Standardvorlagen entfällt, sie werden ohnehin beim Start angelegt.
  • Darlehen, Wartung, Hausmeister-Aufgaben und CSV-Profile: „anlegen“ ist eine Schaltfläche im Seitenkopf mit Dialog; das Formular unter der Liste entfällt. Ebenso „Stand erfassen“ auf der Zählerseite (Dialog ReadingEntryDialog statt Formular auf der Seite, mit Foto und Bestätigung bei Auffälligkeiten).
  • Umlageschlüssel (Festlegen und Beenden je Zeile), AfA-Anschaffung (Button im Seitenkopf, Zusammenfassung statt Formular) und Zählerliste („Stand eintragen“ je Zähler, ohne Ablese-Runde) arbeiten mit Dialogen.
  • Vorlagen: Die Standardvorlagen werden beim Start automatisch angelegt (was fehlt, auch neue nach einem Update; bewusst Gelöschtes bleibt gelöscht). Die Schaltfläche „Standardvorlagen anlegen“ in der Vorlagenliste entfällt.
  • Beispieldaten: Die Mietverträge beginnen am 1. Januar des vorletzten Jahres. Die Demo-Instanz zeigt im Mieterportal versendete Abrechnungen mit Rechenweg, Vorjahresvergleich und freigegebenen Beispielbelegen.

Behoben

  • Dashboard: Gemeldete Zählerstände von Mietern erschienen nicht als Hinweis, weil die Quelle (ReadingReportTodos) nie registriert war. Ein Architekturtest prüft jetzt, dass jede ITodoSource registriert ist.
  • Abrechnung im Mieterportal auf dem Handy: Der Rechenweg steht als linksbündiger Block über die volle Breite der Karte, statt in schmale Spalten gequetscht zu werden. Die Summenzeile des Vorjahresvergleichs bricht um und lässt die Seite nicht mehr seitlich überstehen.
  • Datenimport: Eine leerstehende Wohnung bekommt ihre Fläche ab dem frühesten Mietbeginn des Hauses. Bisher ließ sich eine Abrechnung für frühere Jahre wegen der fehlenden Fläche nicht freigeben.
  • Handy: Die Reiter auf Detailseiten (z. B. Vertrag) springen beim Wischen nicht mehr auf den gewählten Reiter zurück.
  • Belegung auf dem Handy: Beim Wechsel des Jahres springt die Seite nicht mehr nach oben, sondern bleibt an der Jahresleiste.
  • Dokumentenliste auf dem Handy: Schlagworte brachen den Titel buchstabenweise um; Titel und Schlagworte stehen jetzt in einer Zelle und umbrechen sauber.
  • Interaktive Seiten reagieren erst, wenn die Verbindung steht: Bis dahin nehmen Auswahlfelder, Schalter und Knöpfe keine Eingaben an und werden nach kurzer Zeit abgedunkelt, statt Tipps zu verschlucken (langsame Mobilfunkverbindung).
  • manifest.webmanifest, Symbole und App-Icon wurden auf Unterseiten nicht gefunden (404, „manifest is not valid JSON“), weil <base> nach den Links stand.

Hinzugefügt

  • Mieterportal: Die Abrechnungsseite zeigt das Ergebnis, die Anteile je Kostenart und den Vergleich mit dem Vorjahr zusätzlich als Balkendiagramme. Eine Nachzahlung oder ein Guthaben steht mit Betrag im Text; die Tabellen bleiben.
  • Mieterportal: Die versendete Betriebskostenabrechnung hat eine eigene Seite (Portal → Abrechnungen) mit dem Rechenweg je Position in Klartext, dem Vergleich mit der Abrechnung des Vorjahres (Beträge und Unterschied je Kostenart), den vom Vermieter freigegebenen Belegen und „Frage zu dieser Position“ (neue Nachricht mit vorbelegtem Betreff, mit Hinweis, dass eine Rückfrage keinen förmlichen Einwand ersetzt). Mieter sehen nur die Abrechnung ihres eigenen Vertrags und nur versendete Fassungen, nie Werte anderer Mieter.
  • Belege für Mieter freigeben: Auf der Abrechnung gibt es den Reiter „Belege für Mieter“. Standard ist, dass nichts freigegeben ist; der Hinweis auf Daten Dritter steht dabei, Freigaben sind jederzeit zurücknehmbar. Der Abruf im Portal wird bei jedem Aufruf geprüft und im Zugriffsprotokoll festgehalten.
  • Abrechnungsschreiben: QR-Code und Link zum Mieterportal, wenn die öffentliche Adresse (Application__BaseUrl) eingestellt ist und ein Mieter des Vertrags ein Portalkonto hat. Der Code enthält nur den Portal-Link, keinen Zugangsschlüssel.
  • Abrechnungs-Assistent: Prüfhinweise zu typischen Einwänden (Kostenpositionen ohne Belegdatei, als nicht umlagefähig markierte Positionen). Sie sperren die Freigabe nicht.
  • Notfallmappe (Einstellungen → System → Notfallmappe): eine verschlüsselte HTML-Datei, mit der Angehörige die Vermietung weiterführen können, auch wenn Elocaro oder der Server nicht erreichbar sind. Sie enthält eine Checkliste für die ersten 30 Tage, Ihre eigenen Hinweise, Objekte, laufende Mietverträge mit Kontaktdaten, Miete und Kaution, offene Posten, Fristen, Konten (ohne Zugangsdaten), Dienstleister und Versicherungen sowie Hinweise zur Wiederherstellung; auf Wunsch liegen die unterschriebenen Mietverträge bei. AES-256-GCM mit PBKDF2-SHA256 (600.000 Iterationen), entschlüsselt wird offline im Browser. Das Passwort wird nirgends gespeichert. Die Startseite erinnert an die Erneuerung nach zwölf Monaten.
  • Lizenz geklärt: AGPL-3.0-or-later mit Urheberrechtsvermerk (README, „Über Elocaro“, Projektdateien) und Beitragsvereinbarung (CLA.md, Pull-Request-Vorlage, Hinweis in CONTRIBUTING.md) mit automatischer Prüfung als Action CLA.
  • Abrechnungs-Assistent warnt, wenn Belege des Zeitraums noch nicht vollständig auf Kostenarten und Objekte aufgeteilt sind (mit offener Summe); sie fehlen sonst in der Abrechnung.
  • Die Offline-Seite der installierten Web-App versucht es selbst erneut und öffnet Elocaro, sobald der Server wieder antwortet.
  • „Jetzt aufteilen“ auf der Belegseite trägt den offenen Rest als Betrag vor.
  • Beleg erfassen überarbeitet: Die Seite hat zwei Schritte (Rechnung, Zuordnung). Sichtbar sind nur Lieferant, Rechnungsnummer, Datum und Brutto; Leistungszeitraum, Netto, Fälligkeit und Notiz stehen unter „Weitere Angaben“. Die Zuordnung zu Kostenart und Objekt gehört gleich dazu, auch auf mehrere Kostenarten oder Objekte aufgeteilt; eine Statuszeile zeigt live, was noch zu verteilen ist. Speichern ohne vollständige Verteilung fragt nach.
  • Brennstoff (nur Heizkosten) und „Art der Rechnung“ (Abschlag oder Jahresabrechnung des Versorgers, nur bei Wasser, Abwasser, Heizung und Allgemeinstrom) erscheinen nur noch, wenn die gewählte Kostenart es verlangt. Der Haken „Jahresabrechnung“ ist eine Auswahl mit Erklärung.
  • Belegseite: Oben steht „Noch … nicht aufgeteilt“ mit dem Knopf „Jetzt aufteilen“. Die Aufgabe auf der Startseite („Belege ohne vollständige Kostenaufteilung“) ist jetzt „bald fällig“, nennt die Summe und führt bei einem Beleg direkt dorthin.
  • Neue Installationsanleitung docs/installation.md (und Unterseite installation.html auf der Website): Wahl des Weges, Probelauf, Server mit Skript, von Hand, NAS und Plattformen, Checkliste nach der Installation, Fehlersuche.
  • Abmelden im Benutzermenü ist abgesetzt und fragt „Wirklich abmelden?“.
  • Die Mietzeit eines Vertrags wird in einem Dialog korrigiert („Mietzeit korrigieren“ neben der Laufzeit).
  • Abrechnungs-Erinnerung: Im Abrechnungs-Assistenten lässt sich die Erinnerung für ein Objekt und Jahr dauerhaft ausblenden (und wieder einblenden), zum Beispiel wenn die Frist verstrichen ist und keine Abrechnung mehr entsteht. Die Abrechnung bleibt weiter möglich.
  • Handy: Die Kopfleiste mit dem Namen Elocaro erscheint auch im Verwaltungsbereich. Verliert die Seite die Verbindung, versucht sie es im Hintergrund erneut, statt auf „Erneut versuchen“ zu warten.
  • Demo-Modus (Demo__Enabled): legt beim ersten Start einen Demo-Benutzer ohne Zwei-Faktor an, lädt die Beispieldaten legt je Rolle einen Demo-Benutzer an (Verwalter, Hausmeister, Handwerker, Eigentümer, Mieter), sperrt Passwortänderung und Zwei-Faktor-Einrichtung, blendet die Sicherungsmeldung aus und zeigt die Zugangsdaten auf der Anmeldeseite; dazu deploy/docker-compose.demo.yml, deploy/Caddyfile.demo und deploy/demo/reset.sh für das nächtliche Zurücksetzen (siehe Betrieb → Demo-Instanz).