Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
Betrieb – Betriebsführungsprogramm Schaarschmidt Holzbau
Nachfolger des Projektplaners V70 als Serverversion. Anforderungen und Ausbaustufen stehen im Lasten- und Pflichtenheft; dieses Repository setzt sie um, beginnend mit Stufe 0 (Grundlage).
Aufbau
| Ordner | Inhalt |
|---|---|
src/domain |
Rechenkern ohne Datenbank: Arbeitstage und Feiertage SH, Beträge in Cent, Umsatzsteuer, Zahlungsplan, Liquidität |
src/server |
Server (Fastify), Datenbankzugriff, Migrationen in migrations/ |
src/web |
Oberfläche im Browser |
test |
Automatische Tests; api.test.ts braucht eine Testdatenbank |
deploy |
Betrieb auf dem Server: Docker Compose, Proxy, Update und Rückkehr |
backup |
Container für die nächtliche Sicherung |
Grundregeln: Beträge immer als ganze Cent, Datumsangaben als JJJJ-MM-TT, Verknüpfungen nur über IDs.
Jede Tabelle hat angelegt_am, geaendert_am, geaendert_von; jede Änderung landet in protokoll.
Entwickeln
Im Dev Container (VS Code oder GitHub Codespaces) ist alles eingerichtet:
npm run dev # Server auf http://localhost:3000, Datenbank aus dem Dev Container
npm test # alle Tests
npm run typecheck
Ohne Dev Container: Node 22 und PostgreSQL 16, dann DATABASE_URL und für die API-Tests
TEST_DATABASE_URL setzen. Datenbankänderungen nur als neue Datei in src/server/migrations
(002_….sql, 003_….sql); sie laufen beim Start automatisch.
Release
- Änderung im eigenen Zweig, Pull Request, Prüfung muss grün sein.
- Nach dem Zusammenführen
CHANGELOG.mdergänzen und einen Tag setzen:git tag v1.0.0 && git push --tags. - Auf dem Server baut
update.shdas Image aus diesem Tag (git.deichnet.com), eine Registry ist nicht nötig. - Auf dem Server (vorerst nur Produktion, ohne Testumgebung):
cd deploy
./update.sh 1.0.0
./zurueck.sh # falls etwas schiefgeht: vorige Version und Sicherung
Server einrichten (einmalig)
- Server mit Docker und git; ein Reverse Proxy (HAProxy) mit TLS leitet an
APP_ADRESSE:APP_PORTaus.envweiter. - Repository von git.deichnet.com auf den Server klonen,
deploy/.env.beispielnachdeploy/.envkopieren und ausfüllen. cd deploy && ./update.sh 0.53.1baut das Image und startet Programm, Datenbank und Sicherung (docker compose up -d). Die Daten liegen indeploy/data/dbunddeploy/data/backup. HTTPS macht der vorhandene HAProxy; er setztX-Forwarded-Proto: https.- Beim ersten Aufruf fragt das Programm nach dem Inhaber und dem Einrichtungscode (aus
.envoderdocker compose logs app | grep Einrichtungscode). Alle weiteren Zugänge legt der Inhaber unter „Benutzer“ an.
Sicherung: jede Nacht und vor jedem Update, 30 Tage aufbewahrt, Kopie per WebDAV in die Nextcloud.
Eine Sicherung von Hand: docker compose exec backup sicherung.