Fahrzeugdetailseite

Die Fahrzeugdetailseite bietet umfassende Informationen über ein einzelnes Fahrzeug und ermöglicht es Betreibern, dieses Fahrzeug in Echtzeit zu steuern, zu überwachen und zu verwalten. Diese Anleitung behandelt alle auf der Detailseite verfügbaren Funktionen.

Zugriff auf die Fahrzeugdetailseite

Navigieren Sie zur Fahrzeugdetailseite durch:

1. Klicken Sie in der Fahrzeugliste auf Anzeigen bei einer beliebigen Fahrzeugzeile
2. Direkte URL: /dashboard/vehicles/[fahrzeug-id]

Seitenlayout-Übersicht

Die Fahrzeugdetailseite ist in mehrere Bereiche unterteilt:

1. Kopfzeile - Fahrzeugidentität, Unterkonto und primäre Steuerungen
2. Schnellaktionsleiste - Häufig verwendete Befehle und Aktionen
3. Allgemeine Info-Karte - Statische Fahrzeuginformationen
4. Status- und Telemetrie-Karte - Live-Echtzeitdaten vom IoT-Gerät
5. Aktuelle Aufgaben - Offene Serviceaufgaben und Arbeitsaufträge
6. Fahrtende-Fotos - Aktuelle Parknachweis-Bilder
7. Aktuelle Fahrten - Neueste Mietverlauf
8. IoT-Befehle - Vollständiges Befehlspanel zur Gerätesteuerung
9. Standortkarte - Aktuelle und historische GPS-Positionen

---

Kopfzeilenbereich

Fahrzeugidentität

Die Kopfzeile zeigt:

• Fahrzeug-ID/Nummer: Der primäre Identifikator (z.B. "VH-001", "SCOOTER-123")
• Unterkonto-Badge: Zeigt den Unterkontonamen, die Stadt und das Bundesland
• Fahrzeugmodell: Der Modell-/Fahrzeugtyp

Sperren/Entsperren-Schaltflächen

Die wichtigsten Steuerungen sind prominent angezeigt:

Schaltflächenzustände:

• Deaktiviert (abgeblendet): Fahrzeug befindet sich bereits in diesem Zustand
• Aktiv: Klicken, um Befehl zu senden
• Laden (Spinner): Befehl wird gesendet

Die Schaltflächen erkennen automatisch den aktuellen Sperrstatus und deaktivieren sich, wenn bereits in diesem Zustand.

---

Schnellaktionsleiste

Eine horizontale Leiste mit häufig verwendeten Steuerungen:

Fahrzeug-Signalton-Schaltfläche

• Zweck: Spielt einen hörbaren Alarm am Fahrzeug ab, um es zu lokalisieren
• Anwendungsfall: Auffinden eines Fahrzeugs in einem überfüllten Parkbereich oder Überprüfung, ob Sie am richtigen Roller sind
• Deaktivierter Zustand: Zeigt Tooltip, der erklärt, warum, wenn das Protokoll keinen Ton unterstützt

Befehl nach IoT-Modell:

Akku entsperren-Schaltfläche

• Zweck: Entsperrt das Akkufach zum Wechseln
• Anwendungsfall: Akkuwechsel-Operationen für Fahrzeuge mit wechselbarem Akku
• Farbe: Bernstein zur Vorsichtsanzeige

Befehls-Suchsequenz (versucht jeden der Reihe nach, bis einer funktioniert):

1. UNLOCK_BATTERY_LOCK (Segway Max Plus)
2. BATTERY_LOCK_UNLOCK (Okai/Queclink)
3. CONTROL_EXTERNAL_LOCKS mit operation=1 (Omni SCOR)

Fahrt starten/beenden-Launcher

Dynamische Schaltfläche, die sich ändert, je nachdem, ob eine aktive Fahrt existiert:

Keine aktive Fahrt:

• Zeigt Fahrt starten-Schaltfläche
• Öffnet den vom Personal initiierten Fahrtablauf
• Verwendet für: Tests, Demonstrationen, Umpositionierung

Aktive Fahrt existiert:

• Zeigt Aktive Fahrt anzeigen-Link
• Verlinkt zur Fahrtdetailseite
• Zeigt Fahrtnummer zur Identifikation

Fahrzeugaktionen-Menü

Zusätzliche Aktionen im Dropdown verfügbar:

---

Allgemeine Info-Karte

Statische Informationen über die Fahrzeugkonfiguration:

Inline-Status-Editor

Klicken Sie auf das Status-Badge, um den Status des Fahrzeugs direkt von dieser Seite aus zu ändern. Verfügbare Status:

