Reportes de Flota

La sección de reportes del módulo de Flota permite generar documentos sobre el uso de la flota: inspecciones, consumo de combustible por vehículo, costos de mantenimiento y kilometraje por período.

Para qué sirve

Provee visibilidad sobre la operación de la flota: qué vehículos están activos, cuánto consumen, cuánto cuesta mantenerlos y cuántos kilómetros recorren. Útil para decisiones de renovación de flota y análisis de eficiencia.

Vista principal

Cómo acceder

Navegar a Flota → Reportes en el menú lateral.

Reportes disponibles

Reporte	Descripción
Reporte de Inspección	Checklist de inspección vehicular por unidad

Nota sobre el estado actual

Hallazgo QA (2026-04-26 — CRÍTICO P0):

• El reporte “Inspección vehicular” está renderizando una Factura de Venta (FAC-2026-001547) en lugar del checklist de inspección. El report_template_id asignado referencia incorrectamente una plantilla del módulo Ventas. Requiere corrección urgente antes de uso en producción.

• Solo hay 1 reporte disponible para todo el módulo de Flota. Faltan reportes esperados: consumo de combustible por vehículo, costos de mantenimiento, kilometraje por período, eficiencia de conductores, estado de la flota (P3).
• El heading y las tarjetas usan emojis (📄, 🚗) — pendiente reemplazar por iconos SVG del sistema de diseño (P3).

Flujo del usuario

Vista no tecnica de los reportes disponibles. Pensada para responsables de flota, contabilidad y gerencia.

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: query engine, cache, plantillas y zentto-report como motor PDF.

Componente	Tipo	Ubicacion
GET /v1/flota/reportes	Route Express	web/api/src/routes/flota/reports.ts
usp_Fleet_Dashboard	Stored procedure (datos agregados)	web/api/sqlweb*/includes/sp/
usp_Fleet_Fuel_List	Stored procedure (consumo por periodo)	web/api/sqlweb*/includes/sp/
usp_Fleet_Maintenance_List	Stored procedure (costos agregados)	web/api/sqlweb*/includes/sp/
usp_Fleet_Trip_List	Stored procedure (km por conductor)	web/api/sqlweb*/includes/sp/
flt.Vehicle	Tabla operativa	web/api/migrations/postgres/
flt.FuelLog	Tabla operativa	web/api/migrations/postgres/
flt.MaintenanceOrder	Tabla operativa	web/api/migrations/postgres/
flt.Trip	Tabla operativa	web/api/migrations/postgres/
rpt.ReportTemplate	Plantilla zentto-report	zentto-report/
ReportsPage.tsx	Componente Frontend	web/modular-frontend/packages/module-flota/src/

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