Projet Ferme

Installation du projet

Windows

Pour windows, il faut installer le WSL2, Ubuntu, docker et nvm. Il suffit de suivre cette doc

Linux

Pour linux, il faut installer docker et nvm. Il suffit de suivre cette doc

Installation du projet

Une fois les prérequis installés, il suffit de cloner le projet et de lancer les commandes suivantes

make start
make install

Dans le cas ou le make start plante à cause du port de la bdd, il faut modifier POSTGRES_PORT dans le fichier .env.docker.local, remplacer le par un port disponible.

Configuration global

Pour les variables d'environnement, il faut demander un .env.local pour le backend et un .env pour le frontend à votre collègue.

Vérifier que dans le .env.local, vous avez :

• APP_SECRET (doit être différent de celui de votre collègue, puisque utilisé pour signer des tokens)
• DATABASE_URL
• PONT_BASCULE_BYPASS (doit être à true en dev)
• PONT_BASCULE_URL

Vérifier que dans le .env du dossier frontend, vous avez :

• NUXT_PUBLIC_API_BASE

Configuration xdebug

Pour configurer xdebug, il faut ajouter un serveur sur phpstorm.
Pour cela, il faut aller dans Settings > PHP > Servers

• Name : ferme-docker
• Host : localhost
• Port : 8080
• Path : File/Directory -> l'endroit où est stocké votre projet et le path -> /var/www/html

Pour que xdebug fonctionne sur windows, il faut modifier la variable XDEBUG_CLIENT_HOST par votre ip local

Utilisation du projet

Backend

L'api est disponible sur http://localhost:8080/api Pour la bdd toutes les infos sont dans le fichier docker/.env.docker.local Vous pouvez modifier le port si nécessaire.

La bdd est déja pré-configuré dans PhpStorm, il suffit de rentrer les infos du .env.docker.local pour se connecter. C'est un bdd local dans le docker.

Frontend

Pour le frontend, il suffit de taper la commande suivante qui va lancer le serveur de dev

make dev-nuxt

Le front sera accessible sur http://localhost:3000

Commandes utiles

Pour restart le container

make restart

Pour lancer les TU

make test

Pour accéder au container et lance des commandes

make shell

Pour clear le cache Symfony

make cache-clear