Admin Panel Overview

​

Introduction

​

Admin Roles

​

Admin Entity Structure

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

​

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

​

System Statistics Entity

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

​

Use Cases

class GetSystemStats {
  final AdminRepository repository;

  GetSystemStats(this.repository);

  Future<Result<SystemStats>> call() async {
    return await repository.getSystemStats();
  }
}

class ApproveDriver {
  final AdminRepository repository;

  ApproveDriver(this.repository);

  Future<Result<void>> call(int conductorId) async {
    if (conductorId <= 0) {
      return Error(ValidationFailure('ID de conductor inválido'));
    }
    return await repository.approveDriver(conductorId);
  }
}

class ManageUserUseCase {
  Future<Result<bool>> updateUser({
    required int adminId,
    required int userId,
    String? nombre,
    String? apellido,
    String? telefono,
    bool? esActivo,
    String? tipoUsuario,
    int? empresaId,
  });
}

​

Next Steps