Procédure d’installation :
Cette section décrit les différentes étapes nécessaires pour installer et lancer le projet Nexus. L’application peut être exécutée de manière complète à l’aide de Docker, ce qui constitue la méthode recommandée, ou en mode développement sans Docker selon les besoins.
Prérequis :
Avant toute installation, il est nécessaire d’installer un environnement Docker fonctionnel (Docker Desktop ou équivalent). Une fois installé, il convient de vérifier que Docker et Docker Compose sont correctement configurés sur la machine.
Configuration de la base de données :
Le projet utilise une base de données PostgreSQL. Les paramètres de connexion sont définis dans le fichier nexus.env situé à la racine du projet. Il est possible de modifier le nom de la base, l’utilisateur ainsi que le mot de passe selon les besoins.
Lancement de l’application avec Docker :
Pour lancer l’ensemble de l’application, il faut se positionner dans le dossier racine du projet, puis exécuter la commande permettant de construire et démarrer les conteneurs. Cette méthode permet de déployer rapidement tous les services nécessaires (frontend, API, base de données, outils annexes).
Une fois les conteneurs démarrés, il est possible d’accéder aux différents services via les ports configurés :
-
Interface utilisateur (frontend)
-
API backend
-
Outil de gestion de base de données (Adminer)
-
Outil de test des emails (Mailpit)
Dépannage
En cas de problème, il est possible de redémarrer complètement l’environnement en supprimant les volumes Docker, ce qui réinitialise la base de données. Des commandes de consultation des logs sont également disponibles afin d’identifier d’éventuelles erreurs au niveau des différents services.
Cette procédure permet ainsi de mettre en place rapidement l’environnement de développement et d’assurer le bon fonctionnement de l’application Nexus.