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¶
- Upload streamt die Datei nach
captures/<id>/; ein Prüfauftrag liest sie und speichert Punktzahl und Ausdehnung. - „Aushub berechnen“ prüft die Eingaben und reiht einen Auftrag ein.
- Ein Worker übernimmt ihn (
UPDATE … RETURNINGin SQLite), rechnet im Thread-Pool und schreibt Ergebnis unddiff.tifnachjobs/<id>/. - 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: