> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Braian551/viax/llms.txt
> Use this file to discover all available pages before exploring further.
# Admin Panel Overview
> Introduction to Viax administrative panel capabilities and access control
## Introduction
The Viax Admin Panel provides comprehensive tools for managing and monitoring your ride-sharing platform. Administrators can oversee users, drivers, companies, trips, and configure system-wide settings.
Admin access is role-based. Different admin roles have different permission levels: **Super Admin**, **Admin**, and **Moderator**.
## Admin Roles
Viax supports three distinct admin roles, each with specific permissions:
Full system access with all administrative privileges including user management, system configuration, and financial oversight.
Standard administrative access for day-to-day operations including user management, driver approval, and reporting.
Limited access focused on content moderation and basic user support tasks.
## Admin Entity Structure
The admin entity in Viax follows Clean Architecture principles:
```dart admin/domain/entities/admin.dart theme={null}
class Admin {
final int id;
final String nombre;
final String email;
final AdminRole role;
final bool activo;
const Admin({
required this.id,
required this.nombre,
required this.email,
required this.role,
required this.activo,
});
}
enum AdminRole {
superAdmin('Super Admin'),
admin('Admin'),
moderador('Moderador');
final String displayName;
const AdminRole(this.displayName);
}
```
## Panel Navigation Structure
The admin panel is organized into four main tabs for efficient navigation:
Real-time metrics, KPIs, and recent activity feed
User, driver, and company administration tools
Detailed analytics, charts, and reports
Admin account settings and preferences
## Key Capabilities
### User Management
* View and search all users (clients, drivers, companies)
* Activate/deactivate user accounts
* Edit user profiles and assign companies
* Filter by user type and status
### Driver Verification
* Review driver documents (license, vehicle, insurance)
* Approve or reject driver applications
* Monitor document expiration dates
* Verify SOAT, technomechanical inspection, and insurance
### Company Management
* Create and manage transport companies
* Assign drivers to companies
* Track company performance metrics
* Configure commission rates
### Trip Monitoring
* View all trip requests in real-time
* Monitor active trips
* Access complete trip history
* Handle disputes and issues
### System Configuration
* Configure pricing by vehicle type
* Define service areas
* Manage vehicle categories
* Set surge pricing and promotions
### Audit & Compliance
* Complete audit log of all admin actions
* Track user activity and system events
* Export reports for compliance
* Monitor platform earnings
## Accessing the Admin Panel
Admin credentials are separate from regular user accounts. Contact your system administrator to obtain admin access.
Use your admin email and password to access the system
The admin interface loads automatically after authentication
Use the bottom navigation to switch between Dashboard, Management, Statistics, and Profile
## System Statistics Entity
The admin panel displays real-time system statistics:
```dart admin/domain/entities/admin.dart theme={null}
class SystemStats {
final int totalUsuarios;
final int totalConductores;
final int conductoresPendientes;
final int viajesHoy;
final int viajesTotal;
final double gananciaHoy;
final double gananciaTotal;
const SystemStats({
required this.totalUsuarios,
required this.totalConductores,
required this.conductoresPendientes,
required this.viajesHoy,
required this.viajesTotal,
required this.gananciaHoy,
required this.gananciaTotal,
});
}
```
## Security Features
Permissions enforced at the API level based on admin role
All administrative actions are logged with timestamps and user IDs
Automatic session timeout for security
Admin actions tracked with IP address and user agent
## Use Cases
The admin domain implements key use cases:
```dart admin/domain/usecases/get_system_stats.dart theme={null}
class GetSystemStats {
final AdminRepository repository;
GetSystemStats(this.repository);
Future> call() async {
return await repository.getSystemStats();
}
}
```
```dart admin/domain/usecases/approve_driver.dart theme={null}
class ApproveDriver {
final AdminRepository repository;
ApproveDriver(this.repository);
Future> call(int conductorId) async {
if (conductorId <= 0) {
return Error(ValidationFailure('ID de conductor inválido'));
}
return await repository.approveDriver(conductorId);
}
}
```
```dart admin/domain/usecases/manage_user_usecase.dart theme={null}
class ManageUserUseCase {
Future> updateUser({
required int adminId,
required int userId,
String? nombre,
String? apellido,
String? telefono,
bool? esActivo,
String? tipoUsuario,
int? empresaId,
});
}
```
## Next Steps
Explore real-time metrics and KPIs
Learn how to manage platform users
Review and approve driver applications
Track all system activities