- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| especificaciones | ||
| implementacion | ||
| README.md | ||
MAI-007: Seguridad Industrial
ID: MAI-007 Fase: 2 - Core Business Presupuesto: $30,000 MXN Story Points: 52 SP Sprint: Sprint 11-13 (Semanas 21-26) Prioridad: P0 (Crítica) Estado: En documentación
Resumen Ejecutivo
El módulo de Seguridad Industrial gestiona integralmente la seguridad e higiene en obras de construcción, proporcionando herramientas para:
- Gestión y control de Equipo de Protección Personal (EPP)
- Inspecciones de seguridad con evidencia fotográfica y geolocalización
- Reporte y seguimiento de incidentes y accidentes laborales
- Planificación y seguimiento de capacitaciones de seguridad
- Cumplimiento de normativas mexicanas (NOM-STPS) e internacionales (OSHA)
Problema que Resuelve
Las obras de construcción enfrentan riesgos constantes de accidentes laborales que generan:
- Pérdida de vidas humanas y lesiones
- Costos médicos y legales elevados
- Multas por incumplimiento normativo
- Suspensión de obras por autoridades
- Deterioro de la imagen corporativa
Sin este módulo: Control manual con formatos en papel, pérdida de evidencias, falta de trazabilidad, incumplimiento normativo, riesgos legales.
Con este módulo: Digitalización de procesos de seguridad, trazabilidad completa, alertas preventivas, cumplimiento normativo automatizado, reducción de accidentes.
Objetivos
Objetivos de Negocio
- Prevenir accidentes: Reducir incidentes laborales mediante inspecciones periódicas y controles preventivos
- Cumplimiento normativo: Garantizar cumplimiento de NOM-031-STPS-2011 y normativas aplicables
- Protección laboral: Asegurar que todo trabajador cuente con EPP adecuado y vigente
- Capacitación continua: Mantener personal capacitado en normas y procedimientos de seguridad
- Trazabilidad completa: Documentar todas las actividades de seguridad con evidencia digital
Objetivos Técnicos
- App móvil integrada: Inspecciones y reportes desde campo con MOB-003 y MOB-004
- Modo offline: Funcionamiento sin conexión con sincronización automática
- Geolocalización: Registro GPS de inspecciones e incidentes
- Evidencia fotográfica: Captura y almacenamiento de evidencias
- KPIs en tiempo real: Dashboard con indicadores de seguridad actualizados
Alcance Funcional
1. Gestión de Equipo de Protección Personal (EPP)
Funcionalidades:
- Catálogo de tipos de EPP (casco, guantes, botas, arnés, chaleco, etc.)
- Registro de especificaciones técnicas y normativas de cada EPP
- Control de inventario con vida útil y fechas de caducidad
- Asignación de EPP a trabajadores según puesto y actividades
- Generación de actas de entrega con firma digital
- Alertas de renovación por vencimiento o desgaste
- Verificación móvil del uso correcto de EPP en campo
Entidades de datos:
- Catálogo de EPP
- Inventario de EPP
- Asignaciones de EPP por trabajador
- Inspecciones de uso de EPP
2. Inspecciones de Seguridad
Funcionalidades:
- Creación de plantillas de checklist personalizadas por tipo de obra
- Definición de criterios de evaluación y niveles de riesgo
- Programación de inspecciones con frecuencia configurable
- Ejecución de inspecciones desde app móvil (MOB-003, MOB-004)
- Captura de fotografías geolocalizadas de hallazgos
- Clasificación de hallazgos por nivel de riesgo (bajo, medio, alto, crítico)
- Asignación de acciones correctivas con responsables y plazos
- Seguimiento de cierre de hallazgos con evidencia
- Reportes de cumplimiento y tendencias
Entidades de datos:
- Plantillas de inspección
- Inspecciones realizadas
- Hallazgos de inspección
- Acciones correctivas
3. Reportes de Incidentes y Accidentes
Funcionalidades:
- Reporte inmediato de incidentes desde app móvil
- Clasificación por tipo (leve, grave, fatal)
- Registro de ubicación GPS y evidencia fotográfica
- Identificación de personas involucradas y testigos
- Investigación de causas raíz (análisis de Ishikawa)
- Documentación de testimonios y evidencias
- Definición de acciones preventivas y correctivas
- Registro de costos asociados (médicos, laborales, legales)
- Cálculo de días perdidos y tasa de incidentes
- Generación de informes oficiales para autoridades
Entidades de datos:
- Reportes de incidentes
- Investigaciones de incidentes
- Testigos y testimonios
- Acciones correctivas
- Costos de incidentes
4. Capacitaciones de Seguridad
Funcionalidades:
- Catálogo de cursos y capacitaciones de seguridad
- Definición de capacitaciones obligatorias por puesto
- Programación de sesiones con fecha, hora, ubicación e instructor
- Gestión de inscripciones y control de capacidad
- Registro de asistencia con firma o código QR
- Aplicación de evaluaciones de conocimientos
- Generación de constancias de capacitación
- Historial de capacitaciones por trabajador
- Alertas de capacitaciones próximas a vencer
- Matriz de cumplimiento de capacitación
- Reportes de cobertura y estadísticas
Entidades de datos:
- Catálogo de capacitaciones
- Sesiones programadas
- Registro de asistencia
- Evaluaciones y calificaciones
- Constancias emitidas
Arquitectura del Módulo
Schema de Base de Datos: safety
Tablas principales:
-- EPP
safety.epp_catalog -- Catálogo de tipos de EPP
safety.epp_inventory -- Inventario de EPP disponible
safety.epp_assignments -- Asignaciones a trabajadores
safety.epp_inspections -- Verificaciones de uso
-- Inspecciones
safety.inspection_templates -- Plantillas de checklist
safety.inspections -- Inspecciones realizadas
safety.inspection_findings -- Hallazgos de inspecciones
safety.corrective_actions -- Acciones correctivas
-- Incidentes
safety.incident_reports -- Reportes de incidentes
safety.incident_investigations -- Investigaciones
safety.incident_witnesses -- Testigos
safety.incident_costs -- Costos asociados
-- Capacitaciones
safety.training_catalog -- Catálogo de cursos
safety.training_sessions -- Sesiones programadas
safety.training_attendance -- Asistencia
safety.training_evaluations -- Evaluaciones
safety.training_certificates -- Constancias emitidas
ENUMs:
epp_type: helmet, gloves, boots, harness, vest, goggles, mask, etc.epp_status: available, assigned, expired, damagedrisk_level: low, medium, high, criticalincident_type: near_miss, minor, serious, fatalincident_status: reported, under_investigation, closedaction_status: pending, in_progress, completed, cancelled
Backend: NestJS
Modules:
SafetyModule- Módulo principalEppModule- Gestión de EPPInspectionModule- Inspecciones de seguridadIncidentModule- Incidentes y accidentesTrainingModule- Capacitaciones
Services:
EppService- CRUD y lógica de EPPEppInventoryService- Control de inventarioInspectionService- Gestión de inspeccionesInspectionTemplateService- Plantillas de checklistIncidentService- Registro de incidentesIncidentInvestigationService- InvestigacionesTrainingService- Gestión de capacitacionesSafetyKpiService- Cálculo de indicadoresSafetyReportService- Generación de reportes
Controllers:
EppController- API REST de EPPInspectionController- API REST de inspeccionesIncidentController- API REST de incidentesTrainingController- API REST de capacitacionesSafetyReportController- Endpoints de reportes
Frontend: React + TypeScript
Páginas principales:
/safety/dashboard- Dashboard general de seguridad/safety/epp- Gestión de EPP/safety/inspections- Inspecciones de seguridad/safety/incidents- Incidentes y accidentes/safety/trainings- Capacitaciones/safety/reports- Reportes y estadísticas
Componentes principales:
SafetyDashboard- Dashboard con KPIsEppCatalogManagement- Gestión de catálogoEppAssignmentForm- Asignación de EPPEppInventoryDashboard- Control de inventarioInspectionTemplateBuilder- Constructor de plantillasInspectionScheduler- Programador de inspeccionesFindingsList- Lista de hallazgosCorrectiveActionTracker- Seguimiento de accionesIncidentReportForm- Formulario de incidentesIncidentInvestigationForm- Investigación de causasIncidentStatistics- Estadísticas de incidentesTrainingCatalogManagement- Gestión de catálogoTrainingSessionPlanner- Planificador de sesionesAttendanceRegistration- Registro de asistenciaTrainingComplianceDashboard- Matriz de cumplimiento
Flujos de Trabajo
Flujo 1: Asignación de EPP a Nuevo Trabajador
1. [Coordinador Seguridad] Ingresa nuevo trabajador al sistema
2. [Sistema] Identifica EPP requerido según puesto y actividades
3. [Coordinador] Verifica disponibilidad en inventario
4. [Coordinador] Asigna EPP con fecha de entrega
5. [Sistema] Genera acta de entrega de EPP (PDF)
6. [Trabajador] Firma digitalmente o en papel el acta
7. [Sistema] Registra asignación en expediente del trabajador
8. [Sistema] Programa alertas de renovación según vida útil
Flujo 2: Inspección de Seguridad en Campo
1. [Supervisor] Abre app móvil MOB-003
2. [Supervisor] Selecciona proyecto y tipo de inspección
3. [Sistema] Carga checklist correspondiente
4. [Supervisor] Completa checklist item por item
5. [Supervisor] Identifica hallazgo (no conformidad)
6. [Supervisor] Toma fotografía del hallazgo
7. [Sistema] Registra GPS y timestamp automáticamente
8. [Supervisor] Clasifica riesgo (bajo/medio/alto/crítico)
9. [Sistema] Sincroniza datos con servidor
10. [Sistema] Notifica a coordinador si hay hallazgos críticos
11. [Coordinador] Asigna acción correctiva con responsable y plazo
12. [Sistema] Envía notificación al responsable
13. [Responsable] Implementa corrección y registra evidencia
14. [Coordinador] Verifica y cierra hallazgo
Flujo 3: Reporte de Incidente Laboral
1. [Supervisor/Capataz] Presencia incidente en obra
2. [Supervisor] Abre app móvil y selecciona "Reportar Incidente"
3. [Sistema] Activa formulario de reporte rápido
4. [Supervisor] Completa datos:
- Tipo de incidente (leve/grave/fatal)
- Personas involucradas
- Descripción de lo ocurrido
- Fotografías de la escena
5. [Sistema] Captura GPS y timestamp
6. [Sistema] Envía notificación inmediata a:
- Coordinador de Seguridad
- Residente de Obra
- Director General (si es grave o fatal)
7. [Coordinador] Inicia investigación formal
8. [Coordinador] Documenta causas raíz
9. [Coordinador] Define acciones preventivas/correctivas
10. [Sistema] Asigna responsables y plazos
11. [Coordinador] Genera informe oficial
12. [Sistema] Calcula KPIs (tasa de incidentes, días perdidos)
13. [Coordinador] Cierra incidente con verificación de medidas
Flujo 4: Capacitación de Seguridad
1. [Coordinador] Programa sesión de capacitación
2. [Sistema] Identifica trabajadores que requieren la capacitación
3. [Sistema] Envía notificación de inscripción
4. [Día de sesión] [Instructor] Registra asistencia (QR o firma)
5. [Instructor] Imparte capacitación
6. [Instructor] Aplica evaluación de conocimientos
7. [Sistema] Registra calificaciones
8. [Sistema] Genera constancias para aprobados
9. [Sistema] Actualiza matriz de cumplimiento
10. [Sistema] Programa alerta de renovación (si aplica)
Integraciones
Integraciones con Módulos Backend
| Módulo | Relación | Datos Compartidos |
|---|---|---|
| MAI-001 Fundamentos | Consume datos de personal | Trabajadores, puestos, proyectos asignados |
| MAI-002 Proyectos | Vincula inspecciones/incidentes a obras | Proyectos activos, ubicaciones, residentes |
| MAI-004 Compras/Inventarios | Gestiona inventario de EPP | Stock de EPP, movimientos, proveedores |
| MAI-007-RRHH Asistencias | Complementa expediente laboral | Historial de capacitaciones, incidentes |
| MGN-005 Catálogos | Consume catálogos generales | Tipos de EPP, tipos de capacitación |
| MGN-007 Auditoría | Registra eventos críticos | Logs de incidentes, cambios de estado |
| MGN-008 Notificaciones | Envía alertas y recordatorios | Notificaciones push, emails |
Integraciones con Apps Móviles
MOB-003: App Supervisor
Funcionalidades compartidas:
- Verificación de uso de EPP en campo
- Ejecución de inspecciones de seguridad con checklist
- Reporte inmediato de incidentes con GPS y fotos
- Consulta de capacitaciones del personal
- Captura de evidencias fotográficas geolocalizadas
- Modo offline: Todas las funcionalidades disponibles sin conexión
- Sincronización: Automática al recuperar conexión
Flujo de datos:
App Móvil (MOB-003) <--> API REST (MAI-007) <--> PostgreSQL
|
v
AWS S3 (Fotos)
MOB-004: App Capataz
Funcionalidades compartidas:
- Reporte de incidentes de su cuadrilla
- Inspecciones básicas de seguridad
- Verificación de EPP de trabajadores bajo su cargo
- Consulta de checklist de seguridad
- Registro de asistencia a capacitaciones
Características:
- Interfaz simplificada para uso en campo
- Modo offline completo
- Sincronización en segundo plano
Reutilización del Core ERP
Porcentaje de reutilización: 0% - Módulo vertical específico
Justificación:
- Módulo completamente nuevo especializado en construcción
- No existe equivalente en el core ERP genérico
- Cumple normativas específicas del sector construcción (NOM-STPS, OSHA)
- Integración profunda con apps móviles de campo
Componentes reutilizados del core:
- Sistema de autenticación y permisos (MGN-001)
- Catálogos generales (MGN-005)
- Sistema de auditoría (MGN-007)
- Sistema de notificaciones (MGN-008)
Requerimientos Funcionales
| ID | Título | Descripción | Prioridad | SP |
|---|---|---|---|---|
| RF-SEG-001 | Gestión de EPP | Control de equipo de protección personal | Crítica | 13 |
| RF-SEG-002 | Inspecciones de Seguridad | Checklist, hallazgos y acciones correctivas | Crítica | 15 |
| RF-SEG-003 | Reportes de Incidentes | Registro, investigación y seguimiento | Crítica | 13 |
| RF-SEG-004 | Capacitaciones de Seguridad | Programación, evaluación y seguimiento | Alta | 11 |
Total Story Points: 52 SP
Indicadores Clave (KPIs)
KPI 1: Tasa de Incidentes
- Descripción: Número de incidentes por cada 100,000 horas trabajadas
- Fórmula:
(Número de incidentes / Total horas trabajadas) × 100,000 - Target: < 2.0
- Actualización: Diaria
KPI 2: Cumplimiento de Inspecciones
- Descripción: Porcentaje de inspecciones realizadas vs programadas
- Fórmula:
(Inspecciones realizadas / Inspecciones programadas) × 100 - Target: >= 95%
- Actualización: Semanal
KPI 3: Tiempo de Cierre de Hallazgos
- Descripción: Días promedio para cerrar hallazgos de inspecciones
- Fórmula:
Promedio de días desde hallazgo hasta cierre - Target: <= 7 días
- Actualización: Diaria
KPI 4: Cobertura de Capacitación
- Descripción: Porcentaje de trabajadores capacitados
- Fórmula:
(Trabajadores capacitados / Total trabajadores) × 100 - Target: 100%
- Actualización: Mensual
KPI 5: Cumplimiento de EPP
- Descripción: Porcentaje de trabajadores con EPP vigente
- Fórmula:
(Trabajadores con EPP vigente / Total trabajadores) × 100 - Target: 100%
- Actualización: Diaria
Roles y Permisos
| Rol | Permisos |
|---|---|
| Coordinador de Seguridad | Gestión completa del módulo, crear/modificar EPP, inspecciones, incidentes, aprobar acciones correctivas, generar todos los reportes |
| Supervisor de Obra | Realizar inspecciones, reportar incidentes, verificar EPP, consultar reportes de su obra |
| Capataz | Reportar incidentes, realizar inspecciones básicas, verificar EPP de su cuadrilla |
| Residente de Obra | Consultar inspecciones e incidentes de su proyecto, aprobar acciones correctivas |
| Director General | Visualizar todos los reportes y KPIs, recibir alertas de incidentes graves |
| Trabajador | Consultar su historial de EPP, consultar sus capacitaciones, reportar sugerencias de seguridad |
Dependencias
Dependencias Técnicas
Módulos del Core ERP:
- MGN-001 (Usuarios y Autenticación): Sistema de login y permisos
- MGN-005 (Catálogos): Catálogos de tipos de EPP y capacitaciones
- MGN-007 (Auditoría): Registro de eventos críticos
- MGN-008 (Notificaciones): Alertas y recordatorios
Módulos de Construcción:
- MAI-001 (Fundamentos): Datos de trabajadores y proyectos
- MAI-002 (Proyectos): Vinculación de inspecciones e incidentes a obras
- MAI-004 (Compras/Inventarios): Control de inventario de EPP
- MAI-007-RRHH (Asistencias): Expediente laboral completo
Apps Móviles:
- MOB-003 (App Supervisor): Inspecciones y reportes en campo
- MOB-004 (App Capataz): Verificación de EPP y reportes básicos
Dependencias de Infraestructura
- PostgreSQL 14+: Base de datos principal
- Redis: Caché para sincronización móvil
- AWS S3 / Azure Blob: Almacenamiento de fotografías
- AWS SNS / Firebase: Notificaciones push a móviles
- WebSockets: Sincronización en tiempo real
Diagrama de Arquitectura
┌─────────────────────────────────────────────────────────────────┐
│ MÓDULO MAI-007: SEGURIDAD INDUSTRIAL │
└─────────────────────────────────────────────────────────────────┘
┌──────────────────────┐ ┌──────────────────────┐
│ APPS MÓVILES │ │ FRONTEND WEB │
│ │ │ │
│ ┌────────────────┐ │ │ ┌────────────────┐ │
│ │ MOB-003 │ │ │ │ Dashboard │ │
│ │ Supervisor │ │ │ │ Seguridad │ │
│ └────────────────┘ │ │ └────────────────┘ │
│ │ │ │
│ ┌────────────────┐ │ │ ┌────────────────┐ │
│ │ MOB-004 │ │ │ │ Gestión EPP │ │
│ │ Capataz │ │ │ └────────────────┘ │
│ └────────────────┘ │ │ │
│ │ │ ┌────────────────┐ │
│ - Modo Offline │ │ │ Inspecciones │ │
│ - GPS & Cámara │ │ └────────────────┘ │
│ - Sync Queue │ │ │
└──────────┬───────────┘ └──────────┬───────────┘
│ │
│ API REST / WebSockets │
└────────────────┬───────────────┘
│
┌─────────────▼──────────────┐
│ BACKEND - NestJS │
│ │
│ ┌──────────────────────┐ │
│ │ SafetyModule │ │
│ ├──────────────────────┤ │
│ │ - EppService │ │
│ │ - InspectionService │ │
│ │ - IncidentService │ │
│ │ - TrainingService │ │
│ │ - KpiService │ │
│ └──────────────────────┘ │
└─────────────┬──────────────┘
│
┌──────────────────┼──────────────────┐
│ │ │
┌────▼─────┐ ┌──────▼──────┐ ┌─────▼─────┐
│PostgreSQL│ │ AWS S3 │ │ Redis │
│ │ │ │ │ │
│ Schema: │ │ - Fotos EPP │ │ - Cache │
│ safety │ │ - Evidencias│ │ - Queue │
└──────────┘ │ - Reportes │ │ - Sync │
└─────────────┘ └───────────┘
│
│
┌────▼─────────────────────────────┐
│ INTEGRACIONES │
│ │
│ - MAI-001 (Personal) │
│ - MAI-002 (Proyectos) │
│ - MAI-004 (Inventarios) │
│ - MAI-007-RRHH (Asistencias) │
│ - MGN-007 (Auditoría) │
│ - MGN-008 (Notificaciones) │
└──────────────────────────────────┘
Stack Tecnológico
Backend
runtime: Node.js 20 LTS
framework: NestJS 10
language: TypeScript 5.3+
database: PostgreSQL 14+
orm: Prisma 5.x
cache: Redis 7.x
storage: AWS S3 / Azure Blob Storage
notifications: AWS SNS / Firebase Cloud Messaging
websockets: Socket.io
Frontend Web
framework: React 18
meta_framework: Next.js 14
language: TypeScript 5.3+
state: Zustand 4.x
ui_library: Material-UI 5.x / shadcn/ui
forms: React Hook Form + Zod
charts: Recharts / Chart.js
maps: Leaflet (para visualización de GPS)
Apps Móviles
framework: React Native 0.73+
platform: Expo 50
language: TypeScript 5.3+
state: Zustand 4.x
navigation: React Navigation 6.x
offline_storage: WatermelonDB
sync: Background Fetch + Queue
camera: expo-camera
location: expo-location
biometrics: expo-local-authentication
Infraestructura
hosting: AWS / Azure / Google Cloud
containers: Docker + Kubernetes (opcional)
ci_cd: GitHub Actions
monitoring: Sentry (errores), DataDog (métricas)
logs: CloudWatch / Azure Monitor
backups: Automated daily snapshots
Normativas y Cumplimiento
Normativas Mexicanas (NOM-STPS)
| Norma | Descripción | Aplicación |
|---|---|---|
| NOM-031-STPS-2011 | Construcción - Condiciones de seguridad y salud | General - Todo el módulo |
| NOM-017-STPS-2008 | Equipo de protección personal - Selección, uso y manejo | Gestión de EPP |
| NOM-019-STPS-2011 | Comisiones de seguridad e higiene | Inspecciones de seguridad |
| NOM-009-STPS-2011 | Trabajos en altura | Inspecciones de andamios y arneses |
| NOM-030-STPS-2009 | Servicios preventivos de seguridad y salud | Capacitaciones |
Estándares Internacionales
| Estándar | Descripción | Aplicación |
|---|---|---|
| OSHA 1926 | Safety and Health Regulations for Construction | Referencia general |
| ISO 45001 | Sistemas de gestión de la seguridad y salud en el trabajo | Arquitectura del módulo |
Reportes
REP-MAI-007-001: Dashboard de Seguridad
- Frecuencia: Diario / Tiempo real
- Secciones:
- Indicadores de incidentes (tasa, días perdidos)
- Estado de inspecciones (programadas vs realizadas)
- Hallazgos pendientes por nivel de riesgo
- Cumplimiento de EPP
- Capacitaciones próximas
- Gráficos de tendencias
REP-MAI-007-002: Reporte de Incidentes
- Frecuencia: Mensual
- Secciones:
- Resumen de incidentes por tipo y gravedad
- Análisis de causas raíz
- Acciones correctivas implementadas
- Costos asociados (médicos, legales, operativos)
- Tendencias y recomendaciones
REP-MAI-007-003: Matriz de Capacitación
- Frecuencia: Mensual
- Secciones:
- Capacitaciones vigentes por trabajador
- Capacitaciones próximas a vencer
- Capacitaciones pendientes
- Estadísticas de evaluación
- Cobertura por proyecto/área
REP-MAI-007-004: Reporte de Inspecciones
- Frecuencia: Semanal
- Secciones:
- Inspecciones realizadas vs programadas
- Hallazgos por nivel de riesgo
- Acciones correctivas pendientes
- Tendencias de cumplimiento
- Áreas críticas identificadas
Roadmap de Implementación
Fase 1: Gestión de EPP (4 semanas) - Sprint 11
Story Points: 13 SP
Entregables:
- Catálogo de tipos de EPP con especificaciones
- Control de inventario de EPP
- Asignación de EPP a trabajadores
- Generación de actas de entrega
- Alertas de renovación
- Integración con app móvil para verificación (MOB-003)
Hitos:
- Sistema de EPP operativo
- Primeros trabajadores con EPP asignado
- Verificaciones desde app móvil funcionando
Fase 2: Inspecciones de Seguridad (5 semanas) - Sprint 12
Story Points: 15 SP
Entregables:
- Constructor de plantillas de checklist
- Programador de inspecciones
- App móvil para ejecución de inspecciones (MOB-003, MOB-004)
- Captura de fotos y GPS
- Gestión de hallazgos con clasificación de riesgo
- Sistema de acciones correctivas
- Dashboard de inspecciones
Hitos:
- Primeras inspecciones realizadas desde móvil
- Sistema de hallazgos y acciones correctivas operativo
- Modo offline funcional
Fase 3: Reportes de Incidentes (4 semanas) - Sprint 12-13
Story Points: 13 SP
Entregables:
- Formulario de reporte inmediato en app móvil
- Sistema de investigación de causas
- Análisis de Ishikawa
- Registro de costos y días perdidos
- Seguimiento de acciones preventivas
- Generación de informes oficiales
- Dashboard de estadísticas
Hitos:
- Sistema de reporte de incidentes operativo
- Primeras investigaciones documentadas
- KPIs de seguridad calculándose automáticamente
Fase 4: Capacitaciones (3 semanas) - Sprint 13
Story Points: 11 SP
Entregables:
- Catálogo de capacitaciones de seguridad
- Programador de sesiones
- Registro de asistencia (firma/QR)
- Sistema de evaluaciones
- Generador de constancias
- Matriz de cumplimiento
- Alertas de renovación
Hitos:
- Primera capacitación registrada en el sistema
- Constancias generadas automáticamente
- Matriz de cumplimiento completa
Puntos Críticos
Riesgos Técnicos
| Riesgo | Probabilidad | Impacto | Mitigación |
|---|---|---|---|
| Sincronización móvil-backend | Media | Alto | Queue robusta, conflict resolution, tests exhaustivos |
| Pérdida de datos en modo offline | Baja | Crítico | WatermelonDB con persistencia local, sync automático |
| GPS impreciso en interiores | Alta | Medio | Permitir corrección manual, usar último GPS conocido |
| Fotos de gran tamaño | Media | Medio | Compresión automática, límite de tamaño, carga en background |
Riesgos de Negocio
| Riesgo | Probabilidad | Impacto | Mitigación |
|---|---|---|---|
| Resistencia al cambio | Alta | Alto | Capacitación intensiva, beneficios claros, gamificación |
| Incumplimiento normativo | Baja | Crítico | Validación con expertos, auditorías previas al lanzamiento |
| Falta de evidencia en inspecciones | Media | Alto | Hacer obligatorias fotos en hallazgos críticos |
| Subregistro de incidentes | Media | Alto | Cultura de seguridad, incentivos por reporte, anonimato opcional |
Métricas de Éxito
Indicadores Operacionales
| Métrica | Target | Medición |
|---|---|---|
| Adopción de app móvil | >90% de supervisores usando MOB-003 | Porcentaje de usuarios activos |
| Tiempo de reporte de incidente | <15 minutos desde ocurrencia | Timestamp de incidente vs timestamp de reporte |
| Cumplimiento de inspecciones | >=95% | Inspecciones realizadas / Programadas |
| Tiempo de cierre de hallazgos críticos | <=48 horas | Promedio de horas desde hallazgo hasta cierre |
| Cobertura de capacitación | 100% | Trabajadores capacitados / Total trabajadores |
Indicadores de Seguridad
| Métrica | Target | Medición |
|---|---|---|
| Reducción de incidentes | -30% vs año anterior | Comparación año sobre año |
| Tasa de incidentes | <2.0 por 100K horas | (Incidentes / Horas trabajadas) × 100,000 |
| Días sin incidentes | >90 días consecutivos | Contador desde último incidente |
| Cumplimiento normativo | 100% en auditorías | Porcentaje de conformidad en auditorías STPS |
Próximos Pasos
Fase de Documentación
- README.md completado
- Crear 4 Requerimientos Funcionales (RF-SEG-001 a RF-SEG-004)
- Crear Especificaciones Técnicas
- Crear Historias de Usuario (12 US estimadas)
- Actualizar TRACEABILITY.yml
Fase de Diseño
- Diseño de base de datos detallado
- Diseño de APIs REST
- Mockups de interfaces web
- Prototipos de apps móviles
- Arquitectura de sincronización offline
Fase de Desarrollo
- Sprint 11: Gestión de EPP (4 semanas)
- Sprint 12: Inspecciones de Seguridad (5 semanas)
- Sprint 12-13: Reportes de Incidentes (4 semanas)
- Sprint 13: Capacitaciones (3 semanas)
Referencias
- Trazabilidad del módulo: TRACEABILITY.yml
- Apps móviles: EPIC-MAI-019-mobile-apps.md
- Normativas NOM-STPS: www.stps.gob.mx
- OSHA Construction Standards: www.osha.gov/construction
- Fase de módulos: ../README.md
Generado: 2025-12-06 Versión: 1.0 Estado: Completo Reutilización del Core ERP: 0% - Módulo vertical específico de construcción Mantenedores: @safety-team @mobile-team @backend-team