Vehicle Inspection CM — Control de Flota
Plataforma enterprise para inspección de flota, odómetro antifraude y control en garitas multi-país con SQL Server RLS.
- Rol
- Full Stack Engineer & Database Architect
- Cliente
- Grupo ConstruMarket (Panamá, Guatemala, El Salvador, Nicaragua)
- Periodo
- 2025 — En Producción
- Estado
- Desplegado en producción regional multi-sucursal
Aislamiento estricto forzado en el motor de base de datos mediante RLS
Driver crudo mssql con transacciones atómicas por request vía AsyncLocalStorage
Detección de inconsistencias de kilometraje con justificación obligatoria
UI diseñada para tabletas expuestas a luz solar directa en garitas de acceso
Así se ve
Terminal de Garita / Dashboard de Guardia. Interfaz táctil de alto contraste diseñada para tabletas bajo luz solar directa, selector ágil de placa y flujo de entrada/salida.
Aviso: Los datos, cifras y registros mostrados son ficticios y corresponden a pruebas simuladas (mock data); no pertenecen a la empresa ni exponen información real.
El problema
En una multinacional con cientos de camiones y camionetas operando en 4 países, el control en garitas con bitácoras de papel provocaba pérdidas por daños no reportados, fraude en kilometraje de combustible y herramientas de seguridad extraviadas.
- 01
Colisiones y daños no reportados
Las camionetas volvían con golpes y ningún conductor se hacía responsable, cargando el costo de reparación a la empresa.
- 02
Fraude de odómetro y combustible
Lecturas manuales erróneas o alteradas intencionalmente para desviar vales de combustible.
- 03
Extravío de herramientas de seguridad
Pérdida continua de extintores, conos, gatas y llaves de cruz que no se inspeccionaban con agilidad en el cambio de turno.
- 04
Aislamiento de datos regional
Cada país y sucursal requería operar sus listas de chequeo de manera independiente sin ver datos de otras subsidiarias.
Decisiones de arquitectura
Stream Puro de Eventos de Inspección
Event-StreamEn lugar de sesiones abiertas que quedan abandonadas, cada inspección es un evento atómico inmutable que dispara acciones de mantenimiento.
- Flujo táctil de 30 segundos optimizado para guardias de seguridad.
- Cualquier daño marcado genera instantáneamente un ticket de 'Problema Abierto' para el taller mecánico.
- Auditoría inmutable de quién inspeccionó, fecha exacta y fotos de evidencia.
SQL Server Row-Level Security (RLS) Nativo
Cero ORM & Máxima SeguridadLa seguridad multi-inquilino no se delega a la capa de aplicación, sino que vive en las funciones de predicado de SQL Server.
- Asignación de tenant en cada conexión usando `SESSION_CONTEXT()`.
- Consultas parametrizadas a mano para latencias de milisegundos sin sobrecarga de ORM.
- Políticas de acceso en cascada: Global → País → Sucursal.
Stack
- Backend
- Node.js 20
- Express
- TypeScript 5.4
- Driver crudo mssql (Cero ORM)
- AsyncLocalStorage
- Frontend
- React 18
- Vite
- React Router 7
- Tailwind CSS
- shadcn/ui
- Lucide Icons
- Base de datos
- Microsoft SQL Server
- Row-Level Security (RLS) nativa
- Consultas parametrizadas