Platform Features

Viax provides a complete suite of features for users, drivers, administrators, and companies to manage on-demand transportation and delivery services.

User Features

Authentication & Profile Management

Secure Registration

Email-based registration
Phone number verification
6-digit verification codes
Password requirements enforcement

Login & Sessions

Secure email/password login
Session management
Remember me functionality
Password reset via email

Profile Management

Update personal information
Change profile photo
Manage contact details
Optional address information

Email Verification

Automated email sending
6-digit verification codes
Code expiration (10 minutes)
Resend verification option

Trip Booking & Management

Request Trips
Vehicle Selection
Trip Tracking

Interactive Trip Booking

Tap on map to select pickup location
Choose destination with real-time geocoding
View route preview on map
Distance and duration estimates
Real-time fare calculation

Service Types:

🚗 Ride (Personal transportation)
📦 Package Delivery (Courier service)

Choose from multiple vehicle categories:

Vehicle Type	Capacity	Use Case
🏍️ Motorcycle	1-2	Quick rides, small packages
🚗 Car	1-4	Standard rides
🏍️ Cargo Motorcycle	Packages	Medium deliveries
🚙 Cargo Car	Large items	Big deliveries

Pricing adjusts automatically based on vehicle type.

Real-time Monitoring:

Driver search status
Driver location tracking
Estimated arrival time
Route visualization
Trip status updates

Trip States:

pendiente - Waiting for driver
aceptada - Driver assigned
en_curso - Trip in progress
completada - Successfully completed
cancelada - Cancelled by user/driver

Maps & Location Services

GPS Positioning

Automatic location detection using device GPS with high-accuracy mode

Geocoding

Convert coordinates to addresses and vice versa using Nominatim API

Route Calculation

Calculate optimal routes using Mapbox Directions API with traffic data

Interactive Maps

Flutter Map integration with Mapbox tiles for smooth pan and zoom

Traffic Information

Real-time traffic data from TomTom API for accurate ETAs

Payment Management

Payment system is in development. Current implementation includes:

Fare estimation before booking
Distance-based pricing
Vehicle type surcharges
Time-based charges
Commission calculation
Price breakdown display

Driver Features

Registration & Verification

Driver Onboarding

Registration Process:

Complete personal information form
Upload required documents:
- Driver’s license (front/back)
- Vehicle registration
- Insurance documents
- Profile photo
Submit for admin review
Await approval notification

Document Requirements:

Images in JPG/PNG format
Clear, readable scans
Valid expiration dates
Matching personal information

Verification Workflow

Admin Review Process:

Document authenticity check
Background verification
Vehicle inspection status
License validity confirmation

Approval States:

pendiente - Awaiting review
en_revision - Under review
aprobado - Approved for service
rechazado - Rejected with reason

Trip Management

// Driver receives nearby trip requests
{
  "solicitud_id": 123,
  "usuario_nombre": "John Doe",
  "origen": "Calle 123",
  "destino": "Avenida 456",
  "distancia_km": 5.2,
  "duracion_minutos": 15,
  "precio_estimado": 12500,
  "tipo_vehiculo": "carro"
}

Driver Capabilities:

View pending trip requests within 5km radius
Accept or decline trip offers
Navigate to pickup location
Update trip status (en route, arrived, in progress)
Complete trip and confirm payment
View earnings breakdown

Availability Management

Online/Offline
Location Updates

Toggle availability status:

Online (disponibilidad = 1): Receive trip requests
Offline (disponibilidad = 0): No requests received

Automatic status changes:

Goes offline when accepting a trip
Returns online after trip completion

Driver Dashboard

Earnings Overview

Daily/weekly/monthly earnings
Trip count statistics
Average fare per trip
Commission breakdown

Trip History

Complete trip log
Filter by date range
Export trip reports
Rating history

Performance Metrics

Acceptance rate
Cancellation rate
Average rating
Total distance driven

Document Status

License expiration alerts
Insurance renewal reminders
Vehicle inspection status
Document update prompts

Administrator Features

User Management

User Operations:

View all registered users
Search and filter users
View user details and trip history
Suspend/activate user accounts
Handle user disputes
Export user data

Driver Management:

Review driver applications
Approve/reject driver documents
Monitor driver performance
Handle driver complaints
Manage driver ratings
Deactivate problematic drivers

Document Verification

Review Queue

Access pending driver document submissions with priority sorting

Document Inspection

View high-resolution document images with zoom and rotation

Verification Checks

Verify authenticity
Check expiration dates
Match personal information
Validate vehicle details

Approval/Rejection

Approve or reject with detailed feedback for drivers

Dashboard & Analytics

// Real-time dashboard metrics
{
  "active_users": 1523,
  "active_drivers": 342,
  "trips_today": 856,
  "revenue_today": 4250000,
  "avg_trip_duration": 18,
  "avg_fare": 15200,
  "pending_approvals": 23
}

