Vehículos

La pantalla de Vehículos gestiona el catálogo completo de la flota: registro de cada unidad con sus datos técnicos, estado operativo y conductor asignado.

Para qué sirve

Mantiene el inventario de vehículos disponibles, su estado actual (activo, en mantenimiento, fuera de servicio) y su historial completo de combustible, mantenimientos y viajes.

Vista principal

Cómo acceder

Navegar a Flota → Vehículos en el menú lateral.

Datos de un vehículo

Campo	Descripción
Placa	Matrícula o placa de circulación
Marca	Fabricante del vehículo
Modelo	Modelo específico
Año	Año de fabricación
Tipo	Sedán, camioneta, camión, moto, etc.
Combustible	Gasolina, diésel, eléctrico, híbrido
Odómetro	Kilometraje actual
Estado	Activo, en mantenimiento, fuera de servicio
Conductor asignado	Conductor habitual del vehículo

Detalle de vehículo

Al abrir el detalle de un vehículo se accede al historial completo:

• Últimas cargas de combustible.
• Mantenimientos recientes.
• Viajes recientes.
• Documentos legales vigentes (seguro, revisión técnica).
• Indicadores: consumo promedio (km/l), costo total del mes, km recorridos.

Nota sobre el estado actual

Hallazgo QA (2026-04-26):

• La columna “Placa” aparece vacía en todas las filas del listado y en el modal de detalle. El campo placa parece no estar siendo devuelto por el SP o el binding del frontend no coincide (P1).
• La columna “Año” se muestra como “Ano” sin tilde — error tipográfico en la definición de la columna (P3).
• Los estados se muestran en inglés en el listado (ACTIVE, IN_MAINTENANCE) pero en español en el modal de detalle (Activo). Pendiente localización consistente (P2).
• cache.zentto.net/v1/grid-layouts/module-flota:vehiculos:list devuelve 500 (P1).

Flujo del usuario

Vista no tecnica del modulo. Pensada para conductores, responsables de flota y personal administrativo.

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: entidades, stored procedures, tablas y relaciones FK del catalogo vehicular.

Componente	Tipo	Ubicacion
GET /v1/flota/vehiculos	Route Express	web/api/src/routes/flota/vehicles.ts
POST /v1/flota/vehiculos	Route Express	web/api/src/routes/flota/vehicles.ts
GET /v1/flota/vehiculos/:id/documentos	Route Express	web/api/src/routes/flota/vehicles.ts
usp_Fleet_Vehicle_List	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Vehicle_Get	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Vehicle_Create	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_VehicleDocument_List	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_VehicleDocument_Create	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
flt.Vehicle	Tabla operativa	web/api/migrations/postgres/
flt.VehicleDocument	Tabla operativa	web/api/migrations/postgres/
VehiclesListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-flota/src/

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