workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAA-017-seguridad-hse/requerimientos/RF-MAA017-005-cumplimiento-stps.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
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
2026-01-04 03:37:42 -06:00

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

  1. Toda obra debe tener matriz de cumplimiento antes de iniciar
  2. Las constancias DC-3 deben emitirse dentro de 20 dias habiles
  3. La comision debe tener recorrido minimo mensual
  4. No conformidades criticas deben cerrarse antes de 30 dias
  5. El programa de seguridad debe actualizarse anualmente
  6. Los documentos oficiales requieren firma electronica autorizada
  7. Obras sin comision constituida no pueden operar
  8. 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:

  1. Coordinador selecciona obra a evaluar
  2. Sistema genera matriz de normas aplicables
  3. Por cada norma, sistema muestra requisitos
  4. Coordinador evalua cada requisito
  5. Coordinador adjunta evidencias disponibles
  6. Sistema calcula porcentaje de cumplimiento
  7. Sistema identifica brechas criticas
  8. Sistema genera plan de accion sugerido
  9. Coordinador asigna responsables y fechas
  10. Sistema programa alertas de seguimiento

CU-MAA017-005.2: Generar Constancia DC-3

Actor: Coordinador HSE Precondicion: Capacitacion completada, asistencia registrada

Flujo Principal:

  1. Sistema identifica capacitaciones sin constancia
  2. Coordinador selecciona capacitacion
  3. Sistema muestra lista de asistentes aprobados
  4. Coordinador selecciona trabajadores
  5. Sistema genera DC-3 con datos de NOM
  6. Sistema asigna folio consecutivo
  7. Coordinador verifica datos
  8. Sistema genera PDF en formato oficial
  9. Sistema registra emision y notifica a trabajadores

CU-MAA017-005.3: Preparar Carpeta de Auditoria

Actor: Gerente HSE Precondicion: Auditoria programada

Flujo Principal:

  1. Gerente selecciona tipo de auditoria
  2. Sistema genera checklist de documentos requeridos
  3. Sistema verifica documentos disponibles
  4. Sistema indica documentos faltantes
  5. Gerente genera acciones para completar
  6. Al completar, sistema genera carpeta digital
  7. Sistema organiza por norma/requisito
  8. Sistema genera indice navegable
  9. Sistema permite descargar carpeta completa

CU-MAA017-005.4: Registrar Recorrido de Comision

Actor: Secretario de Comision Precondicion: Comision constituida, recorrido programado

Flujo Principal:

  1. Secretario abre recorrido programado
  2. Sistema muestra formato de acta
  3. Durante recorrido, se registran areas visitadas
  4. Se registran hallazgos encontrados
  5. Se documentan recomendaciones
  6. Integrantes firman digitalmente
  7. Sistema genera acta en formato oficial
  8. Sistema programa seguimiento a recomendaciones
  9. 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