rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ec43d9c6cd
erp-transportistas-v2/docs/02-definicion-modulos/MAI-013-mantenimiento-flota/REQUERIMIENTOS.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

4.5 KiB
Raw Blame History

REQUERIMIENTOS - MAI-013: Mantenimiento de Flota

Modulo: MAI-013 Fuente: REQ-GIRO-TRANSPORTISTA.md - Seccion 4.11 Version: 1.0.0

Requerimientos Funcionales

RF-4.11.1: Plan Preventivo

Descripcion: Programar mantenimiento preventivo automatico por km, horas o fecha.

Tipos de trigger:

Trigger Parametro Ejemplo
Por km Intervalo km Cada 15,000 km
Por horas motor Intervalo horas Cada 500 hrs
Por fecha Periodicidad Cada 6 meses
Por evento Condicion Post-viaje largo

Planes tipicos por tipo de unidad:

Unidad Servicio Intervalo
Tracto Cambio aceite 15,000 km
Tracto Revision frenos 30,000 km
Tracto Service mayor 100,000 km
Remolque Revision llantas 10,000 km
Remolque Lubricacion 5,000 km

Generacion automatica:

  • Job diario verifica km/horas/fechas
  • Al alcanzar umbral → genera OT preventiva
  • Notifica a jefe de mantenimiento
  • Pre-agenda fecha tentativa

Tablas DDL:

  • maintenance.planes_mantenimiento
  • maintenance.servicios_programados

RF-4.11.2: Mantenimiento Correctivo

Descripcion: Gestionar fallas reportadas con tickets y ordenes de trabajo.

Flujo correctivo:

Falla detectada → Ticket → Diagnostico → OT →
Ejecucion → Pruebas → Cierre → Liberacion

Prioridades:

Nivel Descripcion SLA
CRITICA Unidad parada en ruta 4 horas
ALTA Afecta seguridad 24 horas
MEDIA Afecta operacion 48 horas
BAJA Estetico/menor 1 semana

Campos de ticket:

  • Unidad afectada
  • Tipo de falla
  • Descripcion
  • Fotos
  • Ubicacion (si en ruta)
  • Prioridad
  • Reportado por

Tablas DDL:

  • maintenance.tickets_falla
  • maintenance.ordenes_trabajo

RF-4.11.3: Inventario de Refacciones

Descripcion: Control minimo de refacciones para taller propio.

Alcance (minimo para el giro):

  • Catalogo de refacciones comunes
  • Stock actual por almacen
  • Consumo en ordenes de trabajo
  • Punto de reorden
  • Costo promedio

Fuera de alcance:

  • Multialmacen complejo
  • Lotes y caducidad
  • Produccion

Tablas DDL:

  • maintenance.refacciones
  • maintenance.movimientos_refaccion

RF-4.11.4: Historial por Activo

Descripcion: Mantener historial completo de mantenimientos por unidad.

Metricas por unidad:

Metrica Descripcion
MTBF Mean Time Between Failures
MTTR Mean Time To Repair
Costo total Suma de OTs
Fallas recurrentes Misma falla >2 veces

Reportes:

  • Historial cronologico de OTs
  • Costos acumulados
  • Fallas frecuentes
  • Comparativo entre unidades similares

Tablas DDL:

  • maintenance.historial_unidad (vista materializada)

RF-4.11.5: Disponibilidad de Flota

Descripcion: Controlar estado de cada unidad y bloquear si corresponde.

Estados de unidad:

Estado Puede asignarse Motivo
DISPONIBLE Si Lista para viaje
EN_VIAJE No Ya asignada
EN_TALLER No En mantenimiento
BLOQUEADA No Doc vencida o falla critica
BAJA_TEMPORAL No Fuera de servicio temporal
BAJA_DEFINITIVA No Vendida/siniestrada

Bloqueos automaticos:

  • Verificacion vehicular vencida
  • Poliza de seguro vencida
  • Mantenimiento preventivo vencido
  • Falla critica no resuelta

Dashboard de disponibilidad:

  • Total unidades
  • Disponibles
  • En viaje
  • En taller
  • Bloqueadas
  • % disponibilidad

Tablas DDL:

  • fleet.unidades.estado
  • maintenance.bloqueos_unidad

Requerimientos No Funcionales

RNF-001: Alertas Proactivas

  • Notificar 7 dias antes de vencimiento
  • Notificar 1,000 km antes de servicio
  • Notificar al 80% de horas de intervalo

RNF-002: Integracion Telematica

  • Obtener km/horas de ECU automaticamente
  • Detectar codigos de falla OBD

RNF-003: Movilidad

  • App para mecanicos en piso
  • Fotos de trabajos realizados

Matriz de Trazabilidad

RF Tablas DDL Endpoints Historias
RF-4.11.1 planes_mto, servicios GET/POST /planes US-MAI013-001
RF-4.11.2 tickets, ordenes POST /tickets US-MAI013-002
RF-4.11.3 refacciones GET /refacciones US-MAI013-002
RF-4.11.4 historial_unidad GET /historial US-MAI013-003
RF-4.11.5 bloqueos_unidad GET /disponibilidad US-MAI013-003

REQUERIMIENTOS MAI-013 - ERP Transportistas v1.0.0