Fahrzeuge verwalten

Die Fahrzeugseite ist die zentrale Anlaufstelle für das Flottenmanagement in Levy Fleets. Diese umfassende Anleitung behandelt alles, was Sie über das Hinzufügen, Anzeigen, Filtern und Verwalten Ihrer Fahrzeugflotte wissen müssen.

Zugriff auf die Fahrzeugseite

Navigieren Sie zu Dashboard > Fahrzeuge, um auf die Flottenverwaltungsoberfläche zuzugreifen. Die Seite zeigt alle Fahrzeuge an, die mit Ihrem ausgewählten Unterkonto verknüpft sind.

Seitenübersicht

Kopfzeilenbereich

Die Kopfzeile zeigt an:

• Seitentitel: "Fahrzeuge"
• Fahrzeuganzahl: Zeigt die Gesamtzahl der Fahrzeuge im aktuellen Unterkonto
• Aktionsschaltflächen:
  • CSV importieren: Massenimport von Fahrzeugen aus einer CSV-Datei
  • Fahrzeug hinzufügen: Ein einzelnes neues Fahrzeug manuell hinzufügen

Status-Übersichtskarten

Sechs anklickbare Statuskarten bieten einen schnellen Überblick über den aktuellen Zustand Ihrer Flotte:

Suche und Filterung

Schnellsuche

Die Suchleiste ermöglicht es Ihnen, Fahrzeuge zu finden nach:

• Fahrzeug-ID/Nummer (z.B. "VH-001")
• IMEI-Nummer
• FIN (Fahrzeug-Identifizierungsnummer)
• Modellname

Geben Sie einfach Ihren Suchbegriff ein und die Ergebnisse werden in Echtzeit gefiltert.

Statusfilter

Verwenden Sie das Dropdown-Menü, um Fahrzeuge nach ihrem aktuellen Betriebsstatus zu filtern:

• Alle Status (Standard)
• Verfügbar
• Verfügbar (Ausgeblendet)
• In Benutzung
• Wartung
• Offline
• Nicht bereit
• Wird geladen

Erweiterte Filter

Klicken Sie auf Weitere Filter, um auf zusätzliche Filteroptionen zuzugreifen:

1. Fahrzeugmodell: Nach bestimmtem Fahrzeugmodell/-typ filtern
2. Akkuladestand (Min %): Nur Fahrzeuge mit Akku über einem Schwellenwert anzeigen
3. Akkuladestand (Max %): Nur Fahrzeuge mit Akku unter einem Schwellenwert anzeigen

Klicken Sie auf Filter löschen, um alle erweiterten Filter zurückzusetzen.

Ansichtsmodi

Wechseln Sie zwischen zwei Ansichtsmodi über die Schaltflächen oben rechts in der Fahrzeugliste:

Listenansicht

Zeigt Fahrzeuge in einem detaillierten Tabellenformat an (Standard auf Desktop) mit Spalten:

• Kontrollkästchen zur Auswahl
• Fahrzeug (ID, Modell und Symbol)
• Status (mit Inline-Bearbeitung)
• Akkuladestand mit farbcodierter Anzeige
• Standort (Koordinaten oder Adresse)
• Kilometerstand (in km)
• Letzter Signalzeitpunkt
• Aktionsschaltflächen

Kartenansicht

Zeigt alle gefilterten Fahrzeuge als Markierungen auf einer interaktiven Google-Karte an.

Kartenfunktionen:

• Benutzerdefinierte SVG-Markierungen mit statusfarbigen Symbolen
• Akkuprozentsatz auf jeder Markierung angezeigt
• Info-Fenster-Popups beim Klicken auf eine Markierung
• Automatische Anpassung der Grenzen, um alle Fahrzeuge anzuzeigen
• Zoom-, Vollbild- und Kartentyp-Steuerungen

Markierungsfarben nach Status:

Info-Fenster-Inhalt (klicken Sie auf eine beliebige Markierung):

• Fahrzeugnummer und Modell
• Status-Badge
• Akkuprozentsatz mit Symbol
• Kilometerstand
• Letzte Signalzeit (relativ)
• GPS-Koordinaten
• Schnelllinks zu "Details anzeigen" und "Fahrten"

Kartenlegende: Eine Legende am unteren Rand zeigt die Farbcodierung für jeden Statustyp.

Nützlich für:

