Architektur im Überblick
Fachliche Module, Komponenten, Datenfluss und wo die Details stehen.
Fachliche Module
Bearbeitbare Fassungen: draw.io · bilder/module.excalidraw
Die Bereiche entsprechen grob den Kapiteln der Spezifikation (docs/spec/). Die Pfeile zeigen die
wichtigsten fachlichen Datenflüsse, Stammdaten und Plattform nutzen alle Bereiche.
Produktion
Bearbeitbare Fassungen: draw.io · bilder/architektur-prod.excalidraw
Entwicklung (Dev-Stack)
Bearbeitbare Fassungen: draw.io · bilder/architektur-dev.excalidraw
Ein Klick auf ein Diagramm öffnet es in voller Größe; angezeigt wird der Excalidraw-Export passend zum hellen oder dunklen Farbschema. In den beiden Architekturdiagrammen zeigen die Pfeile, wer die Verbindung aufbaut.
Komponenten
- Backend (
backend/): Go mit chi, pgx und sqlc. Jeder Datenbankzugriff läuft über sqlc, Migrationen liegen inbackend/db/migrationsund laufen beim Start. - Frontend (
frontend/): React mit Vite, Tailwind und Zustand. Ein geteilter WebSocket je Browser liefert Echtzeit-Ereignisse: ein Leader-Fenster hält die Verbindung und verteilt sie an die übrigen Fenster. - Gateway (
gateway/): eigenes Go-Modul für lokale Geräte hinter NAT; verbindet sich ausgehend mit einem eigenen WebSocket-Hub des Backends. - Handbuch (
handbuch/): diese Seite, gebaut mit Blume.
Details: docs/architektur/backend.md,
docs/architektur/frontend.md und die ADRs im selben Ordner.