schulmanager-calendar-sync
Servicio autoalojado que sincroniza automáticamente los horarios de Schulmanager Online con Google Calendar de forma segura y privada, utilizando Docker para despliegue sencillo sin interfaz web.
Ficha actualizada 27 sept 2026, 17:08 · upstream 27 sept 2026, 16:48 · release v0.1.0
Qué es schulmanager-calendar-sync
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El servicio consulta una ventana de horario móvil, convierte las clases en eventos estables y reconcilia esos eventos con un Google Calendar. Las sincronizaciones repetidas actualizan solo lo que ha cambiado y eliminan solo los eventos previamente creados por el proyecto.
Funciona como contenedor Docker no privilegiado, leyendo credenciales de Schulmanager Online y cuentas de servicio de Google desde archivos seguros en .env y directorios data/. Soporta plantillas personalizadas para títulos de eventos, iconos por materia y notificaciones de cambios vía webhook.
Es un proyecto comunitario no oficial. Requiere mantenimiento si Schulmanager cambia su API o estructura web, ya que no ofrece una API pública documentada para los horarios. Se recomienda pinning de versiones en despliegues productivos.
- Sincronización automática de horarios escolares
- Gestión de sustituciones y cancelaciones
- Notificaciones de cambios vía webhook
- Despliegue privado en servidor local
- Sincronización continua configurable
- Manejo de zonas horarias (Europe/Berlin)
- Eventos estables con ID único
- Seguridad: credenciales en .env y data/
- API no oficial de Schulmanager requiere mantenimiento
- Eventos gestionados pueden sobrescribirse si se editan manualmente en Google Calendar
- Sin interfaz web para gestión de credenciales
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.
Usar Docker Compose o GHCR. Configurar correctamente SCHULMANAGER_TOKEN y credenciales de Google. No exponer el endpoint /health públicamente sin proxy autenticado. Backup de data/ y rotación de credenciales.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.