TrustRide Driver Accounts: Trips, Vehicles, and Payouts

# Returns all drivers who have been admin-verified
User.objects.verified_drivers()
# Equivalent to: User.objects.filter(role='driver', is_driver_verified=True)

def clean(self):
    if self.is_driver_verified and not self.is_driver:
        raise ValidationError({
            'is_driver_verified': 'Only drivers can be verified as drivers.'
        })

class Vehicle(UUIDModel, TimeStampedModel):
    driver            = models.ForeignKey(User, limit_choices_to={'role': 'driver'})
    make              = models.CharField(max_length=50)
    model             = models.CharField(max_length=50)
    year              = models.IntegerField()          # 1900 – current year + 1
    color             = models.CharField(max_length=30)
    plate_number      = models.CharField(max_length=20, unique=True)  # e.g., ABC-123DE
    vehicle_type      = models.CharField(choices=['sedan', 'suv', 'minivan', 'bus', ...])
    seating_capacity  = models.IntegerField()
    passenger_capacity = models.IntegerField()         # must not exceed seating_capacity
    car_image         = models.ImageField(upload_to='vehicles/%Y/%m/')
    seat_layout       = models.JSONField(default=dict)
    is_active         = models.BooleanField(default=True)

{
  "front": 2,
  "middle": [3, 3],
  "back": 3
}

draft → published → in_progress → completed
              ↓
           cancelled

# Approval view (simplified)
booking.status = 'confirmed'
booking.confirmed_at = timezone.now()
booking.save()
send_booking_confirmation_email(booking)
Notification.objects.create(user=booking.rider, title='✅ Payment Approved!', ...)

class DriverReport(UUIDModel, TimeStampedModel):
    reporter = models.ForeignKey(User, related_name='reports_submitted')
    driver   = models.ForeignKey(User, related_name='reports_received')
    trip     = models.ForeignKey(Trip, related_name='reports')
    reason   = models.CharField(choices=[
        'inappropriate_behavior', 'safety_concern',
        'trip_cancelled', 'vehicle_issue', 'other'
    ])
    details  = models.TextField()
    status   = models.CharField(choices=['pending', 'reviewed', 'resolved', 'dismissed'])

commission_rate = models.DecimalField(max_digits=5, decimal_places=2, default=0.00)

net_payout = total_confirmed_earnings × (1 - commission_rate / 100)