Mantenimiento

La pantalla de Mantenimiento gestiona las órdenes de mantenimiento de la flota: preventivo (por intervalo de km o tiempo) y correctivo (reparaciones no programadas), con seguimiento desde la programación hasta la finalización.

Para qué sirve

Controla el estado de mantenimiento de cada vehículo para prevenir averías, registrar los costos de reparación y asegurar que los vehículos de la flota estén siempre en condiciones operativas.

Vista principal

Cómo acceder

Navegar a Flota → Mantenimiento en el menú lateral.

Ciclo de vida de una orden de mantenimiento

Programado → En proceso → Completado
                       → Cancelado

Estado	Descripción
Programado	Pendiente de ejecución
En proceso	En taller o en curso
Completado	Mantenimiento finalizado
Cancelado	Orden anulada

Datos de una orden

Campo	Descripción
Número	Identificador correlativo (ej: MNT-2026-001)
Vehículo / Placa	Vehículo a mantener
Tipo	Preventivo o correctivo
Descripción	Trabajo a realizar
Fecha programada	Fecha planificada del servicio
Costo estimado	Presupuesto del mantenimiento
Costo real	Costo definitivo al completar
Estado	Estado actual de la orden

Vista de detalle

Al abrir una orden se muestra el detalle completo con todos los campos, incluido el proveedor del servicio (taller) y las observaciones.

Integración contable

Al completar una orden de mantenimiento se genera asiento contable (best-effort):

• Preventivo: Débito Gasto de Mantenimiento / Crédito Caja o Banco
• Correctivo: Débito Gasto de Reparaciones / Crédito Caja o Banco

Nota sobre el estado actual

Hallazgo QA (2026-04-26):

• Las columnas “Placa Vehículo”, “Tipo” y “Descripción” aparecen vacías en todas las filas (P1).
• El botón “Cancelar” se muestra activo sobre órdenes en 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 (SCHEDULED, IN_PROGRESS, COMPLETED) en el listado pero en español en el modal de detalle (P2).
• cache.zentto.net/v1/grid-layouts/module-flota:mantenimiento:list devuelve 500 (P1).

Flujo del usuario

Vista no tecnica del proceso. Pensada para responsables de flota, talleres 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: sequence diagram con endpoints, stored procedures, tablas y side-effects contables.

Componente	Tipo	Ubicacion
GET /v1/flota/mantenimientos	Route Express	web/api/src/routes/flota/maintenance.ts
POST /v1/flota/mantenimientos	Route Express	web/api/src/routes/flota/maintenance.ts
POST /v1/flota/mantenimientos/:id/completar	Route Express	web/api/src/routes/flota/maintenance.ts
POST /v1/flota/mantenimientos/:id/cancelar	Route Express	web/api/src/routes/flota/maintenance.ts
usp_Fleet_Maintenance_Create	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Maintenance_Complete	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Maintenance_Cancel	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_MaintenanceType_List	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
flt.MaintenanceOrder	Tabla operativa	web/api/migrations/postgres/
acc.JournalEntry	Tabla contable (side-effect)	web/api/migrations/postgres/
MaintenanceListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-flota/src/

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