Earnings Tracking

The Rodando Driver app provides comprehensive earnings tracking with real-time updates, prepaid plan management, and wallet balance monitoring. Drivers can view their daily, monthly, and yearly earnings along with detailed transaction history.

Earnings Overview

The earnings dashboard displays aggregated earnings data across multiple time periods:

<div class="earnings-grid">
  <div class="earn-item">
    <div class="earn-label">Ganancias totales</div>
    <div class="earn-value">$710,015</div>
    <ion-badge color="dark">DÍA</ion-badge>
  </div>
  <div class="earn-item">
    <div class="earn-label">Ganancia en el año</div>
    <div class="earn-value">$19,350</div>
    <div class="period-tabs">
      <ion-chip class="is-active">MES</ion-chip>
      <ion-chip>AÑO</ion-chip>
    </div>
  </div>
</div>

Key Metrics:

Total Earnings

Cumulative earnings for the selected period (day, month, or year).

Period Tabs

Switch between daily, monthly, and yearly views for earnings analysis.

Visual Charts

SVG-based charts show earnings trends over time for quick insights.

Real-Time Updates

Earnings update automatically as trips are completed.

Trip Fare Calculation

Trip fares are calculated based on multiple factors including distance, duration, and waiting time:

Base Fare Components

interface FareSnapshotDto {
  currency: string;              // Currency code (e.g., "CUP")
  surgeMultiplier?: number | null;  // Dynamic pricing multiplier
  breakdown?: any;               // Detailed fare breakdown
  distanceKmEst?: number | null; // Estimated distance in km
  durationMinEst?: number | null; // Estimated duration in minutes
  estimatedTotal?: number | null; // Base fare estimate
}

Calculation Logic:

// Extract base fare from trip data
const baseFare =
  typeof t.fareEstimatedTotal === 'number'
    ? t.fareEstimatedTotal
    : typeof t.fareFinalTotal === 'number'
    ? t.fareFinalTotal
    : null;

const currency =
  t.fareFinalCurrency ??
  t.fareEstimatedCurrency ??
  'CUP';

this.store.setInitialFare(baseFare, currency);

Waiting Fees

The app automatically calculates waiting fees when drivers wait at the pickup location:

Start Waiting Timer

When the driver marks arrival at pickup, the waiting timer begins:

async markArrivedPickup(): Promise<void> {
  const arrivedAt = new Date().toISOString();
  
  this.store.setArrivedPickup(arrivedAt);
  this.store.setPhase('arriving');
  
  // Start waiting time tracking
  this.store.startWaiting(arrivedAt);
  this.startWaitingTimer();
}

Track Waiting Time

The timer increments every second:

private startWaitingTimer() {
  this.waitingTimerSub = interval(1000).subscribe(() => {
    const s = this.store.state();
    if (!s.activeTripId || s.phase !== 'arriving' || !s.arrivedPickupAt) {
      this.stopWaitingTimer();
      return;
    }

    // Increment waiting seconds
    this.store.tickWaiting(1);
  });
}

Apply Penalty Threshold

After a threshold (5 seconds in demo, configurable in production), a waiting fee is applied:

const s2 = this.store.state();
if (s2.waitingSeconds >= 5 && !s2.waitingPenaltyApplied) {
  const base = s2.baseFare ?? 0;
  const extra = Math.max(1, Math.round(base * 0.05)); // 5% or minimum 1
  const text = `Se aplicó un recargo por espera (${s2.waitingSeconds} s).`;

  this.store.applyWaitingPenalty(extra, text);
  this.store.setWaitingReason('Espera prolongada en el punto de recogida');

  // Show penalty modal
  this.presentWaitingPenaltyModal();
}

Calculate Final Total

The live fare updates to include the waiting fee:

applyWaitingPenalty(extra: number, text: string) {
  this._s.update(s => {
    const base = s.baseFare ?? 0;
    const live = base + (extra || 0);
    return {
      ...s,
      liveFare: live,
      waitingExtraFare: extra,
      waitingPenaltyApplied: true,
      waitingPenaltyText: text,
    };
  });
}

Waiting Fee Formula:

const waitingFee = Math.max(1, Math.round(baseFare * 0.05));
const finalTotal = baseFare + waitingFee;

Configurable Threshold: The 5-second threshold and 5% fee are demo values. Production settings can be configured based on market conditions and regulatory requirements.

Final Fare Breakdown

When completing a trip, the driver sees a detailed fare breakdown:

