Documento técnico público

Arquitectura del Método Glocal

Visualización de toda la infraestructura de datos propuesta para el MVP: dominios, tablas, reglas de seguridad y cómo cada cláusula del contrato se mapea a la base de datos.

MVPPWAContrato Feb 202612 semanas

Tablas

Dominios

Roles

Línea de tiempo del contrato

3 fases · 12 semanas

Fase 1

Diseño y Onboarding

Semanas 1–4

·Auth + roles
·Perfiles
·Consentimiento parental
·TRIAGE inicial

Fase 2

Desarrollo Core

Semanas 5–9

·Contenido Historia 8°
·Calendario adaptativo
·Geolocalización
·Match grupos
·Gamificación

Fase 3

Lanzamiento y IA

Semanas 10–12

·Asistente IA
·QR
·Panel admin
·Pulido y QA

Mapa de dominios

Cada dominio agrupa tablas con un propósito común. Click para ver el detalle.

Identidad y consentimiento

Cuentas, perfiles y permisos parentales para menores.

profilesuser_rolesstudent_profilesteacher_profilesguardiansparental_consents

Onboarding TRIAGE

Diagnóstico inicial y perfil de aprendizaje personalizado.

triage_questionstriage_responseslearner_profiles

Contenido educativo

Asignaturas, cursos, unidades y lecciones (Historia 8°).

subjectscoursesunitslessonslesson_progress

Calendario adaptativo

Rutas y planificación semanal generada por la plataforma.

learning_pathscalendar_events

Geolocalización

Ubicación segura y actividades físicas comunitarias.

student_locationsphysical_activities

Match y grupos

Grupos de hasta 7 estudiantes con tutor asignado.

learning_groupsgroup_members

Gamificación

Logros, puntos y rachas para motivar el avance.

achievementsuser_achievementspoints_ledgerstreaks

Supervisión

Vista de profesor y panel de administración.

teacher_observationsaudit_log

Herramientas

QR, asistente IA y notificaciones.

qr_codesai_assistant_messagesnotifications

Esquema completo (ER)

Diagrama entidad-relación de todas las tablas y sus llaves foráneas.

Cargando diagrama…

Identidad y consentimiento

Cuentas, perfiles y permisos parentales para menores.

profiles

Datos personales asociados a cada cuenta de auth.users.

Columna	Tipo	Propósito
idPKFK	uuid	FK a auth.users
first_name	text	Nombre
last_name	text	Apellido
email	text	Correo de contacto
phone	text	Teléfono opcional
avatar_url	text	Imagen de perfil

Estudiante:SELECTUPDATE

Profesor:SELECT

Admin:SELECTUPDATE

user_roles

Asignación de roles (student / teacher / admin) — separado de profiles para evitar escalada.

Columna	Tipo	Propósito
idPK	uuid	PK
user_idFK	uuid	Usuario
role	app_role	Rol asignado

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

student_profiles

Datos académicos del estudiante: curso, colegio, fecha de nacimiento.

Columna	Tipo	Propósito
user_idPKFK	uuid	Estudiante
grade	text	Curso (ej. 8° básico)
school	text	Colegio
birthdate	date	Fecha de nacimiento

Estudiante:SELECTUPDATE

Profesor:SELECT

Admin:SELECTUPDATE

Apoderado:SELECT

teacher_profiles

Datos profesionales del profesor / tutor.

Columna	Tipo	Propósito
user_idPKFK	uuid	Profesor
specialty	text	Área principal
bio	text	Biografía corta

Estudiante:SELECT

Profesor:SELECTUPDATE

Admin:SELECTUPDATE

guardians

Apoderados vinculados a un estudiante menor de edad.

Columna	Tipo	Propósito
idPK	uuid	PK
guardian_user_idFK	uuid	Apoderado
student_user_idFK	uuid	Estudiante
relationship	text	Vínculo (madre/padre/tutor)

Admin:SELECTINSERTUPDATEDELETE

Apoderado:SELECT

parental_consents

Consentimientos firmados por el apoderado: datos, geolocalización, imagen.

