In English: A narrative game of philosophical dilemmas about science for secondary-school classes. Students play anonymously from their phones, the projected class view only shows aggregates of five or more, and the teacher has a private console. TypeScript, Supabase (Postgres, Edge Functions, anonymous auth).
Videojuego narrativo de dilemas filosóficos sobre la ciencia para Filosofía de 4.º ESO. El diseño completo está en docs/DISENO_ANOMALIA.md y las decisiones posteriores en docs/decisiones.md.
- Alumnado (
/): juega desde el móvil con un alias y el código de clase. - Centro de Control (
/centro): vista proyectable, anónima, con datos agregados (k ≥ 5). - Consola docente (
/consola): crear clases, desbloquear capítulos, ver alertas privadas y verificar PDF.
Requisitos: Node 22 o posterior y npm. No hace falta Docker.
npm install
cp .env.example .env.local # y rellénalo (ver comentarios)
npm run dev # http://localhost:5173
npm run dev -- --host # para abrirlo desde el móvil en la misma wifiEl proyecto «anomalia» (ref kicpndzbcswxchxiejje, región eu-west-1) ya está creado y configurado. En un equipo nuevo:
- Inicia sesión en la CLI con
npx supabase loginy vincula el proyecto connpx supabase link --project-ref kicpndzbcswxchxiejje. No necesitas la contraseña de la base de datos. - Aplica las migraciones con
npm run db:push, despliega la función connpm run functions:deployy regenera los tipos connpm run db:types. - La configuración de Auth vive en
supabase/config.toml: inicio de sesión anónimo activado y limitado a 150/h, porque el aula comparte una sola IP.- Para aplicarla, lanza
npx supabase config push. - Revisa el diff antes de confirmar: los valores locales sustituyen a los remotos.
- Para aplicarla, lanza
- CORS de las Edge Functions:
npx supabase secrets set ALLOWED_ORIGINS=https://ray86-dev.github.io,http://localhost:5173. - Docentes: crea el usuario en Authentication → Users → Add user, marcando Auto Confirm User. Después añádelo a la lista blanca con
npm run teacher:add -- tu@correo "Tu nombre". - Datos de prueba:
npm run seed:demorecrea la clase PRUEBA con 30 alumnos simulados. Su docente de demostración esdocente.demo@anomalia.invalid, con la contraseñaDEMO_TEACHER_PASSWORDde.env.local. - Clase en directo:
npm run simularpone a 25 alumnos simulados a jugar a la vez en PRUEBA (o en--clase CODIGO). Abre a la vez/centro?clase=<id>para ver cómo se mueve. Con--borrarlos quitas.
Ábrelo en el ordenador del aula con tu sesión docente, desde el botón «Abrir el Centro de Control» de cada clase en la consola. Atajos:
| Tecla | Acción |
|---|---|
| R | Revela u oculta las decisiones de la clase |
| ← → / Esc | Destaca un panel a pantalla completa / vuelve a la vista general |
| F | Pantalla completa |
| M | Activa o silencia el ambiente sonoro |
| H | Muestra u oculta la ayuda |
npm run check # contenido + tipos + lint + formato + tests unitarios
npm run test:integration # RLS y Edge Functions contra Supabase (necesita .env.local)Cada push a main publica en GitHub Pages mediante .github/workflows/deploy.yml. Las variables públicas VITE_SUPABASE_URL y VITE_SUPABASE_PUBLISHABLE_KEY se configuran como Variables de Actions en el repositorio.
No despliegues durante una clase: los móviles perderían los archivos que ya tienen cargados.