// Calculate amounts for confirmation modal
const base =
  s.baseFare ??
  trip?.fareEstimatedTotal ??
  trip?.fareFinalTotal ??
  null;

const extra = s.waitingExtraFare ?? 0;

const finalTotal =
  trip?.fareFinalTotal ??
  s.liveFare ??
  (base != null ? base + extra : null);

const cur =
  s.baseCurrency ??
  trip?.fareFinalCurrency ??
  trip?.fareEstimatedCurrency ??
  'CUP';

Completion Payload:

interface CompleteTripPayload {
  driverId: string;
  extraFees?: number | null;           // Waiting fees
  waitingTimeMinutes?: number | null;  // Total waiting time
  waitingReason?: string | null;       // Reason for charge
  actualDistanceKm?: number | null;    // Actual distance traveled
  actualDurationMin?: number | null;   // Actual trip duration
}

// Convert seconds to minutes (minimum 1 minute)
const waitingSeconds = s.waitingSeconds ?? 0;
const waitingMinutes =
  waitingSeconds > 0 ? Math.max(1, Math.round(waitingSeconds / 60)) : null;

const payload: CompleteTripPayload = {
  driverId,
  extraFees: extra || null,
  waitingTimeMinutes: waitingMinutes,
  waitingReason: s.waitingReason ?? 'Recargo por espera en el punto de recogida',
};

Prepaid Plan Management

Drivers operate on a prepaid plan system where they pay a per-trip fee:

<div class="plan-box">
  <div class="plan-head">
    <ion-badge color="success">Activo</ion-badge>
    <span class="plan-name">Plan Pro</span>
  </div>
  <div class="plan-body">
    <div class="row">
      <span class="muted">Costo por viaje</span>
      <strong>$0.75</strong>
    </div>
    <div class="row">
      <span class="muted">Vence en</span>
      <strong>3 días</strong>
    </div>
    <ion-progress-bar value="0.75"></ion-progress-bar>
    <ion-note class="muted">75% del periodo restante</ion-note>
  </div>
  <div class="plan-actions">
    <ion-button size="small" shape="round">Recargar plan</ion-button>
    <ion-button size="small" fill="outline" shape="round">Ver planes</ion-button>
  </div>
</div>

Plan Features:

Plan Status
Pricing Model
Plan Actions

Active/Inactive Badge: Visual indicator of plan status
Plan Name: Tier level (Basic, Pro, Premium)
Expiration Countdown: Days remaining on current plan
Progress Bar: Visual representation of time remaining

Wallet Balance

The wallet system manages the driver’s available balance for trip fees:

<div class="wallet-box">
  <div class="wallet-head">
    <span class="muted">Saldo disponible</span>
    <h2 class="wallet-balance">$ 12.40</h2>
    <ion-badge color="warning">Autonomía: 2 viajes</ion-badge>
  </div>
  <div class="wallet-movements">
    <ion-list lines="none">
      <ion-item>
        <ion-icon name="arrow-down-circle-outline" slot="start"></ion-icon>
        <ion-label>
          <h3>Recarga efectiva</h3>
          <p class="muted">hoy · 10:24</p>
        </ion-label>
        <ion-note slot="end" color="success">+ $5.00</ion-note>
      </ion-item>
      <ion-item>
        <ion-icon name="car-outline" slot="start"></ion-icon>
        <ion-label>
          <h3>Viaje #8472</h3>
          <p class="muted">ayer · 19:05</p>
        </ion-label>
        <ion-note slot="end" color="medium">- $2.50</ion-note>
      </ion-item>
    </ion-list>
  </div>
</div>

Wallet Features:

Available Balance

Current funds available to pay for trip fees.

Trip Autonomy

Estimated number of trips driver can complete with current balance.

Transaction History

Detailed log of all deposits and trip deductions.

Low Balance Alerts

Warnings when balance is insufficient for minimum trips.

Transaction Types

Deposits
Trip Deductions
Refunds

{
  type: 'deposit',
  amount: 5.00,
  method: 'cash' | 'card' | 'bank_transfer',
  timestamp: '2026-03-09T10:24:00Z',
  description: 'Recarga efectiva'
}

Deposit Methods:

Cash at authorized locations
Debit/credit card
Bank transfer
Digital wallet integration

{
  type: 'trip_fee',
  tripId: 'trip_8472',
  amount: -2.50,
  timestamp: '2026-03-08T19:05:00Z',
  description: 'Viaje #8472'
}

Deduction Timing:

Deducted when trip is marked as completed
Based on current plan’s per-trip rate
Includes any applicable taxes or fees

