# 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*