Skip to content

NexLogix/NexLogix_Software

Repository files navigation

NexLogix Logo

Typing SVG

Status Version License

Sistema Integral de Gestión Logística

Optimizando operaciones de transporte y distribución con tecnología de vanguardia


Stack Tecnológico

Backend Development

Laravel PHP JWT Swagger

Frontend Development

React TypeScript Vite React Router

Database & Storage

MySQL Eloquent

Testing & Quality

PHPUnit ESLint

Descripción del Proyecto

NexLogix es una plataforma empresarial de nueva generación diseñada para revolucionar la gestión logística mediante la automatización inteligente y optimización de procesos de transporte, distribución y seguimiento de envíos en tiempo real.

Desarrollado con arquitectura moderna Full-Stack, combina la robustez de Laravel en el backend con la reactividad de React + TypeScript en el frontend, ofreciendo control total sobre operaciones logísticas complejas con interfaces intuitivas y APIs RESTful escalables.

Características Principales

  • Sistema JWT para autenticación
  • Gestión de flota completa
  • Rutas optimizadas automáticas
  • Seguimiento en tiempo real
  • Reportes avanzados con analytics
  • Auditoría completa del sistema

Módulos del Sistema

Autenticación

Sistema JWT avanzado con roles granulares y middleware de seguridad

Gestión de Flota

Control completo de vehículos, conductores y asignaciones inteligentes

Rutas Optimizadas

Planificación estratégica y distribución geográfica eficiente

Gestión de Envíos

Seguimiento completo desde recogida hasta entrega final


Sistema de Autenticación Enterprise

Características Avanzadas

  • Autenticación JWT con tokens de acceso y refresh automático
  • Control de roles granular: Manager, Empleado, Conductor
  • Permisos específicos por funcionalidad y recurso
  • Middleware personalizado para protección de rutas
  • Sesiones seguras con encriptación de nivel empresarial
  • Logs de acceso y auditoría de seguridad completa

Arquitectura de Seguridad

// Middleware de roles
Route::middleware(['auth:api', 'role:2,3'])
    ->group(function () {
        // Rutas protegidas
    });

// JWT Configuration
'ttl' => env('JWT_TTL', 60),
'refresh_ttl' => env('JWT_REFRESH_TTL', 20160),

Gestión de Flota Inteligente

Administración de Vehículos

  • Registro completo: marca, modelo, placa
  • Control de capacidad y especificaciones
  • Historial de mantenimiento detallado
  • Estados: Disponible, En Ruta, Mantenimiento
  • Monitoreo en tiempo real

Gestión de Conductores

  • Registro de licencias y categorías
  • Validación automática de vigencia
  • Asignación inteligente conductor-vehículo
  • Control de estados y disponibilidad
  • Evaluación de desempeño

Asignaciones Automáticas

  • Algoritmos de optimización
  • Matching por capacidad y tipo
  • Disponibilidad en tiempo real
  • Histórico de asignaciones
  • Reportes de eficiencia

Optimización de Rutas y Distribución

Planificación Estratégica de Rutas

Funcionalidades Avanzadas:

  • Creación dinámica de rutas con algoritmos de optimización
  • Asignación automática de vehículos por capacidad y tipo
  • Control de horarios y tiempos estimados de entrega
  • Distribución geográfica inteligente por ciudades y áreas
  • Optimización de cobertura territorial con análisis de densidad
  • Métricas de eficiencia por zona y conductor
interface Ruta {
  idRuta: number;
  nombreRuta: string;
  horaInicioRuta: string;
  horaFinalizacionRuta: string;
  descripcion: string;
  estadoRuta: 'Activa' | 'Inactiva';
  novedades: string;
  fechaCreacionRuta: Date;
}

Gestión Integral de Envíos

Registro de Envíos

  • Datos completos remitente/destinatario
  • Múltiples métodos de pago
  • Cálculo automático de costos
  • Categorización inteligente

Gestión de Recogidas

  • Programación automática
  • Rutas optimizadas
  • Confirmación en tiempo real
  • Tracking de estado

Control de Entregas

  • Confirmación de entrega
  • Evidencia fotográfica
  • Firmas digitales
  • Notificaciones automáticas

Seguimiento 24/7

  • Estados en tiempo real
  • Historial completo
  • Alertas automáticas
  • Dashboard interactivo

Sistema de Analytics y Reportes

Dashboard Ejecutivo

  • KPIs en tiempo real
  • Métricas de rendimiento
  • Gráficos interactivos
  • Alertas inteligentes

Reportes Categorizados

  • Reportes operacionales
  • Análisis financiero
  • Rendimiento de flota
  • Satisfacción del cliente

Exportación de Datos

  • Formatos múltiples (PDF, Excel, CSV)
  • Reportes programados
  • Distribución automática
  • API de integración

