# 6. Plan de implementación por fases

## Fase 0 — Base técnica (esta entrega)

- Auditoría del módulo actual.
- Arquitectura, modelo 3FN, módulos y estructura.
- Migración SQL no destructiva.
- Configuración del algoritmo.
- Servicio de proyección y validador con prueba automática.

**Salida:** diseño revisable y código base sin alterar datos productivos.

## Fase 1 — Persistencia normalizada y compatibilidad

- Aplicar migración 069 en una copia de la base.
- Crear repositorios SIRGILA especializados.
- Crear adaptador de matriz JSON a resultados verticales.
- Ejecutar conciliación de conteos y porcentajes.
- Agregar permisos y auditoría funcional.

**Criterio de cierre:** diferencias de conteos iguales a cero para una muestra de Primaria y Secundaria.

## Fase 2 — Importación profesional

- Plantilla versionada por nivel.
- Flujo cargar → validar → previsualizar → confirmar.
- Informe de errores por hoja, fila y columna.
- Hash de archivo, límites y defensa contra ZIP bomb/fórmulas.

**Criterio de cierre:** un lote inválido no modifica la base; uno válido queda confirmado e inmutable.

## Fase 3 — Motor de metas

- Integrar `GoalProjectionService` con repositorios.
- Mostrar escenarios conservador, recomendado y desafiante.
- Edición manual, justificación, estados y versiones.
- Comparar sugerencia con meta aprobada.

**Criterio de cierre:** todas las distribuciones suman 100 y cada cambio es auditable.

## Fase 4 — Dashboard y detalle

- KPIs, filtros, matriz histórica, gráfico de evolución y alertas.
- Detalle por competencia y comparación de escenarios.
- Diseño responsivo y accesible.
- DataTable con paginación de servidor para volúmenes grandes.

**Criterio de cierre:** pantalla, PDF y XLSX coinciden para los mismos filtros.

## Fase 5 — Planes de mejora

- Generación de borradores basada en prioridad y brecha.
- CRUD de acciones, responsables, plazos, indicadores y evidencias.
- Seguimiento de avance y semáforos.

## Fase 6 — Reportes y operación

- Reportes institucionales y comparativos.
- Exportaciones por cola cuando el volumen lo requiera.
- Manual técnico, manual de usuario, respaldo y recuperación.
- Pruebas de seguridad, rendimiento y despliegue web.

## Estrategia de despliegue

1. Copia de seguridad y entorno de ensayo.
2. Migración de esquema.
3. Migración/conciliación de un año y un grado piloto.
4. Activación por feature flag para Dirección.
5. Comparación paralela con la versión actual.
6. Activación general y conservación temporal del rollback de lectura.

## Riesgos principales

| Riesgo | Mitigación |
|---|---|
| Encabezados históricos variables | Plantilla versionada y mapeo explícito |
| Competencias duplicadas o renombradas | Clave CNEB + catálogo de equivalencias |
| Datos parciales | Cobertura y confianza visibles; no ocultar faltantes |
| Diferencias por redondeo | Normalización final y prueba de suma 100 |
| Consultas pesadas | Agregados persistidos, índices y paginación |
| Ruptura del módulo actual | Adaptador, feature flag y migración no destructiva |