# EPICA: EPIC-MAI-011 - INFONAVIT Cumplimiento

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MAI-011 |
| **Nombre** | INFONAVIT Cumplimiento Normativo |
| **Modulo** | infonavit-cumplimiento |
| **Fase** | Fase 1 - Alcance Inicial |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 6-8 |

---

## Descripcion

Sistema de gestion de cumplimiento para programas de vivienda INFONAVIT. Incluye registro de proyectos en programas (Cerrando Fronteras, Linea III, etc.), checklists de requisitos normativos, gestion de evidencias documentales, seguimiento de auditorias y generacion de reportes para cumplimiento.

---

## Objetivo de Negocio

Asegurar cumplimiento INFONAVIT que:
- Registre proyectos en programas vigentes
- Gestione requisitos por normativa
- Documente evidencias por requisito
- Rastree visitas de verificacion
- Genere reportes para auditorias
- Alerte sobre vencimientos

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MAI011-001 | Como admin, quiero registrar proyecto bajo programa INFONAVIT | P0 | 5 | Backlog |
| US-MAI011-002 | Como admin, quiero configurar checklist de requisitos por programa | P0 | 8 | Backlog |
| US-MAI011-003 | Como residente, quiero cargar evidencias por requisito | P0 | 5 | Backlog |
| US-MAI011-004 | Como admin, quiero registrar visitas de verificacion | P0 | 5 | Backlog |
| US-MAI011-005 | Como residente, quiero gestionar observaciones de visita | P0 | 5 | Backlog |
| US-MAI011-006 | Como director, quiero generar reporte de cumplimiento | P0 | 5 | Backlog |
| US-MAI011-007 | Como director, quiero ver dashboard de cumplimiento | P1 | 5 | Backlog |
| US-MAI011-008 | Como sistema, quiero alertar sobre requisitos por vencer | P1 | 3 | Backlog |

**Total Story Points:** 41 SP (ajustado a 42)

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Catalogo de programas INFONAVIT vigentes
- [ ] Registro de proyecto en programa(s)
- [ ] Checklist dinamico por programa/normativa
- [ ] Repositorio de evidencias por requisito
- [ ] Workflow: Pendiente -> En revision -> Aprobado
- [ ] Registro de visitas con observaciones
- [ ] Reportes de cumplimiento (% por programa)
- [ ] Alertas de vencimiento

**No Funcionales:**
- [ ] Cumplimiento 100% con requerimientos INFONAVIT
- [ ] Trazabilidad completa de evidencias

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MAI-001 Fundamentos | Backlog | Si |
| EPIC-MAI-002 Proyectos | Backlog | Si |
| EPIC-MAI-005 Control Obra | Backlog | No |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `infonavit_management`
- [ ] Tablas: 10 (programs, program_requirements, project_programs, compliance_items, evidences, audits, audit_observations, requirement_status)

**Backend:**
- [ ] Modulo: `infonavit`
- [ ] Entities: 10
- [ ] Endpoints: 20+
- [ ] Tests: 30+

**Frontend:**
- [ ] Paginas: 6 (Programs, Compliance, Evidences, Audits, Reports, Dashboard)
- [ ] Componentes: ChecklistView, EvidenceUploader, AuditTimeline
- [ ] Stores: 1 (infonavitStore)

---

## Programas INFONAVIT Soportados

| Programa | Codigo | Requisitos |
|----------|--------|------------|
| Cerrando Fronteras | CF | 45+ requisitos |
| Linea III | L3 | 30+ requisitos |
| Mejorasi | MEJ | 25+ requisitos |
| Unamos Creditos | UC | 35+ requisitos |

---

## Estados de Requisito

| Estado | Descripcion |
|--------|-------------|
| Pendiente | Sin evidencia cargada |
| En Revision | Evidencia cargada, pendiente validar |
| Observado | Con observaciones de auditoria |
| Aprobado | Cumplimiento verificado |
| NA | No aplica para este proyecto |

---

**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-05
