Inspiration La inspiración provino de observar el proceso manual existente para gestionar justificantes académicos, el cual era desordenado, propenso a fallos y dependía de correos, hojas de Excel y documentos sueltos. El objetivo era eliminar los errores, reducir el tiempo perdido y crear un flujo de trabajo trazable para la administración.

What it does Kiosko Directivo es una plataforma web que digitaliza y centraliza todo el proceso de justificantes para estudiantes que asisten a eventos institucionales. La plataforma:

Centraliza las solicitudes.

Valida automáticamente matrículas y horarios.

Genera el justificante oficial en formato PDF.

Prepara correos personalizados para cada profesor, listando solo a los alumnos que tienen en su clase.

Provee un panel para revisar, aprobar o rechazar justificantes.

How we built it Construimos una plataforma web con un frontend en Next.js (usando el app router) y React. La autenticación de usuarios se gestiona con Firebase Auth. Para la persistencia de datos, el frontend consume una API externa (NEXT_PUBLIC_API_URL) que se conecta a una base de datos MongoDB.

Challenges we ran into Los principales desafíos fueron técnicos y de configuración:

Asegurar la correcta conexión con la base de datos MongoDB a través de la variable MONGODB_URI.

Configurar correctamente las variables de entorno (.env.local) para que el frontend pudiera consumir la API externa (NEXT_PUBLIC_API_URL).

Integrar y configurar adecuadamente el SDK de Firebase para la autenticación.

Accomplishments that we're proud of Estamos orgullosos de haber convertido un proceso manual caótico en una operación digital clara, rápida y totalmente auditable. Logramos crear un flujo que ahorra tiempo a la administración y reduce drásticamente los errores. También implementamos un componente funcional para analizar archivos HTML (.htm/.html) y extraer automáticamente datos de estudiantes, profesores y horarios.

What we learned Aprendimos cómo analizar un flujo de trabajo administrativo real y propenso a fallos para transformarlo en una solución digital eficiente. Técnicamente, aprendimos a integrar un stack moderno (Next.js, React) con servicios de terceros como Firebase Auth y una API RESTful conectada a MongoDB para crear una aplicación web completa.

What's next for Kiosko Gallo Los próximos pasos sugeridos se centran en robustecer la aplicación:

Mover la configuración pública de Firebase a variables de entorno NEXT_PUBLIC_*.

Añadir validaciones más estrictas y un mejor manejo de errores en las llamadas a la API.

Implementar pruebas unitarias y de extremo a extremo (e2e) para los flujos críticos, como el login y la aprobación de justificantes.

Built With

Share this project:

Updates