• Visualisierung der Flottenverteilung
• Identifizierung von Fahrzeugclustern
• Auffinden von Fahrzeugen an bestimmten Standorten
• Überprüfung, welche Fahrzeuge keine Standortdaten haben

Ein neues Fahrzeug hinzufügen

Manuelle Eingabe

1. Klicken Sie auf die Schaltfläche Fahrzeug hinzufügen
2. Füllen Sie die erforderlichen Felder aus:
   • Fahrzeug-ID (erforderlich): Eindeutiger Identifikator (z.B. "VH-001", "SCOOTER-123")
   • Fahrzeugmodell (erforderlich): Wählen Sie aus konfigurierten Modellen für Ihr Unterkonto
   • IoT-Gerät (erforderlich): Wählen Sie ein verfügbares (nicht verknüpftes) IoT-Gerät
   • FIN (optional): Fahrzeug-Identifizierungsnummer
3. Klicken Sie auf Fahrzeug hinzufügen, um zu speichern

Massenimport per CSV

Siehe den speziellen Artikel Massenimport von Fahrzeugen (CSV) für detaillierte Anweisungen.

Fahrzeuge bearbeiten

Inline-Statusbearbeitung

Der schnellste Weg, den Status eines Fahrzeugs zu ändern:

1. Klicken Sie auf das Status-Badge in der Fahrzeugzeile
2. Wählen Sie den neuen Status aus dem Dropdown-Menü
3. Der Status wird sofort aktualisiert

Automatische IoT-Befehle: Beim Ändern des Status sendet das System automatisch entsprechende Befehle an das Fahrzeug:

• Setzen auf Verfügbar oder Verfügbar (Ausgeblendet) → Sendet SPERREN-Befehl
• Setzen auf Transport → Sendet ENTSPERREN-Befehl
• Setzen auf Wird geladen → Sendet AKKU ENTSPERREN-Befehl (für Akkuwechsel)

Vollständige Fahrzeugbearbeitung

1. Klicken Sie auf das Einstellungen (Zahnrad) Symbol in einer Fahrzeugzeile, oder
2. Klicken Sie auf Anzeigen, um die Fahrzeugdetailseite zu öffnen, dann klicken Sie auf Bearbeiten
3. Ändern Sie verfügbare Felder:
   • Fahrzeug-ID/Nummer
   • FIN
   • Fahrzeugmodell
   • Status
4. Klicken Sie auf Änderungen speichern

Massenoperationen

Mehrere Fahrzeuge auswählen

• Klicken Sie auf das Kontrollkästchen in einzelnen Fahrzeugzeilen
• Klicken Sie auf das Kopfzeilen-Kontrollkästchen, um alle gefilterten Fahrzeuge auszuwählen/abzuwählen
• Die Anzahl der ausgewählten Fahrzeuge erscheint in der Massenaktions-Symbolleiste

Massen-Statusaktualisierung

1. Wählen Sie ein oder mehrere Fahrzeuge aus
2. Wählen Sie in der blauen Massenaktionsleiste einen neuen Status aus dem Dropdown
3. Klicken Sie auf Status aktualisieren
4. Alle ausgewählten Fahrzeuge werden auf den neuen Status aktualisiert

Massen-QR-Code-Download

1. Wählen Sie die Fahrzeuge aus, für die Sie QR-Codes benötigen
2. Klicken Sie auf QR-Codes herunterladen in der Massenaktionsleiste
3. Eine ZIP-Datei wird heruntergeladen, die individuelle QR-Code-Bilder für jedes ausgewählte Fahrzeug enthält

Massenlöschung

1. Wählen Sie die zu löschenden Fahrzeuge aus
2. Klicken Sie auf Ausgewählte löschen
3. Bestätigen Sie die Löschung, wenn Sie dazu aufgefordert werden

Fahrzeugstatus verstehen

Verfügbar

Das Fahrzeug ist bereit für Kundenvermietungen. Wenn dieser Status gesetzt ist:

• Fahrzeug erscheint in der Kunden-App (sofern nicht ausgeblendet)
• IoT-Gerät ist gesperrt (Fahrzeug kann ohne Entsperren nicht gefahren werden)
• Fahrzeug ist zum Scannen/Mieten berechtigt

Verfügbar (Ausgeblendet)

Wie Verfügbar, aber:

