Skip to content

ytunoRTX/UNIBOT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 UniBot: Asistente Académico Inteligente e Inclusivo

Hackathon 2025 - Automatización, Eficiencia y Accesibilidad Universitaria.

Status Stack


El Problema

La gestión académica actual enfrenta dos grandes desafíos:

  1. Ineficiencia Burocrática: El 90% de los estudiantes pierden horas en filas o navegando portales web complejos para trámites simples (certificados, consultas), lo que satura a las secretarías.
  2. Barreras de Acceso: Las plataformas tradicionales son rígidas y excluyentes. Un estudiante con dificultades motoras o visuales depende de terceros para realizar gestiones básicas.

La Solución

UniBot es un sistema de Automatización Inteligente diseñado para TODOS. Transforma la burocracia en una conversación fluida en Telegram.

Su enfoque es Multimodal y Universal:

  • Para el estudiante ocupado: Ofrece inmediatez. Permite gestionar trámites en segundos mediante menús rápidos o notas de voz mientras se desplaza.
  • Para el estudiante con discapacidad: Elimina las barreras de entrada, permitiendo una gestión 100% autónoma mediante comandos de voz natural.

No es solo un chatbot, es una ventanilla virtual 24/7 que:

  1. Escucha y Lee: Procesa tanto Texto como Voz (Whisper AI).
  2. Razona: Entiende la intención del usuario sin necesidad de comandos rígidos.
  3. Ejecuta: Genera documentos oficiales válidos al instante.

Características Clave

1. Interfaz Multimodal (Texto y Voz)

El sistema se adapta al usuario, no al revés.

  • Modo Texto: Menús visuales claros y navegación rápida para consultas silenciosas.
  • Modo Voz: Potente motor Voice-to-Text que permite solicitar trámites complejos (ej: "Dame mis notas, cédula 123...") hablando naturalmente. Ideal para agilizar procesos o para personas con dificultades de escritura.

2. Generación Dinámica de Documentos

Los certificados se generan en tiempo real inyectando datos SQL en plantillas profesionales.

  • Tecnología: Liquid Templates + CSS Print.

3. Seguridad y Validez

Cada documento generado incluye medidas de seguridad antifraude:

  • Código QR Dinámico: Enlace de validación único por documento.
  • Hash SHA-256: Simulación de firma electrónica para integridad de datos.

4. Robustez y Control de Sobrecarga (Guardrail de Frecuencia)

Para prevenir la sobrecarga del servidor y garantizar una experiencia equitativa para todos los usuarios, UniBot incorpora un sistema inteligente de "Semáforo" de frecuencia:

  • Problema Abordado: Evitar ataques de denegación de servicio (DDoS) involuntarios, donde múltiples usuarios intentan generar documentos costosos en RAM simultáneamente.
  • Mecanismo Implementado: Antes de generar el documento, el sistema consulta la base de datos para verificar la fecha_emision de la última solicitud.
  • Regla de Tiempo: Si el tiempo transcurrido desde la última solicitud es inferior a un umbral predefinido (ej. 2 minutos), la ejecución es bloqueada con un mensaje de espera.
  • Beneficio: Asegura la estabilidad operativa 24/7 y protege los recursos del servidor.

5. Manejo de Errores y Guiado de Usuario (Guardrails)

El agente cuenta con reglas estrictas (Guardrails) para guiar al usuario si ingresa opciones inválidas, evitando que el sistema colapse ante entradas inesperadas. También incluye validación de datos para avisar al usuario si la cédula ingresada no existe en la base de datos.


Stack Tecnológico

Componente Función
n8n Orquestación del flujo de trabajo, lógica de negocio y agentes IA.
Telegram Interfaz de usuario (Frontend).
OpenAI (Whisper) Transcripción de mensajes de voz.
OpenAI (GPT) Agente IA para razonamiento y entendimiento de intención.
PostgreSQL / Supabase Base de datos para registros académicos y control de frecuencia.
PDFMonkey Generación de documentos PDF profesionales mediante inyección SQL.

About

Asistente Académico Inteligente (Hackathon 2025).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors