Projet Gnotes - Application de gestion de notes

Description Générale

Gnotes est une application de bureau développée en Java, destinée aux enseignants pour la gestion des notes d’élèves. Elle permet une utilisation en mode hors ligne et intègre une interface JavaFX ainsi qu’une API REST réalisée avec Spring Boot. Elle offre une interface conviviale permettant de gérer les étudiants, les matières et les contrôles associés à des statistiques claires et détaillées.

But du projet

Le projet GNotes a pour objectif principal de concevoir et de développer une application de bureau intuitive, robuste et fonctionnelle permettant aux enseignants du BTS SIO de gérer efficacement les notes et appréciations des étudiants.

Cette solution vise à répondre aux besoins suivants :

Offrir un outil simple d’utilisation pour la saisie des notes, coefficients et appréciations par matière et par étudiant.
Permettre une visualisation en temps réel des statistiques de classe (moyenne, note minimale et maximale) pour chaque matière.
Fournir une vue d’ensemble des résultats des étudiants, toutes matières confondues, avec mise en avant des majors de promotion par semestre.
Garantir une utilisation hors réseau, pour que les enseignants puissent travailler même sans connexion Internet.
Faciliter la gestion des utilisateurs et des données (enseignants, étudiants, matières) via une interface d’administration.
Assurer la pérennité et l’évolutivité du système par le respect des bonnes pratiques de développement (tests unitaires, gestion des exceptions, intégration continue).
Permettre à terme la synchronisation des données avec une base de données distante via une API RESTful.

Ce projet s’inscrit dans une démarche pédagogique, professionnelle et collaborative avec une méthode agile (SCRUM) pour fournir un produit de qualité, évolutif et répondant aux attentes des utilisateurs.

Projet Gnotes

Utilité de l'application

Gnotes a été conçue pour répondre aux besoins des enseignants souhaitant :

🧑‍🏫 Gérer les contrôles et notes des étudiants facilement depuis leur poste.
📉 Visualiser les statistiques par contrôle et par matière.
📁 Conserver une trace hors ligne des évaluations réalisées.
👀 Avoir une vue synthétique sur les résultats et les appréciations.

Chaque enseignant peut consulter tous les étudiants, gérer les contrôles de sa matière, et suivre les performances par semestre.

Fonctionnalités principales

👨‍🏫 Authentification sécurisée des enseignants.
📝 Création, modification et suppression de contrôles.
📊 Visualisation de la moyenne, note min, note max par matière.
📚 Accès rapide aux élèves et à leurs performances.
📶 Fonctionnement hors-ligne pour la saisie des notes.
🧾 Statistiques claires et précises pour chaque matière et chaque élève.
🔐 Gestion des utilisateurs et rôles (connexion sécurisée avec mot de passe chiffré).

Technologies Utilisées

Java : développement de l'application côté client et serveur.
Spring Boot : framework Java pour construire l’API REST.
Hibernate (JPA) : gestion des entités et persistance des données.
JavaFX : interface graphique moderne et interactive.
MySQL : base de données relationnelle pour stocker toutes les informations.
POSTMAN : pour tester les endpoints de l'API.
Eclipse / SceneBuilder : IDE et outil de conception d'interface graphique.

Structure du Projet Java

Le projet est organisé en couches claires selon le modèle MVC :

com.saintsau.slam2.gnotes30.controller : pour gérer les vues et la navigation.
com.saintsau.slam2.gnotes30.entity : correspondance directe avec les tables de la base.
com.saintsau.slam2.gnotes30.service : logique métier (ex : calcul de moyenne).
com.saintsau.slam2.gnotes30.jpaRepository : interfaces JPA pour interroger la base.
com.saintsau.slam2.gnotes30.exception : gestion des exceptions personnalisées.

Base de données

La base gnotesdb contient les tables principales suivantes :

etudiants : informations des élèves (nom, prénom, numéro).
controles : chaque note liée à un élève, une matière et un professeur.
matieres : liste des matières enseignées.
users : informations de connexion des professeurs (nom d'utilisateur, mot de passe).

Le schéma relationnel montre clairement les dépendances entre les entités. Par exemple, chaque contrôle possède une clé étrangère vers un étudiant, une matière et un utilisateur (professeur).

Classes du projet Gnotes

Le projet Gnotes est structuré autour de plusieurs classes Java réparties dans des packages bien définis. Chaque package a un rôle spécifique dans l’architecture de l’application selon le modèle MVC (Modèle-Vue-Contrôleur).

entity : contient les classes représentant les entités de la base de données comme Etudiant, Controle, Matiere et User. Ces classes sont annotées avec JPA pour permettre la persistance en base de données.
controller : regroupe les classes responsables de la gestion des événements de l'interface utilisateur. Par exemple, LoginPageController gère la connexion, tandis que AddControleController permet d’ajouter des contrôles.
service : contient les classes qui implémentent la logique métier, comme le calcul de moyennes ou la gestion des filtres de recherche.
jpaRepository : interfaces héritant de JpaRepository pour accéder aux données des entités sans écrire de requêtes SQL (ex : EtudiantRepository, ControleRepository).
exception : classes de gestion des erreurs personnalisées, telles que EtudiantNotFoundException ou ControleNotFoundException, afin de rendre les messages d’erreur plus explicites.

Aperçu des classes Java du projet Gnotes

Page de Connexion

Lors de l'ouverture de l'application, l'utilisateur est redirigé vers une page de connexion. Il doit entrer un identifiant et mot de passe. L’authentification est validée via l’API Spring Boot. En cas de succès, l'utilisateur est redirigé vers les onglets (Élèves, Professeurs, Contrôles).

Page Élèves

L’interface permet de visualiser rapidement la liste des élèves enregistrés. Il est possible d’ajouter un élève via le bouton prévu à cet effet. Un double-clic permet d’accéder à ses notes et statistiques.