Cargo Electric
Una sola plataforma para la operación, la analítica, las finanzas y la gestión de personas de una startup de logística eléctrica, con más de 10.000 rutas registradas que antes vivían en planillas. La usan su equipo interno y los ejecutivos de sus clientes. Fui Product Owner y Full-Stack Engineer: definí el producto, diseñé la arquitectura y escribí 619 de los 632 commits de la web app.
- Rol
- Product Owner · Full-Stack Engineer
- Alcance
- Producto, arquitectura y entrega
- Periodo
- Sep 2025 – hoy
- Stack
- Next 16 · Firebase · Recharts
- 10.000+
- rutas operacionales registradas
- 14
- camiones eléctricos
- 5
- módulos en producción
- 8
- meses de web app
El problema que resolvemos
Cargo Electric opera una flota de camiones eléctricos de reparto urbano, y lo gestionaba todo con Google Sheets dispersos, sin visibilidad en tiempo real y con facturación calculada a mano cada período.
- 01Sheets sin conexión entre sí: datos duplicados y desincronizados
- 02Sin visibilidad del estado de la flota en tiempo real
- 03Facturación manual propensa a errores por período
- 04Imposible escalar sin multiplicar la carga operativa
- Múltiples Google Sheets sin conexión entre sí
- Actualización manual, propensa a errores y duplicados
- Sin visibilidad en tiempo real del estado de la flota
- Facturación calculada a mano por período
- Imposible escalar sin multiplicar la carga operativa
- Una sola plataforma para operación, analítica, finanzas y gestión de personas
- Datos en tiempo real desde Firestore
- Analítica operacional con KPIs y tendencias históricas
- Facturación y bonos de conductores calculados con tarifarios vigentes
- Equipo interno (administración y directorio) y ejecutivos de clientes en la misma app, con acceso por rol
La app hoy
Los módulos que cubren el ciclo completo: desde el registro del movimiento diario hasta la analítica y la facturación. El quinto, el motor de bonos de conductores, está en la historia del desarrollo.
Resumen Diario: operación completa en tiempo real
Consolida toda la actividad mensual de la flota conectado directamente a Firestore. Muestra en tiempo real el estado de cada camión, las rutas del día y los KPIs del período.
- 5 vistas: General, Día, Flota (heatmap), Camión y Semana
- KPIs mensuales: monto total, presupuesto, desviación y rutas
- Gráfico de tendencia diaria vs presupuesto configurable
- Selector de período histórico sin recargar la página
Dashboard Operacional: tiempos y cuellos de botella
Panel de métricas con filtros por período, camión y conductor. Identifica automáticamente el segmento operativo de mayor impacto y entrega una recomendación.
- 6 KPIs: rutas, destinos, ciclo promedio, km, CO₂ y costo/km
- Gráfico de barras por segmento operativo con comparativa UULL
- Drill-down por waypoint al hacer clic en cualquier segmento
- Exportación a PDF ejecutivo con gráfico y drill-down incluidos
Gestión de Rutas: registro del movimiento diario
Tabla completa con todas las columnas operativas: guía, estado, turno, tipo de carga, origen, destino, conductor, camión, hora y tarifa.
- Creación, edición inline y eliminación con confirmación
- Cambio de estado y turno directamente desde la tabla
- Filtros por rango de fechas y columnas configurables
- Formato es-CL en montos, fechas y exportaciones
Facturación: del registro de ruta al Excel del cliente
Toma las rutas completadas desde Firestore, las agrupa por camión y calcula montos según el tarifario vigente del cliente para el período.
- Agrupación automática por camión con IVA 19% calculado
- Tarifarios con fecha de vigencia, editables desde la app
- Excel fiel al formato de referencia del cliente con fórmulas incluidas
- Sin estados intermedios: lo que se descarga refleja las rutas registradas
Gestión de la flota y los actores
Páginas dedicadas para crear y editar cada entidad del sistema. Los cambios de estado se propagan en tiempo real a los módulos de operación y analítica.
Puntos de destino
Puntos de destino con código, nombre y estado. Un local inactivo desaparece de la asignación de rutas sin perder historial.
Hitos del desarrollo
Desde el primer commit hasta el estado actual, cada fase incorporó nuevas capacidades sobre una base sólida y real.
- 14 Enero 2026
Dashboard de Analítica
Primer dashboard analytics con KPIs, gráficos Recharts y drill-down por camión, junto con el rebrand inicial a la identidad de Cargo Electric.
- 23 Enero – 4 Febrero 2026
Sistema de Facturación / Proformas
Primer módulo de billing: cálculo de proformas con el modelo de precios del cliente, filtros por fecha y exportación a Excel.
- Marzo 2026
Refinamiento de Rutas y exportación a Excel
Ordenamiento multinivel, formato de montos, actualización de tarifas 2026, exportación de proformas a Excel y segunda versión del heatmap de operación por camión.
- 13–20 Marzo 2026
Administración: Locales, Camiones y Usuarios
Páginas CRUD dedicadas para gestionar los puntos de destino, la flota de 14 camiones y los conductores/administradores del sistema.
- 16 Abril 2026
Resumen Diario dinámico
Nueva vista de Resumen Diario con matriz camiones × días, vista móvil dedicada y chart de desviación vs presupuesto configurable por período.
- 21–29 Abril 2026
Identidad de marca, uplift visual y seguridad
Implementación de la identidad visual de Cargo Electric en toda la app, rediseño de navegación, y parches de seguridad CRITICAL/HIGH sobre producción.
- 13 Mayo 2026
Diseño del modelo operacional
Diseño del siguiente modelo de datos operacional (journeys), documentado como schema para una etapa posterior, y corrección de la búsqueda histórica.
- 24 Julio – Agosto 2026
Motor de bonos de conductores
Reemplazo del Excel de nómina: cálculo por camión-día, tarifario con vigencia, tripulación manual, exportación a Excel y un snapshot que consume la app móvil. Reconciliado mes a mes contra la planilla real.
- Agosto 2026
Seguridad por roles y limpieza de deuda
Autorización con acceso denegado por defecto en todas las Server Actions y matriz de roles centralizada (admin, board, client). Retiro del kit de migración y del ciclo de proformas que el producto no usaba, ESLint de 87 errores a 0 y telemetría con Vercel Analytics.
Stack y arquitectura
Stack técnico en producción: capas de usuario, aplicación Next.js con App Router, base de datos Firestore en tiempo real y exportaciones generadas en el cliente.
Frontend
Next.js 16
App Router
React 19
Server + Client
TypeScript
strict mode
shadcn/ui + Tailwind v4
Módulos de la app
Analítica
KPIs · heatmap · tendencias
Rutas
CRUD · filtros · estados
Facturación
Tarifarios · Excel
Bonos
Conductores · conciliación
Administración
Flota · locales · usuarios
Backend & datos
Firebase Auth
roles admin · board · client
Firestore
base de datos en tiempo real
Vercel
deploy + hosting
Exportaciones
ExcelJS
facturación y bonos
jsPDF
reportes ejecutivos
Recharts
gráficos interactivos
Diseñé y construí esta plataforma de principio a fin: arquitectura, base de datos, interfaz y lógica de negocio.