Lager Guru Dokumentation
Willkommen zur vollständigen Dokumentation für Lager Guru, ein Enterprise-Grade Warehouse Management und Transport Orchestrierungssystem.
Schnellstart
- Einführung - Was ist Lager Guru?
- Produkttour - Geführte Tour durch die Funktionen
- Hauptfunktionen - Vollständige Funktionsliste
- Architektur - Systemarchitektur
- Deployment Anleitung - Produktions-Deployment
- API Referenz - TypeScript API Dokumentation
- Troubleshooting - Häufige Probleme und Lösungen
Funktionen
Kernfunktionalität
- Multi-Rollen-System: Admin, Fahrer, Arbeiter Rollen mit rollenbasierter Zugriffskontrolle
- Echtzeit-Updates: Supabase Realtime für Live-Datensynchronisation
- PWA-Unterstützung: Installierbare, offline-fähige Progressive Web Application
- Barcode-Scanning: Kamera-basiertes Barcode-Scanning für schnelle Bestellungssuche
- GPS-Tracking: Live-Fahrerstandort-Tracking auf interaktiver Karte
- KI-Vorschläge: Intelligente Fahrer- und Zonenzuweisungsempfehlungen
- Schichtverwaltung: Wöchentliche/monatliche Schichtplanung mit Vorlagen, automatischer Status-Synchronisation und Analytics
- Analytics: Echtzeit-KPIs und erweiterte Berichte einschließlich Schichtstunden-Tracking
Enterprise Module
- Inventar / Bestandsverwaltung: Vollständige Inventarverfolgung mit Bestandsbewegungen
- Pick & Pack: Enterprise WMS-Style Kommissionierung und Verpackung
- Lagerkarte: SVG-basierte Zonenlayout-Visualisierung
- Slotting Optimization AI: Intelligente Zonenplatzierungsempfehlungen
- Wartungsmodul: Gerätewartungsverfolgung
- Sicherheit & Compliance: Vorfallberichterstattung und Analytics
- Equipment Tracking: QR/RFID/manuelle Gerätestandortverfolgung
- Auto Assignment Engine: Intelligente Fahrer- und Zonenzuweisung
Siehe Enterprise Module für detaillierte Dokumentation.
Technologie-Stack
- Frontend: React 18 + TypeScript + Vite
- UI: shadcn/ui + Tailwind CSS
- Backend: Supabase (PostgreSQL + Realtime + Auth)
- Karten: MapLibre GL
- Diagramme: Recharts
- Deployment: Docker + Nginx
Erste Schritte
Voraussetzungen
- Node.js 18+
- npm oder yarn
- Supabase-Konto
- Docker (für Deployment)
Installation
bash
# Repository klonen
git clone https://github.com/your-org/lager-guru.git
cd lager-guru
# Abhängigkeiten installieren
npm install
# Umgebungsvariablen einrichten
cp .env.example .env
# .env mit Ihren Supabase-Anmeldedaten bearbeiten
# Entwicklungsserver starten
npm run devEntwicklung
bash
# Entwicklungsserver ausführen
npm run dev
# Für Produktion bauen
npm run build
# Produktions-Build in der Vorschau anzeigen
npm run preview
# Dokumentation generieren
npm run docs:dev
npm run docs:buildDokumentationsstruktur
docs/
├── overview/ # Produktübersicht und Einführung
├── features/ # Enterprise Module und Funktionen
├── admin/ # Admin-Anleitungen und Konfiguration
├── users/ # Benutzeranleitungen (Arbeiter, Fahrer)
├── product/ # Produktinformationen (Preise, Editionen, FAQ)
├── api/ # API-Dokumentation
├── database/ # Datenbankreferenz
├── development/ # Entwickleranleitungen
├── integrations/ # Integrationsanleitungen
├── enterprise/ # Enterprise-Betrieb
├── security/ # Sicherheitsdokumentation
├── deployment/ # Deployment-Anleitungen
├── multitenant/ # Multi-Tenant-Architektur
├── sso/ # SSO-Integration
└── changelog/ # Release-NotizenMitwirken
Beim Hinzufügen neuer Funktionen oder Komponenten:
- JSDoc-Kommentare hinzufügen zu Ihrem TypeScript/React-Code
- Relevante Dokumentation aktualisieren im
docs/Ordner - Dokumentationsgenerierung ausführen:
npm run docs:generate - Änderungen in der Vorschau anzeigen:
npm run docs:dev
Ressourcen
- Haupt-README - Projektübersicht und Setup
- Installationsanleitung - Detaillierte Installationsschritte
- Runbook - Betriebsverfahren
- Wartungsanleitung - Wartungscheckliste
Support
Bei Problemen und Fragen:
- Prüfen Sie Troubleshooting
- Überprüfen Sie Runbook
- Öffnen Sie ein Issue auf GitHub
Zuletzt aktualisiert: 2025-12-07