Page 19 - LogiLoom_Plattform_Dokumentation

13 Technische Architektur

13.1 Technologie-Stack

LogiLoom ist als moderne Full-Stack-Webanwendung realisiert. Frontend und Backend teilen sich ein
gemeinsames TypeScript-Typsystem, was Laufzeitfehler durch Typ-Inkompatibilitäten zwischen API und UI
eliminiert. Der gesamte Quellcode ist in TypeScript geschrieben.

Schicht Technologie Version Zweck

Frontend React 19.x UI-Framework, komponentenbasiert
Frontend Vite 7.x Build-Tool und Dev-Server
Frontend Tailwind CSS 4.x Utility-first CSS-Framework
Frontend shadcn/ui + Radix UI aktuell Barrierefreie UI-Komponenten
Frontend Recharts 2.x Interaktive Diagramme
Frontend Wouter 3.x Client-seitiges Routing
Frontend TanStack Query 5.x Server-State-Management
Frontend React Hook Form + Zod aktuell Formularvalidierung
Frontend Framer Motion 12.x Animationen
API tRPC 11.x End-to-end typsichere API
API Zod 4.x Schema-Validierung für Eingaben
API Superjson 1.x Serialisierung (Date, Map, Set)
Backend Express 4.x HTTP-Server
Backend Node.js / tsx 22.x JavaScript-Laufzeit
Datenbank MySQL / TiDB aktuell Relationale Datenbank
Datenbank Drizzle ORM 0.44.x Typsicherer ORM
Auth Manus OAuth + JWT jose 6.x Authentifizierung und Session
Auth bcryptjs 3.x Passwort-Hashing
Speicher AWS S3 @aws-sdk 3.x Datei-Speicher (Profilbilder)
Testing Vitest 2.x Unit- und Integrationstests
Export xlsx 0.18.x Excel-Export

13.2 Datenbankschema

Die Datenbank besteht aus 11 Tabellen, die über Drizzle ORM verwaltet werden. Schemaänderungen
werden über Migrations-SQL-Dateien versioniert und nachvollziehbar dokumentiert. Alle Zeitstempel
werden als UTC-basierte Unix-Zeitstempel gespeichert.

Tabelle Beschreibung Wichtige Felder
users Benutzerkonten id, email, name, role (user/subadmin/admin),
passwordHash
shipments Sendungen (66 Felder) trackingNumber, status, shipmentType, priority,
sender*, recipient*, weight, dates, avisStatus