• Fahrzeug erscheint NICHT in der Kunden-App
• Wird für Fahrzeuge verwendet, die bereit sind, aber vorübergehend vor Kunden verborgen werden sollen
• Häufige Verwendung: reservierte Fahrzeuge, Tests, bereitgestellte Fahrzeuge für den Einsatz

In Benutzung

Zeigt an, dass das Fahrzeug derzeit gemietet wird:

• Wird automatisch gesetzt, wenn ein Kunde eine Fahrt beginnt
• Wird automatisch gelöscht, wenn die Fahrt endet
• Sollte unter normalen Umständen nicht manuell gesetzt werden

Transport

Wird verwendet, wenn Mitarbeiter Fahrzeuge bewegen:

• Entsperrt das Fahrzeug, damit Mitarbeiter es fahren/bewegen können
• Fahrzeug erscheint für Kunden nicht als verfügbar
• Verwenden Sie dies beim Umsetzen von Fahrzeugen zwischen Zonen

Wartung

Fahrzeug wird gewartet oder repariert:

• Aus der Kundenverfügbarkeit entfernt
• Hilft zu verfolgen, welche Fahrzeuge in der Werkstatt sind
• Wird manuell von Flottenbetreibern gesetzt

Wird geladen

Wird während des Akkuladens/Akkuwechsels verwendet:

• Entsperrt automatisch das Akkufach
• Fahrzeug nicht für Vermietungen verfügbar
• Häufig bei Systemen mit wechselbaren Akkus verwendet

Nicht bereit

Ein Sammelstatus für nicht einsatzbereite Fahrzeuge:

• Neue Fahrzeuge, die noch nicht konfiguriert sind
• Fahrzeuge, die auf Inspektion warten
• Fahrzeuge mit ungelösten Problemen

Lager

Für Fahrzeuge in Langzeitlagerung:

• Fahrzeug ist gesperrt und gesichert
• Nicht für Vermietungen verfügbar
• Wird für saisonales Flottenmanagement verwendet
• Hilft, Fahrzeuge zu verfolgen, die vorübergehend aus der Rotation genommen wurden

Offline

Zeigt Kommunikationsprobleme an:

• Kein aktuelles Signal vom IoT-Gerät
• Kann auf leeren Akku, keinen Mobilfunkempfang oder Gerätefehler hinweisen
• Erfordert Untersuchung vor Ort

Fahrzeuginformationsanzeige

Jedes Fahrzeug in der Liste zeigt:

Akkuladestand

Farbcodierter Akkuprozentsatz:

• Grün (>50%): Guter Ladestand
• Gelb (21-50%): Mittlerer Ladestand, benötigt möglicherweise bald Aufmerksamkeit
• Rot (0-20%): Niedriger Akku, muss geladen werden

Standort

Zeigt entweder:

• Straßenadresse (wenn Geokodierung verfügbar)
• GPS-Koordinaten (Breitengrad, Längengrad)
• "Unbekannt", wenn keine Standortdaten vorhanden

Klicken Sie auf Koordinaten, um in Google Maps zu öffnen.

Kilometerstand

Gesamte zurückgelegte Strecke in Kilometern. Quellen können sein:

• Eingebauter Kilometerzähler des Fahrzeugs
• IoT-Gerät-Streckenverfolgung
• Aggregiert aus abgeschlossenen Fahrten

Letztes Signal

Zeit seit der letzten Kommunikation des IoT-Geräts:

• Zeigt "Nie", wenn kein Signal empfangen wurde
• Relative Zeit (z.B. "vor 5 Min.", "vor 2 Std.", "vor 3 Tagen")
• Verwendet den aktuellsten aller verfügbaren Zeitstempelfelder

Schnellaktionen

Jede Fahrzeugzeile bietet Schnellaktions-Schaltflächen:

Paginierung

Bei großen Flotten werden Fahrzeuge paginiert:

• 50 Fahrzeuge pro Seite (Standard)
• Maximal 100 Fahrzeuge pro Seite
• Seitennavigation am unteren Rand der Liste
• Zeigt aktuellen Seitenbereich (z.B. "1-50 von 350 Ergebnissen")
• Springen Sie zu bestimmten Seiten über die nummerierten Schaltflächen

Echtzeit-Updates

Die Fahrzeugliste wird in Echtzeit aktualisiert, wenn:

• IoT-Geräte neue Telemetriedaten senden
• Statusänderungen auftreten
• Fahrten beginnen oder enden

