Construyendo TAssist mi viaje creando un asistente docente con IA para Google Classroom
Cómo levanté una aplicación full stack para revolucionar la evaluación de tareas con FastAPI, Next.js y modelos de inteligencia artificial
El problema que lo inició todo
Como asistente docente me enfrentaba al esfuerzo de evaluar cientos de entregas de código y dar retroalimentación útil de forma consistente. El proceso manual era lento, generaba incoherencias en la calificación y retrasaba la devolución de comentarios. Además, tomar vivas manuales podía llevar de 2 a 3 días, así que decidí crear TAssist para revisar tareas con un solo clic.
Qué hace TAssist
• Evalúa automáticamente entregas de programación con modelos de IA. • Se integra de forma nativa con Google Classroom. • Genera feedback detallado en función de rúbricas e instrucciones. • Admite múltiples formatos de archivo como código, PDF y cuadernos Jupyter. • Permite control granular para evaluar entregas completas o ficheros concretos.
Stack tecnológico
Backend con FastAPI y Python. API REST robusta, cliente de Google para integrarse con Classroom, Firebase Admin SDK para datos, Redis para caché de resultados, modelos de OpenAI y DeepSeek para evaluación, y librerías de parsing como PyMuPDF y python docx.
Frontend con Next.js y TypeScript. Next.js 15 con App Router, TypeScript para seguridad de tipos, TailwindCSS para estilo, Framer Motion para animaciones y React Context API para gestionar estado.
Arquitectura en detalle
Autenticación con Google OAuth. Implementé un flujo OAuth seguro con consentimiento, tokens de actualización y manejo de expiración para operar con los permisos de Google Classroom sin fricciones.
Parsing inteligente de archivos. TAssist procesa ZIPs con estructuras anidadas y extrae contenido de archivos de texto, PDF, DOCX e IPYNB, preservando el contexto de dónde proviene cada fragmento para que la IA entienda la entrega de forma holística.
Motor de evaluación con IA. El corazón de TAssist es un motor con tolerancia a fallos y conmutación entre proveedores que produce resultados consistentes con formato estructurado incluyendo puntuación total, desglose según la rúbrica y retroalimentación técnica específica.
Retos y soluciones
Límites de tasa de la API de Google. Para evitar bloqueos al consultar grandes clases, apliqué concurrencia controlada con semáforos, reintentos con backoff y manejo cuidadoso de errores transitorios.
Estructuras de archivos complejas. Las entregas venían en múltiples formatos y niveles de anidación. Diseñé un parser extensible por tipo de archivo y con normalización de contenido para maximizar la calidad del texto que consume la IA.
Gestión de estado en React. Para estados complejos de evaluación, selección de archivos y actualizaciones en tiempo real usé Context API con TypeScript, tipando cada entidad para prevenir errores en tiempo de ejecución.
Características clave
Interpretación inteligente de instrucciones. Detecta si una tarea es de programación o subjetiva y adapta el enfoque de evaluación y el prompt de IA a cada caso.
Selección granular de archivos. El docente elige qué ficheros considerar, útil cuando una entrega incluye assets irrelevantes o documentación extensiva.
Caché con Redis. Los resultados se almacenan temporalmente para acelerar consultas repetidas y evitar reprocesamiento innecesario.
Lo que aprendí al construir TAssist
Integración de APIs a escala. Profundicé en flujos de autenticación, límites de tasa y manejo de casos límite en integraciones con terceros.
Ingeniería de prompts. Redactar prompts claros y prescriptivos fue crucial para lograr consistencia, sobre todo al exigir formato de salida estructurado y criterios de evaluación explícitos.
Procesamiento de archivos. Trabajar con streams, memoria y librerías específicas por formato fue clave para rendimiento y estabilidad.
Diseño de experiencia de usuario. Comprender el flujo del docente permitió crear una interfaz simple, enfocada y realmente útil.
Impacto y futuro
TAssist ahorra horas de corrección manual, homogeneiza criterios, ofrece feedback inmediato y escala la evaluación en clases masivas.
Próximas mejoras
• Mayor cobertura de lenguajes y tipos de tareas. • Integración con otros LMS como Canvas y Moodle. • Analítica avanzada para insights de rendimiento por clase. • Detección de plagio. • App móvil para revisión en movilidad.
Buenas prácticas técnicas
Manejo de errores. Con múltiples servicios externos y modelos de IA, la degradación elegante, los reintentos y los guardarraíles son esenciales.
Seguridad de tipos. TypeScript en todo el frontend evitó fallos sutiles y mejoró la mantenibilidad.
Optimización de rendimiento. Caché, carga perezosa y concurrencia marcan la diferencia entre una herramienta lenta y una experiencia excelente.
Conclusión
Construir TAssist ha sido un proyecto profundamente gratificante. Automatizar algo con impacto directo en el aprendizaje es emocionante. Como cualquier base de código viva, siempre hay margen de mejora, pero el avance ya demuestra su valor.
Sobre Q2BSTUDIO
En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, con un fuerte enfoque en inteligencia artificial, ciberseguridad, automatización de procesos, servicios cloud aws y azure, servicios inteligencia de negocio y power bi. Nuestro equipo crea soluciones de ia para empresas, diseña agentes IA y acompaña a organizaciones en su transformación digital end to end. Si tu organización busca acelerar iniciativas de inteligencia artificial, explora cómo podemos ayudarte con nuestra práctica de inteligencia artificial. Si necesitas una plataforma robusta y a medida, descubre nuestro enfoque de software a medida.
¿Quieres probar TAssist?
El proyecto está en desarrollo activo y buscamos feedback de docentes y desarrolladores. Si te interesa evaluarlo o contribuir, estaremos encantados de escucharte. Etiquetas sugeridas para la conversación IA, Educación, FastAPI, NextJS, GoogleAPI, FullStack, Python, TypeScript, OAuth, WebDevelopment, aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi.