Gruppenfahrten einrichten

Gruppenfahrten ermoglichen es einem einzelnen Kunden, mehrere Fahrzeuge zum Fahren mit Freunden, Familie oder Gruppen zu entsperren. Das Guthaben oder Paket des Hauptfahrers deckt alle Fahrzeuge ab, was die Organisation von Gruppenausflug einfach macht.

Ubersicht

Wenn Gruppenfahrten aktiviert sind, konnen Kunden uber ihr eigenes hinaus weitere Fahrzeuge entsperren. Alle Fahrten der Gruppe sind mit der Hauptfahrt fur Abrechnung und Verfolgung verknupft. Dies ist ideal fur Touristen, Familien oder jedes Szenario, bei dem mehrere Personen zusammen fahren mochten.

Hauptfunktionen

• Mehrfachfahrzeug-Sitzungen - Ein Kunde, mehrere Fahrzeuge
• Gemeinsame Abrechnung - Hauptfahrer zahlt fur alle Gruppenmitglieder
• Paket-Integration - Fahrtpakete konnen Gruppengrossen-Limits setzen
• Konfigurierbare Limits - Maximale Gruppengrosse pro Standort setzen
• Echtzeit-Verfolgung - Alle Gruppenfahrten mit Hauptfahrt verknupft

Wie es funktioniert

Kunde entsperrt erstes Fahrzeug (Hauptfahrt)
         ↓
Kunde tippt auf "Fahrer hinzufugen" oder scannt weiteres Fahrzeug
         ↓
System pruft Gruppenlimit (Paket oder Einstellungen)
         ↓
Innerhalb Limit?
    ├── Ja → Untergeordnete Fahrt erstellen, mit Hauptfahrt verknupft
    │         Kunde entsperrt zusatzliches Fahrzeug
    │         Abrechnung an Hauptfahrt gebunden
    └── Nein  → Anzeige "Gruppenlimit erreicht"
             Kunde kann keine weiteren Fahrer hinzufugen

Gruppenfahrten aktivieren

Unterkontoeinstellungen

Konfigurationsoptionen

Paketbasierte Gruppenlimits

Fahrtpakete konnen das Unterkonto-Gruppenlimit mit ihrer eigenen max_riders-Einstellung uberschreiben. Dies ermoglicht es Premium-Paketen, grossere Gruppengrossen anzubieten.

Prioritatsreihenfolge

1. Aktives Paket - Wenn Kunde Paket mit max_riders > 1 hat, Paketlimit verwenden
2. Unterkontoeinstellungen - Zuruckfallen auf other.group_rides_max
3. Standard - DEFAULT_GROUP_RIDE_LIMIT (4) verwenden

Beispiel-Paketkonfiguration

Wenn ein Kunde mit "Gruppen-Tour" ein Fahrzeug entsperrt, kann er bis zu 7 zusatzliche Fahrer hinzufugen (8 insgesamt), unabhangig vom Standard-Limit des Unterkontos.

Fahrtstruktur

Haupt- und untergeordnete Fahrten

Gruppenfahrten verwenden eine Eltern-Kind-Beziehung:

Hauptfahrt (Fahrzeug des Kunden)
    │
    ├── Untergeordnete Fahrt 1 (Fahrzeug des Freundes)
    ├── Untergeordnete Fahrt 2 (Fahrzeug des Familienmitglieds)
    └── Untergeordnete Fahrt 3 (Fahrzeug eines anderen Freundes)

Hauptfahrt:

• Zuerst erstellt, wenn Kunde entsperrt
• is_group_ride_parent = true
• Alle Abrechnungen an Hauptfahrt belastet

Untergeordnete Fahrten:

• Erstellt, wenn zusatzliche Fahrzeuge entsperrt werden
• parent_ride_id referenziert die Hauptfahrt
• Abrechnung rollt zur Hauptfahrt auf

Datenbankfelder

Fahrtentabelle:

Kundenerfahrung

Eine Gruppenfahrt starten

1. Erstes Fahrzeug - Kunde scannt/entsperrt sein Fahrzeug normal
2. Fahrer hinzufugen - Auf "Fahrer hinzufugen" tippen oder zusatzliche Fahrzeuge scannen
3. Bestatigen - Jedes zusatzliche Fahrzeug wird als mit Gruppe verknupft angezeigt
4. Zusammen fahren - Alle Fahrzeuge aktiv unter einer Sitzung

Wahrend der Fahrt

• Alle Gruppenmitglieder fahren unabhangig
• Hauptfahrer kann alle aktiven Fahrten sehen
• Pausieren/Fortsetzen betrifft einzelne Fahrzeuge
• Hauptfahrer kann alle Fahrten auf einmal beenden

Gruppenfahrten beenden

Wenn die Hauptfahrt endet:

