• Description
• Fonctionnalités Principales
  • Gestion des Utilisateurs
  • Gestion des Clubs
  • Sondages et Intelligence Artificielle
  • Événements
  • Compétitions
  • Gestion des Produits
• Technologies Utilisées
• Prérequis
• Installation
• Utilisation
• Intégration avec l'Application Web
• Contribution
• Équipe de Développement
• Licence
• Remerciements

UNICLUBS est une application de bureau développée en JavaFX qui permet la gestion complète des clubs, événements, sondages et compétitions au sein de l'école ESPRIT. Cette application fait partie d'un système intégré qui comprend également une interface web développée avec Symfony.

Faciliter et centraliser la gestion des activités parascolaires au sein de l'école ESPRIT en offrant une plateforme intuitive et complète.

• Fragmentation des outils de gestion des clubs
• Manque de centralisation des informations
• Difficulté de communication entre les clubs
• Complexité dans l'organisation des événements

• 🔐 Système d'authentification sécurisé
• 👤 Gestion des profils utilisateurs avec interface administrateur complète
• 🎭 Différents rôles (Administrateur, Président de Club, Membre, Non-Membre)
• ✉ Système de vérification par email
• 🔍 Système de filtration avancé pour les utilisateurs (par rôle, statut, vérification)
• 📊 Statistiques en temps réel sur les utilisateurs (total, actifs, non-vérifiés)
• 🚫 Modération des utilisateurs (activation/désactivation, suppression)
• 🛡 Détection de contenu inapproprié avec système d'avertissement
• 📈 Tableau de bord analytique pour suivre les tendances d'inscription

• 📋 Création et gestion des clubs
• 👥 Gestion des membres
• 📊 Tableau de bord pour les présidents de clubs
• 📅 Planification des activités

• 📝 Création et gestion des sondages
• 🤖 Fonctionnalités IA avancées :
  • 🛡 Détection automatique des commentaires toxiques
  • 🌐 Traduction automatique des commentaires
  • 📊 Analyse des sentiments dans les commentaires
  • 📑 Génération automatique de résumés des commentaires
  • 🚫 Système de modération intelligent (ban automatique)
• 📈 Statistiques avancées :
  • 📊 Analyse des sentiments en temps réel
  • 📉 Tableaux de bord IA pour administrateurs
  • 📈 Visualisation des tendances utilisateur
• 💬 Système de commentaires intelligent
• 📈 Statistiques en temps réel

• 📅 Création et gestion d'événements
• 🎫 Système de participation
• 📍 Localisation des événements
• 📸 Gestion des médias

• 🎮 Organisation de compétitions
• 🏅 Système de classement
• 🎯 Suivi des scores
• 🏆 Gestion des récompenses

• 📦 Ajout et gestion des produits
• 💰 Gestion des prix et des stocks
• 🏷 Catégorisation des produits
• 🛒 Système de commande
• 📊 Suivi des ventes

• ☕ Java 17
• 🎨 JavaFX
• 🗃 MySQL
• 🔄 Hibernate
• 📧 JavaMail API
• 🎨 CSS pour le styling
• 📊 JFoenix pour les composants UI modernes
• 🤖 Intégration IA :
  • 🧠 OpenAI API pour l'analyse de texte et la génération de résumés
  • 🔍 Hugging Face pour la détection de toxicité et l'analyse des sentiments
  • 🌐 APIs de traduction avancée

• ☕ Java Development Kit (JDK) 17 ou supérieur
• 🗃 MySQL Server
• 📦 Maven

1. Cloner le repository bash git clone https://github.com/OussemaKachti/Projet_Integre_Desktop.git cd esprit-club-hub

2. Configurer la base de données bash

mysql -u root -p CREATE DATABASE dbpi;

mysql -u root -p dbpi < database.sql

3. Configurer le fichier config.properties properties db.url=jdbc:mysql://localhost:3306/esprit_club_hub db.username=votre_username db.password=votre_password

4. Compiler et exécuter le projet bash mvn clean install mvn javafx:run

1. Lancer l'application
2. Se connecter avec les identifiants administrateur par défaut :
   • Email : admin@test.com
   • Mot de passe : Lina-lanouna1818

• Gestion des Clubs : Créer, modifier et gérer les clubs
• Événements : Organiser et participer aux événements
• Sondages et IA :
  • Créer et répondre aux sondages
  • Modération automatique des commentaires
  • Analyse des sentiments
  • Génération de résumés
  • Traduction automatique
• Compétitions : Gérer les compétitions et suivre les scores
• Produits : Gérer le catalogue des produits, les stocks et les commandes

Cette application desktop est intégrée avec une application web Symfony, permettant une synchronisation en temps réel des données entre les deux plateformes. Les principales fonctionnalités d'intégration incluent :

• 🔄 Synchronisation des comptes utilisateurs
• 📊 Partage des données des événements
• 📝 Synchronisation des sondages et analyses IA
• 🏆 Mise à jour en temps réel des compétitions
• 🤖 Partage des analyses et statistiques IA

Nous accueillons et apprécions toute contribution à UNICLUBS ! Voici comment vous pouvez contribuer :

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

• Suivez les conventions de nommage Java
• Documentez les nouvelles fonctionnalités
• Ajoutez des tests unitaires pour les nouvelles fonctionnalités

• 👨‍💻 [Oussema KACHTI] - Team Lead & System Architect

  • Architecture globale du projet et intégration des modules
  • Développement du module Sondages (Frontend/Backend)
  • Intégration des technologies IA (OpenAI, Hugging Face)
  • Gestion du versioning et Git
  • Conception des diagrammes UML
  • Tests et corrections des modules
  • Documentation technique

• 👩‍💻 [Nour Balti] - Full Stack Developer - Module Utilisateurs

  • Système d'authentification et autorisation
  • Gestion des profils utilisateurs
  • Système de vérification par email
  • Gestion des rôles et permissions
  • API des utilisateurs et intégration

• 👨‍💻 [Mariem Trabelsi] - Full Stack Developer - Module Clubs

  • Développement du système de gestion des clubs
  • Interface d'administration des clubs
  • Gestion des membres et des rôles
  • Dashboard des clubs
  • API des clubs et intégration

• 👩‍💻 [Imen Rzigui] - Full Stack Developer - Module Événements

  • Système de gestion des événements
  • Interface de planification
  • Gestion des participations
  • Système de notification
  • API des événements et intégration

• 👨‍💻 [Sirine Wahbi] - Full Stack Developer - Module Produits

  • Système de gestion des produits
  • Interface e-commerce
  • Gestion des stocks
  • Système de commandes
  • API des produits et intégration

• 👩‍💻 [Yassine Jomni] - Full Stack Developer - Module Compétitions

  • Système de gestion des compétitions
  • Interface des tournois
  • Gestion des scores
  • Système de classement
  • API des compétitions et intégration

Chaque membre de l'équipe a développé son module de manière autonome (frontend et backend), tandis que le Team Lead a :

• ✅ Assuré la cohérence entre les modules
• 🔄 Géré l'intégration continue
• 🧪 Effectué les tests d'intégration
• 🤖 Implémenté les fonctionnalités IA
• 📊 Conçu l'architecture globale
• 📝 Supervisé la documentation

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

• 🎓 ESPRIT pour le support et l'opportunité
• 👨‍🏫 Les encadrants pour leur guidance
• 🤝 Tous les contributeurs au projet
• 📚 La communauté open source pour les outils et bibliothèques utilisés