erp-transportistas-v2/docs/02-definicion-modulos/MAE-017-hos-bitacora/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

3.8 KiB

REQUERIMIENTOS - MAE-017: HOS y Bitacora

Modulo: MAE-017 Fuente: REQ-GIRO-TRANSPORTISTA.md - Seccion 5.2 Version: 1.0.0


Requerimientos Funcionales

RF-5.2.1: Registro HOS

Descripcion: Capturar horas de conduccion, pausas y descanso.

Metodos de registro:

Metodo Descripcion Precision
Manual Operador ingresa en app Baja
Telematica ECU reporta automatico Alta
Hibrido Telematica + confirmacion Alta

Eventos a registrar:

Evento Codigo Descripcion
ON_DUTY D En servicio (no conduciendo)
DRIVING DR Conduciendo
OFF_DUTY OFF Fuera de servicio
SLEEPER SB En litera
BREAK BR Pausa

Datos por evento:

  • Operador
  • Fecha/hora inicio
  • Fecha/hora fin
  • Duracion
  • Ubicacion (inicio/fin)
  • Viaje relacionado (opcional)

Tablas DDL:

  • compliance.registros_hos
  • compliance.eventos_operador

RF-5.2.2: Bitacora Imprimible

Descripcion: Generar bitacora en formato oficial para inspeccion.

Formato requerido:

  • Nombre del operador y licencia
  • Empresa transportista
  • Unidad y placas
  • Grafico de 24 horas con franjas
  • Totales por tipo de evento
  • Firma del operador
  • Observaciones

Periodos:

  • Bitacora diaria (24 horas)
  • Bitacora por viaje
  • Resumen semanal

Salida:

  • PDF para impresion
  • Vista en pantalla
  • Exportar a Excel

Tablas DDL:

  • Vista: compliance.bitacora_hos_diaria

RF-5.2.3: Alertas de Incumplimiento

Descripcion: Alertar antes de exceder limites legales.

Limites NOM-087:

Limite Valor Alerta al
Servicio maximo 14 horas 80% (11.2h)
Conduccion maxima 11 horas 80% (8.8h)
Conduccion continua 5 horas 80% (4h)
Descanso minimo 10 horas Si no cumple

Tipos de alerta:

Nivel Descripcion Accion
ADVERTENCIA Proximo al limite Notificar operador
CRITICA Excedio limite Notificar supervisor
BLOQUEO No cumplio descanso No asignar viaje

Notificaciones:

  • Push a app operador
  • Email a supervisor
  • Alerta en sistema despacho

Tablas DDL:

  • compliance.alertas_hos

RF-5.2.4: Auditoria y Evidencias

Descripcion: Mantener trazabilidad de ediciones y responsables.

Registros de auditoria:

  • Cambios manuales (quien, cuando, motivo)
  • Ediciones de tiempos
  • Correcciones
  • Aprobaciones de supervisor

Evidencias:

  • Datos de telematica (respaldo)
  • Firmas digitales
  • Timestamps de sistema

Retencion:

  • Minimo 1 ano de historial
  • Exportable para auditoria externa

Tablas DDL:

  • compliance.auditoria_hos
  • compliance.firmas_bitacora

Limites NOM-087 (Referencia)

PERIODO DE 24 HORAS
├── Servicio maximo: 14 horas
│   ├── Conduccion: max 11 horas
│   ├── En servicio (no conduciendo): resto
│   └── Pausas: obligatorias cada 5h conduccion
│
└── Descanso obligatorio: min 10 horas
    ├── Puede ser consecutivo
    └── O en 2 bloques (7h + 3h)

Requerimientos No Funcionales

RNF-001: Precision

  • Telematica: precision ±1 minuto
  • Manual: validar coherencia

RNF-002: Disponibilidad Offline

  • App permite registro sin conexion
  • Sincroniza al recuperar red

RNF-003: Integracion Telematica

  • Soportar protocolos ELD comunes
  • API para proveedores GPS

Matriz de Trazabilidad

RF Tablas DDL Endpoints Historias
RF-5.2.1 registros_hos POST /hos US-MAE017-001
RF-5.2.2 bitacora_diaria GET /bitacora US-MAE017-003
RF-5.2.3 alertas_hos GET /alertas US-MAE017-002
RF-5.2.4 auditoria_hos GET /auditoria US-MAE017-003

REQUERIMIENTOS MAE-017 - ERP Transportistas v1.0.0