# RF-MAA017-001: Gestion de Incidentes

## Informacion General

| Atributo | Valor |
|----------|-------|
| **Codigo** | RF-MAA017-001 |
| **Nombre** | Gestion de Incidentes |
| **Modulo** | MAA-017 Seguridad HSE |
| **Prioridad** | P0 - Critica |
| **Complejidad** | Alta |

## Descripcion

El sistema debe permitir el registro, seguimiento e investigacion de incidentes y accidentes de trabajo ocurridos en las obras. Incluye clasificacion por gravedad, investigacion de causas raiz, y seguimiento de acciones correctivas.

## Requisitos Funcionales

### RF-MAA017-001.1: Registro de Incidentes
- Capturar datos basicos: fecha, hora, ubicacion, descripcion
- Clasificar por tipo: accidente, incidente, casi-accidente
- Clasificar por gravedad: leve, moderado, grave, fatal
- Registrar personas involucradas (lesionados, testigos)
- Adjuntar fotografias del lugar/lesiones
- Capturar geolocalizacion automatica
- Generar numero de folio automatico

### RF-MAA017-001.2: Investigacion de Accidentes
- Metodologia de investigacion (5 Por ques, Arbol de causas)
- Identificar causas inmediatas y basicas
- Clasificar factores: acto inseguro, condicion insegura
- Documentar declaraciones de testigos
- Adjuntar evidencia fotografica/documental
- Determinar acciones correctivas y preventivas

### RF-MAA017-001.3: Seguimiento de Acciones
- Asignar responsables y fechas compromiso
- Enviar notificaciones de vencimiento
- Registrar avances y evidencias de cumplimiento
- Cerrar acciones con evidencia
- Calcular efectividad de acciones

### RF-MAA017-001.4: Reportes IMSS
- Generar formato ST-7 (Aviso de accidente)
- Generar formato ST-9 (Recaida)
- Calcular dias de incapacidad
- Exportar en formato requerido

## Reglas de Negocio

1. Todo incidente debe registrarse en menos de 24 horas
2. Accidentes graves requieren investigacion en 48 horas
3. Accidentes fatales deben notificarse inmediatamente a gerencia
4. Las acciones correctivas tienen maximo 30 dias para implementarse
5. No se puede cerrar un incidente sin completar la investigacion
6. Los testigos deben firmar sus declaraciones

## Criterios de Aceptacion

- [ ] Usuario puede registrar incidente con todos los campos requeridos
- [ ] Sistema genera folio unico automaticamente
- [ ] Se pueden adjuntar hasta 10 fotos por incidente
- [ ] Geolocalizacion se captura automaticamente
- [ ] Investigacion sigue metodologia definida
- [ ] Acciones correctivas tienen seguimiento automatico
- [ ] Alertas se envian 3 dias antes del vencimiento
- [ ] Reportes IMSS se generan en formato oficial

## Datos Requeridos

### Incidente
```
- folio: VARCHAR(20) AUTO
- fecha_hora: TIMESTAMP
- fraccionamiento_id: UUID FK
- ubicacion_descripcion: TEXT
- ubicacion_geo: GEOMETRY(Point)
- tipo: ENUM(accidente, incidente, casi_accidente)
- gravedad: ENUM(leve, moderado, grave, fatal)
- descripcion: TEXT
- causa_inmediata: TEXT
- causa_basica: TEXT
- estado: ENUM(abierto, en_investigacion, cerrado)
```

### Involucrado
```
- incidente_id: UUID FK
- employee_id: UUID FK
- rol: ENUM(lesionado, testigo, responsable)
- descripcion_lesion: TEXT
- parte_cuerpo: VARCHAR(100)
- dias_incapacidad: INTEGER
```

## Mockups

### Pantalla: Registro de Incidente
```
+------------------------------------------+
| REGISTRO DE INCIDENTE                    |
+------------------------------------------+
| Folio: INC-2025-0001 (auto)             |
|                                          |
| Fecha/Hora: [____/__/__] [__:__]        |
| Fraccionamiento: [_____________ v]       |
| Ubicacion: [_________________________]   |
|                                          |
| Tipo:     (o) Accidente                  |
|           ( ) Incidente                  |
|           ( ) Casi-accidente             |
|                                          |
| Gravedad: ( ) Leve  (o) Moderado         |
|           ( ) Grave ( ) Fatal            |
|                                          |
| Descripcion:                             |
| [_____________________________________] |
| [_____________________________________] |
|                                          |
| Fotos: [+ Agregar]  [IMG1] [IMG2]       |
|                                          |
| [Cancelar]            [Guardar]          |
+------------------------------------------+
```

## Especificaciones Relacionadas

- ET-MAA017-DB-001: Schema HSE Database
- ET-MAA017-BE-001: Incidents Service
- ET-MAA017-FE-002: Incident Form

## User Stories Relacionadas

- US-MAA017-001: Registrar incidente de seguridad
- US-MAA017-002: Investigar accidente

---

**Autor**: Requirements-Analyst
**Fecha**: 2025-12-06
