studylife-discord
Bot para Discord que integra StudyLife mediante comandos slash y webhooks. Proporciona acceso a cursos, temporizadores, estadísticas de estudio y notas sin conexión persistente al Gateway.
Ficha actualizada 28 sept 2026, 9:16 · upstream 28 sept 2026, 8:53 · release v0.1.28
Qué es studylife-discord
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
studylife-discord es un bot diseñado específicamente para interactuar con la plataforma StudyLife a través de Discord. Utiliza una arquitectura basada en Python (FastAPI/uvicorn) que procesa comandos slash para consultar el estado del temporizador, gestionar sesiones de estudio y buscar notas. A diferencia de otros bots, opera bajo un modelo single-user: una única cuenta de StudyLife autentificada gestiona todas las acciones del bot, eliminando la necesidad de vincular cuentas individuales por usuario de Discord.
- Consulta del estado actual del temporizador de concentración (Fokus-Timer).
- Visualización de estadísticas de tiempo de estudio en periodos específicos (semana, mes).
- Gestión de notas mediante búsqueda y creación de nuevas entradas.
- Seguimiento del progreso académico por grados universitarios (ECTS).
- Notificaciones automáticas de inicio y finalización de sesiones vía webhooks.
- Consulta de objetivos de aprendizaje abiertos y totales.
- Arquitectura sin conexión persistente al Gateway de Discord, reduciendo la huella de recursos.
- Licencia AGPL-3.0, garantizando código abierto y permisos comerciales bajo condiciones de reciprocidad.
- Integración nativa con el sistema de webhooks de StudyLife para anuncios automáticos.
- Validación estricta de enums en Discord para evitar ambigüedades en fechas (ej: 'esta semana' vs 'la última').
- Cálculo client-side del progreso ECTS derivado de datos de cursos y objetivos.
- Seguridad reforzada mediante claves API separadas y autenticación OAuth2 estándar.
- Diseñado para un único usuario de StudyLife; no soporta vinculación granular por usuario de Discord.
- Funciones de edición o borrado de notas, sesiones y objetivos están deliberadamente ocultas sin paso de confirmación externo.
- El progreso del programa predeterminado (id: null) no devuelve detalles detallados en la API original.
- Requiere configuración manual de webhooks y endpoints de interacción en el portal de desarrolladores.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue auto-alojado compatible con K3s. Requiere configurar variables de entorno para credenciales de Discord (TOKEN, APPLICATION_ID) y StudyLife (API_KEY). El endpoint de interacciones debe apuntar a una URL pública válida para recibir PINGs de Discord. Para anuncios automáticos, es necesario crear un webhook en StudyLife apuntando al endpoint /webhooks/studylife y configurar el ID del canal de Discord objetivo.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.