https://github.com/redneath/development-processes
https://github.com/redneath/development-processes
Last synced: 24 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/redneath/development-processes
- Owner: RedNeath
- Created: 2025-08-04T07:36:50.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T07:46:35.000Z (11 months ago)
- Last Synced: 2025-10-09T11:59:02.127Z (9 months ago)
- Language: PHP
- Size: 13.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# development-processes
## Comment démarrer le projet
Comme vous pouvez le voir dans le `docker-compose.yml` à la racine, le projet repose sur cinq conteneurs docker.
Fort heureusement, un fichier Makefile (ne fonctionne que sous Linux) contenant les commandes principales à utiliser pour travailler sur le projet est aussi présent.
Pour les utilisateurs windows : il vous faut installer WSL, cependant, nous vous recommandons d'installer docker Desktop d'abord, étant donné qu'il intègre automatiquement une WSL lors de son installation.
### Installer docker
Vous pouvez retrouver la procédure pour installer docker ici : https://docs.docker.com/get-started/get-docker/
### Installer make
Cette installation permettra d'exécuter les commandes définies dans le Makefile. Si vous êtes sur windows, assurez-vous de lancer ces commandes depuis votre terminal WSL.
La commande make est théoriquement disponible dans toutes les distributions Linux. Certaines viennent même avec la commande préinstallée.
Si votre distribution n'en dispose pas, voici un exemple expliquant comment l'installer pour les distributions basées sur Debian :
```sh
sudo apt-get install make
```
> **NOTE :**
> Pour les utilisateurs windows, si vous conservez la distribution par défaut livrée avec docker, sachez qu'il s'agit d'Ubuntu. Par conséquent, la commande ci-dessus devrait fonctionner, pour peu que vous l'exécutiez dans le bon terminal.
### Lancer le programme !
Une fois que les deux outils nécessaires sont installés sur votre machine, vous pouvez enfin démarrer le programme en utilisant une des deux commandes :
```sh
make start
```
ou
```sh
make run
```
Elles font toutes les deux la même chose, à l'exception près que la commande `run` vous détache directement de la sortie des conteneurs docker.
Cela est particulièrement pratique pour exécuter d'autres commandes depuis le même terminal dans lequel vous avez lancé la première commande.
### Exécuter les migrations
Nous sommes presques rendus ! Mais avant de tester l'application, pensez à exécuter les migrations de la base de données jusqu'à la version la plus récente.
Pour ce faire, vous allez devoir ouvrir une session bash sur le conteneur `web`, dont il est question :
```sh
make wsh
```
Et ensuite exécuter cette commande. Elle exécutera à son tour toutes les migrations qui sont répertoriées :
```sh
php bin/console doctrine:migrations:migrate
```
Et voilà, votre application est désormais 100% opérationnelle.
> **NOTE :**
> Pour aller plus vite, `doctrine:migrations:migrate` peut être résumé à `d:m:m` !
### Arrêter les conteneurs
Si vous n'avez pas l'outil docker Desktop (ou n'importe quel autre outil pour vous permettre de le faire graphiquement), vous pouvez utiliser cette commande afin d'arrêter les conteneurs :
```sh
make stop
```
## Utiliser l'application
Une fois l'application démarrée, vous pouvez la voir en action en suivant les URL :
- http://localhost:8090/api/openapi.json : Redirige vers le fichier JSON contenant la documentation OpenAPI du serveur backend.
- http://localhost:8091 : Le frontend de l'application.
- http://localhost:8094 : L'interface graphique pour la documentation OpenAPI du backend (peut être utilisée pour envoyer de requêtes au backend).
- http://localhost:8095 : L'intercepteur de mails (mailcatcher). C'est à cet endroit que les mails envoyés par l'application apparaîtront.
Si vous souhaitez ajouter la base de données à votre IDE, vous pouvez utiliser la chaîne de connexion suivante :
```txt
mysql://development-processes-user:development-processes-user-password@localhost:8096/development-processes-db?charset=utf8mb4
```
## Notes importantes
### Ownership
Si vous rencontrez des problèmes de droits avec les fichiers du projet, vous pouvez utiliser la commande :
```sh
make owner
```
qui donnera à votre système la propriété sur tous les fichiers et dossiers sous `development-processes-php` et `development-processes-vue`.
### Exécuter les tests
Pour exécuter les tests de l'application, vous avez trois possibilités :
1. Les tests pour le frontend :
```sh
make tests-front
```
2. Les tests pour le backend :
```sh
make tests-back
```
3. Tous les tests en même temps :
```sh
make tests
```