Viajes

La pantalla de Viajes registra cada desplazamiento de los vehículos de la flota: origen, destino, conductor, distancia recorrida y propósito del viaje, para el control de uso vehicular y el cálculo de costos operativos por recorrido.

Para qué sirve

Mantiene el historial de viajes de la flota, permitiendo analizar el uso de cada vehículo, calcular la distancia recorrida por período y controlar que cada viaje tenga conductor y propósito registrados.

Vista principal

Cómo acceder

Navegar a Flota → Viajes en el menú lateral.

Ciclo de vida de un viaje

Planificado → En ruta → Completado

Datos de un viaje

Campo	Descripción
Número	Identificador correlativo (ej: TRIP-001)
Vehículo / Placa	Vehículo asignado al viaje
Conductor	Persona responsable del viaje
Origen	Punto de partida
Destino	Punto de llegada
Fecha de salida	Fecha y hora de inicio del viaje
Fecha de llegada	Fecha y hora de finalización (al completar)
Distancia	Kilómetros recorridos
Propósito	Motivo del viaje
Estado	Estado actual del viaje

Vista de detalle

El detalle del viaje muestra todos los campos con la opción de completar el viaje registrando el odómetro final y la fecha de llegada.

Nota sobre el estado actual

Hallazgo QA (2026-04-26):

• Las columnas “Placa Vehículo”, “Conductor”, “Fecha Salida” y “Distancia” aparecen vacías en todas las filas (P1).
• El botón “Completar” se muestra activo sobre viajes que ya tienen estado “Completado” — lógica de estado rota (P1).
• El botón “Eliminar” ejecuta sin diálogo de confirmación (P2).
• Los estados se muestran en inglés (COMPLETED) en el listado pero en español en el modal (P2).
• cache.zentto.net/v1/grid-layouts/module-flota:viajes:list devuelve 500 (P1).

Flujo del usuario

Vista no tecnica del proceso. Pensada para conductores, despachadores y responsables de flota.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo tecnico

Vista tecnica para desarrolladores: sequence diagram con endpoints, stored procedures, actualizacion de odometro y cache.

Componente	Tipo	Ubicacion
GET /v1/flota/viajes	Route Express	web/api/src/routes/flota/trips.ts
POST /v1/flota/viajes	Route Express	web/api/src/routes/flota/trips.ts
POST /v1/flota/viajes/:id/completar	Route Express	web/api/src/routes/flota/trips.ts
usp_Fleet_Trip_List	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Trip_Create	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Trip_Complete	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Dashboard	Stored procedure (refresh KPIs tras completar)	web/api/sqlweb*/includes/sp/
flt.Trip	Tabla operativa	web/api/migrations/postgres/
flt.Vehicle	Tabla operativa (UPDATE odometro)	web/api/migrations/postgres/
TripsListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-flota/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.