# 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
