Semillero Digital Dashboard

Inspiration

La inspiración nació del deseo de demostrar que los contratos LLM creados funcionan en un caso real. El proyecto sirve como prueba viva de que es posible guiar el desarrollo completo de un sistema educativo moderno únicamente a través de contratos bien definidos.

What it does

El Semillero Digital Dashboard conecta la formación digital con la tecnología.

• Estudiantes: ven cursos, tareas entregadas, pendientes y atrasadas.
• Docentes: gestionan entregas de alumnos y corrigen tareas.
• Coordinadores: buscan alumnos, identifican métricas de riesgo y detectan abandono.
• Administradores: tienen una visión global de cursos, alumnos y tasas de finalización. Además, funciona en dos modos:
• Mock: con dataset simulado para demos y pruebas.
• Google: integrado a Google Classroom API en producción. Incluye notificaciones mock vía Telegram para avisos de tareas y riesgos.

How we built it

• Backend separado en Node.js + TypeScript, con APIs REST {data, meta}.
• Frontend en Next.js 15 + React 18 + TypeScript, con Bootstrap 5.3 y ApexCharts.
• Modo Mock con datos simulados (2 cursos, 300 alumnos, tareas variadas).
• Modo Google con OAuth2 y consumo real de Google Classroom.
• Desarrollo con enfoque TDD, contratos LLM por etapas y registros en workspace/.

Challenges we ran into

• Diseñar un backend flexible que funcione en modo mock y real sin romper el frontend.
• Resolver la integración OAuth2 con Google y manejar tokens de forma segura.
• Asegurar trazabilidad de errores y soluciones en workspace/errores.md.
• Mantener simplicidad en la UI para usuarios no técnicos.

Accomplishments that we're proud of

• Validar que los contratos LLM funcionan como guía de desarrollo real.
• Entregar un MVP capaz de funcionar en hackatón/demo en modo Mock y escalar a modo Google.
• Diseñar dashboards claros para cada rol con métricas útiles de riesgo y abandono.
• Implementar prácticas de TDD, accesibilidad y CI/CD desde el inicio.

What we learned

• Los contratos LLM permiten estructurar y gobernar proyectos complejos de software de forma colaborativa.
• La importancia de pensar en modos alternativos (Mock vs Google) para acelerar validaciones sin depender de APIs externas.
• Que la claridad en los roles y métricas críticas (abandono, atrasos, riesgo) es clave para cualquier plataforma educativa.

What's next for Semillero Digital Dashboard

• Escalar el sistema a cohortes reales con miles de alumnos.
• Extender la capa de notificaciones a múltiples canales (Email, WhatsApp, etc.).
• Incorporar analítica avanzada: predicción de abandono y recomendaciones personalizadas.
• Mejorar la experiencia de accesibilidad y usabilidad para llegar a más usuarios.
• Publicar los contratos como open framework para que otros proyectos puedan replicar el modelo.

Built With

• apexcharts
• bootstrap-5.3
• ci/cd
• dataset-mock-json
• express/fastify
• git
• google-classroom-api
• javascript
• next.js-15
• node.js
• oauth2
• playwright
• react-18
• react-bootstrap
• telegram-(mock)
• typescript
• vitest
• windsurf