Volver al Inicio
Documentación Oficial

Toolkit Educativo ClassRoom Clash

Una herramienta administrativa y de gamificación diseñada para transformar la dinámica del aula.

¿Qué es ClassRoom Clash?

Es un toolkit educativo gamificado y una herramienta administrativa para profesores. Diseñado bajo una arquitectura modular limpia en Python, utiliza Tkinter para una interfaz fluida y SQLite para la persistencia de datos segura. La aplicación permite gestionar grupos de estudiantes y motivar su participación mediante dinámicas de juego.

Funcionalidades Estrella

Características Principales

Gestión de Grupos

Crea, edita y organiza tus listas. Incluye función de Archivado para limpiar tu vista sin perder datos históricos.

Sorteo "Champions Style"

Crea equipos balanceados con animaciones estilo sorteo internacional. Modos Manual y Automático (cada 2 seg).

Tómbola de Participación

Selección aleatoria con opciones de: Puntos (+/-), 0 Puntos (Participó) y Exclusión Temporal (🚫) para ausentes.

Control de Actividades

Ranking automático (🥇, 🥈, 🥉) según velocidad de entrega. Permite eliminar o corregir entregas accidentales.

Leaderboard & Reportes

Visualiza a los destacados y exporta todo a Excel (.xlsx) para integrarlo con tu libreta de calificaciones.

Ayuda Contextual

Botón azul de "❓ Ayuda" en cada pantalla con instrucciones instantáneas de uso.

Arquitectura Modular

Diseñado con un sistema de mixins para máxima escalabilidad. Los componentes principales son:

app.py: Contenedor maestro y gestión de estado global.
state.py: AppState centralizado para datos efímeros.
database.py: Lógica SQLite con soporte para archivado.
constants.py: Sistema de diseño (temas "premium" y colores).
screens.py / wheel.py / activities.py: Dominios lógicos de la interfaz.

Ejecución y Portabilidad

Ejecutar desde el código:

python -m classroomclash

Empaquetado Portable (.exe):

Utiliza el script integrado para generar la versión portable con un solo comando:

python build_exe.py

El resultado es un único archivo ClassRoomClash.exe en la carpeta /dist.

Portabilidad de Datos: El ejecutable y la base de datos desafio_data.db deben vivir juntos. Puedes llevarlos en una memoria USB y funcionarán al 100% sin conexión a internet.

Preguntas Frecuentes

¿Funciona en Mac?
¡Sí! Hemos lanzado la versión .dmg para usuarios de Apple. Solo descarga, arrastra a aplicaciones y listo.
¿Mis datos están seguros?
Totalmente. Toda la información se guarda en el archivo desafio_data.db en tu misma carpeta. Nada se sube a la nube.