1. Alle aktiven untergeordneten Fahrten werden zum Beenden aufgefordert
2. Gesamtabrechnung uber alle Fahrten berechnet
3. Einzelne Belastung auf Guthaben/Karte des Hauptfahrers
4. Quittung zeigt Aufschlusselung nach Fahrzeug

Abrechnungsuberlegungen

Wie Gebuhren funktionieren

Alle Gruppenfahrt-Kosten werden dem Hauptfahrer belastet:

Hauptfahrt: 30 Min. × 0,25 € = 7,50 €
Untergeordnete Fahrt 1: 28 Min. × 0,25 € = 7,00 €
Untergeordnete Fahrt 2: 32 Min. × 0,25 € = 8,00 €
Untergeordnete Fahrt 3: 25 Min. × 0,25 € = 6,25 €
───────────────────────────────
Gesamt: 28,75 € dem Hauptfahrer belastet

Paketverbrauch

Bei Verwendung eines Fahrtpakets:

• Zeit wird proportional abgezogen
• Alle Fahrer teilen die Paketvorteile
• Paket max_riders bestimmt Gruppengrosse
• Uberschreitende Zeit wird zu Standardtarifen abgerechnet

Entsperrgebuhren

API-Referenz

Effektives Gruppenlimit abrufen

import { getEffectiveGroupRideLimit } from '@/lib/rides/group-session'

const result = await getEffectiveGroupRideLimit(admin, customerUuid, subaccountId)
// Gibt zuruck: { limit: number, source: 'package' | 'settings' | 'default', packageInfo? }

Aktive Gruppen-Untergeordnete zahlen

import { countActiveGroupChildren } from '@/lib/rides/group-session'

const childCount = await countActiveGroupChildren(admin, parentRideId)
// Gibt zuruck: Anzahl aktiver untergeordneter Fahrten

Fahrtinhaber prufen

import { rideBelongsToCustomer } from '@/lib/rides/group-session'

const isOwner = rideBelongsToCustomer(ride, customer, userId)
// Gibt zuruck: boolean

Best Practices

Gruppenlimits setzen

1. Fahrzeugverfugbarkeit berucksichtigen - Grossere Limits konnen Flotte erschopfen
2. Zielgruppe anpassen - Touristen benotigen moglicherweise grossere Gruppen
3. Paketwert ausbalancieren - Premium-Pakete konnen grossere Gruppen anbieten
4. Sicherheitsuberlegungen - Grosse Gruppen benotigen moglicherweise Koordination

Betriebliche Uberlegungen

1. Personalbewusstsein - Personal fur Gruppenfahrt-Support schulen
2. Fahrzeugnahe - Gruppen parken moglicherweise zusammen
3. Kundenkommunikation - Klare Anweisungen fur Gruppenstart
4. Ende-der-Fahrt-Behandlung - Gruppen beim Beenden aller Fahrten helfen

Paketdesign

1. Gruppenpakete erstellen - Dedizierte Pakete fur Gruppen
2. Angemessen bepreisen - Gruppenrabatte fordern Nutzung
3. Klares Marketing - max_riders in Paketbeschreibung hervorheben
4. Zeitallokation - Langere Dauern fur Gruppen erwagen

Fehlerbehebung

Kann keine weiteren Fahrer hinzufugen

1. Limit erreicht prufen - Aktive untergeordnete Fahrten zahlen
2. Paket verifizieren - Unterstutzt Paket mehr Fahrer?
3. Einstellungen prufen - Unterkonto group_rides_max Einstellung
4. Aktive Hauptfahrt - Hauptfahrt muss noch aktiv sein

Abrechnungsprobleme

1. Hauptfahrt verifizieren - Alle Gebuhren gehen an Hauptfahrt
2. Verknupfung der Untergeordneten prufen - parent_ride_id sollte gesetzt sein
3. Paket uberprufen - Paketvorteile konnen unterschiedlich gelten

Untergeordnete Fahrt nicht verknupft

1. Fahrterstellung prufen - Wurde parent_ride_id gesetzt?
2. Kundenubereinstimmung verifizieren - Gleicher Kunde fur alle Fahrten
3. Entsperrablauf uberprufen - Wurde Gruppenfahrt-Option ausgewahlt?

Datenbankschema

Schlusselabfragen

Hauptfahrt finden:

SELECT * FROM rides
WHERE customer_uuid = 'uuid'
  AND ride_status IN ('active', 'paused')
  AND is_group_ride_parent = true

Gruppengrosse zahlen:

SELECT COUNT(*) FROM rides
WHERE parent_ride_id = 'parent-uuid'
  AND ride_status IN ('active', 'paused')

Gruppengesamt abrufen:

SELECT SUM(total_cost) as group_total
FROM rides
WHERE parent_ride_id = 'parent-uuid'
   OR id = 'parent-uuid'