GELAKRAFT

Plataforma de gamificación de aula en euskera, basada en mitología vasca.

Anbotoko kobazulotik egina.

Stack técnico

• Next.js 15 con App Router
• React 19
• TypeScript
• Fraunces + Inter (vía next/font)
• Supabase — Postgres + Auth (email + contraseña para profesores)
• iron-session — sesiones de alumno (sin Supabase Auth)
• Vercel — hosting

---

Setup inicial (primera vez)

1. Instalar dependencias

Necesitas Node.js 20 o superior:

npm install

2. Crear cuenta y proyecto en Supabase

1. Ir a supabase.com y crear cuenta (gratis).
2. New project:
   • Name: gelakraft
   • Database password: genera una fuerte y guárdala en tu gestor de contraseñas.
   • Region: Frankfurt (eu-central-1) o París — importante para que los datos vivan en la UE.
3. Esperar 1-2 minutos a que se cree el proyecto.

3. Ejecutar el esquema de base de datos

En Supabase: SQL Editor → New query → pegar el script → Run. Repetir con cada uno de los 19 scripts de supabase/, en este orden:

#	Script	Qué hace	Depende de
1	schema.sql	Tablas profiles, classrooms; trigger que crea el perfil al registrarse	—
2	students.sql	Tabla students; RPC find_student_for_login	1
3	students-stats.sql	Columnas hero_class, xp, hearts, mana…; RPC apply_battle_result	2
4	events.sql	Tabla events (ustekabeko gertaerak)	1
5	student-dashboard.sql	Columna avatar, tabla activities; RPC get_student_dashboard, record_activity	3
6	avatar-and-bulk.sql	avatar_config (JSONB), activities.affected_student_ids; RPC adjust_students	5
7	behaviors-teams-powers.sql	Tablas behaviors, teams, team_members, power_usages; RPC generate_teams, use_power	6
8	power-requests.sql	Tabla power_requests; RPC request_power, approve_power_request…	7
9	konfigurazioa.sql	Tabla power_overrides, weekly_mana/weekly_hearts; RPC apply_weekly_grants, update_classroom_settings	8
10	grant-days.sql	Columna classrooms.grant_days; redefine apply_weekly_grants y update_classroom_settings	9
11	patuak.sql	Tabla death_consequences, students.pending_death; RPC execute_death_sentence	6
12

No hay missions-patch-v4.sql: los commits "misioak v4" solo tocaron código de la app.

El orden es el de creación de cada script en el historial de git, comprobado contra las dependencias (tablas, columnas y funciones que usa cada uno). Los puntos donde un orden distinto rompe algo sin dar error:

• get_student_dashboard se redefine en 5 scripts (5, 6, 7, 8, 9). Gana el último ejecutado. La versión buena es la de konfigurazioa.sql (incluye power_requests y llama a apply_weekly_grants). Si se ejecuta power-requests.sql después de konfigurazioa.sql, los alumnos dejan de recibir el maná y los corazones semanales.
• apply_weekly_grants: la versión final es la de grant-days.sql (por días de la semana). Si konfigurazioa.sql va después, vuelve al reparto semanal antiguo.
• list_overrides_for_classroom / get_power_effective: la versión final es la de full-editable-powers.sql. Si fix-power-invoke.sql va después, el alumno deja de ver nombre, descripción e icono editados de los poderes.
• update_classroom_settings: konfigurazioa.sql la crea con 4 parámetros y grant-days.sql crea otra con 5 (no la reemplaza, queda sobrecargada). La app llama siempre a la de 5 (lib/classroom/settings.ts), así que funciona, pero la de 4 sobra.

Todos los scripts usan if not exists / create or replace, así que volver a ejecutar uno ya aplicado no falla; lo que importa es el orden relativo de los que redefinen funciones.

GRANT. Desde el 30/10/2026 Supabase no da acceso por la Data API a las tablas nuevas de public. grants.sql (paso 19) da los permisos de las 17 tablas; ejecútalo al final. Las tablas que se creen a partir de ahora deben llevar sus propios GRANT en su script (ver CLAUDE.md).

4. Configurar Authentication en Supabase

4.1. URLs

1. En Supabase: Authentication → URL Configuration.
2. Site URL: https://gelakraft.eus
3. Redirect URLs: añadir las dos:
   • https://gelakraft.eus/auth/callback
   • http://localhost:3000/auth/callback (para desarrollo)
4. Save.

4.2. Confirmación de email obligatoria

1. Authentication → Providers → Email.
2. Asegúrate de que "Confirm email" está activado (toggle en azul/verde).
3. Esto hace que cada nuevo usuario reciba un email de confirmación al registrarse y deba pulsar el enlace antes de poder iniciar sesión. Solo se manda este email una vez en la vida del usuario.
4. Save.

4.3. Personalizar templates de email (recomendado)

En Authentication → Email Templates hay tres plantillas que recibirá el usuario:

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