Available Reports:

User growth trends
Driver performance rankings
Revenue by vehicle type
Peak usage hours
Geographic heat maps
Cancellation rate analysis

Configuration Management

Pricing Rules
Service Areas
Notifications

Configure dynamic pricing:

Base fare by vehicle type
Per-kilometer charges
Per-minute charges
Minimum fare amounts
Surge pricing rules
Platform commission rates

Company Features

Fleet Management

Driver Fleet

Assign drivers to company
Monitor driver performance
Manage driver schedules
Track fleet utilization

Vehicle Management

Register company vehicles
Track maintenance schedules
Monitor vehicle status
Assign vehicles to drivers

Performance Tracking

Fleet-wide statistics
Driver comparison reports
Vehicle efficiency metrics
Revenue per driver

Company Settings

Company profile management
Branding customization
Commission agreements
Service area restrictions

Technical Features

Architecture

Clean Architecture Implementation:

Domain layer with business logic
Data layer with repository pattern
Presentation layer with provider state management
Dependency injection via service locator
Modular feature organization

Prepared for Microservices:

Modular backend structure
Service-based endpoints
Centralized API configuration
Independent feature modules

API Integration

// Login endpoint
POST /auth/login.php
{
  "email": "[email protected]",
  "password": "securepass123"
}

Security Features

Security is paramount in a mobility platform handling user data and payments.

Authentication: Email/password with verification
SQL Injection Protection: Prepared statements throughout
XSS Prevention: Input sanitization
CORS Configuration: Controlled API access
Session Management: Secure token handling
Data Encryption: Passwords hashed with bcrypt

Database Schema

Core Tables:

usuarios - User accounts and profiles
conductores - Driver information and status
solicitudes_servicio - Trip requests
viajes - Completed trips
asignaciones_conductor - Driver assignments
documentos_conductor - Driver documents
configuracion_precios - Pricing rules
administradores - Admin accounts
audit_logs - System activity logs
empresas - Company accounts

Development Features

Multi-Environment Support

# Development
flutter run --dart-define=API_BASE_URL=http://10.0.2.2/viax/backend

# Staging
flutter run --dart-define=API_BASE_URL=https://staging.viax.com

# Production
flutter run --dart-define=API_BASE_URL=http://76.13.114.194

Hot Reload & Debugging

Flutter hot reload for instant UI updates
Comprehensive error logging
Network request debugging
State management inspection
Performance profiling tools

Documentation

Architecture Docs

20,000+ words of technical documentation

API Reference

Complete endpoint documentation

Setup Guides

Step-by-step installation guides

Coming Soon

Features currently in development or planned for future releases:

🔔 Push Notifications: Real-time alerts for trip updates
💬 In-App Chat: Communication between users and drivers
⭐ Rating System: Rate and review completed trips
💳 Payment Gateway: Credit card and digital wallet integration
📍 Favorite Locations: Save frequently used addresses
🎁 Promotions: Discount codes and referral system
📊 Advanced Analytics: Business intelligence dashboard
🌐 Multi-Language: Support for multiple languages
🌙 Dark Mode: System-wide theme support
🔐 Two-Factor Auth: Enhanced security with 2FA

Viax is feature-rich and production-ready with continuous improvements based on user feedback and business needs.

Get Started

Core Concepts

Setup & Deployment

​Platform Features

​User Features

​Authentication & Profile Management

Secure Registration

Login & Sessions

Profile Management

Email Verification

​Trip Booking & Management

​Maps & Location Services

​Payment Management

​Driver Features

​Registration & Verification

​Trip Management

​Availability Management

​Driver Dashboard

Earnings Overview

Trip History

Performance Metrics

Document Status

​Administrator Features

​User Management

​Document Verification

​Dashboard & Analytics

​Configuration Management

​Company Features

​Fleet Management

Driver Fleet

Vehicle Management

Performance Tracking

Company Settings

​Technical Features

​Architecture

​API Integration

​Security Features

​Database Schema

​Development Features

​Multi-Environment Support

​Hot Reload & Debugging

​Documentation

Architecture Docs

API Reference

Setup Guides

​Coming Soon

Build docs developers (and LLMs) love

Platform Features

User Features

Authentication & Profile Management

Trip Booking & Management

Maps & Location Services

Payment Management

Driver Features

Registration & Verification

Trip Management

Availability Management

Driver Dashboard

Administrator Features

User Management

Document Verification

Dashboard & Analytics

Configuration Management

Company Features

Fleet Management

Technical Features

Architecture

API Integration

Security Features

Database Schema

Development Features

Multi-Environment Support

Hot Reload & Debugging

Documentation

Coming Soon