• Verfügbar
• Verfügbar (Ausgeblendet)
• In Benutzung
• Transport
• Wartung
• Wird geladen
• Lager
• Offline
• Nicht bereit

---

Status- und Telemetrie-Karte

Diese Karte zeigt Echtzeitdaten vom IoT-Gerät an und aktualisiert sich automatisch über WebSocket-Abonnement.

Akku-Informationen

Farbcodierung:

• Grün (>50%): Gut
• Gelb (21-50%): Überwachen
• Rot (0-20%): Muss geladen werden

Sperrstatus

Zeigt aktuellen Sperrzustand:

• Gesperrt: Fahrzeug ist gesichert, Gashebel deaktiviert
• Entsperrt: Fahrzeug kann gefahren werden
• Unbekannt: Kein aktueller Status vom Gerät

Zündungsstatus

Für Fahrzeuge mit Zündungserkennung:

• Ein: Fahrzeug ist eingeschaltet
• Aus: Fahrzeug ist ausgeschaltet

Kilometerstand

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

• Eingebauter Kilometerzähler des Fahrzeugs
• IoT-berechnete Strecke aus GPS
• Aggregierte Fahrtstrecken

Standort

Aktuelle GPS-Koordinaten mit Zeitstempel:

• Zeigt Breitengrad und Längengrad
• Zeigt an, wann der Standort zuletzt aktualisiert wurde
• Link zur Anzeige auf externer Karte

Signalinformationen

Mobilfunk-Verbindungsdaten:

• Signalstärke: Mobilfunk-Signalqualität
• Letztes Signal: Wann das Gerät zuletzt kommuniziert hat

Fahrtstatistiken

Schnelle Statistiken über Vermietungsaktivitäten:

• Gesamtfahrten: Anzahl der abgeschlossenen Vermietungen
• Erste Fahrt: Wann das Fahrzeug zum ersten Mal vermietet wurde
• Letzte Fahrt: Datum der letzten Vermietung

Fehlercodes

Wenn das Fahrzeug Fehler meldet:

• Zeigt aktuelle Fehlercode(s) an
• Zeigt Fehlermeldungsbeschreibung
• Kritisch für die Diagnose von Problemen

---

Aktuelle Aufgaben-Karte

Zeigt offene und kürzlich aktualisierte Serviceaufgaben:

• Wartungsarbeitsaufträge
• Schadensmeldungen
• Inspektionseinträge
• Benutzerdefinierte Aufgaben

---

Fahrtende-Fotos-Karte

Zeigt die letzten 6 Parknachweis-Fotos, die von Kunden aufgenommen wurden:

• Fotos werden in einem 3x2-Raster angezeigt
• Klicken Sie auf ein beliebiges Foto, um es in voller Größe anzuzeigen
• Fotos sind nach dem neuesten zuerst sortiert
• Zeigt nur Fotos, bei denen Kunden einen Nachweis hochgeladen haben

Was diese Fotos zeigen

Fahrtende-Fotos werden aufgenommen, wenn Kunden ihre Miete abschließen:

• Bestätigt korrektes Parken
• Dokumentiert den Fahrzeugzustand
• Hilft, Missbrauch oder unsachgemäßes Parken zu identifizieren
• In vielen Rechtsordnungen für die Einhaltung erforderlich

---

Aktuelle Fahrten-Karte

Zeigt die letzten 3 Fahrten auf diesem Fahrzeug:

Klicken Sie auf Alle Fahrten anzeigen, um den vollständigen Fahrtverlauf für dieses Fahrzeug anzuzeigen.

---

IoT-Befehle-Bereich

Erweiterbarer Bereich mit vollständiger Gerätesteuerung:

Zugriff auf Befehle

1. Klicken Sie auf Befehle anzeigen, um den Bereich zu erweitern
2. Sehen Sie aktuelle Telemetrie-Antworten
3. Senden Sie einzelne Befehle

Passwort-Konfiguration

Einige IoT-Protokolle erfordern Authentifizierung:

• Gerätepasswort: Wird für Befehlsauthentifizierung verwendet
• Automatisch ausgefüllt basierend auf IoT-Typ und Unterkonto-Einstellungen
• Kann bei Bedarf manuell überschrieben werden

Standardpasswörter nach Protokoll:

• OKAI: zk200
• Queclink: ks600
• Andere: 0000

Protokollspezifisches Verhalten

Omni SCOR-Protokoll:

• Befehle werden direkt ohne Passwort gesendet
• Echtzeit-bidirektionale Kommunikation
• Keine Passworteingabe erforderlich

Segway TCP-Protokoll:

