575 lines
18 KiB
YAML
575 lines
18 KiB
YAML
# TRACEABILITY.yml
|
|
# Módulo: MAI-007 - Seguridad Industrial
|
|
# Proyecto: Construcción
|
|
# Descripción: Trazabilidad de requerimientos funcionales del módulo de Seguridad Industrial
|
|
|
|
module:
|
|
id: MAI-007
|
|
name: Seguridad Industrial
|
|
description: Gestión integral de seguridad en obras de construcción, incluyendo EPP, inspecciones, incidentes y capacitaciones
|
|
vertical: construccion
|
|
phase: core-business
|
|
priority: high
|
|
status: planned
|
|
|
|
# Requerimientos Funcionales
|
|
functional_requirements:
|
|
|
|
# RF-001: Gestión de EPP
|
|
- id: RF-MAI-007-001
|
|
name: Gestión de Equipo de Protección Personal (EPP)
|
|
description: Administración y control de equipos de protección personal asignados a trabajadores
|
|
priority: critical
|
|
status: planned
|
|
|
|
user_stories:
|
|
- id: US-MAI-007-001
|
|
title: Registro de EPP
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Registrar y catalogar los diferentes tipos de EPP disponibles
|
|
so_that: Pueda mantener un inventario actualizado de equipos de protección
|
|
acceptance_criteria:
|
|
- Crear catálogo de tipos de EPP (casco, guantes, botas, arnés, etc.)
|
|
- Registrar especificaciones técnicas y normativas de cada EPP
|
|
- Definir vida útil y fecha de caducidad
|
|
- Asignar códigos y ubicación de almacenamiento
|
|
- Registrar proveedor y costo por unidad
|
|
|
|
- id: US-MAI-007-002
|
|
title: Asignación de EPP a trabajadores
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Asignar EPP a trabajadores de obra
|
|
so_that: Pueda garantizar que cada trabajador tenga el equipo necesario
|
|
acceptance_criteria:
|
|
- Asignar EPP según puesto y actividades del trabajador
|
|
- Registrar fecha de entrega y firma de recibido
|
|
- Generar acta de entrega de EPP
|
|
- Vincular asignación con expediente del trabajador
|
|
- Notificar próximo vencimiento o renovación
|
|
|
|
- id: US-MAI-007-003
|
|
title: Control de EPP en campo
|
|
as_a: Supervisor de Obra
|
|
i_want: Verificar el uso correcto de EPP desde dispositivo móvil
|
|
so_that: Pueda asegurar el cumplimiento de normas de seguridad
|
|
acceptance_criteria:
|
|
- Registrar inspección de uso de EPP vía app móvil
|
|
- Tomar fotografías del equipo en uso
|
|
- Marcar EPP en mal estado o vencido
|
|
- Generar reporte de no conformidades
|
|
- Enviar alertas al coordinador de seguridad
|
|
|
|
dependencies:
|
|
modules:
|
|
- MAI-001 # Gestión de Personal
|
|
- MAI-003 # Inventarios y Almacén
|
|
- MGN-005 # Catálogos
|
|
mobile_apps:
|
|
- MOB-003 # App Supervisor
|
|
- MOB-004 # App Capataz
|
|
|
|
database_entities:
|
|
- epp_catalog
|
|
- epp_assignments
|
|
- epp_inspections
|
|
- epp_inventory
|
|
|
|
api_endpoints:
|
|
- POST /api/v1/safety/epp/catalog
|
|
- GET /api/v1/safety/epp/catalog
|
|
- POST /api/v1/safety/epp/assignments
|
|
- GET /api/v1/safety/epp/assignments/:worker_id
|
|
- PUT /api/v1/safety/epp/assignments/:id
|
|
- POST /api/v1/safety/epp/inspections
|
|
- GET /api/v1/safety/epp/inventory
|
|
|
|
ui_components:
|
|
- EPPCatalogManagement
|
|
- EPPAssignmentForm
|
|
- EPPWorkerHistory
|
|
- EPPInventoryDashboard
|
|
- EPPMobileInspection (móvil)
|
|
|
|
# RF-002: Inspecciones de Seguridad
|
|
- id: RF-MAI-007-002
|
|
name: Inspecciones de Seguridad
|
|
description: Realización y seguimiento de inspecciones de seguridad en obras
|
|
priority: critical
|
|
status: planned
|
|
|
|
user_stories:
|
|
- id: US-MAI-007-004
|
|
title: Creación de checklist de inspección
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Crear listas de verificación personalizadas para inspecciones
|
|
so_that: Pueda estandarizar los criterios de evaluación de seguridad
|
|
acceptance_criteria:
|
|
- Crear plantillas de checklist por tipo de obra
|
|
- Definir criterios de evaluación y puntuación
|
|
- Establecer frecuencia de inspecciones
|
|
- Asignar responsables de inspección
|
|
- Incluir normativas y referencias aplicables
|
|
|
|
- id: US-MAI-007-005
|
|
title: Ejecución de inspecciones en campo
|
|
as_a: Supervisor de Obra
|
|
i_want: Realizar inspecciones de seguridad desde dispositivo móvil
|
|
so_that: Pueda documentar hallazgos en tiempo real
|
|
acceptance_criteria:
|
|
- Completar checklist desde app móvil
|
|
- Tomar fotografías de hallazgos
|
|
- Registrar coordenadas GPS del punto inspeccionado
|
|
- Clasificar hallazgos por nivel de riesgo
|
|
- Funcionar en modo offline con sincronización posterior
|
|
|
|
- id: US-MAI-007-006
|
|
title: Gestión de hallazgos y acciones correctivas
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Dar seguimiento a hallazgos de inspecciones
|
|
so_that: Pueda asegurar que se implementen acciones correctivas
|
|
acceptance_criteria:
|
|
- Visualizar hallazgos por nivel de riesgo
|
|
- Asignar responsables para acciones correctivas
|
|
- Establecer plazos de solución
|
|
- Registrar evidencia de corrección
|
|
- Generar reportes de cumplimiento
|
|
|
|
dependencies:
|
|
modules:
|
|
- MAI-002 # Gestión de Obras
|
|
- MGN-007 # Auditoría
|
|
- MGN-008 # Notificaciones
|
|
mobile_apps:
|
|
- MOB-003 # App Supervisor
|
|
- MOB-004 # App Capataz
|
|
|
|
database_entities:
|
|
- safety_inspection_templates
|
|
- safety_inspections
|
|
- inspection_findings
|
|
- corrective_actions
|
|
|
|
api_endpoints:
|
|
- POST /api/v1/safety/inspections/templates
|
|
- GET /api/v1/safety/inspections/templates
|
|
- POST /api/v1/safety/inspections
|
|
- GET /api/v1/safety/inspections/:project_id
|
|
- PUT /api/v1/safety/inspections/:id
|
|
- POST /api/v1/safety/inspections/:id/findings
|
|
- POST /api/v1/safety/findings/:id/corrective-actions
|
|
- PUT /api/v1/safety/corrective-actions/:id
|
|
|
|
ui_components:
|
|
- InspectionTemplateBuilder
|
|
- InspectionScheduler
|
|
- MobileInspectionForm (móvil)
|
|
- FindingsList
|
|
- CorrectiveActionTracker
|
|
- SafetyComplianceDashboard
|
|
|
|
# RF-003: Reportes de Incidentes
|
|
- id: RF-MAI-007-003
|
|
name: Reportes de Incidentes y Accidentes
|
|
description: Registro, investigación y seguimiento de incidentes de seguridad
|
|
priority: critical
|
|
status: planned
|
|
|
|
user_stories:
|
|
- id: US-MAI-007-007
|
|
title: Reporte inmediato de incidentes
|
|
as_a: Supervisor de Obra
|
|
i_want: Reportar incidentes o accidentes desde dispositivo móvil
|
|
so_that: Pueda documentar el evento de forma inmediata
|
|
acceptance_criteria:
|
|
- Formulario de reporte rápido en app móvil
|
|
- Clasificar tipo de incidente (leve, grave, fatal)
|
|
- Registrar ubicación con GPS y fotografías
|
|
- Identificar personas involucradas
|
|
- Enviar notificación automática a coordinador
|
|
|
|
- id: US-MAI-007-008
|
|
title: Investigación de incidentes
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Documentar la investigación de incidentes
|
|
so_that: Pueda identificar causas raíz y prevenir recurrencias
|
|
acceptance_criteria:
|
|
- Registrar análisis de causas (diagrama de Ishikawa)
|
|
- Documentar testimonios y evidencias
|
|
- Identificar causas raíz y contribuyentes
|
|
- Definir acciones preventivas y correctivas
|
|
- Generar informe de investigación
|
|
|
|
- id: US-MAI-007-009
|
|
title: Seguimiento de incidentes
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Dar seguimiento a incidentes hasta su cierre
|
|
so_that: Pueda asegurar la implementación de medidas correctivas
|
|
acceptance_criteria:
|
|
- Visualizar estado de cada incidente
|
|
- Registrar acciones tomadas y responsables
|
|
- Adjuntar documentación médica si aplica
|
|
- Calcular días perdidos y costos asociados
|
|
- Cerrar incidente con verificación de medidas
|
|
|
|
dependencies:
|
|
modules:
|
|
- MAI-001 # Gestión de Personal
|
|
- MAI-002 # Gestión de Obras
|
|
- MGN-007 # Auditoría
|
|
- MGN-008 # Notificaciones
|
|
mobile_apps:
|
|
- MOB-003 # App Supervisor
|
|
- MOB-004 # App Capataz
|
|
|
|
database_entities:
|
|
- incident_reports
|
|
- incident_investigations
|
|
- incident_witnesses
|
|
- incident_corrective_actions
|
|
- incident_costs
|
|
|
|
api_endpoints:
|
|
- POST /api/v1/safety/incidents
|
|
- GET /api/v1/safety/incidents
|
|
- GET /api/v1/safety/incidents/:id
|
|
- PUT /api/v1/safety/incidents/:id
|
|
- POST /api/v1/safety/incidents/:id/investigation
|
|
- POST /api/v1/safety/incidents/:id/witnesses
|
|
- POST /api/v1/safety/incidents/:id/corrective-actions
|
|
- PUT /api/v1/safety/incidents/:id/close
|
|
|
|
ui_components:
|
|
- MobileIncidentReport (móvil)
|
|
- IncidentsList
|
|
- IncidentInvestigationForm
|
|
- IncidentCauseAnalysis
|
|
- IncidentFollowUp
|
|
- IncidentStatisticsDashboard
|
|
|
|
# RF-004: Capacitaciones de Seguridad
|
|
- id: RF-MAI-007-004
|
|
name: Capacitaciones de Seguridad
|
|
description: Planificación, ejecución y seguimiento de capacitaciones en seguridad
|
|
priority: high
|
|
status: planned
|
|
|
|
user_stories:
|
|
- id: US-MAI-007-010
|
|
title: Programación de capacitaciones
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Planificar capacitaciones de seguridad
|
|
so_that: Pueda asegurar que todo el personal esté debidamente capacitado
|
|
acceptance_criteria:
|
|
- Crear catálogo de cursos de seguridad
|
|
- Definir capacitaciones obligatorias por puesto
|
|
- Programar sesiones con fecha, hora y ubicación
|
|
- Asignar instructores internos o externos
|
|
- Calcular capacidad y gestionar inscripciones
|
|
|
|
- id: US-MAI-007-011
|
|
title: Registro de asistencia y evaluación
|
|
as_a: Instructor de Seguridad
|
|
i_want: Registrar asistencia y evaluar participantes
|
|
so_that: Pueda documentar el cumplimiento de capacitación
|
|
acceptance_criteria:
|
|
- Registrar asistencia con firma o QR
|
|
- Aplicar evaluación de conocimientos
|
|
- Registrar calificaciones obtenidas
|
|
- Generar constancias de capacitación
|
|
- Tomar fotografías de la sesión
|
|
|
|
- id: US-MAI-007-012
|
|
title: Seguimiento de capacitaciones
|
|
as_a: Coordinador de Seguridad
|
|
i_want: Consultar el historial de capacitaciones por trabajador
|
|
so_that: Pueda verificar cumplimiento de requisitos de seguridad
|
|
acceptance_criteria:
|
|
- Visualizar capacitaciones por trabajador
|
|
- Identificar capacitaciones vencidas o pendientes
|
|
- Generar alertas de renovación
|
|
- Exportar matriz de capacitación
|
|
- Generar reportes de cobertura
|
|
|
|
dependencies:
|
|
modules:
|
|
- MAI-001 # Gestión de Personal
|
|
- MGN-005 # Catálogos
|
|
- MGN-008 # Notificaciones
|
|
mobile_apps:
|
|
- MOB-003 # App Supervisor (consulta)
|
|
|
|
database_entities:
|
|
- training_catalog
|
|
- training_sessions
|
|
- training_attendance
|
|
- training_evaluations
|
|
- training_certificates
|
|
|
|
api_endpoints:
|
|
- POST /api/v1/safety/trainings/catalog
|
|
- GET /api/v1/safety/trainings/catalog
|
|
- POST /api/v1/safety/trainings/sessions
|
|
- GET /api/v1/safety/trainings/sessions
|
|
- POST /api/v1/safety/trainings/sessions/:id/attendance
|
|
- POST /api/v1/safety/trainings/sessions/:id/evaluations
|
|
- GET /api/v1/safety/trainings/worker/:worker_id/history
|
|
- GET /api/v1/safety/trainings/compliance-matrix
|
|
|
|
ui_components:
|
|
- TrainingCatalogManagement
|
|
- TrainingSessionPlanner
|
|
- AttendanceRegistration
|
|
- TrainingEvaluation
|
|
- WorkerTrainingHistory
|
|
- TrainingComplianceDashboard
|
|
|
|
# Integraciones con Apps Móviles
|
|
mobile_integrations:
|
|
|
|
- app_id: MOB-003
|
|
app_name: App Supervisor
|
|
description: Aplicación móvil para supervisores de obra
|
|
features:
|
|
- Verificación de uso de EPP
|
|
- Inspecciones de seguridad en campo
|
|
- Reporte inmediato de incidentes
|
|
- Consulta de capacitaciones del personal
|
|
- Fotografías y evidencias
|
|
- Funcionalidad offline
|
|
sync_frequency: real-time
|
|
offline_capable: true
|
|
|
|
- app_id: MOB-004
|
|
app_name: App Capataz
|
|
description: Aplicación móvil para capataces
|
|
features:
|
|
- Reporte de incidentes
|
|
- Inspecciones básicas de seguridad
|
|
- Verificación de EPP de su cuadrilla
|
|
- Consulta de checklist de seguridad
|
|
- Registro de asistencia a capacitaciones
|
|
sync_frequency: real-time
|
|
offline_capable: true
|
|
|
|
# Indicadores y Métricas
|
|
kpis:
|
|
- name: Tasa de Incidentes
|
|
description: Número de incidentes por cada 100,000 horas trabajadas
|
|
formula: (Número de incidentes / Total horas trabajadas) * 100,000
|
|
target: "< 2.0"
|
|
|
|
- name: Cumplimiento de Inspecciones
|
|
description: Porcentaje de inspecciones realizadas vs programadas
|
|
formula: (Inspecciones realizadas / Inspecciones programadas) * 100
|
|
target: ">= 95%"
|
|
|
|
- name: Tiempo de Cierre de Hallazgos
|
|
description: Días promedio para cerrar hallazgos de inspecciones
|
|
formula: Promedio de días desde hallazgo hasta cierre
|
|
target: "<= 7 días"
|
|
|
|
- name: Cobertura de Capacitación
|
|
description: Porcentaje de trabajadores capacitados
|
|
formula: (Trabajadores capacitados / Total trabajadores) * 100
|
|
target: "100%"
|
|
|
|
- name: Cumplimiento de EPP
|
|
description: Porcentaje de trabajadores con EPP vigente
|
|
formula: (Trabajadores con EPP vigente / Total trabajadores) * 100
|
|
target: "100%"
|
|
|
|
# Reportes
|
|
reports:
|
|
- id: REP-MAI-007-001
|
|
name: Dashboard de Seguridad
|
|
description: Panel general de indicadores de seguridad
|
|
frequency: diario
|
|
sections:
|
|
- Indicadores de incidentes
|
|
- Estado de inspecciones
|
|
- Hallazgos pendientes
|
|
- Cumplimiento de EPP
|
|
- Capacitaciones próximas
|
|
|
|
- id: REP-MAI-007-002
|
|
name: Reporte de Incidentes
|
|
description: Informe detallado de incidentes del período
|
|
frequency: mensual
|
|
sections:
|
|
- Resumen de incidentes por tipo
|
|
- Análisis de causas
|
|
- Acciones correctivas implementadas
|
|
- Costos asociados
|
|
- Tendencias y recomendaciones
|
|
|
|
- id: REP-MAI-007-003
|
|
name: Matriz de Capacitación
|
|
description: Estado de capacitaciones por trabajador
|
|
frequency: mensual
|
|
sections:
|
|
- Capacitaciones vigentes
|
|
- Capacitaciones próximas a vencer
|
|
- Capacitaciones pendientes
|
|
- Estadísticas de evaluación
|
|
|
|
- id: REP-MAI-007-004
|
|
name: Reporte de Inspecciones
|
|
description: Resultados de inspecciones de seguridad
|
|
frequency: semanal
|
|
sections:
|
|
- Inspecciones realizadas
|
|
- Hallazgos por nivel de riesgo
|
|
- Acciones correctivas pendientes
|
|
- Tendencias de cumplimiento
|
|
|
|
# Normativas y Regulaciones
|
|
compliance:
|
|
standards:
|
|
- name: NOM-031-STPS-2011
|
|
description: Construcción - Condiciones de seguridad y salud en el trabajo
|
|
scope: General
|
|
|
|
- name: NOM-017-STPS-2008
|
|
description: Equipo de protección personal
|
|
scope: Gestión de EPP
|
|
|
|
- name: NOM-019-STPS-2011
|
|
description: Comisiones de seguridad e higiene
|
|
scope: Inspecciones
|
|
|
|
- name: OSHA 1926
|
|
description: Safety and Health Regulations for Construction
|
|
scope: General (referencia internacional)
|
|
|
|
# Tecnologías y Stack
|
|
technical_stack:
|
|
backend:
|
|
- Node.js / Express
|
|
- PostgreSQL
|
|
- Redis (caché)
|
|
frontend:
|
|
- React / Next.js
|
|
- Material-UI
|
|
mobile:
|
|
- React Native
|
|
- Offline storage: SQLite
|
|
cloud:
|
|
- AWS S3 (almacenamiento de fotos)
|
|
- AWS SNS (notificaciones push)
|
|
integrations:
|
|
- API Gateway
|
|
- WebSockets (sincronización real-time)
|
|
|
|
# Seguridad y Permisos
|
|
security:
|
|
roles:
|
|
- role: Coordinador de Seguridad
|
|
permissions:
|
|
- Gestión completa del módulo
|
|
- Crear y modificar EPP, inspecciones, incidentes
|
|
- Aprobar acciones correctivas
|
|
- Generar todos los reportes
|
|
|
|
- role: Supervisor de Obra
|
|
permissions:
|
|
- Realizar inspecciones
|
|
- Reportar incidentes
|
|
- Verificar EPP
|
|
- Consultar reportes de su obra
|
|
|
|
- role: Capataz
|
|
permissions:
|
|
- Reportar incidentes
|
|
- Realizar inspecciones básicas
|
|
- Verificar EPP de su cuadrilla
|
|
|
|
- role: Trabajador
|
|
permissions:
|
|
- Consultar su historial de EPP
|
|
- Consultar sus capacitaciones
|
|
- Reportar sugerencias de seguridad
|
|
|
|
# Roadmap de Implementación
|
|
implementation_phases:
|
|
|
|
- phase: 1
|
|
name: Gestión de EPP
|
|
duration: 4 semanas
|
|
deliverables:
|
|
- Catálogo de EPP
|
|
- Asignación a trabajadores
|
|
- Control de inventario
|
|
- Integración con app móvil para verificación
|
|
|
|
- phase: 2
|
|
name: Inspecciones de Seguridad
|
|
duration: 5 semanas
|
|
deliverables:
|
|
- Plantillas de inspección
|
|
- App móvil para inspecciones
|
|
- Gestión de hallazgos
|
|
- Sistema de acciones correctivas
|
|
|
|
- phase: 3
|
|
name: Reportes de Incidentes
|
|
duration: 4 semanas
|
|
deliverables:
|
|
- Reporte de incidentes
|
|
- Investigación de causas
|
|
- Seguimiento y cierre
|
|
- Estadísticas y KPIs
|
|
|
|
- phase: 4
|
|
name: Capacitaciones
|
|
duration: 3 semanas
|
|
deliverables:
|
|
- Catálogo de capacitaciones
|
|
- Programación de sesiones
|
|
- Registro de asistencia y evaluaciones
|
|
- Matriz de cumplimiento
|
|
|
|
# Testing
|
|
testing_strategy:
|
|
unit_tests:
|
|
- Lógica de negocio de EPP
|
|
- Cálculo de KPIs
|
|
- Validaciones de formularios
|
|
|
|
integration_tests:
|
|
- APIs de seguridad
|
|
- Sincronización móvil-backend
|
|
- Integración con módulos dependientes
|
|
|
|
e2e_tests:
|
|
- Flujo completo de inspección
|
|
- Flujo de reporte de incidente
|
|
- Asignación de EPP
|
|
|
|
mobile_tests:
|
|
- Funcionalidad offline
|
|
- Sincronización de datos
|
|
- Captura de fotos y GPS
|
|
|
|
# Documentación
|
|
documentation:
|
|
technical:
|
|
- API Documentation (Swagger/OpenAPI)
|
|
- Database Schema
|
|
- Mobile App Architecture
|
|
|
|
user:
|
|
- Manual de Usuario - Coordinador de Seguridad
|
|
- Guía Rápida - Supervisor (App Móvil)
|
|
- Guía Rápida - Capataz (App Móvil)
|
|
- Videos tutoriales
|
|
|
|
# Changelog
|
|
changelog:
|
|
- version: 1.0.0
|
|
date: 2025-12-06
|
|
changes:
|
|
- Creación inicial del documento de trazabilidad
|
|
- Definición de 4 requerimientos funcionales principales
|
|
- Integración con apps móviles MOB-003 y MOB-004
|
|
- Definición de KPIs y reportes
|