workspace/projects/gamilit/docs/database/VIEWS-INVENTARIO.md

VISTAS (VIEWS) DATABASE - INVENTARIO

Proyecto: GAMILIT - Plataforma Educativa Gamificada Version: 1.0 Fecha: 2025-12-26 Total Views: 17

---

RESUMEN POR SCHEMA

Schema	Views	Proposito
admin_dashboard	7	Dashboard administrativo
auth	1	Alias de tenants
educational_content	1	Analisis de validacion
gamification_system	4	Leaderboards
gamilit	1	Utilidades
progress_tracking	2	Seguimiento de progreso
social_features	1	Progreso de aula
TOTAL	17	-

---

1. SCHEMA: admin_dashboard (7 views)

01-recent_activity.sql

Proposito: Actividad reciente del sistema para dashboard admin

Columna	Descripcion
activity_id	ID de actividad
user_id	Usuario que realizo la accion
activity_type	Tipo de actividad
description	Descripcion de la accion
created_at	Timestamp

---

assignment_submission_stats.sql

Proposito: Estadisticas de envios de asignaciones

Columna	Descripcion
assignment_id	ID de asignacion
total_submissions	Total de envios
pending_reviews	Pendientes de revision
average_score	Puntuacion promedio
completion_rate	Tasa de completado

---

classroom_overview.sql

Proposito: Vista general de aulas para admin

Columna	Descripcion
classroom_id	ID del aula
classroom_name	Nombre
teacher_name	Profesor asignado
student_count	Cantidad de estudiantes
avg_progress	Progreso promedio

---

moderation_queue.sql

Proposito: Cola de contenido pendiente de moderacion

Columna	Descripcion
item_id	ID del item
content_type	Tipo de contenido
reporter_id	Quien reporto
reason	Razon del reporte
status	Estado de moderacion

---

organization_stats_summary.sql

Proposito: Resumen de estadisticas por organizacion

Columna	Descripcion
org_id	ID de organizacion
total_users	Total usuarios
active_users	Usuarios activos
total_classrooms	Total aulas
total_exercises_completed	Ejercicios completados

---

recent_admin_actions.sql

Proposito: Acciones recientes de administradores

Columna	Descripcion
action_id	ID de accion
admin_id	Admin que ejecuto
action_type	Tipo de accion
target_entity	Entidad afectada
timestamp	Cuando ocurrio

---

user_stats_summary.sql

Proposito: Resumen de estadisticas de usuarios

Columna	Descripcion
total_users	Total usuarios
active_today	Activos hoy
new_this_week	Nuevos esta semana
by_role	Desglose por rol

---

2. SCHEMA: auth (1 view)

tenants_alias.sql

Proposito: Alias para acceso simplificado a tenants

Columna	Descripcion
tenant_id	ID del tenant
name	Nombre
alias	Alias corto
status	Estado del tenant

---

3. SCHEMA: educational_content (1 view)

01-v_validation_analysis.sql

Proposito: Analisis de validacion de contenido educativo

Columna	Descripcion
exercise_id	ID de ejercicio
validation_status	Estado de validacion
errors_found	Errores encontrados
warnings	Advertencias
last_validated	Ultima validacion

---

4. SCHEMA: gamification_system (4 views)

01-leaderboard_coins.sql

Proposito: Leaderboard por ML Coins

Columna	Descripcion
rank	Posicion
user_id	ID usuario
username	Nombre de usuario
total_coins	ML Coins totales
avatar_url	URL avatar

---

02-leaderboard_global.sql

Proposito: Leaderboard global combinado

Columna	Descripcion
rank	Posicion
user_id	ID usuario
username	Nombre
total_xp	XP total
maya_rank	Rango Maya
total_coins	ML Coins

---

03-leaderboard_streaks.sql

Proposito: Leaderboard por rachas de actividad

Columna	Descripcion
rank	Posicion
user_id	ID usuario
username	Nombre
current_streak	Racha actual (dias)
longest_streak	Racha maxima

---

04-leaderboard_xp.sql

Proposito: Leaderboard por puntos de experiencia

Columna	Descripcion
rank	Posicion
user_id	ID usuario
username	Nombre
total_xp	XP total
maya_rank	Rango Maya actual

---

5. SCHEMA: gamilit (1 view)

number_series.sql

Proposito: Utilidad para generar series numericas

Columna	Descripcion
n	Numero en la serie

Uso: Funciones de utilidad y generacion de datos

---

6. SCHEMA: progress_tracking (2 views)

02-teacher_pending_reviews.sql

Proposito: Revisiones pendientes para docentes

Columna	Descripcion
review_id	ID de revision
student_id	Estudiante
exercise_id	Ejercicio
exercise_type	Tipo (M4/M5 creativos)
submitted_at	Fecha de envio
status	Estado (pending)

---

user_progress_summary.sql

Proposito: Resumen de progreso del usuario

Columna	Descripcion
user_id	ID usuario
modules_completed	Modulos completados
exercises_completed	Ejercicios completados
total_xp	XP ganado
current_streak	Racha actual
last_activity	Ultima actividad

---

7. SCHEMA: social_features (1 view)

01-classroom_progress_overview.sql

Proposito: Vista general de progreso del aula

Columna	Descripcion
classroom_id	ID del aula
student_id	Estudiante
student_name	Nombre
module_progress	Progreso por modulo (JSON)
total_progress	Progreso total %
maya_rank	Rango actual

---

NOTAS TECNICAS

Permisos

Todas las views tienen permisos para gamilit_user:

GRANT SELECT ON schema.view_name TO gamilit_user;

Mantenimiento

• Las views no requieren datos iniciales (seeds)
• Se recrean en cada ./init-database.sh
• Dependen de tablas base del schema

Performance

Views con indices recomendados:

• leaderboard_* - Indexar por user_id, total_xp
• classroom_progress_overview - Indexar por classroom_id
• teacher_pending_reviews - Indexar por status, submitted_at

---

Generado por: Requirements-Analyst Fecha: 2025-12-26 Version: 1.0