{
  type: 'refund',
  tripId: 'trip_8455',
  amount: 2.50,
  reason: 'Trip cancelled by passenger',
  timestamp: '2026-03-07T16:30:00Z'
}

Refund Scenarios:

Passenger cancels after driver charged
System error in fee calculation
Promotional credits
Customer service adjustments

Low Balance Warnings

The app proactively warns drivers when balance is running low:

<ion-card class="inline-banner warning" color="warning">
  <ion-card-content>
    <ion-icon name="alert-outline"></ion-icon>
    <span>Tu plan vence pronto. Renueva para no quedarte sin cobertura.</span>
  </ion-card-content>
</ion-card>

Warning Thresholds:

Balance	Trips Remaining	Warning Level	Action
> $10	> 4	None	Normal operation
$5-10	2-4	Info	Suggest recharge
$2.50-5	1-2	Warning	Prompt recharge
< $2.50	0-1	Critical	Block new trips

Earnings History

The earnings chart provides visual insights into earnings trends:

<div class="chart-wrap">
  <svg viewBox="0 0 100 28" preserveAspectRatio="none" class="chart-svg">
    <polyline 
      fill="currentColor" 
      fill-opacity="0.25" 
      stroke="currentColor" 
      stroke-width="1" 
      points="0,20 10,18 20,22 30,14 40,16 50,12 60,18 70,10 80,12 90,8 100,16" 
    />
  </svg>
  <div class="chart-axis">
    <span>2021</span><span>2022</span><span>2023</span><span>2024</span><span>2025</span>
  </div>
</div>

Chart Technology: Uses inline SVG for lightweight, scalable charts without external dependencies. Can be replaced with Chart.js or ApexCharts for more advanced visualizations.

Earnings Component

The earnings component integrates authentication for secure logout:

export default class EarningsComponent implements OnInit {
  private auth = inject(AuthFacade);
  private toast = inject(ToastController);

  private getSessionType(): 'web' | 'mobile' {
    try {
      const v = localStorage.getItem('auth.sessionType')?.trim().toLowerCase();
      return (v === 'mobile') ? 'mobile' : 'web';
    } catch { return 'web'; }
  }

  async onLogout() {
    const sessionType = this.getSessionType();
    const obs = sessionType === 'mobile'
      ? this.auth.logoutMobileFlow()
      : this.auth.logoutWebFlow();

    const t = await this.toast.create({ 
      message: 'Cerrando sesión…', 
      duration: 1200, 
      position: 'top' 
    });
    await t.present();

    obs.pipe(take(1)).subscribe({ next: () => {}, error: () => {} });
  }
}

Best Practices

Real-Time Updates

Use WebSocket events to update earnings immediately when trips complete.

Offline Caching

Cache recent transactions locally for offline viewing and faster load times.

Transparent Fees

Show complete fare breakdown including base, waiting fees, and any surcharges.

Balance Monitoring

Proactively notify drivers before balance becomes critically low.

Trip Management - How trips generate earnings
Real-Time Updates - Live earnings notifications
Authentication - Secure access to earnings data

Getting Started

Core Features

User Guides

Configuration

Earnings Overview

Total Earnings

Period Tabs

Visual Charts

Real-Time Updates

Trip Fare Calculation

Base Fare Components

Waiting Fees

Final Fare Breakdown

Prepaid Plan Management

Wallet Balance

Available Balance

Trip Autonomy

Transaction History

Low Balance Alerts

Transaction Types

Low Balance Warnings

Earnings History

Earnings Component

Best Practices

Real-Time Updates

Offline Caching

Transparent Fees

Balance Monitoring

Build docs developers (and LLMs) love

Getting Started

Core Features

User Guides

Configuration

​Earnings Overview

Total Earnings

Period Tabs

Visual Charts

Real-Time Updates

​Trip Fare Calculation

​Base Fare Components

​Waiting Fees

​Final Fare Breakdown

​Prepaid Plan Management

​Wallet Balance

Available Balance

Trip Autonomy

Transaction History

Low Balance Alerts

​Transaction Types

​Low Balance Warnings

​Earnings History

​Earnings Component

​Best Practices

Real-Time Updates

Offline Caching

Transparent Fees

Balance Monitoring

​Related Documentation

Build docs developers (and LLMs) love

Earnings Overview

Trip Fare Calculation

Base Fare Components

Waiting Fees

Final Fare Breakdown

Prepaid Plan Management

Wallet Balance

Transaction Types

Low Balance Warnings

Earnings History

Earnings Component

Best Practices

Related Documentation