Kein manuelles Aktualisieren erforderlich, um den aktuellen Flottenzustand zu sehen.

Mobile Responsivität

Auf mobilen Geräten:

• Die Listenansicht wechselt zu einem kartenbasierten Layout
• Jedes Fahrzeug wird als erweiterbare Karte angezeigt
• Alle Aktionen über Tippen zugänglich
• Kartenansicht funktioniert mit Touch-Gesten

Berechtigungen

Die Fahrzeugverwaltung erfordert entsprechende Berechtigungen:

• Super Admin / Globaler Admin: Voller Zugriff auf alle Unterkonto-Fahrzeuge
• Admin / Flottenmanager: Kann Fahrzeuge in zugewiesenen Unterkonten hinzufügen, bearbeiten, löschen
• Servicetechniker: Kann nur den Fahrzeugstatus aktualisieren
• Betrachter: Nur-Lese-Zugriff

Best Practices

1. Konsistente Fahrzeug-IDs verwenden: Etablieren Sie eine Namenskonvention (z.B. "STADT-001", "ZONE-A-012")
2. IoT-Geräte verknüpft halten: Verknüpfen Sie Fahrzeuge immer mit IoT-Geräten für die Verfolgung
3. Status zeitnah aktualisieren: Genaue Status verbessern das Kundenerlebnis
4. Verfügbar (Ausgeblendet) strategisch nutzen: Für Tests oder bereitgestellte Einsätze
5. Offline-Fahrzeuge überwachen: Innerhalb von 24-48 Stunden untersuchen
6. Regelmäßige Flottenaudits: Überprüfen Sie periodisch alle Fahrzeuge auf Richtigkeit

Fehlerbehebung

Fahrzeug erscheint nicht in der Liste

• Überprüfen Sie das ausgewählte Unterkonto
• Überprüfen Sie, ob das Fahrzeug nicht gelöscht wurde
• Löschen Sie Filter und Suchbegriffe

Neues Fahrzeug kann nicht hinzugefügt werden

• Stellen Sie sicher, dass IoT-Geräte existieren und nicht verknüpft sind
• Überprüfen Sie, ob das Fahrzeugmodell für das Unterkonto konfiguriert ist
• Prüfen Sie auf doppelte Fahrzeug-ID

Statusänderung funktioniert nicht

• Überprüfen Sie, ob Ihre Benutzerrolle die Berechtigung hat
• Überprüfen Sie, ob eine aktive Fahrt auf dem Fahrzeug besteht
• Suchen Sie nach Fehlermeldungen in der Antwort

Akku zeigt 0%

• IoT-Gerät meldet möglicherweise keinen Akku
• Überprüfen Sie die Zeit des letzten Signals
• Fahrzeug muss möglicherweise vor Ort inspiziert werden

API-Referenz

Fahrzeuge auflisten

GET /api/vehicles

Abfrageparameter:

Fahrzeug erstellen

POST /api/vehicles
Content-Type: application/json

{
  "vehicle_number": "VH-001",
  "iot_imei": "123456789012345",
  "vehicle_model_id": "model-uuid",
  "vin": "1HGBH41JXMN109186",
  "subaccount_id": "subaccount-uuid"
}

Fahrzeug aktualisieren

PATCH /api/vehicles/[id]
Content-Type: application/json

{
  "status": "available",
  "vehicle_number": "VH-001-NEU",
  "vin": "aktualisierte-fin"
}

Fahrzeug löschen

DELETE /api/vehicles/[id]

Führt eine sanfte Löschung durch (setzt deleted_at Zeitstempel). Fahrzeugdaten werden aufbewahrt, erscheinen aber nicht mehr in Abfragen.

Webhooks

Wenn sich der Fahrzeugstatus ändert, kann das System Webhooks auslösen, um externe Systeme zu benachrichtigen.

vehicle.status_changed

Wird ausgelöst, wenn der Status eines Fahrzeugs über die API aktualisiert wird.

Payload:

{
  "vehicle_id": "uuid",
  "vehicle_number": "VH-001",
  "previous_status": "offline",
  "new_status": "available",
  "changed_at": "2024-12-25T12:00:00.000Z",
  "subaccount_id": "uuid"
}

Konfigurieren Sie Webhooks unter Dashboard > Einstellungen > Webhooks.