Por Qué la Caseta Nunca Detiene un Camión
Un resultado en ROJO en la caseta no detiene nada — el camión sigue su camino de cualquier forma. Lo que realmente cambia es a quién se le avisa, y si esa unidad aparece en la lista que despacho debe revisar antes del siguiente viaje.
El escaneo no puede decir que no. No existe un botón de rechazo.
Esto no es un ajuste que se desactiva para una flotilla permisiva — así está escrito el código. El endpoint de la caseta tiene fijo que el camión sigue su camino, y lo dice directamente en su propia documentación interna: solo registro, los camiones nunca se detienen, el camión avanza sin importar lo que digan los documentos.
El veredicto se calcula en el momento
Un escaneo junta el tractocamión, cada remolque involucrado y la licencia del operador en un solo resultado, reducido a cuatro salidas — vigente, vencido, faltante, inválido — más simple que el estado detallado que muestra un panel, pensado para que un guardia lo lea de un vistazo.
Nada lee un "rechazo" de vuelta
Un evento de escaneo puede llevar una nota de decisión, pero se guarda como registro de lo que pasó, no se vuelve a leer ni se hace cumplir en ningún lado. Lo único que un resultado malo realmente dispara del lado del servidor es lo que sigue abajo — nunca un bloqueo.
Un resultado malo igual hace dos cosas
La pantalla de caseta en la web dispara un WhatsApp en segundo plano al grupo de supervisores — placa, código de unidad, resultado, los problemas específicos, y una línea explícita de "el camión siguió su camino, solo registro" — y el estado de la unidad alimenta la siguiente exportación de no-programar.
Una lista que despacho debe revisar, no un candado que DocVigia impone.
Cada noche, junto con la corrida propia de la escalera de alertas, DocVigia escribe cada unidad en ROJO — vencida o con un documento faltante por completo — en un archivo JSON sencillo: placa, código de unidad, centro de distribución y los problemas específicos, con fecha y conteo.
Lo que esta exportación no garantiza
DocVigia escribe el archivo. Que el proceso de despacho o el TMS de una flotilla realmente lo abra antes de asignar el siguiente viaje es un paso que pasa del lado propio de esa flotilla — la exportación está pensada para consumirse, pero DocVigia no entra a un sistema de despacho para bloquear una asignación por su cuenta, igual que la caseta misma no bloquea un camión. Ambas cosas son información, puesta donde quien la necesita pueda actuar, no un candado automático.
"Solo registro" significa exactamente eso, en ambos sentidos.
- Un resultado en ROJO nunca retiene a un operador en la caseta. La respuesta que muestra la pantalla del guardia siempre deja que el camión avance — no existe una ruta en el código donde la API se niegue a un escaneo.
- Los cuatro resultados de la caseta son más generales que los del panel. Vigente, vencido, faltante, inválido — un estado que un gerente ve como "por vencer" en el panel no tiene su propio nivel en la caseta; se lee como vigente hasta que realmente vence.
- El archivo de no-programar tiene que leerse de verdad. Es una exportación que despacho debe revisar cada corrida — nada obliga a que esa revisión pase, y DocVigia no tiene visibilidad de si realmente sucede.
- Un escaneo está diseñado para sobrevivir sin señal, a nivel de API. Las marcas de tiempo de un evento usan el reloj propio del dispositivo en lugar de la hora de llegada al servidor — precisamente para que un escaneo hecho en un patio sin señal siga registrando el momento real en que ocurrió una vez que se sincroniza.
Preguntas sobre la caseta.
Si una unidad está en ROJO, ¿un guardia puede negarse a dejarla pasar de todas formas?
Nada en el producto le impide a una persona tomar esa decisión por su cuenta — el diseño del sistema es registrar y avanzar, y escalar a un supervisor por WhatsApp en lugar de poner una barrera en la pantalla. Que una flotilla imponga su propia política más estricta encima es una decisión ajena a DocVigia.
¿La app del guardia necesita señal para escanear?
El contrato del backend está construido para reproducirse sin conexión — la marca de tiempo de un escaneo la pone el dispositivo, no el servidor, precisamente para que un evento que se sincroniza tarde desde una zona sin señal siga registrando con exactitud. Eso es lo que garantiza la API; describe lo que el servidor espera, no una afirmación sobre cualquier cliente construido contra ella.
¿Quién actúa realmente sobre la exportación de no-programar?
DocVigia lo escribe cada noche con la placa, el código y los problemas específicos de cada unidad en ROJO. El propio proceso de despacho o el TMS de una flotilla debe revisarlo antes de asignar un viaje — ese es el uso previsto, pero es un paso que pasa del lado de la flotilla, no algo que DocVigia verifique que haya sucedido.