Columna	Tipo	Propósito
idPK	uuid	PK
student_user_idFK	uuid	Estudiante
guardian_idFK	uuid	Apoderado que firma
scope	text	data \| geo \| image \| ai
granted_at	timestamptz	Fecha de firma
document_url	text	PDF firmado en Storage

Admin:SELECTUPDATEDELETE

Apoderado:SELECTINSERT

⚙ Bloquea operaciones sensibles si el scope requerido no está activo

Onboarding TRIAGE

Diagnóstico inicial y perfil de aprendizaje personalizado.

triage_questions

Banco de preguntas del diagnóstico inicial.

Columna	Tipo	Propósito
idPK	uuid	PK
category	text	intereses / estilo / nivel
prompt	text	Texto de la pregunta
options	jsonb	Alternativas

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

Anónimo:SELECT

triage_responses

Respuestas de cada estudiante al TRIAGE.

Columna	Tipo	Propósito
idPK	uuid	PK
student_user_idFK	uuid	Estudiante
question_idFK	uuid	Pregunta
answer	jsonb	Respuesta seleccionada

Estudiante:SELECTINSERT

Profesor:SELECT

Admin:SELECT

learner_profiles

Perfil derivado del TRIAGE: estilo de aprendizaje, intereses, nivel.

Columna	Tipo	Propósito
user_idPKFK	uuid	Estudiante
learning_style	text	visual / auditivo / kinestésico
interests	text[]	Áreas de interés
level	int	Nivel inicial

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTUPDATE

Contenido educativo

Asignaturas, cursos, unidades y lecciones (Historia 8°).

subjects

Asignaturas (MVP: Historia 8° básico).

Columna	Tipo	Propósito
idPK	uuid	PK
name	text	Nombre
grade	text	Curso objetivo

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

Anónimo:SELECT

courses

Cursos por asignatura.

Columna	Tipo	Propósito
idPK	uuid	PK
subject_idFK	uuid	Asignatura
title	text	Título

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

units

Unidades dentro de un curso.

Columna	Tipo	Propósito
idPK	uuid	PK
course_idFK	uuid	Curso
title	text	Título
order	int	Orden

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

lessons

Lecciones con material multimedia.

Columna	Tipo	Propósito
idPK	uuid	PK
unit_idFK	uuid	Unidad
title	text	Título
body	jsonb	Contenido enriquecido
media_url	text	Recurso en Storage

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

lesson_progress

Avance por lección de cada estudiante.

Columna	Tipo	Propósito
idPK	uuid	PK
student_user_idFK	uuid	Estudiante
lesson_idFK	uuid	Lección
status	text	started / completed
score	int	Resultado

Estudiante:SELECTINSERTUPDATE

Profesor:SELECT

Admin:SELECT

Calendario adaptativo

Rutas y planificación semanal generada por la plataforma.

learning_paths

Ruta personalizada generada para cada estudiante.

Columna	Tipo	Propósito
idPK	uuid	PK
student_user_idFK	uuid	Estudiante
course_idFK	uuid	Curso
generated_at	timestamptz	Fecha de generación

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

calendar_events

Bloques de estudio y actividades en el calendario semanal.

Columna	Tipo	Propósito
idPK	uuid	PK
path_idFK	uuid	Ruta
lesson_idFK	uuid	Lección opcional
starts_at	timestamptz	Inicio
ends_at	timestamptz	Fin
kind	text	study / activity / group

Estudiante:SELECTUPDATE

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

Geolocalización

Ubicación segura y actividades físicas comunitarias.

student_locations

Última ubicación conocida — solo si hay consentimiento parental activo.

Columna	Tipo	Propósito
idPK	uuid	PK
student_user_idFK	uuid	Estudiante
lat	double	Latitud
lng	double	Longitud
accuracy_m	int	Precisión en metros
captured_at	timestamptz	Captura

Estudiante:SELECTINSERT

Admin:SELECT

Apoderado:SELECT

⚙ Bloquea INSERT si no existe parental_consent con scope='geo' activo

physical_activities

Actividades comunitarias presenciales (caminatas, terreno).

Columna	Tipo	Propósito
idPK	uuid	PK
title	text	Nombre
lat	double	Latitud
lng	double	Longitud
starts_at	timestamptz	Inicio
created_byFK	uuid	Profesor creador

Estudiante:SELECT

Profesor:SELECTINSERTUPDATE

Admin:SELECTINSERTUPDATEDELETE

Match y grupos

Grupos de hasta 7 estudiantes con tutor asignado.

learning_groups

Grupos de hasta 7 estudiantes con un tutor.

Columna	Tipo	Propósito
idPK	uuid	PK
name	text	Nombre del grupo
tutor_user_idFK	uuid	Tutor
course_idFK	uuid	Curso

Estudiante:SELECT

Profesor:SELECTINSERTUPDATE

Admin:SELECTINSERTUPDATEDELETE

group_members

Miembros del grupo (máx 7 por trigger).

Columna	Tipo	Propósito
idPK	uuid	PK
group_idFK	uuid	Grupo
student_user_idFK	uuid	Estudiante
joined_at	timestamptz	Ingreso

Estudiante:SELECT

Profesor:SELECTINSERTDELETE

Admin:SELECTINSERTUPDATEDELETE

⚙ Trigger: rechaza inserción si el grupo ya tiene 7 miembros

Gamificación

Logros, puntos y rachas para motivar el avance.

achievements

Catálogo de logros disponibles.

Columna	Tipo	Propósito
idPK	uuid	PK
code	text	Identificador
title	text	Nombre
points	int	Puntos otorgados

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERTUPDATEDELETE

user_achievements

Logros desbloqueados por estudiante.

Columna	Tipo	Propósito
idPK	uuid	PK
user_idFK	uuid	Estudiante
achievement_idFK	uuid	Logro
unlocked_at	timestamptz	Fecha

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERT

points_ledger

Registro append-only de puntos ganados.

Columna	Tipo	Propósito
idPK	uuid	PK
user_idFK	uuid	Estudiante
delta	int	Variación de puntos
reason	text	Motivo

Estudiante:SELECT

Profesor:SELECT

Admin:SELECTINSERT

streaks

Rachas de actividad diaria.

Columna	Tipo	Propósito
user_idPKFK	uuid	Estudiante
current	int	Días seguidos
best	int	Mejor racha

Estudiante:SELECT

Profesor:SELECT

Admin:SELECT

Supervisión

Vista de profesor y panel de administración.

teacher_observations

Notas de seguimiento del profesor sobre un estudiante.

Columna	Tipo	Propósito
idPK	uuid	PK
teacher_user_idFK	uuid	Profesor
student_user_idFK	uuid	Estudiante
note	text	Observación

Profesor:SELECTINSERTUPDATEDELETE

Admin:SELECT

audit_log

Bitácora de acciones sensibles para auditoría.

Columna	Tipo	Propósito
idPK	uuid	PK
actor_user_idFK	uuid	Quién
action	text	Acción
target	text	Recurso afectado
at	timestamptz	Cuándo

Admin:SELECT

Herramientas

QR, asistente IA y notificaciones.

qr_codes

Códigos QR generados para acceso rápido o inscripción.

Columna	Tipo	Propósito
idPK	uuid	PK
code	text	Token único
purpose	text	checkin / invite / lesson
payload	jsonb	Datos asociados

Estudiante:SELECT

Profesor:SELECTINSERT

Admin:SELECTINSERTUPDATEDELETE

ai_assistant_messages

Conversaciones con el asistente IA (texto / voz).

Columna	Tipo	Propósito
idPK	uuid	PK
user_idFK	uuid	Usuario
role	text	user / assistant
content	text	Mensaje
created_at	timestamptz	Fecha

Estudiante:SELECTINSERT

Profesor:SELECTINSERT

Admin:SELECT

notifications

Notificaciones in-app para usuarios.

Columna	Tipo	Propósito
idPK	uuid	PK
user_idFK	uuid	Destinatario
title	text	Título
body	text	Contenido
read_at	timestamptz	Lectura

Estudiante:SELECTUPDATE

Profesor:SELECTUPDATE

Admin:SELECTINSERT

Matriz de seguridad (RLS)

Permisos por tabla y rol. Toda la base se protege con Row-Level Security en Postgres.

Tabla	Estudiante	Profesor	Admin	Apoderado	Anónimo
profiles	SELECTUPDATE	SELECT	SELECTUPDATE	—	—
user_roles	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
student_profiles	SELECTUPDATE	SELECT	SELECTUPDATE	SELECT	—
teacher_profiles	SELECT	SELECTUPDATE	SELECTUPDATE	—	—
guardians	—	—	SELECTINSERTUPDATEDELETE	SELECT	—
parental_consents	—	—	SELECTUPDATEDELETE	SELECTINSERT	—
triage_questions	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	SELECT
triage_responses	SELECTINSERT	SELECT	SELECT	—	—
learner_profiles	SELECT	SELECT	SELECTUPDATE	—	—
subjects	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	SELECT
courses	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
units	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
lessons	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
lesson_progress	SELECTINSERTUPDATE	SELECT	SELECT	—	—
learning_paths	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
calendar_events	SELECTUPDATE	SELECT	SELECTINSERTUPDATEDELETE	—	—
student_locations	SELECTINSERT	—	SELECT	SELECT	—
physical_activities	SELECT	SELECTINSERTUPDATE	SELECTINSERTUPDATEDELETE	—	—
learning_groups	SELECT	SELECTINSERTUPDATE	SELECTINSERTUPDATEDELETE	—	—
group_members	SELECT	SELECTINSERTDELETE	SELECTINSERTUPDATEDELETE	—	—
achievements	SELECT	SELECT	SELECTINSERTUPDATEDELETE	—	—
user_achievements	SELECT	SELECT	SELECTINSERT	—	—
points_ledger	SELECT	SELECT	SELECTINSERT	—	—
streaks	SELECT	SELECT	SELECT	—	—
teacher_observations	—	SELECTINSERTUPDATEDELETE	SELECT	—	—
audit_log	—	—	SELECT	—	—
qr_codes	SELECT	SELECTINSERT	SELECTINSERTUPDATEDELETE	—	—
ai_assistant_messages	SELECTINSERT	SELECTINSERT	SELECT	—	—
notifications	SELECTUPDATE	SELECTUPDATE	SELECTINSERT	—	—

Flujos clave

Tres recorridos críticos que recorren múltiples dominios.

Onboarding + consentimiento

Calendario adaptativo

Match por geolocalización

Stack técnico

Frontend

·React 19
·TanStack Start
·Tailwind v4
·shadcn/ui
·Mermaid (diagramas)

Backend

·Supabase Postgres
·Row-Level Security
·Realtime
·Storage
·Edge Functions

Integraciones

·IA generativa pluggable
·Mapas para geolocalización
·Notificaciones in-app
·QR rápido

Cumplimiento del contrato

Cada cláusula del contrato y las tablas que la soportan.

Cláusula / funcionalidad	Tablas que la implementan
Registro de estudiantes con consentimiento parental	profiles student_profiles guardians parental_consents
TRIAGE de personalización al ingresar	triage_questions triage_responses learner_profiles
Contenido de Historia 8° básico	subjects courses units lessons
Seguimiento de avance por lección	lesson_progress points_ledger streaks
Calendario adaptativo personal	learning_paths calendar_events
Geolocalización con permiso del apoderado	student_locations parental_consents
Actividades físicas comunitarias	physical_activities
Match de grupos de hasta 7 con tutor	learning_groups group_members
Gamificación (logros, puntos, rachas)	achievements user_achievements points_ledger streaks
Seguimiento del profesor por estudiante	teacher_observations
Panel de administración con auditoría	audit_log user_roles
QR para inscripción y check-in	qr_codes
Asistente IA (texto/voz)	ai_assistant_messages
Notificaciones a estudiantes y apoderados	notifications

¿Listo para conocer Glocal?

Esta es la base sobre la que construimos. Si eres parte del equipo o cliente, ingresa para ver el producto en acción.

Iniciar sesión Volver al inicio