Pour installer HappiHub, suivez les étapes suivantes :
-
Clonez le dépôt :
git clone https://github.com/benoit-bremaud/happihub.git cd happihub
-
Configurez les variables d'environnement :
- Backend : Copiez le fichier
.env.example
dansserver/
et renommez-le en.env
. Modifiez les valeurs selon vos besoins. - Frontend : Copiez le fichier
.env.example
dansclient/
et renommez-le en.env
. Modifiez les valeurs selon vos besoins.
- Backend : Copiez le fichier
-
Démarrez les conteneurs Docker :
docker-compose up --build
Vous aurez besoin de Docker et Docker Compose installés sur votre machine. Vous pouvez les télécharger et les installer depuis les liens suivants :
Les variables d'environnement sont configurées dans les fichiers .env
situés dans les répertoires server/
et client/
. Voici un exemple de configuration pour le backend :
MONGO_URI=mongodb://localhost:27017/happihub
JWT_SECRET=your_jwt_secret
PORT=5000
Et pour le frontend :
REACT_APP_API_URL=http://localhost:5000/api
Une fois les conteneurs Docker démarrés, vous pouvez accéder à l'application frontend à l'adresse suivante :
http://localhost:3000
Et à l'API backend à l'adresse suivante :
http://localhost:5000
- Accédez à la page d'accueil de HappiHub.
- Cliquez sur "S'inscrire" et remplissez le formulaire d'inscription.
- Après l'inscription, vous pouvez vous connecter en utilisant vos identifiants.
Les rôles et privilèges des utilisateurs sont basés sur un thème cosmopolite. Voici les différents rôles :
- Visiteur : Peut consulter les événements publics.
- Utilisateur : Peut créer et participer à des événements après inscription et connexion.
- Membre Actif : Utilisateur avec des privilèges supplémentaires, tels que la création d'événements récurrents.
- Hubbers : Membres de la communauté très actifs et reconnus.
Les contributions sont les bienvenues. Pour commencer :
- Fork le dépôt.
- Créez une branche pour votre fonctionnalité ou correction de bug (
git checkout -b feature/fooBar
). - Committez vos modifications (
git commit -am 'Add some fooBar'
). - Push la branche (
git push origin feature/fooBar
). - Créez une nouvelle Pull Request.
Le guide de contribution se trouve dans le fichier CONTRIBUTING.
Pour signaler une vulnérabilité de sécurité, veuillez lire notre Politique de Sécurité.
La documentation complète de l'API est disponible dans le fichier API_DOCUMENTATION.
Si vous avez des questions supplémentaires, vous pouvez nous contacter à l'adresse email suivante : contact@happihub.com ou ouvrir une issue sur GitHub.
HappiHub Team