HappiHub - La culture, le partage, la communauté

HappiHub est une application web de réseau social pour les événements culturels et communautaires. Notre objectif est de connecter les personnes partageant les mêmes intérêts et de faciliter l'organisation et la participation à des événements.

Project continuity

Start with project instructions, handover, prioritized work plan, and operational history. Current implementation contracts are in API documentation. Further code requires completed UML conception and explicit owner validation.

Table des Matières

• Structure du Projet
• Prérequis
• Installation
• Environment configuration
• Docker workflows
• Vérification du Bon Fonctionnement
• Contribution
• Licence

Structure du Projet

Le projet est organisé en plusieurs répertoires :

• client/ : Contient le code source du frontend React.
• server/ : Contient le code source du backend Node.js/Express.

Prérequis

• Docker
• Docker Compose

Installation

1. Clonez le dépôt :

   git clone https://github.com/benoit-bremaud/happihub.git
   cd happihub
   

Environment configuration

Follow private configuration instructions. Only placeholder templates are tracked; local and deployed environment files are ignored. Existing local files were preserved during credential cleanup.

The client API base URL includes /api. Supply signing keys privately and do not reuse tutorial values. Production Compose requires private mounted secret files. Its deployment still requires a separate infrastructure review.

Docker workflows

Follow Docker setup and verification. The default Compose file is local-only; production uses a separate reviewed baseline. Do not reuse the former shared-volume profiles or interpret a passing local check as production approval.

Vérification du Bon Fonctionnement

With the default local Compose file, services listen on loopback only:

• Frontend: http://localhost:3200 (override with HAPPIHUB_LOCAL_WEB_PORT)
• Backend readiness: http://localhost:5200/ready (override with HAPPIHUB_LOCAL_API_PORT)

PostgreSQL is not published on the host. Apply the schema once with docker compose exec server npm run migrate. For full checks and troubleshooting, see Docker setup and verification.

Contribution

Les contributions sont les bienvenues. Pour commencer :

1. Fork le dépôt.
2. Créez une branche pour votre fonctionnalité ou correction de bug (git checkout -b feature/fooBar).
3. Commit vos modifications (git commit -am 'Add some fooBar').
4. Push la branche (git push origin feature/fooBar).
5. Créez une nouvelle Pull Request.

Pour plus d'informations, veuillez lire le fichier CONTRIBUTING.

Code de Conduite

Nous avons adopté un code de conduite pour notre communauté. Pour en savoir plus, consultez le Code de Conduite.

Sécurité

Pour signaler une vulnérabilité de sécurité, veuillez lire notre Politique de Sécurité.

Changelog

Pour suivre les modifications, ajouts, corrections de bugs et améliorations apportées au projet HappiHub, consultez le fichier CHANGELOG.md. Ce fichier documente l'évolution du projet de manière chronologique et structurée, suivant les conventions de Keep a Changelog et Semantic Versioning.

Pour des instructions détaillées sur comment, quand et pourquoi mettre à jour le fichier CHANGELOG, veuillez consulter le fichier CHANGELOG_GUIDE.md.

Documentation de l'API

Pour une documentation détaillée de l'API de HappiHub, veuillez consulter le fichier API_DOCUMENTATION et le contrat OpenAPI 3.1. Ce document inclut des descriptions des endpoints, des paramètres, et des exemples de requêtes et de réponses.

Authentication

HappiHub now uses server-managed PostgreSQL sessions and HttpOnly cookies. Browser bearer JWT authentication and JWT refresh examples are historical. See the current API contract, configuration, and cookie-session specification.

Guide Général

The former general guide (JWT, MongoDB, role/rank model) is obsolete and kept in docs/archive. Current state and plan: HANDOVER and WORK_PLAN.

FAQ

The former FAQ described an obsolete MongoDB/JWT setup and is kept in docs/archive. Current setup: CONTRIBUTING.md, configuration and Docker workflows.

Licence

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

Start manually

There is no root package.json. Start each part from its own directory:

cd server && npm ci --ignore-scripts && npm run migrate && npm start

cd client && npm ci --ignore-scripts && npm start

---