erp-construccion/docs/02-definicion-modulos/MAA-017-seguridad-hse/requerimientos/RF-MAA017-001-gestion-incidentes.md

141 lines
4.5 KiB
Markdown

# 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