Ce projet vise à automatiser l'émargement des étudiants de l'Université Bretagne Sud, en particulier ceux de l'ENSIBS. En utilisant Selenium dans un conteneur Docker, il enregistre automatiquement leur présence en cours, évitant ainsi toute retenue sur leur salaire. Son fonctionnement : chaque jour de la semaine, il récupère les cours de l'étudiant via l'API de PlanningSup et vérifie s'il y a une mise à jour. Au début de chaque cours, il émarge automatiquement entre 5 et 10 minutes après le début du cours. De plus, il est possible de recevoir une notification sur son téléphone pour être informé des nouvelles mises à jour, des émargements réussis ainsi que des possibles erreurs.

1. Clonez le dépôt Github

git clone https://github.com/MTlyx/Emarge.git && cd Emarge

2. Modifiez les variables d'environnement du fichier docker-compose.yml

Les variables à modifier sont les suivantes :

• FORMATION : formation de l'étudiant (cyberdefense, cyberdata ou cyberlog)
• ANNEE : Année d'étude (3, 4 ou 5)
• TP : Numéro du groupe de TP (1 à 6)
• Us : Votre identifiant UBS
• Pa : Votre mot de passe UBS
• blacklist : Liste de mots-clés pour exclure certains cours de l'émargement
• TOPIC : Votre topic nfty est à configurer ici (Il sert a recevoir des notifications sur votre téléphone)

Exemple de configuration d'un cyberdefense en 3eme année dans le TP 1

- FORMATION=cyberdefense
- ANNEE=3
- TP=1
- Us=e2404000
- Pa=MonSuperMotDePasse
- blacklist=Entrainement Le Robert, Activités HACK2G2, Activités GCC, Séminaire Facteur Humain
- TOPIC=XXXXXXXXXXX

3. Lancez le conteneur Docker

sudo docker compose up -d

Les notifications sont gérées avec ntfy.sh, son utilisation est très simple

1. Télécharger l'application sur Google Play ou l'App Store

2. Configurez les notifications en appuyant sur le + puis en sélectionner un topic, il faudra aussi le rajouter dans le docker-compose.yml

3. Au premier lancement du programme d'émargement, vous devriez recevoir une notification pour tester la bonne configuration de ntfy

Merci à @Eudaeon pour l'idée

Il est aussi possible de passer le programme en mode notification seulement et il n'émargera pas à votre place

1. Mettre la directive de build target à notification dans le docker-compose.yml

2. Renseigner le topic dans le docker-compose.yml ainsi que votre formation, année et TP

3. L'utilisation de Us et Pa est inutile, vous n'avez donc pas besoin de les configurer

4. Si vous aviez déjà lancé le projet, vous devrez rajouter l'option --build

5. Lancer le projet avec docker compose up -d

Merci à @ElouanFiore pour l'intégration

Pour commencer, il faut supprimer le conteneur Docker avec la commande

sudo docker compose down

Ensuite, il faut mettre à jour le projet avec conteneur Docker, commencez par mettre à jour les différents fichiers avec

git reset --hard
git pull

Enfin, il ne reste plus qu'à le relancer avec l'option --build en plus

sudo docker compose up --build -d

Vous pouvez vérifier vos logs de deux manières :

1. Directement depuis Docker :

sudo docker compose logs -f

2. En consultant le fichier de log :

cat app/emargement.log

Les logs vous permettront de voir :

• Les horaires prévus d'émargement
• Les succès/échecs des émargements
• Les éventuelles erreurs