Diego Viscarra
←Volver a proyectos
Fleet Management / Gatehouse PWA / Multi-Tenant RLS

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
4 Países
Operación multi-tenant

Aislamiento estricto forzado en el motor de base de datos mediante RLS

Cero ORM
Consultas parametrizadas

Driver crudo mssql con transacciones atómicas por request vía AsyncLocalStorage

Anti-Fraude
Odómetro validado

Detección de inconsistencias de kilometraje con justificación obligatoria

Alto Contraste
Kiosco para vigilantes

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.

  1. 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.

  2. 02

    Fraude de odómetro y combustible

    Lecturas manuales erróneas o alteradas intencionalmente para desviar vales de combustible.

  3. 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.

  4. 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-Stream

En 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 Seguridad

La 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