Skip to content

Alaa-din/grade-compute-m1-cm

Repository files navigation

🏗️ Calculateur de Moyenne - M1 Construction Mécanique

Une application web mobile-first, performante et esthétique pour calculer la moyenne semestrielle du Master 1 en Construction Mécanique.

Aperçu

📋 Fonctionnalités

  • Calcul Précis : Respecte les pondérations officielles (40% CA / 60% Examen, coefficients, crédits).
  • Règles Spécifiques :
    • TP MDF/RDM : 100% Contrôle Continu.
    • Etat de surface : 100% Examen.
  • Validation Semestrielle : Indique clairement si le semestre est validé (Moyenne ≥ 10/20).
  • Interface UI/UX Premium :
    • Thème sombre industriel avec animations d'engrenages.
    • Responsive et optimisé pour mobile.
    • Inputs intelligents (désactivation automatique des champs inutiles).
  • Offline First (PWA) : Fonctionne sans connexion internet après le premier chargement.
  • Sauvegarde Locale : Vos notes sont conservées automatiquement sur votre appareil.

🚀 Technologies

🛠️ Installation et Lancement

Prérequis

  • Node.js 18+ installé.

Étapes

  1. Cloner le dépôt :

    git clone https://github.com/Alaa-din/grade-compute-m1-cm.git
    cd grade-compute-m1-cm
  2. Installer les dépendances :

    npm install
    # ou
    yarn install
    # ou
    pnpm install
  3. Lancer le serveur de développement :

    npm run dev
  4. Ouvrir http://localhost:3000 dans votre navigateur.

📱 Progressive Web App (PWA)

L'application est installable comme une application native sur Android et iOS via la fonctionnalité "Ajouter à l'écran d'accueil".

🤝 Contribution

Les contributions sont les bienvenues !

  1. Forkez le projet.
  2. Créez votre branche (git checkout -b feature/AmazingFeature).
  3. Commitez vos changements (git commit -m 'Add some AmazingFeature').
  4. Pushez vers la branche (git push origin feature/AmazingFeature).
  5. Ouvrez une Pull Request.

📄 Licence

Distribué sous la licence MIT. Voir LICENSE pour plus d'informations.

👤 Auteur

Alaa-din


"اللهم ارزق صاحب هذا التطبيق العافية والنجاح في الدنيا والآخرة"

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors