UNIMES · Control Escolar — demo de la base de datos

Demo web de la nueva base de datos de Control Escolar del plantel San Luis Potosí: muestra lo que un sistema completo puede hacer con los datos migrados del sistema anterior.

• Inicio: cifras generales, alumnos por ciclo (gráfica) y por carrera.
• Tablero: indicadores para rectoría (matrícula, nuevo ingreso, reprobación, eficiencia terminal, titulación y deserción por generación), con filtro por licenciatura e impresión a PDF.
• Alumnos: búsqueda y ficha con promedios (gráfica) y kárdex.
• Reportes: 36 reportes por tema (procedimientos almacenados y consultas de solo lectura), entre ellos el formato 911 y las relaciones para la SEP (inscripción, bajas, egresados, titulados, eficiencia terminal, datos faltantes). Cada uno con su explicación, filtros con menús de búsqueda y vista sugerida.
• Modelo de datos: diagrama interactivo de las tablas y sus relaciones (leído en vivo de la base: columnas, llaves y conteos), con la ficha de cada tabla (qué guarda, por qué existe, de dónde vienen sus datos, columnas explicadas), sus registros y la procedencia de cada archivo del sistema anterior (migracion.fuente). Las explicaciones están en lib/modelo.ts.
• Consola SQL: consultas libres en una transacción de solo lectura (una instrucción, 15 s), con ejemplos.
• Guía: cómo usar cada menú, agrupar, graficar y exportar, y un glosario.
• Operaciones: inhabilitadas por ahora (lib/config.ts); la demo es solo de consulta y exportación.

Todo resultado (reporte, búsqueda, kárdex o consola) se puede ver en tabla (ordenar, filtrar) o gráfica (barras o línea, con series), agrupar y resumir en el servidor (conteo, suma, promedio, mínimo, máximo, distintos, % Sí) y exportar a Excel o CSV (hasta 50,000 filas; el Excel trae una hoja «Información» con filtros y consulta).

Next.js 16 (App Router, Cache Components) + Tailwind 4 + Neon (@neondatabase/serverless). Acceso con una contraseña única; la sesión es una cookie firmada.

Variables de entorno

Copia .env.example a .env.local y llena:

Variable	Qué es
DATABASE_URL	URL del proyecto Neon de UNIMES
DEMO_PASSWORD	Contraseña para entrar a la demo
SESSION_SECRET	Texto aleatorio largo para firmar la sesión

En Vercel se definen las mismas tres en Settings → Environment Variables. Nunca se suben al repositorio.

Desarrollo

npm install
npm run dev     # http://localhost:3000
npm run build

Cargar la base en Neon

La base se construye en el proyecto de migración (migraciones 0001–0016 y ETL en Docker). Para copiarla a un proyecto Neon vacío:

./scripts/cargar_neon.sh   # lee DATABASE_URL de .env.local

Se excluyen los datos de migracion.incidencia (la bitácora de la migración, 191 MB) para caber en el plan gratuito.