Accueil Hypercerts
Vous cherchez à délivrer aux étudiants de votre université des attestations de réussite dématérialisées ? Hypercerts vous permettera de générer et envoyer des attestations officielles, numériques, et infalsifiable.
Ces dernières pourront être envoyées par mail, déposées dans le nuage, et même être certifiées authentiques et intègres grâce à une blockchain dédiée.
Une fois l'application connectée à Apogée et au LDAP, les gestionnaires de composantes pourront demander la génération et l'envoi des attestations de réussite en un clic.
Prérequis
Hypercerts est une application Java qui se connecte à Apogée et au LDAP. Elle requiert l'utilisation d'une base MariaDB pour son fonctionnement interne. Elle se déploie sur des serveurs comme une application SpringBoot classique. Le WAR pourra être pris en charge par un tomcat et servir les utilisateur•ices via l'URL configuré.
Technologie | Version |
|---|---|
JDK | 11+ |
SpringBoot | 2.3 |
Vaadin (Frontend) | 14 |
Tomcat | 9+ |
MariaDB | 14+ |
Maven | 3.6+ |
Connection Apogée | |
Connection Apogée via WS | |
Connection LDAP | |
Docker (optionnel) | docker-compose 3 |
Téléchargement des sources
Provisoirement, les sources de l'application peuvent être téléchargées à cet endroit.
Personalisation d'Hypercerts
Configuration l'application
Créer et compléter un fichier application.yaml à la racine du projet sur le modèle de application-sample.yaml
Pour empêcher l'envoi de mails de test en réel, il est conseillé :
- d'utiliser un mail catcher (https://mailcatcher.me/) en remplacement de votre smtp
- ou de configurer l'application pour intercepter tout les mails applicatifs avec ces valeurs :
- app.production à false
- spring.mail.intercept.active à true
- et spring.mail.intercept.mails contenant une ou plusieurs adresses de réception des mails
Configurer et lancer le projet dans Eclipse
- Importer le projet Maven dans eclipse.
- Démarrer l'application en faisant un clic droit sur fr.univlorraine.hypercerts.Application.java et en choisissant 'Run As / Java Application'.
Tâches Maven
- Lancer l'application (hors d'un IDE) :
- Lancer les tests :
- Créer le package pour production :
Customisation des services
Tests unitaires
Pour s'assurez que les résultats d'admission de vos étudiants soient bien correct, et afin d'éviter les faux positifs (donc envoyer une attestation de réussite à un•e étudiant•e non reçu•e aux examens), vous pouvez ajouter vos jeux de données.
Compilation en local
Un Makefile est à votre disposition. Dans le repertoire source, utilisez `make help` pour obtenir les commandes disponibles.
