Skip to content

README.md

Latest commit

 

History

History
103 lines (70 loc) · 2.62 KB

README.md

File metadata and controls

103 lines (70 loc) · 2.62 KB

Générateur de Groupes Aléatoires

Cette application permet aux enseignants de créer facilement des groupes aléatoires d'élèves pour des travaux de groupe, des activités ou des projets collaboratifs.

Fonctionnalités

  • Création de groupes aléatoires à partir d'une liste d'élèves
  • Personnalisation du nombre d'élèves par groupe
  • Interface intuitive et conviviale
  • Export des groupes en format PDF ou CSV (coming soon)
  • Sauvegarde des listes d'élèves pour une utilisation ultérieure (coming soon)

Installation

  1. Clonez le repository :
git clone https://github.com/votre-username/generateur-groupes.git
cd generateur-groupes
  1. Installez les dépendances :
npm install
# ou
yarn install

Utilisation

  1. Lancez l'application :
npm run dev
# ou
yarn dev
  1. Accédez à l'application dans votre navigateur à l'adresse http://localhost:5173

Guide d'utilisation rapide

  1. Définissez le nombre d'élèves souhaité par groupe
  2. Coller un liste d'élève dans le champ prévu à cet effet
  3. Cliquez sur "Générer les groupes"
  4. Exportez ou partagez les groupes générés (coming soon)

Développement

Prérequis

  • Node.js (version 16 ou supérieure)
  • npm ou yarn

Structure du projet

src/
├── components/    # Composants React
├── hooks/        # Hooks personnalisés
├── utils/        # Fonctions utilitaires
└── types/        # Types TypeScript

Scripts disponibles

  • npm run dev : Lance le serveur de développement
  • npm run build : Crée une version de production
  • npm run test : Lance les tests
  • npm run lint : Vérifie le code avec ESLint

Contribution

Les contributions sont les bienvenues ! Pour contribuer :

  1. Forkez le projet
  2. Créez une branche pour votre fonctionnalité (git checkout -b feature/nouvelle-fonctionnalite)
  3. Committez vos changements (git commit -m 'Ajout d'une nouvelle fonctionnalité')
  4. Poussez vers la branche (git push origin feature/nouvelle-fonctionnalite)
  5. Ouvrez une Pull Request

Guide de contribution

  • Respectez les conventions de code existantes
  • Ajoutez des tests pour les nouvelles fonctionnalités
  • Mettez à jour la documentation si nécessaire
  • Vérifiez que tous les tests passent avant de soumettre une PR

Auteur

Support

Si vous rencontrez des problèmes ou avez des questions :

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.