# Projet Ferme ## Installation du projet ### Windows Pour windows, il faut installer le WSL2, Ubuntu, docker et nvm. Il suffit de suivre cette [doc](https://wiki.malio.fr/bookstack/books/environnement-de-dev/chapter/windows) ### Linux Pour linux, il faut installer docker et nvm. Il suffit de suivre cette [doc](https://wiki.malio.fr/bookstack/books/environnement-de-dev/chapter/linux) ### Installation du projet Une fois les prérequis installés, il suffit de cloner le projet et de lancer les commandes suivantes ```bash 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 ```bash make dev-nuxt ``` Le front sera accessible sur http://localhost:3000 ## Commandes utiles Pour restart le container ```bash make restart ``` Pour lancer les TU ```bash make test ``` Pour accéder au container et lance des commandes ```bash make shell ``` Pour clear le cache Symfony ```bash make cache-clear ```