# 16 — Recomendaciones *(Entregable P)*

> **Ninguna recomendación de este documento es un requisito.** Son mejoras que el equipo considera valiosas,
> con su costo estimado y su beneficio, para que el colegio decida cuáles adoptar. Si no se aprueban, el sistema
> especificado se construye igual y completo.
>
> Costo: **⚪ bajo** (horas) · **🟡 medio** (días) · **🔴 alto** (semanas)

---

# Nivel 1 — Fuertemente recomendadas

*El equipo considera que estas cinco deberían adoptarse. Su ausencia genera problemas concretos y previsibles.*

## REC-01 · Exigir PHP 8.2 como versión mínima
**Costo:** ⚪ · **Beneficio:** Crítico

Ver [RG-01](00-hallazgos-y-decisiones.md#rg-01--php-80-está-fuera-de-soporte-de-seguridad--crítico). PHP 8.0 no
recibe parches de seguridad. Subir el piso no cuesta nada, está disponible en cualquier hosting actual y no cambia
una línea de la arquitectura. **Es la recomendación con mejor relación beneficio/costo de todo el documento.**

## REC-02 · Separar Grado de Curso en el modelo de datos
**Costo:** ⚪ (ahora) · 🔴 (si se hace después) · **Beneficio:** Alto

Ver [DP-09](00-hallazgos-y-decisiones.md#dp-09--el-modelo-confunde-grado-con-curso--y-eso-rompe-la-promoción).
Sin esta separación, la sugerencia automática de promoción —el mayor ahorro operativo del sistema— **no se puede
construir**, los cursos se ordenan alfabéticamente en todos los reportes, y no hay agrupación por nivel educativo.

Añadirlo ahora es una entidad más. Añadirlo después obliga a migrar todos los cursos y todas las matrículas.

## REC-03 · Bloqueo progresivo por intentos fallidos
**Costo:** ⚪ · **Beneficio:** Crítico

Ver [DP-08](00-hallazgos-y-decisiones.md#dp-08--la-política-de-contraseñas-tiene-un-riesgo-de-seguridad-real).
Sin este control, la política de contraseñas especificada es vulnerable a fuerza bruta en minutos. Es
aproximadamente medio día de desarrollo y neutraliza el riesgo por completo.

## REC-04 · Importador masivo de estudiantes y acudientes
**Costo:** 🟡 · **Beneficio:** Muy alto en la puesta en marcha

No está en la especificación, pero define la viabilidad del arranque. Sin importador, poner en marcha el sistema
significa digitar manualmente 800 estudiantes con sus acudientes: entre 6 y 8 semanas de trabajo de secretaría.
Con importador: una tarde de preparación del archivo y una carga validada.

**Debe incluir validación previa con reporte fila por fila** — un importador que inserta primero y falla después
es peor que no tenerlo.

## REC-05 · Copias de seguridad automáticas con prueba de restauración
**Costo:** ⚪ · **Beneficio:** Crítico

El histórico académico de un colegio es irreemplazable y la especificación no menciona respaldos. La parte
importante no es configurar el respaldo, sino **probar la restauración periódicamente**: un respaldo que nunca se
ha restaurado no se puede considerar un respaldo.

---

# Nivel 2 — Recomendadas

*Aportan valor claro con costo contenido.*

## REC-06 · Reporte de cumplimiento de registro por docente
**Costo:** ⚪ · **Beneficio:** Alto

Alimenta el bloque de avance del dashboard del Coordinador. Responde a la pregunta que se hace todos los días de
la última semana de periodo: *¿quién me falta?* Hoy esa respuesta se obtiene llamando por teléfono.

## REC-07 · Botón "Recordar" en el panel de pendientes
**Costo:** ⚪ · **Beneficio:** Medio

Genera un comunicado dirigido al docente con el detalle de sus notas pendientes. Reutiliza el módulo de
comunicados ya construido. Convierte una llamada telefónica en un clic.

## REC-08 · Reporte de integridad de datos
**Costo:** ⚪ · **Beneficio:** Alto

Detecta: estudiantes sin acudiente, asignaturas sin docente, cursos sin director, estudiantes sin notas en un
periodo cerrado. Barato de construir y evita descubrir estos problemas el día de la entrega de boletines.

## REC-09 · Catálogo oficial de departamentos y municipios
**Costo:** ⚪ · **Beneficio:** Medio

Cargar el catálogo DANE en la instalación elimina de raíz el problema de tener "Bogotá", "BOGOTA D.C." y "bogota"
como tres municipios distintos en los reportes oficiales.

## REC-10 · Entidad Sede desde la versión 1
**Costo:** ⚪ · **Beneficio:** Medio

Muchos colegios tienen sede principal y sedes anexas bajo el mismo código DANE. La entidad cuesta poco ahora y
obliga a migrar cursos y matrículas si se añade después.

## REC-11 · Accesos rápidos contextuales al calendario escolar
**Costo:** ⚪ · **Beneficio:** Medio

El dashboard adapta sus atajos al momento del año: en enero destaca *Matricular*, en junio *Cerrar periodo*, en
noviembre *Promoción*. Detalle pequeño que ahorra navegación durante todo el año.

## REC-12 · Código de verificación en el boletín impreso
**Costo:** ⚪ · **Beneficio:** Medio

Un código en el pie que permita a secretaría confirmar la autenticidad de un boletín físico frente al sistema.
Previene la alteración de boletines impresos, que es un problema real en colegios.

## REC-13 · Fecha límite de reapertura de periodo
**Costo:** ⚪ · **Beneficio:** Medio

Al reabrir un periodo, permitir fijar una fecha tras la cual se cierra automáticamente. Evita el escenario real de
periodos que quedan abiertos durante meses "por si acaso", que anula el propósito del cierre.

## REC-14 · Reporte de recuperaciones
**Costo:** ⚪ · **Beneficio:** Medio

No está listado en §54 pero se deriva de §30. Necesario para el control y la trazabilidad de las nivelaciones,
especialmente ante reclamos.

## REC-15 · Directorio exportable de acudientes
**Costo:** ⚪ · **Beneficio:** Medio

Uno de los listados que más pide la coordinación: convocatorias a reuniones, contacto masivo, verificación de
datos de contacto. No está en §54.

---

# Nivel 3 — A considerar

*Valiosas, pero se pueden posponer sin consecuencias.*

## REC-16 · Permitir a las familias cambiar su contraseña (interruptor)
**Costo:** ⚪ · **Beneficio:** Medio a largo plazo

§11 lo prohíbe y la propuesta lo respeta: el interruptor viene **desactivado**. Pero existir permite que el
colegio lo active más adelante sin desarrollo, cuando la carga de restablecimientos manuales se vuelva evidente.

## REC-17 · Aumentar el sufijo de la contraseña de 4 a 6 dígitos
**Costo:** ⚪ · **Beneficio:** Alto en seguridad

Mismo formato, cien veces más resistente. Cambia el ejemplo de §11 (`Juan@4832` → `Juan@483217`), por lo que
requiere aprobación explícita.

## REC-18 · Marcado de logros por estudiante
**Costo:** 🟡 · **Beneficio:** Alto pedagógicamente

Permitiría indicar qué logros alcanzó cada estudiante, individualizando el boletín. La arquitectura ya lo
contempla como extensión ([DP-07](00-hallazgos-y-decisiones.md#dp-07--los-desempeños-del-boletín-iguales-para-todo-el-curso-o-marcados-por-estudiante)).
Aumenta el trabajo del docente, lo que va en dirección contraria a §62 — de ahí que no se recomiende para la v1.

## REC-19 · Nota de área en el boletín
**Costo:** 🟡 · **Beneficio:** Depende del colegio

Ver [DP-05](00-hallazgos-y-decisiones.md#dp-05--el-boletín-se-organiza-por-área-o-por-asignatura). Si el colegio
lo requiere, hay que definir el método de cálculo (media simple o ponderada por intensidad horaria).

## REC-20 · Observación por asignatura además de la general
**Costo:** ⚪ · **Beneficio:** Medio

Contemplado en el diseño y desactivado por defecto. Se activa si los docentes lo van a usar; si no, solo añade
trabajo.

## REC-21 · Historial de cambios de documento
**Costo:** ⚪ · **Beneficio:** Medio

Permite encontrar a una persona por su documento anterior tras una corrección o un cambio TI → CC. Casos poco
frecuentes pero muy molestos cuando ocurren.

## REC-22 · Foto del estudiante en el boletín
**Costo:** ⚪ (bloque ya previsto) + 🟡 (captura de fotos) · **Beneficio:** Medio

El bloque está contemplado y desactivado. El costo real no es técnico: es capturar y cargar 800 fotografías.

---

# Nivel 4 — Evolución posterior [FF]

*Fuera de alcance en la v1, con la arquitectura preparada.*

| # | Funcionalidad | Costo | Por qué es la siguiente evolución natural |
|---|---|---|---|
| REC-23 | **Asistencia** | 🔴 | Es el módulo que más piden los colegios después del núcleo académico. El espacio ya está reservado en el boletín |
| REC-24 | **Notificación por correo** | 🟡 | Comunicados y tareas por correo. El servicio de notificación ya define la interfaz |
| REC-25 | **Entrega de tareas** | 🔴 | Requiere gestión de archivos por estudiante y control de plazos |
| REC-26 | **Multi-colegio operativo** | 🟡 | El modelo de datos ya está listo; falta la capa de administración y el selector |
| REC-27 | **Horarios** | 🔴 | La asignación docente ya modela la base |
| REC-28 | **Constancias y certificados** | 🟡 | La información ya está en el modelo; falta la plantilla y el flujo |
| REC-29 | **Portal público de admisiones** | 🔴 | Preinscripción en línea que alimenta la matrícula |
| REC-30 | **API para aplicación móvil** | 🟡 | Nueva capa de controladores sobre los mismos servicios, sin duplicar lógica |
| REC-31 | **Comisiones de evaluación** | 🟡 | Actas y seguimiento de casos, complemento natural de la promoción |
| REC-32 | **Integración SIMAT** | 🔴 | La estructura de datos ya toma SIMAT como referencia |

---

# Recomendaciones de proceso

*No son funcionalidades: son formas de trabajar que reducen el riesgo del proyecto.*

## REC-33 · Validar la Fase 5 con docentes reales
**Costo:** ⚪ · **Beneficio:** Muy alto

Dos o tres docentes calificando un curso real antes de dar por cerrada la fase de notas. Es el hito que mejor
predice la adopción del sistema y el más barato de ejecutar.

## REC-34 · Aprobar la maqueta del boletín antes de programarla
**Costo:** ⚪ · **Beneficio:** Alto

Presentar el diseño del boletín en la Fase 6, en papel, para aprobación del rector y la coordinación. Rediseñar
una maqueta cuesta horas; reprogramar un boletín ya construido cuesta días.

## REC-35 · Cargar datos de prueba realistas desde la Fase 4
**Costo:** ⚪ · **Beneficio:** Alto

800 estudiantes ficticios con nombres, tildes y eñes reales. Los problemas de rendimiento y de codificación
aparecen con volumen, no con 20 registros de prueba.

## REC-36 · Puesta en marcha por fases, no de golpe
**Costo:** ⚪ · **Beneficio:** Alto

Usar el sistema en producción desde la Fase 4 (matrícula), luego notas, luego boletines. La retroalimentación con
datos reales descubre lo que ninguna especificación anticipa, y distribuye el cambio organizacional en el tiempo.

## REC-37 · Definir un responsable funcional en el colegio
**Costo:** ⚪ · **Beneficio:** Alto

Una persona —normalmente el coordinador— con autoridad para resolver dudas funcionales y decidir. Sin un
interlocutor único, cada decisión pendiente se convierte en una reunión.

## REC-38 · Documentar el SIEE del colegio antes de la Fase 8
**Costo:** ⚪ (para el colegio) · **Beneficio:** Alto

El criterio de promoción vive en el SIEE. Tenerlo por escrito antes de llegar a la Fase 8 evita improvisar la
regla más delicada del sistema.

---

# Resumen de priorización

| Prioridad | Recomendaciones | Costo total estimado |
|---|---|---|
| **Adoptar sí o sí** | REC-01, REC-02, REC-03, REC-05 | ⚪ Bajo |
| **Adoptar para viabilidad de arranque** | REC-04 | 🟡 Medio |
| **Alto valor, bajo costo** | REC-06 a REC-15 | ⚪ Bajo (acumulado ≈ 1 semana) |
| **Decidir con el colegio** | REC-16 a REC-22 | ⚪–🟡 |
| **Versión 2** | REC-23 a REC-32 | 🔴 |
| **Proceso — no cuestan desarrollo** | REC-33 a REC-38 | ⚪ |

**Adoptar el nivel 1 completo (REC-01 a REC-05) añade aproximadamente una semana al cronograma** y elimina los
riesgos R-14, R-15, R-16, R-17 y buena parte de R-01. Es la inversión de menor costo y mayor retorno de toda la
propuesta.
