ValidEtu est une application moderne conçue pour aider les étudiants à suivre leur parcours académique, gérer leurs résultats et simuler leurs moyennes pour valider leurs semestres et années.
- Tableau de Bord Étudiant : Vue d'ensemble des performances et progression.
- Gestion Académique : Suivi détaillé des années, semestres et Unités d'Enseignement (UE).
- Simulation de Notes : Outil puissant pour simuler des scénarios de validation en fonction des notes potentielles.
- Authentification Sécurisée : Inscription et connexion pour sauvegarder ses données.
- Interface UI/UX Soignée : Design responsive et moderne avec mode clair/sombre (supporté par Tailwind CSS).
Ce projet utilise une stack technique robuste et moderne :
- Core : React (v18)
- Langage : TypeScript
- Build Tool : Vite
- Styling : Tailwind CSS
- Routing : React Router
- Validation : Zod & React Hook Form
- Icônes : Lucide React
- Notifications : React Hot Toast
Suivez ces étapes pour lancer le projet localement :
-
Cloner le dépôt
git clone https://github.com/Bellox1/validEtu.git cd validEtu -
Installer les dépendances
npm install
-
Lancer le serveur de développement
npm run dev
L'application sera accessible sur
http://localhost:5173.
src/
├── components/ # Composants réutilisables (Layout, UI, etc.)
├── contexts/ # Gestion globale de l'état (Auth, Academic)
├── models/ # Définitions des types et interfaces
├── pages/ # Les différentes vues de l'application
│ ├── auth/ # Login, Register
│ ├── academic/ # Détails des années, semestres, UEs
│ └── ... # Dashboard, Profile, Simulations
├── App.tsx # Configuration principale des routes
└── main.tsx # Point d'entrée
Les contributions sont les bienvenues ! Pour des changements majeurs, veuillez ouvrir une issue d'abord pour discuter de ce que vous aimeriez changer.
MIT