Lokale Entwicklung

Diese Seite beschreibt, wie Sie den KanzleiSynchron-Stack lokal aufsetzen, starten und vor jedem Commit prüfen.

Voraussetzungen

Rust (stable) — für das Axum-Backend.
Node.js 20+ — für das Next.js-Frontend.
PostgreSQL — als Datenbank.

Stack starten

./ks-run.sh

ks-run.sh startet den gesamten Stack auf Port 3013. Das Skript:

pinnt NEXT_PUBLIC_API_URL=/api, damit das Frontend seine API über denselben Origin erreicht,
führt scripts/seed-demo.sh aus, das Demo-Daten einspielt — damit landet ein Login auf :3013 direkt auf einem befüllten /today.

scripts/seed-demo.sh

Vor dem Commit: Test-Gate

Ein Commit gilt erst dann als fertig, wenn scripts/dev-test.sh gegen einen laufenden :3013-Stack mit Exit-Code 0 durchläuft:

scripts/dev-test.sh

Die Schritte des Gates:

vitest — Frontend-Unit-Tests.
cargo check — Backend kompiliert.
tsc — TypeScript-Typprüfung.
Playwright @smoke — End-to-End-Rauchtest.

E-Mail-Versand (Postmark)

Ohne gesetzten Postmark-Token läuft der Steuerberater-Versand im Sandbox-Modus: Die Bestätigung zeigt delivery: "sandbox", es wird keine echte E-Mail verschickt. Für echten Versand muss der Token serverseitig gesetzt sein (siehe Steuerberater-Kanal).

Nächster Schritt

Architektur-Überblick — Komponenten und Datenfluss.
Rollen & Capabilities — Rollen- und Berechtigungsmatrix.