Leistungsbilanz

Leistungsbilanz ist eine Webanwendung für die elektrische Ausführungsplanung. Im Mittelpunkt steht ein tabellenähnlicher Stromkreislisten-Editor, der Stromkreise, Gerätezeilen und wiederverwendbare Projektgeräte fachlich getrennt behandelt.

Das Projekt befindet sich in aktiver Entwicklung. Für SQLite stehen ein Docker-Server-Stack mit gebautem Anwendungscode und ein separater Entwicklungsstack bereit. Ein vollständig unterstütztes Produktionsdeployment für mehrere gleichzeitig arbeitende Prozesse und ein vollständig unterstütztes Produktionsdeployment fehlen weiterhin. Anmeldung und zwei feste Rollen sind vorhanden. Die Backend- und Persistenzgrundlage der bisherigen Revit-CSV-/IfcGUID-Anbindung ist durch den XLSX-Austausch des Linear-Plugins mit Worksharing-ID als externem Schlüssel ersetzt. R0 bis R5 sind abgeschlossen; die eigene Revit-Seite besitzt XLSX-Einstellungen und einen persistenten Erstimport. Objekttabelle, Editorzuordnung, Rückgabe und Folgeimport folgen in R6 bis R10.

Unterstützter Arbeitsablauf

Projekte und Verteilungen verwalten; Gebäude, Etagen und Räume auf einer eigenen Seite pflegen, Räume optional mit Fläche und Summen je Etage und Gebäude
pro Verteilung geschützte Stromkreisgruppen für Beleuchtung, 1-phasige und 3-phasige Stromkreise verwalten
Hauptschalter, Überspannungsableiter, Gruppenschutz und zusätzliche Verteilergeräte in der Stromkreisliste abbilden
Schutzgeräte je Stromkreis und optional je Gruppe konfigurieren
Leitungsquerschnitte für einzelne Stromkreise auf Anforderung nach DIN VDE 0298-4 berechnen und ausdrücklich übernehmen
leere, einzeilige und mehrzeilige Stromkreise abbilden
Stromkreise und Gerätezeilen per Drag-and-drop umstrukturieren
Projektgeräte einfügen, verknüpfen und kontrolliert synchronisieren
komplette Stromkreisblöcke filtern und sortieren
BMKs stabil halten und nur auf ausdrücklichen Befehl neu nummerieren
Änderungen projektweit und auch nach einem Reload rückgängig machen und wiederholen
benannte Sicherungspunkte anlegen, wiederherstellen und Revisionen einsehen
automatische Sicherungspunkte mit begrenzter Aufbewahrung nutzen
Seitenansicht mit Deckblatt, Verteilerübersicht und Verteilerplänen öffnen und über den Browser als PDF drucken; Büroangaben und Logo zentral pflegen
grobe Leistungsbilanzen für LPH 2/3 nach Kostengruppen führen, mit der detaillierten Bilanz vergleichen und einzelne Zeilen als Projektgerät übernehmen
Linear-XLSX-Dateien verlustarm lesen und schreiben; Revit-Seite, Erstimport, Editorzuordnung, Rückgabe und Folgeimport werden gemäß Phase-14-Plan in den nächsten Paketen angebunden

Technik

Next.js 16, React 19 und TypeScript für das Frontend
Express 5 und Zod für die API
SQLite, better-sqlite3 und Drizzle ORM für die Persistenz
eigener Spreadsheet-Grid statt eines Bootstrap-Tabellenframeworks
Node.js-Test-Runner für Domain-, Grid- und SQLite-Integrationstests

Schnellstart mit Docker

Voraussetzungen:

Git
Docker Desktop mit Docker Compose

git clone <repository-url>
Set-Location leistungsbilanz-ts
$env:AUTH_BOOTSTRAP_USERNAME = "admin"
$env:AUTH_BOOTSTRAP_PASSWORT = "<eigenes Startpasswort mit mindestens 12 Zeichen>"
docker compose up --build --detach

Danach:

Frontend: http://localhost:3001
API-Healthcheck: http://localhost:3001/health (über den Next.js-Rewrite)

Beim ersten Start erzeugen diese beiden Variablen genau einen Administrator, solange die Benutzertabelle noch leer ist. Danach werden sie ignoriert. Für einen dauerhaften Serverbetrieb gehören die Werte in eine nicht versionierte .env neben compose.yaml; Details stehen unter Anmeldung und Benutzerverwaltung.

Die Express-API ist nicht auf dem Host veröffentlicht. Sämtliche fachlichen API-Routen verlangen eine gültige Anmeldung; der Zugriff läuft über den Rewrite im Web-Dienst.

Der API-Container führt ausstehende Migrationen und die Schemaprüfung beim Start automatisch aus. Die SQLite-Datei liegt auf dem Host unter data/leistungsbilanz.db und bleibt beim Stoppen erhalten.

Das Laufzeit-Image läuft als Benutzer node (UID 1000), nicht als root. Ein data/-Verzeichnis, das ein früherer root-Container angelegt hat, braucht deshalb einmalig sudo chown -R 1000:1000 data auf dem Host.

docker compose ps
docker compose logs --follow
docker compose down

compose.yaml startet den Produktionsstand: gebautes dist/ und next start, ohne Quellcode-Mounts und ohne Datei-Watcher, mit Speichergrenzen und ohne root-Rechte im Container. Details stehen in Deployment und Betrieb.

Für die Entwicklung mit Hot Reload gibt es einen eigenen Stack mit Quellcode-Mounts und Watchern:

docker compose -f compose.dev.yaml up --build --detach
docker compose -f compose.dev.yaml logs --follow
docker compose -f compose.dev.yaml down

Die Watcher darin laufen im Polling-Modus, weil Bind-Mounts unter Windows und macOS keine inotify-Events durchreichen. Das kostet dauerhaft CPU, auch wenn niemand die Anwendung benutzt — deshalb gehört dieser Stack nicht auf einen Server.

Direkte lokale Entwicklung

Voraussetzungen:

Node.js 24
npm

npm ci
npm run db:migrate
npm run db:verify:circuit-schema
$env:AUTH_BOOTSTRAP_USERNAME = "admin"
$env:AUTH_BOOTSTRAP_PASSWORT = "<eigenes Startpasswort mit mindestens 12 Zeichen>"
npm run dev:api

In einem zweiten Terminal:

npm run dev:web

Frontend und API laufen anschließend auf denselben Ports wie im Docker-Setup.

Qualitätssicherung

npm test
npm run build:api
npm run build:web
npm run typecheck:scripts
npx tsc --noEmit -p tsconfig.next.json

Wichtige Datenbankbefehle:

npm run db:backup
npm run db:migrate
npm run db:verify:circuit-schema
npm run db:generate

db:backup verwendet die SQLite-Online-Backup-API und prüft das Ergebnis auf Integrität und Fremdschlüsselverletzungen. Migration 0000 ist die Release-Baseline für eine leere Datenbank; nachfolgende nummerierte Migrationen entwickeln diese Baseline additiv weiter. Datenbanken aus Entwicklungsständen vor der Baseline werden nicht unterstützt.

Dokumentation

Für LLM-gestützte Änderungen enthält AGENTS.md die verbindlichen Domänenregeln, unterstützten Einstiegspunkte und Architekturgrenzen.

7.2 KiB Raw Blame History Unescape Escape