• Direkte TCP-Verbindung zum Gerät
• Passwort wird auf Protokollebene gehandhabt

SMS-basiert (OKAI, Queclink):

• Befehle werden per SMS gesendet
• Antwort kann verzögert sein
• Passwort im Befehlsstring enthalten

Verfügbare Befehle

Befehle variieren je nach IoT-Gerätetyp, umfassen aber typischerweise:

Befehle senden

1. (Falls zutreffend) Befehlsparameter festlegen
2. Senden-Schaltfläche klicken
3. Auf Antwortanzeige warten
4. Ergebnis im Telemetrie-Feed anzeigen

Aktuelle Geräteantworten

Der Telemetrie-Feed zeigt die letzten 30 Nachrichten:

• Echtzeit-Updates: Neue Nachrichten erscheinen automatisch
• Erweiterbare Einträge: Klicken, um vollständige Payload anzuzeigen
• Kopierfunktion: Roh-Payload zum Debuggen kopieren
• Typindikatoren: Zeigt Nachrichtentyp (Status, Bestätigung, Heartbeat, etc.)

Befehlsantwort-Status

Nach dem Senden eines Befehls sehen Sie eines von:

• Erfolg: Gerät hat Befehl bestätigt
• Zeitüberschreitung: Gerät hat nicht rechtzeitig geantwortet
• Fehlgeschlagen: Gerät hat den Befehl abgelehnt
• Gesendet (keine Bestätigung): Befehl abgesendet, keine Bestätigung

---

Standortkarte

Interaktive Karte, die zeigt:

• Aktuelle Fahrzeugposition (Markierung)
• Standortverlaufs-Trail (falls verfügbar)
• Zonen-Overlays (falls konfiguriert)

Kartensteuerungen

• Schwenken/Zoomen: Standard-Kartennavigation
• Satellitenumschaltung: Zwischen Karten- und Satellitenansicht wechseln
• Vollbild: Karte auf Vollbild erweitern

Historische Verfolgung

Der Standortverlauf zeigt:

• GPS-Breadcrumb-Trail
• Zeitstempel für jeden Punkt
• Bewegungsmuster
• Zeit an jedem Standort

---

Echtzeit-Updates

Die Detailseite aktualisiert sich automatisch, wenn:

• Neue Telemetrie vom IoT-Gerät eintrifft
• Sperrstatus sich ändert
• Akkuladestand sich ändert
• Standort aktualisiert wird
• Fahrt beginnt oder endet

Updates werden über WebSocket-Abonnement zum Telemetrie-Kanal des Fahrzeugs gepusht.

---

Fehlerbehebung auf der Detailseite

Fahrzeug zeigt "Offline"

1. Letztes Signal-Zeitstempel prüfen
2. Aktuelle Telemetrie auf letzte Nachrichten überprüfen
3. Mobilfunk-Signalstärke-Verlauf prüfen
4. Kann anzeigen:
   • Leerer Akku
   • Schlechte Mobilfunkabdeckung
   • Hardwarefehler

Befehle funktionieren nicht

1. Überprüfen, ob IoT-Gerät verknüpft ist
2. Passwortkonfiguration prüfen
3. Telemetrie auf Fehlerantworten überprüfen
4. Zuerst STATUS-Befehl versuchen
5. Unterkonto-IoT-Passwörter prüfen

Akkuanzeige falsch

1. Fahrzeug-Akku mit IoT-Akku vergleichen
2. Prüfen, ob Ladeanzeige der Realität entspricht
3. Telemetrie auf Roh-Akkuwerte überprüfen
4. Gerätekalibrierung kann erforderlich sein

Standort aktualisiert nicht

1. GPS-Signalstatus prüfen
2. last_location_update-Zeitstempel überprüfen
3. Fahrzeug kann sich in Gebäuden/unterirdisch befinden
4. IoT-Gerät-GPS muss möglicherweise repariert werden

---

Best Practices

1. Status vor dem Senden von Befehlen prüfen: Redundantes Sperren/Entsperren vermeiden
2. Signalton zur Verifizierung verwenden: Vor der Arbeit an einem Fahrzeug den Ton abspielen, um die Identität zu bestätigen
3. Telemetrie nach Befehlen überprüfen: Überprüfen, ob das Gerät bestätigt hat
4. Probleme dokumentieren: Notizen oder Aufgaben für anhaltende Probleme verwenden
5. Fotos regelmäßig prüfen: Parkkonformitätsprobleme frühzeitig erkennen

---

Berechtigungen

Der Zugriff auf die Fahrzeugdetailseite variiert je nach Rolle: