Claude 9bd88bb7ec Testversion im Browser und Sicherung einspielen
Die Testversion bündelt Oberfläche und Server-Logik mit PGlite (Postgres als
WebAssembly). POST /api/import/stand spielt einen kompletten Stand mit allen IDs
in ein leeres Programm ein; damit ziehen die Daten später auf den Server um.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-20 04:18:42 +00:00

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

  1. Änderung im eigenen Zweig, Pull Request, Prüfung muss grün sein.
  2. Nach dem Zusammenführen CHANGELOG.md ergänzen und einen Tag setzen: git tag v1.0.0 && git push --tags.
  3. Auf dem Server baut update.sh das Image aus diesem Tag (git.deichnet.com), eine Registry ist nicht nötig.
  4. Auf dem Server erst die Testumgebung, nach Freigabe die Produktion:
cd deploy
./update.sh test 1.0.0
./update.sh produktion 1.0.0
./zurueck.sh produktion     # falls etwas schiefgeht: vorige Version und Sicherung

Server einrichten (einmalig)

  1. Server mit Docker und git, Ports 80 und 443 frei, zwei DNS-Einträge (Produktion und Test) auf seine Adresse.
  2. Repository von git.deichnet.com auf den Server klonen, deploy/.env.beispiel nach deploy/.env kopieren und ausfüllen.
  3. cd deploy && ./update.sh test 1.0.0 && ./update.sh produktion 1.0.0 baut das Image und startet beide Umgebungen samt Caddy (docker compose up -d).

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.

Description
No description provided
Readme 9.9 MiB
Languages
TypeScript 88.3%
CSS 9.8%
PLpgSQL 1.5%
Shell 0.2%
JavaScript 0.1%