ExamGuard AI
Plataforma de exámenes en línea para colegios y universidades, con supervisión asistida por IA.
Demo en línea: examguard-mulett.vercel.app — entra con un clic como rectora, docente o estudiante (datos ficticios que se restablecen cada noche). Para ver la supervisión: entra como estudiante, abre el "Taller de repaso", autoriza la cámara y usa el simulador; luego, como docente, mira el monitoreo y la revisión.
La IA no decide que un estudiante hizo trampa. Detecta eventos (cambios de pestaña, inactividad, desconexiones), los organiza en señales con una explicación factual y recomienda revisar. La decisión siempre es de una persona.
Estado
En construcción por fases (ver roadmap).
- Fase 0 — Análisis: docs/ANALISIS.md y decisiones técnicas.
- Fase 1 — Plataforma base: Next.js 16, TypeScript estricto, Tailwind 4 y shadcn/ui; Prisma con PostgreSQL (Neon); Better Auth; roles y permisos; paneles por rol; auditoría; seed de demostración; pruebas e integración continua.
- Fase 2 — Administración y exámenes: usuarios (manual y por CSV), cursos y matrículas, banco de preguntas y constructor de exámenes (cinco tipos, borrador y publicación congelada, ajustes por estudiante).
- Fase 3 — Examen del estudiante: compatibilidad, consentimiento, tiempo del servidor, guardado automático, un dispositivo activo, entrega automática, calificación automática y manual, publicación de notas.
- Fase 4 — Supervisión básica: detectores del navegador, ingesta por lotes, catálogo de eventos, simulador ("modo demostración") y monitoreo en vivo del docente.
- Fase 5 — Agentes y reglas: agentes de dominio, motor de reglas con umbrales por institución, agente de riesgo, señales con explicación factual y resumen para quien revisa (Claude, con barreras de lenguaje y plantilla de respaldo).
- Fase 6 — Revisión humana: cola de sesiones por revisar, revisión con línea de tiempo filtrable (cada evento marca la señal que lo cita), decisión con observaciones y auditoría, y "Mis datos de supervisión" para el estudiante.
- Fase 7 — Cámara y audio: detección de rostros con MediaPipe y nivel del micrófono, en el navegador (la imagen y el sonido no salen del equipo); prueba de los dispositivos antes de empezar, indicadores durante el examen y autorización del acudiente para los menores, registrada por la administración.
- Fase 8 — Producción: política de contenido con nonce y cabeceras de seguridad, límites de uso en la base, borrado automático de la evidencia según la retención, tarea diaria, métricas de supervisión para la administración, imagen de Docker validada en CI y modo demostración para la demo pública (despliegue).
Stack
| Capa | Tecnologías |
|---|
| Aplicación | Next.js 16 (App Router, Route Handlers, proxy.ts), React 19, TypeScript estricto |
| Interfaz | Tailwind CSS 4, shadcn/ui (Radix), lucide, next-intl (español, preparado para más idiomas) |
| Datos | PostgreSQL (Neon), Prisma |
| Autenticación | Better Auth (correo y contraseña, sin registro público), roles ADMIN / TEACHER / STUDENT |
| Supervisión | MediaPipe (detección de rostros en el navegador), Web Audio (nivel de sonido) |
| IA | Claude (API de Anthropic) para el resumen de quien revisa, con barreras y plantilla de respaldo |
| Calidad | Vitest (unitarias e integración), Playwright (E2E), ESLint, GitHub Actions |
| Producción | Vercel (aplicación y tarea diaria) con Neon, o Docker en un servidor propio |
Correr en local
Requisitos: Node.js 20.9+ y una base PostgreSQL (por ejemplo, un proyecto gratuito de Neon).
cp .env.example .env # DATABASE_URL, BETTER_AUTH_SECRET, SEED_PASSWORD...
npm install
npm run db:migrate # aplica las migraciones
npm run db:seed # institución de demostración con datos ficticios
npm run dev # http://localhost:3000
Con Docker: docker compose up --build (aplicación y PostgreSQL) y docker compose run --rm seed para los datos de demostración.
Cuentas de demostración (contraseña: la de SEED_PASSWORD):
Seguridad y privacidad
- La cámara y el micrófono se procesan en el navegador: al servidor solo llegan hechos con su hora (cuántos rostros, si hubo sonido), nunca imágenes ni audio.
- Política de contenido con nonce (
connect-src 'self': nada sale a otros dominios, ni la telemetría de las librerías) y Permissions-Policy que limita cámara y micrófono al propio sitio.
- Permisos por rol y alcance en cada servicio; auditoría de cada decisión; límites de uso en la base.
- La evidencia se borra sola al cumplirse la retención de la institución; la nota y la decisión de la revisión se conservan.
- Menores de edad: cámara y micrófono solo con la autorización del acudiente registrada por la institución.
Pruebas
npm run typecheck # TypeScript
npm test # unitarias
npm run test:integration # contra la base de datos (crean y borran sus propios datos)
npm run test:e2e # Playwright, contra el build de producción y el seed
En GitHub Actions corren todas, además del lint y la verificación de que el esquema coincide con las migraciones, contra una base PostgreSQL nueva.
Detrás de un proxy corporativo
Este proyecto se desarrolla en una red que bloquea algunos paquetes con binarios. Lo que cambia está explicado en docs/DECISIONES.md:
- Comandos que descargan algo (npm,
next build con Google Fonts): NODE_OPTIONS=--use-system-ca.
- Motores de Prisma descargados a mano, indicados en
.env.
- ESLint y Playwright solo corren en CI.
Documentación
