Sistema NEXUS v3.4 migrado con: Estructura principal: - core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles) - core/catalog: Catalogo de funcionalidades reutilizables - shared/knowledge-base: Base de conocimiento compartida - devtools/scripts: Herramientas de desarrollo - control-plane/registries: Control de servicios y CI/CD - orchestration/: Configuracion de orquestacion de agentes Proyectos incluidos (11): - gamilit (submodule -> GitHub) - trading-platform (OrbiquanTIA) - erp-suite con 5 verticales: - erp-core, construccion, vidrio-templado - mecanicas-diesel, retail, clinicas - betting-analytics - inmobiliaria-analytics - platform_marketing_content - pos-micro, erp-basico Configuracion: - .gitignore completo para Node.js/Python/Docker - gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git) - Sistema de puertos estandarizado (3005-3199) Generated with NEXUS v3.4 Migration System EPIC-010: Configuracion Git y Repositorios
15 KiB
15 KiB
RF-MAA017-005: Cumplimiento STPS
Informacion General
| Atributo | Valor |
|---|---|
| Codigo | RF-MAA017-005 |
| Nombre | Cumplimiento STPS |
| Modulo | MAA-017 Seguridad HSE |
| Prioridad | P0 - Critica |
| Complejidad | Alta |
Descripcion
El sistema debe permitir verificar, documentar y mantener el cumplimiento de las Normas Oficiales Mexicanas (NOM) de la Secretaria del Trabajo y Prevision Social (STPS) aplicables a obras de construccion. Incluye generacion de documentos oficiales, alertas de vencimiento, matriz de cumplimiento y preparacion para auditorias.
Requisitos Funcionales
RF-MAA017-005.1: Catalogo de Normas STPS
- Mantener catalogo de NOMs aplicables a construccion:
- NOM-001-STPS-2008: Edificios, locales e instalaciones
- NOM-002-STPS-2010: Prevencion y proteccion contra incendios
- NOM-004-STPS-1999: Sistemas de proteccion y dispositivos de seguridad en maquinaria
- NOM-005-STPS-1998: Manejo de sustancias quimicas peligrosas
- NOM-006-STPS-2014: Manejo y almacenamiento de materiales
- NOM-009-STPS-2011: Trabajos en altura
- NOM-011-STPS-2001: Ruido
- NOM-017-STPS-2008: Equipo de proteccion personal
- NOM-019-STPS-2011: Comisiones de seguridad e higiene
- NOM-026-STPS-2008: Senales de seguridad
- NOM-029-STPS-2011: Mantenimiento de instalaciones electricas
- NOM-030-STPS-2009: Servicios preventivos de seguridad y salud
- NOM-031-STPS-2011: Construccion
- Definir requisitos por norma
- Configurar vigencia y actualizaciones
- Vincular evidencias requeridas por requisito
RF-MAA017-005.2: Matriz de Cumplimiento por Obra
- Generar matriz de NOMs aplicables por tipo de obra
- Evaluar cumplimiento por requisito (cumple, parcial, no cumple)
- Registrar evidencias de cumplimiento
- Calcular porcentaje de cumplimiento por norma
- Identificar brechas de cumplimiento
- Priorizar acciones correctivas
- Dashboard de estado de cumplimiento
RF-MAA017-005.3: Documentos Oficiales STPS
- Generar Constancia DC-1: Habilidades laborales
- Generar Constancia DC-2: Lista de constancias
- Generar Constancia DC-3: Constancia de capacitacion
- Generar Constancia DC-4: Lista de instructores
- Generar formato ST-7: Aviso de accidente de trabajo
- Generar formato ST-9: Aviso de recaida
- Exportar en formatos oficiales (PDF/XML)
- Mantener consecutivo por tipo de documento
RF-MAA017-005.4: Comision de Seguridad e Higiene (NOM-019)
- Registrar integrantes de la comision
- Documentar acta constitutiva
- Programar recorridos mensuales
- Registrar actas de recorridos
- Dar seguimiento a recomendaciones
- Alertar sobre reuniones programadas
- Generar reportes de la comision
RF-MAA017-005.5: Programa de Seguridad (NOM-030)
- Crear programa anual de seguridad
- Definir objetivos y metas
- Programar actividades preventivas
- Asignar responsables y recursos
- Medir avance del programa
- Evaluar efectividad
- Generar informes periodicos
RF-MAA017-005.6: Alertas y Vencimientos
- Alertas de vencimiento de constancias DC-3
- Alertas de proximas reuniones de comision
- Alertas de fechas de recorridos
- Alertas de actualizaciones normativas
- Alertas de cumplimiento pendiente
- Calendario de obligaciones STPS
- Envio de notificaciones automaticas
RF-MAA017-005.7: Preparacion para Auditorias
- Checklist de documentacion por norma
- Verificar completitud de expedientes
- Generar carpeta de auditoria con documentos
- Simular auditoria STPS
- Identificar no conformidades potenciales
- Plan de accion pre-auditoria
- Historico de auditorias recibidas
Reglas de Negocio
- Toda obra debe tener matriz de cumplimiento antes de iniciar
- Las constancias DC-3 deben emitirse dentro de 20 dias habiles
- La comision debe tener recorrido minimo mensual
- No conformidades criticas deben cerrarse antes de 30 dias
- El programa de seguridad debe actualizarse anualmente
- Los documentos oficiales requieren firma electronica autorizada
- Obras sin comision constituida no pueden operar
- Auditorias simuladas deben realizarse trimestralmente
Criterios de Aceptacion
- Catalogo incluye las 13 NOMs principales de construccion
- Matriz de cumplimiento calcula porcentajes automaticamente
- Constancias DC-3 se generan en formato oficial
- Formato ST-7 cumple especificaciones IMSS
- Alertas se envian 30 dias antes de vencimientos
- Dashboard muestra estado de cumplimiento en tiempo real
- Comision tiene calendario de recorridos automatizado
- Sistema genera carpeta de auditoria con un clic
Modelo de Datos
Tabla: hse.normas_stps
- id: UUID PK
- codigo: VARCHAR(30) UNIQUE
- nombre: VARCHAR(300)
- descripcion: TEXT
- fecha_publicacion: DATE
- ultima_actualizacion: DATE
- aplica_construccion: BOOLEAN DEFAULT true
- documento_url: VARCHAR(500)
- activo: BOOLEAN DEFAULT true
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.norma_requisitos
- id: UUID PK
- norma_id: UUID FK (hse.normas_stps)
- numero: VARCHAR(20)
- descripcion: TEXT
- tipo_evidencia: VARCHAR(200)
- es_critico: BOOLEAN DEFAULT false
- aplica_a: VARCHAR(100)
- created_at: TIMESTAMPTZ
Tabla: hse.cumplimiento_obra
- id: UUID PK
- tenant_id: UUID FK
- fraccionamiento_id: UUID FK
- norma_id: UUID FK
- requisito_id: UUID FK
- estado: ENUM(cumple, parcial, no_cumple, no_aplica)
- evidencia_url: VARCHAR(500)
- observaciones: TEXT
- fecha_evaluacion: DATE
- evaluador_id: UUID FK
- fecha_compromiso: DATE
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.comision_seguridad
- id: UUID PK
- tenant_id: UUID FK
- fraccionamiento_id: UUID FK
- fecha_constitucion: DATE
- numero_acta: VARCHAR(50)
- vigencia_inicio: DATE
- vigencia_fin: DATE
- estado: ENUM(activa, vencida, renovada)
- documento_acta_url: VARCHAR(500)
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.comision_integrantes
- id: UUID PK
- comision_id: UUID FK
- employee_id: UUID FK
- rol: ENUM(presidente, secretario, vocal_patronal, vocal_trabajador)
- representacion: ENUM(patronal, trabajadores)
- fecha_nombramiento: DATE
- activo: BOOLEAN DEFAULT true
- created_at: TIMESTAMPTZ
Tabla: hse.comision_recorridos
- id: UUID PK
- comision_id: UUID FK
- fecha_programada: DATE
- fecha_realizada: DATE
- numero_acta: VARCHAR(50)
- areas_recorridas: TEXT
- hallazgos: TEXT
- recomendaciones: TEXT
- estado: ENUM(programado, realizado, cancelado, pendiente)
- documento_acta_url: VARCHAR(500)
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.programa_seguridad
- id: UUID PK
- tenant_id: UUID FK
- fraccionamiento_id: UUID FK
- anio: INTEGER
- objetivo_general: TEXT
- metas: JSONB
- presupuesto: DECIMAL(12,2)
- estado: ENUM(borrador, activo, finalizado)
- aprobado_por: UUID FK
- fecha_aprobacion: DATE
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.programa_actividades
- id: UUID PK
- programa_id: UUID FK
- actividad: VARCHAR(300)
- tipo: ENUM(capacitacion, inspeccion, simulacro, campana, otro)
- fecha_programada: DATE
- fecha_realizada: DATE
- responsable_id: UUID FK
- recursos: TEXT
- estado: ENUM(pendiente, en_progreso, completada, cancelada)
- evidencia_url: VARCHAR(500)
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Tabla: hse.documentos_stps
- id: UUID PK
- tenant_id: UUID FK
- tipo: ENUM(dc1, dc2, dc3, dc4, st7, st9)
- folio: VARCHAR(30) UNIQUE
- fraccionamiento_id: UUID FK
- employee_id: UUID FK (nullable)
- fecha_emision: DATE
- fecha_vencimiento: DATE
- datos_documento: JSONB
- documento_url: VARCHAR(500)
- firmado: BOOLEAN DEFAULT false
- created_at: TIMESTAMPTZ
- created_by: UUID FK
Tabla: hse.auditorias
- id: UUID PK
- tenant_id: UUID FK
- fraccionamiento_id: UUID FK
- tipo: ENUM(interna, simulada, stps, cliente, certificadora)
- fecha_programada: DATE
- fecha_realizada: DATE
- auditor: VARCHAR(200)
- resultado: ENUM(aprobada, aprobada_observaciones, no_aprobada)
- no_conformidades: INTEGER
- observaciones: TEXT
- informe_url: VARCHAR(500)
- created_at: TIMESTAMPTZ
- updated_at: TIMESTAMPTZ
Casos de Uso
CU-MAA017-005.1: Evaluar Cumplimiento Normativo
Actor: Coordinador HSE Precondicion: Obra activa, normas configuradas
Flujo Principal:
- Coordinador selecciona obra a evaluar
- Sistema genera matriz de normas aplicables
- Por cada norma, sistema muestra requisitos
- Coordinador evalua cada requisito
- Coordinador adjunta evidencias disponibles
- Sistema calcula porcentaje de cumplimiento
- Sistema identifica brechas criticas
- Sistema genera plan de accion sugerido
- Coordinador asigna responsables y fechas
- Sistema programa alertas de seguimiento
CU-MAA017-005.2: Generar Constancia DC-3
Actor: Coordinador HSE Precondicion: Capacitacion completada, asistencia registrada
Flujo Principal:
- Sistema identifica capacitaciones sin constancia
- Coordinador selecciona capacitacion
- Sistema muestra lista de asistentes aprobados
- Coordinador selecciona trabajadores
- Sistema genera DC-3 con datos de NOM
- Sistema asigna folio consecutivo
- Coordinador verifica datos
- Sistema genera PDF en formato oficial
- Sistema registra emision y notifica a trabajadores
CU-MAA017-005.3: Preparar Carpeta de Auditoria
Actor: Gerente HSE Precondicion: Auditoria programada
Flujo Principal:
- Gerente selecciona tipo de auditoria
- Sistema genera checklist de documentos requeridos
- Sistema verifica documentos disponibles
- Sistema indica documentos faltantes
- Gerente genera acciones para completar
- Al completar, sistema genera carpeta digital
- Sistema organiza por norma/requisito
- Sistema genera indice navegable
- Sistema permite descargar carpeta completa
CU-MAA017-005.4: Registrar Recorrido de Comision
Actor: Secretario de Comision Precondicion: Comision constituida, recorrido programado
Flujo Principal:
- Secretario abre recorrido programado
- Sistema muestra formato de acta
- Durante recorrido, se registran areas visitadas
- Se registran hallazgos encontrados
- Se documentan recomendaciones
- Integrantes firman digitalmente
- Sistema genera acta en formato oficial
- Sistema programa seguimiento a recomendaciones
- Sistema actualiza calendario de comision
Mockups
Pantalla: Matriz de Cumplimiento
+--------------------------------------------------+
| MATRIZ DE CUMPLIMIENTO NORMATIVO |
| Obra: Residencial Norte |
+--------------------------------------------------+
| Cumplimiento General: 78% |
| ████████████████░░░░░░ |
+--------------------------------------------------+
| NORMA | REQUISITOS | CUMPLIMIENTO |
+--------------------------------------------------+
| NOM-009-STPS-2011 | 15/18 | 83% ████░ |
| Trabajos en altura| | |
+--------------------------------------------------+
| NOM-017-STPS-2008 | 12/12 | 100% █████ |
| EPP | | |
+--------------------------------------------------+
| NOM-031-STPS-2011 | 20/28 | 71% ███░░ |
| Construccion | | |
+--------------------------------------------------+
| NOM-019-STPS-2011 | 8/10 | 80% ████░ |
| Comision S&H | | |
+--------------------------------------------------+
| [Ver Brechas] [Generar Plan] [Exportar] |
+--------------------------------------------------+
Pantalla: Generacion DC-3
+--------------------------------------------------+
| GENERAR CONSTANCIAS DC-3 |
+--------------------------------------------------+
| Capacitacion: Trabajos en Altura |
| Fecha: 15-Dic-2024 |
| Duracion: 8 horas |
| Norma: NOM-009-STPS-2011 |
+--------------------------------------------------+
| SELECCIONAR TRABAJADORES APROBADOS: |
+--------------------------------------------------+
| [✓] Juan Perez Martinez | Calif: 90 |
| [✓] Maria Garcia Lopez | Calif: 85 |
| [✓] Pedro Sanchez Ruiz | Calif: 88 |
| [ ] Carlos Hernandez (Reprobado) | Calif: 55 |
+--------------------------------------------------+
| Instructor: Ing. Roberto Mendez |
| Registro STPS: MERA-850612-TRB-0013 |
+--------------------------------------------------+
| Vista previa DC-3: |
| +--------------------------------------------+ |
| | CONSTANCIA DE HABILIDADES LABORALES DC-3 | |
| | Folio: DC3-2025-0089 | |
| | [Vista previa del formato oficial] | |
| +--------------------------------------------+ |
+--------------------------------------------------+
| [Cancelar] [Generar 3 Constancias] |
+--------------------------------------------------+
Pantalla: Comision de Seguridad
+--------------------------------------------------+
| COMISION DE SEGURIDAD E HIGIENE |
| Obra: Residencial Norte |
+--------------------------------------------------+
| Estado: ACTIVA Vigencia: Ene-2025 a Dic-2025 |
| Acta Constitutiva: CSH-2025-001 |
+--------------------------------------------------+
| INTEGRANTES |
+--------------------------------------------------+
| Representantes Patronales: |
| Presidente: Ing. Carlos Mendez |
| Secretario: Lic. Ana Torres |
| |
| Representantes Trabajadores: |
| Vocal: Juan Perez Martinez |
| Vocal: Maria Garcia Lopez |
+--------------------------------------------------+
| CALENDARIO DE RECORRIDOS 2025 |
+--------------------------------------------------+
| Mes | Fecha | Estado | Acta |
+--------------------------------------------------+
| Enero | 15-Ene | Completado | ACT-001 |
| Febrero | 15-Feb | Programado | - |
| Marzo | 15-Mar | Programado | - |
+--------------------------------------------------+
| RECOMENDACIONES PENDIENTES: 3 |
| [Ver Detalle] |
+--------------------------------------------------+
| [Nuevo Recorrido] [Renovar Comision] |
+--------------------------------------------------+
Especificaciones Tecnicas Relacionadas
- ET-MAA017-DB-001: Schema HSE Database
- ET-MAA017-BE-006: STPS Compliance Service
- ET-MAA017-BE-007: Document Generation Service
- ET-MAA017-FE-010: Compliance Matrix View
- ET-MAA017-FE-011: DC3 Generator
- ET-MAA017-FE-012: Commission Management
User Stories Relacionadas
- US-MAA017-007: Generar reporte STPS
- US-MAA017-017: Evaluar cumplimiento normativo
- US-MAA017-018: Constituir comision de seguridad
- US-MAA017-019: Registrar recorrido de comision
- US-MAA017-020: Preparar auditoria STPS
Integraciones
Internas
- RF-MAA017-002: Vincular capacitaciones para DC-3
- RF-MAA017-003: Vincular inspecciones a requisitos normativos
- RF-MAA017-004: Vincular EPP a NOM-017
Externas
- STPS: Formatos oficiales DC-1 a DC-4
- IMSS: Formatos ST-7, ST-9
Autor: Requirements-Analyst Fecha: 2025-12-06 Version: 1.0.0