# 4. Módulos y flujos

## Módulos

| Módulo | Funciones |
|---|---|
| Catálogos | Niveles, grados, áreas, competencias, tipos de evaluación y periodos |
| Histórico | Plantilla, importación, validación, previsualización, confirmación y consulta |
| Análisis | KPIs, matriz, tendencias, brechas, alertas y detalle por competencia |
| Metas | Cálculo de tres escenarios, edición, justificación, aprobación y versionado |
| Plan de mejora | Acciones sugeridas/manuales, responsables, fechas, indicadores y seguimiento |
| Reportes | PDF, XLSX y consulta tabular con filtros consistentes |
| Administración | Parámetros del algoritmo, permisos y auditoría |

## Flujo de importación

```mermaid
sequenceDiagram
    actor U as Usuario autorizado
    participant W as Interfaz web
    participant I as Servicio de importación
    participant V as Validador
    participant R as Repositorio
    U->>W: Descarga plantilla
    U->>W: Selecciona XLSX
    W->>I: Carga temporal
    I->>V: Valida estructura y contenido
    V-->>W: Resumen, errores y previsualización
    U->>W: Confirma lote
    W->>R: Guarda lote y resultados en transacción
    R-->>W: Lote confirmado e inmutable
```

## Flujo de metas

```mermaid
flowchart TD
    H["Seleccionar año objetivo, nivel y grado"] --> Q["Cargar los tres años anteriores"]
    Q --> C["Validar cobertura y distribuciones"]
    C --> P["Calcular histórico ponderado, tendencia y brecha"]
    P --> S["Generar 3 escenarios"]
    S --> E["Editar sugerencia si corresponde"]
    E --> J["Registrar justificación"]
    J --> G["Guardar nueva versión"]
    G --> A{"Decisión"}
    A -->|Aprobar| AP["Meta vigente"]
    A -->|Rechazar| RE["Meta rechazada"]
    AP --> PM["Plan de mejora y seguimiento"]
```

## Reglas curriculares transversales

- Primaria permite Personal Social y bloquea DPCC/Ciencias Sociales.
- Secundaria permite DPCC/Ciencias Sociales y bloquea Personal Social.
- Castellano como Segunda Lengua queda bloqueado en todos los niveles.
- La validación se aplica en SQL de consulta, servicio de importación y construcción de reportes; no solo en la interfaz.

## IA opcional

La IA solo puede redactar interpretaciones, dificultades y acciones a partir de métricas ya calculadas. No puede modificar conteos, porcentajes, pesos, escenarios ni metas. Toda sugerencia debe presentarse como borrador editable y guardar su origen.