Auditoría y Trazabilidad

Sistema Completo de Auditoría

Características de Auditoría:

  • Registro automático de todas las operaciones del sistema
  • Trazabilidad completa de cambios con timestamps
  • Logs detallados por usuario, IP y acción realizada
  • Integridad de datos con hash de verificación
  • Retención configurable de logs según políticas
  • Alertas de seguridad para actividades sospechosas
class AuditLog extends Model {
    protected $fillable = [
        'user_id', 'action', 'table_name',
        'record_id', 'old_values', 'new_values',
        'ip_address', 'user_agent', 'timestamp'
    ];
    
    protected $casts = [
        'old_values' => 'json',
        'new_values' => 'json'
    ];
}

Arquitectura del Sistema

Stack Tecnológico Detallado

Backend (API REST)

  • Framework: Laravel 10+ con PHP 8.2+
  • Base de datos: MySQL 8.0 con Eloquent ORM
  • Autenticación: JWT con tymon/jwt-auth
  • Documentación: Swagger/OpenAPI 3.0
  • Testing: PHPUnit con cobertura >90%
  • Queue: Redis para trabajos en segundo plano
  • Cache: Redis para optimización de rendimiento

Frontend (SPA)

  • Framework: React 18+ con TypeScript 5+
  • Build tool: Vite 4+ para desarrollo y producción
  • Routing: React Router v6 con lazy loading
  • State: Context API + useReducer patterns
  • Styling: CSS Modules + Responsive Design
  • HTTP Client: Axios con interceptors
  • Testing: Jest + React Testing Library

Roles y Permisos del Sistema

Manager

Control Total del Sistema

  • Dashboard ejecutivo completo
  • Gestión de usuarios y roles
  • Configuración del sistema
  • Reportes estratégicos
  • Auditoría y compliance
  • Administración de flota

Empleado

Operaciones Diarias

  • Gestión de envíos y rutas
  • Consulta de información
  • Reportes operacionales
  • Seguimiento de entregas
  • Coordinación logística
  • Atención al cliente

Conductor

Operaciones de Campo

  • Consulta de rutas asignadas
  • Información de vehículos
  • Estados de entregas
  • Comunicación con central
  • Confirmación de recogidas
  • Reportes de campo

Características Técnicas Avanzadas

Integración Total

API RESTful con endpoints especializados y documentación Swagger completa

Responsive Design

Interfaz adaptativa optimizada para desktop, tablet y móvil

Alto Rendimiento

Lazy loading, caching inteligente y optimización de consultas

Seguridad Enterprise

Encriptación, validación robusta y protección CSRF

Escalabilidad

Arquitectura modular preparada para crecimiento empresarial

Patrones de Desarrollo y Best Practices

Backend Architecture:

// Repository Pattern
interface EnvioRepositoryInterface {
    public function create(array $data): Envio;
    public function findById(int $id): ?Envio;
    public function updateStatus(int $id, string $status): bool;
}

// Service Layer
class EnvioService {
    public function __construct(
        private EnvioRepositoryInterface $repository,
        private NotificationService $notificationService
    ) {}
}

Frontend Architecture:

// Custom Hooks
const useEnvios = () => {
    const [envios, setEnvios] = useState<Envio[]>([]);
    const [loading, setLoading] = useState(false);
    
    const fetchEnvios = useCallback(async () => {
        setLoading(true);
        const data = await envioService.getAll();
        setEnvios(data);
        setLoading(false);
    }, []);
    
    return { envios, loading, fetchEnvios };
};

Información Técnica Adicional

API Endpoints Principales

Módulo Endpoints Autenticación
Autenticación /api/auth/* JWT
Usuarios /api/gestion_usuarios/* JWT + Roles
Vehículos /api/gestion_vehiculos/* JWT + Roles
Rutas /api/gestion_rutas/* JWT + Roles
Envíos /api/gestion_envios/* JWT + Roles
Reportes /api/gestion_reportes/* JWT + Roles
Auditoría /api/gestion_auditorias/* JWT + Admin

Estructura de Base de Datos

Tabla Principal Relaciones Índices
usuarios roles, conductores email, activo
vehiculos conductores, rutas placa, estado
rutas vehiculos, ciudades nombre, estado
envios recogidas, entregas fecha, estado
audit_logs usuarios timestamp, tabla
reportes categorias, users fecha, tipo

Innovación Tecnológica

Desarrollado con tecnología de vanguardia

Solución Empresarial

Diseñado para operaciones de alto volumen

Excelencia Operacional

Optimización continua de procesos logísticos

Sistema integral diseñado para empresas que buscan transformar sus operaciones logísticas

Combinando inteligencia artificial, análisis de datos y experiencia de usuario excepcional

NexLogix Software - Transformando la logística del futuro

About

Proyecto formado por 2 Devs.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •