Examen Site Web + API Documentation du Portail Professeurs Table des matières Introduction Architecture technique Structure du projet Fonctionnalités principales Guide d'utilisation API et endpoints Base de données Sécurité Déploiement Dépannage 1. Introduction Le Portail Professeurs est une application web conçue pour aider les enseignants à gérer efficacement leurs classes, les absences des élèves, les réservations de salles, et à communiquer avec les autres membres de l'établissement. Cette plateforme centralisée offre une interface intuitive et responsive qui s'adapte à tous les appareils. Objectifs du projet Simplifier la gestion administrative pour les enseignants Améliorer le suivi des absences des élèves Faciliter la réservation des salles Offrir des outils de communication entre les membres de l'équipe éducative Fournir des statistiques et des rapports sur les performances et l'assiduité 2. Architecture technique Frontend Framework : Next.js 14 (App Router) Langage : TypeScript UI/UX : Tailwind CSS avec shadcn/ui État client : React Hooks Requêtes API : Fetch API Backend Framework : ASP.NET Core 9 Langage : C# Architecture : API RESTful Authentification : JWT (JSON Web Tokens) WebSockets : Pour la messagerie en temps réel Base de données SGBD : MySQL ORM : Entity Framework Core 3. Structure du projet Frontend (Next.js) /app # Dossier principal des routes (App Router) /absences # Gestion des absences /classes # Gestion des classes /login # Page de connexion /messages # Système de messagerie /notifications # Centre de notifications /parametres # Paramètres utilisateur /points # Système de points /rapports # Génération de rapports /reservations # Réservation de salles /salles # Gestion des salles /statistiques # Tableaux de bord et statistiques /layout.tsx # Layout principal /globals.css # Styles globaux /page.tsx # Page d'accueil /components # Composants réutilisables /ui # Composants UI (shadcn) /header.tsx # En-tête de l'application /sidebar.tsx # Barre latérale de navigation /auth-guard.tsx # Protection des routes authentifiées /lib # Services et utilitaires /api-client.ts # Client API centralisé /auth-service.ts # Service d'authentification /absence-service.ts # Service de gestion des absences /class-service.ts # Service de gestion des classes /message-service.ts # Service de messagerie /points-service.ts # Service de gestion des points /room-service.ts # Service de gestion des salles /settings-service.ts # Service de gestion des paramètres /public # Fichiers statiques Backend (ASP.NET Core) /Controllers # Contrôleurs API /AuthController.cs # Authentification /Teacher # Contrôleurs spécifiques aux enseignants /TeacherAbsenceController.cs /TeacherClassController.cs /TeacherProfileController.cs /TeacherRoomController.cs /TeacherSettingsController.cs /TeacherStatController.cs /Message # Contrôleurs de messagerie /MessageController.cs /Points # Contrôleurs de gestion des points /PointsController.cs /Models # Modèles de données /Absence.cs /Class.cs /Message.cs /Notification.cs /PointsConfig.cs /PointsHistory.cs /Reservation.cs /Room.cs /Schedule.cs /Settings.cs /Student.cs /StudentPoints.cs /Teacher.cs /User.cs /GestionAbsencesContext.cs # Contexte EF Core /DTO # Objets de transfert de données /AbsenceDTO.cs /AuthDTO.cs /ClassDTO.cs /Message /MessageDTO.cs /ConversationDTO.cs /Points /StudentPointsDTO.cs /PointsHistoryDTO.cs /Teacher /TeacherProfileDTO.cs /Services # Services métier /Teacher /TeacherAbsenceService.cs /TeacherClassService.cs /TeacherProfileService.cs /TeacherRoomService.cs /TeacherSettingsService.cs /TeacherStatService.cs /Message /MessageService.cs /Points /PointsService.cs /WebSocket # Gestion des WebSockets /WebSocketHandler.cs /WebSocketMiddleware.cs /WebSocketExtensions.cs /Utils # Utilitaires /DateOnlyJsonConverter.cs /DateUtils.cs /Middleware # Middlewares personnalisés /BearerPrefixMiddleware.cs /RequestResponseLoggingMiddleware.cs /Scripts # Scripts SQL 4. Fonctionnalités principales Authentification et sécurité Connexion sécurisée avec JWT Protection des routes authentifiées Gestion des rôles (professeur, admin) Déconnexion automatique après inactivité Gestion des classes Liste des classes assignées à l'enseignant Détails de chaque classe avec liste des élèves Statistiques de présence par classe Recherche et filtrage des classes Gestion des absences Saisie des absences par classe ou par élève Historique des absences Justification des absences Statistiques d'assiduité Exportation des données d'absence Système de points Attribution de points aux élèves Classement des élèves par points Historique des points attribués Configuration des règles d'attribution Réservation de salles Consultation des salles disponibles Réservation de créneaux horaires Gestion des caractéristiques des salles Calendrier des réservations Messagerie Communication en temps réel via WebSockets Conversations privées entre utilisateurs Notifications de nouveaux messages Statut des messages (envoyé, livré, lu) Rapports et statistiques Génération de rapports personnalisés Tableaux de bord avec indicateurs clés Graphiques d'assiduité et de performance Exportation des rapports en différents formats Paramètres utilisateur Personnalisation du profil Choix du thème (clair/sombre) Préférences de notification Gestion du mot de passe 5. Guide d'utilisation Connexion au portail Accédez à la page de connexion Entrez les identifiants suivants : Email : teacher@teacher.fr Mot de passe : admin123 Cliquez sur "Se connecter" Navigation dans l'application Utilisez la barre latérale pour accéder aux différentes sections Le menu supérieur contient les notifications et l'accès au profil Le tableau de bord principal affiche un résumé des informations importantes Gestion des classes Accédez à la section "Classes" depuis la barre latérale Consultez la liste de vos classes Cliquez sur une classe pour voir les détails et la liste des élèves Utilisez la barre de recherche pour filtrer les classes Saisie des absences Accédez à la section "Absences" depuis la barre latérale Cliquez sur "Saisir des absences" Sélectionnez la classe concernée Cochez les élèves absents Renseignez la date et le motif si connu Validez la saisie Réservation d'une salle Accédez à la section "Salles" depuis la barre latérale Consultez les salles disponibles Cliquez sur "Nouvelle réservation" Sélectionnez la salle, la date et l'horaire Indiquez le motif de la réservation Validez la réservation Utilisation du système de points Accédez à la section "Points" depuis la barre latérale Consultez le classement des élèves Pour attribuer des points : Accédez à la fiche d'un élève Cliquez sur "Ajouter des points" Saisissez le nombre de points et le motif Validez l'attribution Envoi d'un message Accédez à la section "Messages" depuis la barre latérale Cliquez sur "Nouveau message" Sélectionnez le destinataire Rédigez votre message Envoyez le message Génération d'un rapport Accédez à la section "Rapports" depuis la barre latérale Sélectionnez le type de rapport Définissez les paramètres (période, classe, etc.) Générez le rapport Consultez-le en ligne ou exportez-le Modification des paramètres Accédez à la section "Paramètres" depuis la barre latérale Modifiez votre profil, thème ou préférences Enregistrez les modifications 6. API et endpoints Authentification POST /api/auth/login - Connexion utilisateur GET /api/auth/test - Test d'authentification GET /api/auth/test-professeur - Test d'autorisation professeur Gestion des classes GET /api/teacher/classes - Liste des classes GET /api/teacher/classes/{id} - Détails d'une classe Gestion des absences GET /api/teacher/absences - Liste des absences GET /api/teacher/absences/{id} - Détails d'une absence POST /api/teacher/absences - Création d'une absence PUT /api/teacher/absences/{id} - Mise à jour d'une absence DELETE /api/teacher/absences/{id} - Suppression d'une absence Gestion des salles GET /api/teacher/rooms - Liste des salles GET /api/teacher/rooms/{id} - Détails d'une salle GET /api/teacher/rooms/{id}/reservations - Réservations d'une salle Réservations GET /api/teacher/reservations - Liste des réservations GET /api/teacher/reservations/{id} - Détails d'une réservation POST /api/teacher/reservations - Création d'une réservation PUT /api/teacher/reservations/{id} - Mise à jour d'une réservation DELETE /api/teacher/reservations/{id} - Suppression d'une réservation Messagerie GET /api/messages - Liste des conversations GET /api/messages/{userId} - Messages avec un utilisateur POST /api/messages - Envoi d'un message PUT /api/messages/{id}/read - Marquer un message comme lu WebSocket /ws - Communication en temps réel Système de points GET /api/points/students - Points des élèves GET /api/points/students/{id} - Points d'un élève GET /api/points/ranking - Classement des élèves POST /api/points/add - Attribution de points GET /api/points/history/{studentId} - Historique des points Profil et paramètres GET /api/teacher/profile - Profil de l'enseignant PUT /api/teacher/profile - Mise à jour du profil GET /api/teacher/settings - Paramètres utilisateur PUT /api/teacher/settings - Mise à jour des paramètres 7. Base de données Schéma de la base de données La base de données est organisée autour des entités principales suivantes : Users : Utilisateurs du système (enseignants, administrateurs) Teachers : Informations spécifiques aux enseignants Students : Informations sur les élèves Classes : Classes et leurs associations avec les enseignants Absences : Enregistrements des absences des élèves Rooms : Salles disponibles pour réservation Reservations : Réservations des salles Messages : Messages échangés entre utilisateurs Notifications : Notifications système Settings : Paramètres utilisateur StudentPoints : Points attribués aux élèves PointsHistory : Historique des attributions de points PointsConfig : Configuration du système de points Relations principales Un enseignant peut avoir plusieurs classes Une classe peut avoir plusieurs élèves Un élève peut avoir plusieurs absences Un utilisateur peut avoir plusieurs réservations Un utilisateur peut envoyer/recevoir plusieurs messages Un élève peut avoir plusieurs entrées dans l'historique des points 8. Sécurité Authentification Utilisation de JWT (JSON Web Tokens) pour l'authentification Stockage sécurisé des tokens côté client Expiration automatique des tokens Vérification des rôles pour l'accès aux ressources Protection des données Hachage des mots de passe avec SHA-256 Validation des entrées côté client et serveur Protection contre les attaques CSRF Utilisation de HTTPS pour toutes les communications Autorisations Système de rôles (professeur, admin) Vérification des autorisations pour chaque action Isolation des données par utilisateur Journalisation des actions sensibles 9. Déploiement Prérequis Node.js 18+ pour le frontend .NET 9 SDK pour le backend MySQL 8+ pour la base de données Serveur web (Nginx recommandé) Proxy Reverse Caddy Étapes de déploiement Base de données Créer une base de données MySQL Exécuter les scripts de migration Backend Compiler l'application ASP.NET Core Configurer les variables d'environnement Déployer sur un serveur compatible .NET Frontend Construire l'application Next.js ( next build ) Déployer les fichiers statiques Configurer le serveur web pour servir l'application Configuration Fichier .env pour les variables d'environnement frontend Fichier appsettings.json pour la configuration backend Configuration de la base de données dans GestionAbsencesContext.cs 10. Dépannage Problèmes courants Erreur de connexion Vérifier les identifiants ( teacher@teacher.fr / admin123) Vérifier que le serveur backend est accessible Vérifier les logs du serveur pour des erreurs d'authentification Données non affichées Vérifier la connexion au serveur backend Vérifier les requêtes dans la console du navigateur Vérifier que l'utilisateur a les permissions nécessaires Erreurs WebSocket Vérifier que le serveur WebSocket est en cours d'exécution Vérifier la configuration du proxy si applicable Vérifier les logs du serveur pour des erreurs de connexion Problèmes de performance Vérifier la charge du serveur Optimiser les requêtes à la base de données Vérifier les index de la base de données Logs et monitoring Les logs frontend sont disponibles dans la console du navigateur Les logs backend sont stockés dans le dossier /logs Utiliser les outils de développement du navigateur pour déboguer les problèmes frontend Utiliser les outils de débogage de Visual Studio pour le backend Application Mobile Application Mobile de Gestion des Absences Présentation Cette application mobile Android permet aux enseignants de gérer les absences des élèves, consulter leurs classes, et accéder à diverses statistiques. Elle est conçue pour fonctionner en complément d'une API REST qui gère les données côté serveur. Informations de connexion Pour tester l'application, utilisez les identifiants suivants : Email/Username : teacher@teacher.fr Mot de passe : admin123 Architecture de l'application L'application est développée selon le pattern MVVM (Model-View-ViewModel) et utilise les composants d'architecture Android : Model : Représente les données et la logique métier View : Activités et fragments qui affichent l'interface utilisateur ViewModel : Gère les données liées à l'UI et les interactions avec le modèle Repository : Couche intermédiaire qui gère les sources de données (API, base de données locale) Structure des packages com.example.exam/ ├── adapters/ # Adaptateurs pour les RecyclerViews ├── api/ # Services API et configuration Retrofit ├── models/ # Classes de modèles de données ├── repository/ # Repositories pour accéder aux données ├── ui/ # Activités et fragments organisés par fonctionnalité │ ├── absences/ # Gestion des absences │ ├── classes/ # Gestion des classes │ ├── home/ # Écran d'accueil et tableau de bord │ └── ... └── utils/ # Classes utilitaires Fonctionnalités principales 1. Authentification Connexion avec email/mot de passe Stockage sécurisé du token d'authentification Déconnexion 2. Tableau de bord (Dashboard) Vue d'ensemble des statistiques (nombre d'élèves, classes, absences) Graphique des absences par mois Liste des absences récentes Fonctionnalité de rafraîchissement (swipe-to-refresh) 3. Gestion des classes Liste des classes de l'enseignant Détails d'une classe avec liste des élèves Statistiques par classe (taux d'absence, nombre d'élèves) 4. Gestion des absences Consultation des absences Saisie d'une nouvelle absence Possibilité de joindre un justificatif (document) Filtrage des absences Flux d'utilisation Connexion et navigation L'utilisateur lance l'application et arrive sur l'écran de connexion Après authentification réussie, l'utilisateur est redirigé vers le tableau de bord La navigation entre les différentes sections se fait via le menu latéral (Navigation Drawer) Consultation des classes L'utilisateur accède à la section "Classes" depuis le menu La liste des classes s'affiche avec des informations de base En cliquant sur une classe, l'utilisateur accède aux détails et à la liste des élèves Depuis cette vue, l'utilisateur peut saisir une absence ou générer un rapport Saisie d'une absence Depuis la liste des classes ou les détails d'une classe, l'utilisateur peut cliquer sur "Saisir une absence" Un formulaire s'affiche permettant de sélectionner l'élève, la date, le statut et la raison L'utilisateur peut optionnellement joindre un document justificatif Après validation, l'absence est enregistrée et l'utilisateur est redirigé vers l'écran précédent Technologies utilisées Bibliothèques principales AndroidX : Composants d'architecture Android (ViewModel, LiveData) Material Design : Composants UI modernes et cohérents Retrofit : Client HTTP pour les appels API OkHttp : Client HTTP sous-jacent avec intercepteurs pour logging Gson : Sérialisation/désérialisation JSON MPAndroidChart : Visualisation de données sous forme de graphiques Lottie : Animations vectorielles Shimmer : Effets de chargement SwipeRefreshLayout : Fonctionnalité de rafraîchissement par glissement Gestion des données SharedPreferences : Stockage des informations de session (token, identifiants) LiveData : Notification des changements de données aux composants UI ViewModel : Persistance des données lors des changements de configuration Détails techniques Authentification et sécurité L'application utilise un système d'authentification par token JWT : L'utilisateur s'authentifie avec ses identifiants Le serveur renvoie un token JWT Ce token est stocké dans les SharedPreferences Un intercepteur OkHttp ajoute automatiquement le token à chaque requête API Gestion des erreurs L'application gère différents types d'erreurs : Erreurs réseau (pas de connexion) Erreurs d'authentification (token expiré, identifiants incorrects) Erreurs serveur (500, 404, etc.) Des écrans d'erreur spécifiques sont affichés avec possibilité de réessayer. Optimisations UI/UX Shimmer Effect : Affichage d'un effet de chargement pendant les requêtes API Animations : Transitions fluides entre les écrans Swipe-to-refresh : Actualisation des données par glissement vers le bas Mise en cache : Certaines données sont mises en cache pour améliorer les performances API et endpoints L'application communique avec une API REST hébergée à l'adresse https://api.slam.qoyri.fr/api/ . Principaux endpoints utilisés Authentification : /auth/login Dashboard : /teacher/dashboard Classes : /teacher/classes Détails d'une classe : /teacher/classes/{id} Absences : /teacher/absences Création d'absence : /teacher/absences/create Installation et déploiement Prérequis Android Studio 4.0+ JDK 11+ SDK Android 33+ (Android 13) Compilation et installation Cloner le dépôt Ouvrir le projet dans Android Studio Synchroniser avec Gradle Compiler et installer sur un appareil ou émulateur Configuration L'URL de l'API est configurée dans la classe ApiClient.java . Pour changer l'environnement (développement, production), modifiez la constante BASE_URL . Dépannage Problèmes courants Erreur de connexion : Vérifiez votre connexion internet et que l'API est accessible Erreur d'authentification : Vérifiez vos identifiants ou réessayez de vous connecter Données non affichées : Utilisez la fonction de rafraîchissement (swipe-to-refresh) Évolutions futures Implémentation du mode hors ligne avec synchronisation Ajout de notifications push pour les nouvelles absences Intégration de la biométrie pour l'authentification Support du mode sombre