QR-Code Upload für Fahrzeugbilder

Das QR-Code Upload-System ist eine innovative Funktion der bidcars.ch Plattform, die es ermöglicht, Fahrzeugbilder direkt vom Smartphone hochzuladen, ohne sich anmelden zu müssen. Diese Anleitung erklärt die Funktionsweise und Verwendung des Systems im Detail.

Übersicht

Das QR-Code Upload-System wurde entwickelt, um den Prozess der Bilderfassung für Fahrzeuge zu vereinfachen:

• Mobiloptimiert: Direkter Zugriff auf die Smartphone-Kamera
• Anmeldefrei: Keine Anmeldung auf dem mobilen Gerät erforderlich
• Sicher: Zeitlich begrenzte, fahrzeugspezifische Tokens
• Effizient: Mehrere Bilder gleichzeitig aufnehmen und hochladen

Ideal für Situationen, in denen Sie ein Fahrzeug vor Ort fotografieren möchten, ohne komplizierte Übertragungsprozesse zwischen Kamera und Computer.

Wo finden Sie die QR-Code Funktion?

Die QR-Code Funktion ist an zwei Stellen verfügbar:

1. Benutzer-Fahrzeugverwaltung:

   • Gehen Sie zu /home/[account]/vehicles/[id]
   • Wechseln Sie zum Tab "Bilder"
   • Scrollen Sie zum Abschnitt "Mobile Upload"

2. Admin-Fahrzeugverwaltung:

   • Gehen Sie zu /admin/vehicles/[id]
   • Wechseln Sie zum Tab "Bilder"
   • Scrollen Sie zum Abschnitt "Mobile Upload"

Schritt-für-Schritt Anleitung

1. QR-Code generieren

1. Navigieren Sie zur Bilderverwaltung eines Fahrzeugs
2. Scrollen Sie zum Abschnitt "Mobile Upload"
3. Klicken Sie auf die Schaltfläche "QR-Code generieren"
4. Das System generiert einen einmaligen Zugangstoken und zeigt den QR-Code an
5. Der QR-Code enthält eine URL mit eingebettetem Token (Beispiel: https://bidcars.ch/upload/1234abcd?token=timestamp.vehicleId.randomString)

2. QR-Code scannen

1. Verwenden Sie die Kamera-App Ihres Smartphones, um den QR-Code zu scannen
2. Ihr Smartphone öffnet automatisch den Browser mit der Upload-Seite
3. Die Seite prüft die Gültigkeit des Tokens
4. Bei erfolgreicher Validierung wird die mobile Upload-Oberfläche angezeigt

3. Bilder aufnehmen oder auswählen

Die mobile Upload-Seite bietet zwei Optionen:

Option 1: Kamera verwenden

1. Tippen Sie auf die Schaltfläche "Kamera öffnen"
2. Nehmen Sie ein Foto des Fahrzeugs auf
3. Bestätigen Sie die Auswahl oder nehmen Sie ein neues Foto auf
4. Das Foto wird zur Upload-Liste hinzugefügt

Option 2: Galerie verwenden

1. Tippen Sie auf die Schaltfläche "Aus Galerie auswählen"
2. Wählen Sie ein oder mehrere vorhandene Bilder aus
3. Bestätigen Sie Ihre Auswahl
4. Die Bilder werden zur Upload-Liste hinzugefügt

Sie können beliebig viele Bilder zur Upload-Liste hinzufügen, bevor Sie mit dem Upload fortfahren.

4. Bilder hochladen

1. Überprüfen Sie die Vorschaubilder in der Upload-Liste
2. Entfernen Sie unerwünschte Bilder durch Tippen auf das "X"-Symbol
3. Tippen Sie auf die Schaltfläche "Alle hochladen"
4. Der Upload-Prozess beginnt mit Fortschrittsanzeige für jedes Bild
5. Nach erfolgreichem Upload werden die Bilder mit grünem Häkchen markiert

5. Zurück zur Fahrzeugverwaltung

1. Nach Abschluss des Uploads können Sie zur Fahrzeugverwaltung zurückkehren
2. Die hochgeladenen Bilder erscheinen automatisch in der Bildergalerie des Fahrzeugs
3. Sie können die Bilder nun wie gewohnt verwalten (Hauptbild festlegen, Reihenfolge ändern)

Technische Details

Token-System

Das QR-Code System verwendet ein sicheres Token-System:

• Format: timestamp.vehicleId.randomString
• Gültigkeitsdauer: 1 Stunde ab Generierung
• Fahrzeugbindung: Der Token ist an ein spezifisches Fahrzeug gebunden
• Einmalverwendung: Für jede Upload-Session sollte ein neuer Token generiert werden

Sicherheitsmerkmale

• Zeitliche Begrenzung: Tokens laufen nach 1 Stunde automatisch ab
• Fahrzeugspezifisch: Ein Token funktioniert nur für das Fahrzeug, für das er generiert wurde
• Server-Validierung: Zusätzliche Sicherheitsschicht durch Server-seitige Validierung
• Berechtigungsprüfung: Nur Benutzer mit entsprechenden Berechtigungen können Tokens generieren

Bildverarbeitung

Hochgeladene Bilder werden automatisch verarbeitet:

1. Komprimierung: Optimierung der Dateigröße ohne sichtbaren Qualitätsverlust
2. Formatkonvertierung: Erstellung von AVIF-, WebP- und JPEG-Versionen
3. Größenanpassung: Generierung von Thumbnail (300px) und Vollbild (1200px)
4. Speicherung: Alle Varianten werden in Supabase Storage gespeichert
5. Datenbankeintrag: Verknüpfung mit dem Fahrzeug in der vehicle_images-Tabelle

Tipps und Best Practices

• Gute Beleuchtung: Achten Sie auf ausreichend Licht, um qualitativ hochwertige Fotos zu erhalten
• Verschiedene Blickwinkel: Nehmen Sie Bilder aus verschiedenen Perspektiven auf (Front, Heck, Seiten, Innenraum)
• Detailaufnahmen: Dokumentieren Sie besondere Merkmale oder Zustände
• Mehrere Bilder: Laden Sie mindestens 5-10 Bilder pro Fahrzeug hoch
• Stabile Haltung: Vermeiden Sie verwackelte Aufnahmen durch eine stabile Haltung
• Netzwerkverbindung: Stellen Sie eine stabile WLAN-Verbindung sicher für schnellere Uploads

Fehlerbehebung

QR-Code kann nicht gescannt werden

• Stellen Sie sicher, dass der QR-Code vollständig und deutlich sichtbar ist
• Erhöhen Sie die Bildschirmhelligkeit, um den Kontrast zu verbessern
• Versuchen Sie, den Code aus einem anderen Winkel zu scannen

"Token ungültig" Fehlermeldung

• Der Token ist möglicherweise abgelaufen (älter als 1 Stunde)
• Generieren Sie einen neuen QR-Code und versuchen Sie es erneut

Bilder werden nicht hochgeladen

• Überprüfen Sie Ihre Internetverbindung
• Stellen Sie sicher, dass die Bildgröße unter 10MB liegt
• Unterstützte Formate: JPG, PNG, HEIC

Upload-Seite lädt nicht

• Stellen Sie sicher, dass Sie die neueste Version Ihres mobilen Browsers verwenden
• Deaktivieren Sie Browser-Erweiterungen, die den Zugriff blockieren könnten
• Überprüfen Sie, ob JavaScript aktiviert ist

Zusammenfassung

Das QR-Code Upload-System bietet eine einfache und effiziente Möglichkeit, Fahrzeugbilder direkt vom Smartphone hochzuladen, ohne sich anmelden zu müssen. Mit dieser Funktion können Sie:

• Zeit sparen durch direkte Aufnahme und Upload
• Die Bildqualität durch Verwendung moderner Smartphone-Kameras verbessern
• Den Workflow für die Dokumentation von Fahrzeugen optimieren
• Mehrere Bilder gleichzeitig verwalten

Durch die Kombination von Benutzerfreundlichkeit und Sicherheit ist das QR-Code Upload-System ein wertvolles Werkzeug für alle, die regelmäßig Fahrzeugbilder auf die bidcars.ch Plattform hochladen.