Zum Inhalt

Architektur

flowchart LR
  B[Browser<br>Web-UI] -- HTTP, SSE --> A[axum<br>/api]
  A --> D[(SQLite)]
  A --> F[Datenverzeichnis<br>Aufnahmen, Ergebnisse]
  A --> Q[Job-Warteschlange]
  Q --> R[Rechenkern<br>crates/processing]
  R --> F

Eine Programmdatei: der Rust-Server liefert die gebaute Web-UI selbst aus (rust-embed), speichert in SQLite und einem Ordner und rechnet im selben Prozess. Aufbau wie haul; die Technik folgt tech-stack.md, Abweichungen stehen in CLAUDE.md.

Bereich Ort Technik
Rechenkern crates/processing Rust: LAS/LAZ, E57, GeoTIFF, Orthofoto, Raster, Bodenfilter, Volumen, Helmert, UTM/Geoid, Exporte
Server crates/server tokio, axum, sqlx (SQLite), Server-Sent Events, argon2id
Web-UI ui Bun, Vite, React, TanStack Router + Query, Komponenten im shadcn/ui-Stil auf Radix, Tailwind 4, Paraglide (de/en); Karte mit Leaflet, 3D mit three.js (nachgeladen)
E2E e2e Playwright gegen die echte Programmdatei
Auslieferung docker, scripts/install.sh Image in drei Stufen, statische musl-Programmdateien

Server

Modul Aufgabe
api.rs Routen unter /api, Live-Ereignisse /api/events
auth/ Einrichten, Anmelden, Sitzungen, CSRF, Rollen, Benutzer; API-Tokens als Bearer ohne CSRF (tokens.rs); Passkeys mit webauthn-rs, Zeremonien fünf Minuten im Speicher (passkeys.rs)
sites.rs Baustellen und Bereiche (GeoJSON)
captures.rs Hochladen (gestreamt), Name und Flugdatum ändern, Herunterladen, Löschen
jobs/ Warteschlange in SQLite, Worker im Prozess, übersteht Neustarts; spec.rs: Auftragsarten mit typisierten Parametern. Zwei Spuren: FIXPUNKT_MAX_JOBS Rechen-Worker und ein Photogrammetrie-Worker, der nur auf NodeODM wartet
odm/ Drohnenfotos über NodeODM: REST-Client (client.rs, reqwest mit rustls/ring), Ablauf mit Fortschritt und Wiederaufnahme nach Neustart (run.rs), Umrechnung in die Zone der Baustelle und Höhenversatz (cloud.rs)
compute/ Brücke zum Rechenkern: prüfen, Aushub, Haufwerk, Zeitreihe (volume.rs), Soll/Ist (compare.rs), Exporte (export.rs), Passpunkte (georef.rs, Vorschau unter /api/georef/fit)
view.rs Höhenraster für die 2D-Ansicht als Float32 (/api/captures/{id}/grid, /api/jobs/{id}/grid/{name}), je Aufnahme zwischengespeichert
markers/ Dokumentation: Zwangspunkte, Leitungen (Stützpunkte als JSON), Notizen, Fotos (Position und Zeit aus EXIF, Vorschaubild) unter markers/<id>/; als DXF (dxf.rs)
plans/ DXF-Pläne: einmal gelesen (dxf.rs: Linienzüge, Bögen, Texte, Höhenpunkte, Zonenkennung) und als JSON für die Ansicht abgelegt
ortho.rs Orthofoto je Aufnahme: GeoTIFF stückweise verkleinert (Rechenkern ortho.rs), als PNG mit Ecken in der Zone der Baustelle
uploads.rs Fortsetzbarer Upload nach tus 1.0 (Kern, creation, termination): Stücke nach uploads/, fertige Dateien an ihr Ziel (Aufnahme, Drohnenfoto, Orthofoto)
billing/ Abrechnung: Umrechnung fest/lose/t/Fahrten (convert.rs), Aufmaß je Zeitraum mit Preis und Abgleich (statement.rs, reine Funktionen), Lieferscheine mit CSV (deliveries.rs), Kennwerte je Material, Schichten (layers.rs, Aufteilung im Rechenkern volume::cut_by_layers), Positionen je Bereich und Schicht (positions.rs), GAEB DA XML X31 (gaeb.rs, geprüft gegen das offizielle Schema), Freigabe-Links mit eingefrorenem Aufmaß unter /api/public/shares ohne Anmeldung (shares.rs); Aufmaßblatt in report/billing.rs
dashboard/ Überblick einer Baustelle: Aushub je Befliegung gegen das Urgelände, Massenziele je Bereich und Material, Lagerbestand aus den Haufwerk-Berechnungen, letzter Soll/Ist, Zwangspunkte gegen die letzte Aufnahme; Bestand und Verlauf je Material (materials.rs)
flightplan.rs Flugplanung je Bereich: Vorschau als JSON mit Höhenbereich der letzten Aufnahme, Mission als KMZ (Rechenkern flightplan.rs, wpml.rs)
layouts.rs eigener Überblick je Benutzer und Baustelle (/api/me/layouts/{site}): Reihenfolge und Sichtbarkeit der Abschnitte, unbekannte fallen weg, neue kommen hinten dazu
points.rs Punktwolke für 3D: höchstens 1 Mio. Punkte, Float32 relativ zum Ursprung plus RGB, als punkte.bin zwischengespeichert
location.rs Lage der Baustellen für die Karte: Mitte der geprüften Aufnahmen (sonst der Bereiche), UTM → Breite/Länge
report/ PDF-Bericht (/api/jobs/{id}/report): Inhalt je Auftragsart als reine Funktionen (build.rs), Karte (map.rs), Layout mit Helvetica und echten Zeichenbreiten (pdf.rs, pdf-writer, Fotos als JPEG); Dokumentation und Plan/Ist der Baustelle (site.rs, Abruf in site_routes.rs); eigener Bericht aus Bausteinen (custom.rs) aus Überblick (overview.rs) und Dokumentation (entries.rs)
events.rs Live-Ereignisse je Thema und Baustelle (Server-Sent Events)
db.rs SQLite: Verbindung, Migrationen, gemeinsame Abfragen
config.rs, state.rs Einstellungen aus Umgebungsvariablen, gemeinsamer Zustand der Routen
crypto.rs Zufallstokens, SHA-256 für gespeicherte Tokens, Passwörter mit argon2id
ui.rs eingebettete UI mit ETag, Weiterleitung auf Vite in der Entwicklung
error.rs Fehler als Schlüssel; die UI zeigt den Text in der gewählten Sprache

Ablauf einer Berechnung

  1. Upload streamt die Datei nach captures/<id>/; ein Prüfauftrag liest sie und speichert Punktzahl und Ausdehnung.
  2. „Aushub berechnen“ prüft die Eingaben und reiht einen Auftrag ein.
  3. Ein Worker übernimmt ihn (UPDATE … RETURNING in SQLite), rechnet im Thread-Pool und schreibt Ergebnis und diff.tif nach jobs/<id>/.
  4. Jeder Statuswechsel geht als Ereignis an alle offenen Browser; die UI lädt nur die betroffenen Listen neu.

Datenmodell

Baustelle → Aufnahmen, Bereiche, Aufträge, Pläne, Markierungen (Dokumentation), Lieferscheine, Kennwerte und Schichten, Freigaben; Benutzer mit Rolle, Sitzungen, Passkeys, API-Tokens und eigenem Überblick je Baustelle. Eine Instanz gehört einer Firma; Mandanten kommen erst, wenn eine Instanz mehrere Firmen bedienen soll.

Letztes Update: