workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAI-011-infonavit-cumplimiento/_MAP.md

_MAP: MAI-011 - INFONAVIT & Cumplimiento

Épica: MAI-011 Nombre: INFONAVIT & Cumplimiento Fase: 1 - Alcance Inicial Presupuesto: $25,000 MXN Story Points: 40 SP Estado: 📝 A crear Sprint: Sprint 6 (Semanas 11-12) Última actualización: 2025-11-17 Prioridad: P1

---

📋 Propósito

Gestión de cumplimiento normativo y requisitos específicos de INFONAVIT y otros organismos:

• Registro del proyecto bajo programas específicos de INFONAVIT
• Checklists de requisitos técnicos, urbanos y de servicios
• Evidencias documentales, fotográficas y de auditorías
• Reportes para verificadores/auditores externos
• Seguimiento de certificaciones y normativas

Integración clave: Se vincula con Proyectos (MAI-002), Calidad (MAI-009), Gestión Documental (MAE-016) y CRM (MAI-010).

---

📁 Contenido

Requerimientos Funcionales (Estimados: 5)

ID	Título	Estado
RF-INF-001	Registro de proyecto bajo programas INFONAVIT	📝 A crear
RF-INF-002	Checklists de cumplimiento normativo y técnico	📝 A crear
RF-INF-003	Gestión de evidencias y documentación	📝 A crear
RF-INF-004	Seguimiento de auditorías y verificaciones	📝 A crear
RF-INF-005	Reportes de cumplimiento para organismos	📝 A crear

Especificaciones Técnicas (Estimadas: 5)

ID	Título	RF	Estado
ET-INF-001	Modelo de datos de programas y requisitos	RF-INF-001	📝 A crear
ET-INF-002	Sistema de checklists dinámicos	RF-INF-002	📝 A crear
ET-INF-003	Repositorio de evidencias vinculado a requisitos	RF-INF-003	📝 A crear
ET-INF-004	Workflow de auditorías y observaciones	RF-INF-004	📝 A crear
ET-INF-005	Generación automática de reportes	RF-INF-005	📝 A crear

Historias de Usuario (Estimadas: 8)

ID	Título	SP	Estado
US-INF-001	Registrar proyecto bajo programa INFONAVIT	5	📝 A crear
US-INF-002	Configurar checklist de requisitos aplicables	5	📝 A crear
US-INF-003	Cargar evidencias por requisito	5	📝 A crear
US-INF-004	Registrar visita de verificador	5	📝 A crear
US-INF-005	Gestionar observaciones y acciones correctivas	5	📝 A crear
US-INF-006	Generar reporte de cumplimiento	5	📝 A crear
US-INF-007	Dashboard de estatus de cumplimiento	5	📝 A crear
US-INF-008	Exportar paquete de evidencias para auditoría	5	📝 A crear

Total Story Points: 40 SP

Implementación

📊 Inventarios de trazabilidad:

• TRACEABILITY.yml - Matriz completa de trazabilidad
• DATABASE.yml - Objetos de base de datos
• BACKEND.yml - Módulos backend
• FRONTEND.yml - Componentes frontend

Pruebas

📋 Documentación de testing:

• TEST-PLAN.md - Plan de pruebas
• TEST-CASES.md - Casos de prueba

---

🔗 Referencias

• README: README.md - Descripción detallada de la épica
• Fase 1: ../README.md - Información de la fase completa
• Módulo relacionado MVP: Módulo 11 - INFONAVIT & Cumplimiento (MVP-APP.md)

---

📊 Métricas

Métrica	Valor
Presupuesto estimado	$25,000 MXN
Story Points estimados	40 SP
Duración estimada	8 días
Reutilización GAMILIT	25% (checklists y evidencias similares)
RF a implementar	5/5
ET a implementar	5/5
US a completar	8/8

---

🎯 Módulos Afectados

Base de Datos

• Schema: compliance
• Tablas principales:
  • infonavit_programs - Programas INFONAVIT (EVC, tradicional, etc.)
  • project_compliance - Relación proyecto-programa
  • compliance_requirements - Requisitos por programa
  • compliance_checklists - Checklists de cumplimiento
  • compliance_evidence - Evidencias documentales
  • audits - Auditorías y verificaciones
  • audit_findings - Hallazgos y observaciones
  • corrective_actions - Acciones correctivas
• ENUMs:
  • program_type (evc, traditional, cofinavit, infonavit_total)
  • requirement_category (technical, urban, services, legal, environmental)
  • requirement_status (pending, in_progress, compliant, non_compliant, not_applicable)
  • audit_type (initial, progress, final, special, random)
  • audit_status (scheduled, in_progress, completed, follow_up)
  • finding_severity (minor, major, critical)

Backend

• Módulo: compliance, infonavit
• Path: apps/backend/src/modules/compliance/
• Services: ComplianceService, AuditService, EvidenceService, InfonavitIntegrationService
• Controllers: ComplianceController, AuditController, ReportController
• Middlewares: ComplianceAccessGuard, AuditTrailMiddleware

Frontend

• Features: compliance, infonavit, audits
• Path: apps/frontend/src/features/compliance/
• Componentes:
  • ProgramSelector
  • ComplianceChecklist
  • EvidenceUploader
  • AuditScheduler
  • AuditReportViewer
  • FindingsManager
  • CorrectiveActionTracker
  • ComplianceDashboard
  • ReportGenerator
• Stores: complianceStore, auditStore, evidenceStore

---

🏢 Programas INFONAVIT

Tipos de Programas

Programa	Descripción	Características	Requisitos especiales
EVC	Esquemas de Valor Compartido	Vivienda nueva o usada con mejoras	Certificación de calidad, sustentabilidad
Tradicional	Crédito tradicional	Vivienda nueva	Cumplimiento básico de normativa
Cofinavit	Crédito mixto INFONAVIT + bancario	Vivienda nueva o usada	Evaluación dual
INFONAVIT Total	Crédito con subsidio	Vivienda económica	Requisitos adicionales de subsidio
Apoyo INFONAVIT	Solo subsidio (sin crédito)	Vivienda mínima	Estándares mínimos

---

✅ Categorías de Requisitos

1. Requisitos Técnicos

Categoría: Diseño y construcción de vivienda

• Superficies mínimas:

  • Superficie construida mínima (38-58 m² según tipo)
  • Superficie de recámaras (7 m² mínimo)
  • Altura mínima de entrepisos (2.30-2.50 m)
  • Dimensiones de vanos y puertas

• Instalaciones:

  • Sistema eléctrico (CFE, centro de carga)
  • Sistema hidráulico (tomas, tinaco, boiler)
  • Sistema sanitario (drenaje, fosas, registros)
  • Gas (instalación certificada)

• Acabados:

  • Pisos (firme, loseta, según programa)
  • Muros (aplanado, pintura)
  • Cancelería (ventanas, puertas)
  • Muebles de cocina y baño

• Estructural:

  • Cimentación adecuada al tipo de suelo
  • Estructura sismorresistente
  • Materiales certificados
  • Normas técnicas complementarias (NTC)

Evidencias requeridas:

• Planos arquitectónicos
• Planos de instalaciones
• Memorias de cálculo estructural
• Especificaciones técnicas
• Bitácora de obra
• Pruebas de laboratorio

---

2. Requisitos Urbanos

Categoría: Ubicación e infraestructura urbana

• Ubicación:

  • Distancia a fuentes de empleo (<30 km)
  • Distancia a servicios (escuelas, salud, comercio)
  • Accesibilidad (transporte público)
  • Uso de suelo habitacional

• Infraestructura:

  • Red de agua potable (toma domiciliaria)
  • Red de drenaje sanitario
  • Red eléctrica (acometida CFE)
  • Alumbrado público
  • Pavimentación
  • Banquetas y guarniciones

• Servicios:

  • Recolección de basura
  • Seguridad pública (policía)
  • Transporte público (a menos de 500 m)

• Equipamiento:

  • Áreas verdes (% mínimo del desarrollo)
  • Espacios deportivos
  • Áreas de juegos infantiles
  • Estacionamientos (cajones mínimos)

Evidencias requeridas:

• Constancia de uso de suelo
• Contratos de servicios (agua, CFE)
• Planos de urbanización
• Fotografías de infraestructura
• Certificados de obras inducidas

---

3. Requisitos de Servicios

Categoría: Disponibilidad de servicios básicos

• Agua potable:

  • Contrato con organismo operador
  • Toma domiciliaria por vivienda
  • Presión mínima (1.5 kg/cm²)
  • Calidad del agua (NOM-127)

• Drenaje:

  • Conexión a red municipal o planta tratamiento
  • Diámetro mínimo de tuberías
  • Pendientes adecuadas
  • Registros de inspección

• Electricidad:

  • Acometida CFE por vivienda
  • Medidor individual
  • Capacidad mínima (110V, 60Hz)
  • Centro de carga de 4-8 circuitos

• Telecomunicaciones:

  • Disponibilidad de telefonía (opcional según programa)
  • Infraestructura para internet/TV

Evidencias requeridas:

• Contratos de servicios
• Dictámenes técnicos
• Certificados de CFE, agua potable
• Fotografías de instalaciones

---

4. Requisitos Legales

Categoría: Documentación y permisos

• Terreno:

  • Escritura del terreno
  • Certificado de libertad de gravamen
  • Deslinde y levantamiento topográfico
  • Estudio de mecánica de suelos

• Permisos:

  • Licencia de construcción
  • Manifesto de obra ante IMSS
  • Permisos ambientales (si aplica)
  • Autorización de impacto vial (si aplica)

• Desarrollo:

  • Acta constitutiva de régimen de propiedad en condominio
  • Reglamento de condominio
  • Planos autorizados por autoridad municipal
  • No adeudo de predial

• Vivienda:

  • Aviso de terminación de obra
  • Certificado de habitabilidad
  • Certificado de calidad (verificadora autorizada)
  • Póliza de garantía

Evidencias requeridas:

• Copias certificadas de escrituras
• Licencias y permisos vigentes
• Actas y reglamentos
• Certificados oficiales

---

5. Requisitos Ambientales

Categoría: Sustentabilidad y medio ambiente

• Sustentabilidad:

  • Uso eficiente de agua (WC ahorradores, regaderas eco)
  • Iluminación eficiente (LED, focos ahorradores)
  • Orientación solar adecuada
  • Aislamiento térmico
  • Ventilación natural

• Gestión de residuos:

  • Plan de manejo de residuos de construcción
  • Reciclaje de materiales
  • Disposición final adecuada

• Áreas verdes:

  • Mínimo 10-15% del terreno
  • Especies nativas
  • Sistema de riego eficiente

Evidencias requeridas:

• Certificación de sustentabilidad (EDGE, LEED, etc.) si aplica
• Facturas de dispositivos ahorradores
• Plan de manejo de residuos
• Fotografías de áreas verdes

---

📋 Checklists de Cumplimiento

Estructura de Checklist

checklist:
  program: "EVC"
  project_id: "UUID"
  category: "technical"
  requirements:
    - id: "REQ-TEC-001"
      description: "Superficie construida mínima 38 m²"
      status: "compliant"
      evidence_ids: ["EVD-001", "EVD-002"]
      verified_by: "Ing. Juan Pérez"
      verified_date: "2025-11-10"
      notes: "Vivienda tipo A: 42 m²"

    - id: "REQ-TEC-002"
      description: "Altura mínima de entrepiso 2.30 m"
      status: "compliant"
      evidence_ids: ["EVD-003"]
      verified_by: "Ing. Juan Pérez"
      verified_date: "2025-11-10"
      notes: "Altura verificada: 2.40 m"

    - id: "REQ-TEC-003"
      description: "Sistema eléctrico con centro de carga de 4 circuitos mínimo"
      status: "in_progress"
      evidence_ids: []
      verified_by: null
      verified_date: null
      notes: "Pendiente instalación"

Dashboard de Cumplimiento

Indicadores:

Categoría	Total requisitos	Cumplidos	En proceso	No cumple	% Cumplimiento
Técnicos	25	20	4	1	80%
Urbanos	15	12	3	0	80%
Servicios	10	8	2	0	80%
Legales	12	10	2	0	83%
Ambientales	8	6	2	0	75%
TOTAL	70	56	13	1	80%

Semáforo:

• 🟢 Verde: ≥90% cumplimiento
• 🟡 Amarillo: 75-89% cumplimiento
• 🔴 Rojo: <75% cumplimiento

---

📸 Gestión de Evidencias

Tipos de Evidencias

1. Documentos:

   • PDFs de licencias, permisos, contratos
   • Planos arquitectónicos, estructurales, instalaciones
   • Memorias de cálculo
   • Certificados y dictámenes

2. Fotografías:

   • Avances de obra por etapa constructiva
   • Detalles de instalaciones
   • Acabados
   • Infraestructura urbana
   • Equipamiento

3. Videos:

   • Recorridos virtuales del desarrollo
   • Procesos constructivos especiales
   • Pruebas de instalaciones

4. Datos estructurados:

   • Resultados de pruebas de laboratorio
   • Mediciones de superficies
   • Certificados de calibración

---

Organización de Evidencias

Proyecto Los Pinos - EVC
├── 01-Requisitos Técnicos
│   ├── Planos
│   │   ├── Arquitectónicos
│   │   ├── Estructurales
│   │   └── Instalaciones
│   ├── Memorias de cálculo
│   ├── Especificaciones técnicas
│   └── Fotografías de construcción
│       ├── Cimentación
│       ├── Estructura
│       ├── Instalaciones
│       └── Acabados
├── 02-Requisitos Urbanos
│   ├── Planos de urbanización
│   ├── Fotografías de infraestructura
│   └── Licencias y permisos
├── 03-Requisitos de Servicios
│   ├── Contratos de servicios
│   ├── Dictámenes técnicos
│   └── Certificados
├── 04-Requisitos Legales
│   ├── Escrituras
│   ├── Permisos de construcción
│   └── Certificaciones
└── 05-Requisitos Ambientales
    ├── Plan de manejo de residuos
    ├── Certificaciones de sustentabilidad
    └── Fotografías de áreas verdes

---

🔍 Auditorías y Verificaciones

Tipos de Auditorías

Tipo	Momento	Alcance	Duración típica
Inicial	Al inicio del proyecto	Terreno, permisos, diseño	1 día
Avance	Durante construcción	Avance físico, calidad, cumplimiento	1-2 días
Final	Al término de obra	Verificación integral, entregables	2-3 días
Especial	Por solicitud	Tema específico (queja, incidente)	Variable
Aleatoria	Sin previo aviso	Muestra representativa	1 día

---

Flujo de Auditoría

graph TD
    A[Notificación de auditoría] --> B[Preparación de evidencias]
    B --> C[Visita de verificador]
    C --> D[Inspección física]
    C --> E[Revisión documental]
    D --> F[Hallazgos y observaciones]
    E --> F
    F --> G{¿Hay no conformidades?}
    G -->|Sí| H[Plan de acciones correctivas]
    G -->|No| I[Dictamen favorable]
    H --> J[Implementación de correcciones]
    J --> K[Seguimiento]
    K --> L[Cierre de hallazgos]
    L --> I

---

Hallazgos y Observaciones

Clasificación por severidad:

Severidad	Descripción	Acción requerida	Plazo típico
Menor	Desviación sin impacto significativo	Corrección	30 días
Mayor	Desviación con impacto en cumplimiento	Corrección + plan de prevención	15 días
Crítica	Incumplimiento grave	Corrección inmediata + auditoría de seguimiento	7 días

Ejemplo de hallazgo:

finding:
  id: "FIND-2025-001"
  audit_id: "AUD-2025-001"
  date: "2025-11-15"
  category: "technical"
  requirement_id: "REQ-TEC-015"
  description: "Falta instalación de cancelería en 5 viviendas de muestra"
  severity: "major"
  evidence: ["PHOTO-001", "PHOTO-002"]
  responsible: "Contratista XYZ"
  corrective_action:
    description: "Instalación de cancelería faltante"
    deadline: "2025-11-30"
    assigned_to: "Ing. María López"
    status: "in_progress"
  follow_up_date: "2025-12-01"
  resolution_date: null
  resolution_notes: null

---

📊 Reportes de Cumplimiento

Tipos de Reportes

1. Reporte de estatus general:

   • % de cumplimiento por categoría
   • Requisitos pendientes
   • Evidencias faltantes
   • Próximas auditorías

2. Reporte para auditoría:

   • Checklist completo con evidencias
   • Historial de auditorías previas
   • Hallazgos cerrados
   • Acciones correctivas implementadas

3. Reporte ejecutivo:

   • KPIs principales
   • Semáforo de cumplimiento
   • Riesgos identificados
   • Plan de acción

4. Paquete de entrega:

   • Todos los documentos y evidencias organizadas
   • Certificados de calidad
   • Dictámenes de verificadoras
   • Manual de operación y mantenimiento

---

Exportación de Evidencias

Formato de entrega:

• Carpeta comprimida (.zip)
• Estructura organizada por categorías
• Índice de documentos (Excel/PDF)
• Checklist de cumplimiento firmado
• Certificaciones y dictámenes

Contenido típico (500-1000 archivos):

• 200-300 documentos PDF
• 300-500 fotografías
• 10-20 videos
• 50-100 planos
• 20-30 certificados

---

🚨 Puntos Críticos

1. Completitud de evidencias: No iniciar auditoría sin evidencias completas
2. Organización: Sistema de archivos claro y accesible
3. Vigencia de documentos: Verificar que permisos y certificados estén vigentes
4. Trazabilidad: Vincular cada evidencia a requisito específico
5. Acciones correctivas oportunas: Cerrar hallazgos dentro de plazo
6. Actualización continua: Agregar evidencias conforme avanza la obra
7. Backup de evidencias: No perder información crítica

---

🎯 Siguiente Paso

Crear documentación de requerimientos y especificaciones técnicas del módulo.

---

Generado: 2025-11-17 Mantenedores: @tech-lead @backend-team @frontend-team @compliance-team Estado: 📝 A crear