---
title: Architektur im Überblick
description: Fachliche Module, Komponenten, Datenfluss und wo die Details stehen.
---

import moduleHell from "./bilder/module.excalidraw.svg";
import moduleDunkel from "./bilder/module.excalidraw.dark.svg";
import prodHell from "./bilder/architektur-prod.excalidraw.svg";
import prodDunkel from "./bilder/architektur-prod.excalidraw.dark.svg";
import devHell from "./bilder/architektur-dev.excalidraw.svg";
import devDunkel from "./bilder/architektur-dev.excalidraw.dark.svg";

## Fachliche Module

<a href={moduleHell.src} className="inline-flex dark:hidden"><img src={moduleHell.src} alt="Fachliche Module von Lagewerk in neun Bereichen: Einsatzbetrieb, Führung und Stab, Sanitätsdienst, Anbindungen, Lagedarstellung, Dokumentation und Kommunikation, Stammdaten, Plattform und Geplantes, mit den wichtigsten Datenflüssen" /></a>
<a href={moduleDunkel.src} className="hidden dark:inline-flex"><img src={moduleDunkel.src} alt="Fachliche Module von Lagewerk in neun Bereichen: Einsatzbetrieb, Führung und Stab, Sanitätsdienst, Anbindungen, Lagedarstellung, Dokumentation und Kommunikation, Stammdaten, Plattform und Geplantes, mit den wichtigsten Datenflüssen" /></a>

Bearbeitbare Fassungen: [draw.io](/blume-assets/content/inhalt/entwicklung/bilder/module.drawio.svg) · `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

<a href={prodHell.src} className="inline-flex dark:hidden"><img src={prodHell.src} alt="Systemarchitektur in Produktion: Browser über Traefik zu Frontend, Backend und Handbuch; Backend mit PostgreSQL, RustFS, Photon und Gotenberg; externe Dienste; Lagewerk-Gateway vor Ort hinter NAT" /></a>
<a href={prodDunkel.src} className="hidden dark:inline-flex"><img src={prodDunkel.src} alt="Systemarchitektur in Produktion: Browser über Traefik zu Frontend, Backend und Handbuch; Backend mit PostgreSQL, RustFS, Photon und Gotenberg; externe Dienste; Lagewerk-Gateway vor Ort hinter NAT" /></a>

Bearbeitbare Fassungen: [draw.io](/blume-assets/content/inhalt/entwicklung/bilder/architektur-prod.drawio.svg) · `bilder/architektur-prod.excalidraw`

## Entwicklung (Dev-Stack)

<a href={devHell.src} className="inline-flex dark:hidden"><img src={devHell.src} alt="Systemarchitektur im Dev-Stack: wie Produktion, aber mit Caddy, Simulatoren, GreenMail, Gateway-Container, drucker-sim und optionalem Pangolin-Tunnel" /></a>
<a href={devDunkel.src} className="hidden dark:inline-flex"><img src={devDunkel.src} alt="Systemarchitektur im Dev-Stack: wie Produktion, aber mit Caddy, Simulatoren, GreenMail, Gateway-Container, drucker-sim und optionalem Pangolin-Tunnel" /></a>

Bearbeitbare Fassungen: [draw.io](/blume-assets/content/inhalt/entwicklung/bilder/architektur-dev.drawio.svg) · `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 in `backend/db/migrations` und 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`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/docs/architektur/backend.md),
[`docs/architektur/frontend.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/docs/architektur/frontend.md) und die ADRs im selben Ordner.
