Sistema integral de gestión y seguimiento de envíos para operadores logísticos.
Las empresas de logística operan con múltiples sucursales, distintos perfiles de usuarios y decenas (o miles) de envíos moviéndose en simultáneo. Sin una herramienta centralizada, el seguimiento se vuelve caótico: los clientes no saben dónde está su paquete, los supervisores no pueden coordinar acciones ante un problema, y los operadores trabajan a ciegas.
LogiTrack unifica todo en una sola plataforma: desde que se crea un envío hasta que se entrega o devuelve al remitente.
- Visibilidad total de la cadena logística — cada envío tiene un historial completo de eventos, ubicaciones y responsables.
- Control de acceso por rol — cada perfil de usuario ve y puede hacer exactamente lo que le corresponde, sin más ni menos.
- Dashboard gerencial — métricas en tiempo real sobre volumen de envíos, tasas de entrega, envíos problemáticos y rendimiento por sucursal.
- Crear envíos nuevos con datos del remitente, destinatario y ruta.
- Consultar el listado de envíos activos y filtrar por estado.
- Ver el detalle completo y el historial de eventos de cualquier envío.
- Actualizar el estado de los envíos a medida que avanzan por la red (en tránsito, en sucursal, en reparto, entregado…).
- Gestionar situaciones excepcionales: entregas fallidas, devoluciones, retiros en sucursal.
- Validar identidad del destinatario o remitente mediante DNI antes de registrar entregas o devoluciones.
- Vista optimizada para dispositivos móviles con los envíos asignados a su ruta.
- Acceso al detalle de cada envío sin necesidad de navegar por pantallas complejas.
Un envío sigue un ciclo de vida controlado. Cada transición queda registrada con fecha, hora y ubicación:
Borrador (pending)
└─► Confirmado (in_progress) ──────────────────────────────────────► Cancelado ✗
└─► En tránsito (in_transit) ──────────────────────────────► Cancelado ✗
└─► En sucursal (at_branch) ◄──────────────────────► Cancelado ✗
│ ▲
├─► En tránsito (siguiente escala) ─────────┘
├─► En reparto (delivering) ───────────────► Cancelado ✗
│ ├─► Entregado ✓
│ └─► Entrega fallida ──────────────► Cancelado ✗
│ ├─► En reparto (reintento)
│ └─► En sucursal (tramo de vuelta)
├─► Listo para retiro en sucursal (ready_for_pickup) ──► Cancelado ✗
│ ├─► Entregado ✓
│ └─► En tránsito (traslado a otra sucursal)
└─► Listo para devolución (ready_for_return) ──────────► Cancelado ✗
└─► Devuelto ✓
Los envíos con múltiples escalas repiten el tramo en sucursal → en tránsito → en sucursal tantas veces como sea necesario. Entregado, Devuelto y Cancelado son estados terminales — no admiten más transiciones.
Cada envío confirmado recibe un identificador único con formato LT-XXXXXXXX, que puede compartirse con el cliente para el seguimiento público. Los borradores tienen un identificador temporal (DRAFT-XXXXXXXX) que se reemplaza al confirmar el envío.
LogiTrack es una aplicación web full-stack compuesta por dos servicios independientes:
logitrack_core/ → API REST (Go + Gin) puerto 8080
logitrack_web/ → SPA frontend (React + Vite + TypeScript) puerto 5173
Ambos servicios se despliegan de forma independiente. El frontend consume la API a través de HTTP con autenticación por Bearer token.
Requisitos: Node.js 18+ y Go 1.21+
Si no los tenés instalados:
- Node.js → https://nodejs.org (descargá la versión LTS) o con un gestor de versiones:
# macOS/Linux con nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash nvm install --lts
- Go → https://go.dev/dl (descargá el instalador para tu sistema operativo)
# 1. Instalar dependencias (solo la primera vez)
npm install
# 2. Levantar backend y frontend en paralelo
npm run dev- Frontend → http://localhost:5173
- API → http://localhost:8080
Con Ctrl+C se detienen ambos servicios.
Para instrucciones detalladas de cada servicio por separado: