{"id":28307320,"url":"https://github.com/redneath/development-processes","last_synced_at":"2026-06-15T21:31:08.234Z","repository":{"id":308127101,"uuid":"1031694700","full_name":"RedNeath/development-processes","owner":"RedNeath","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-04T07:46:35.000Z","size":14178,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-09T11:59:02.127Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RedNeath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-04T07:36:50.000Z","updated_at":"2025-08-04T07:43:42.000Z","dependencies_parsed_at":"2025-08-04T11:58:02.821Z","dependency_job_id":"10b9e5e4-7907-4320-96d2-19645d129b14","html_url":"https://github.com/RedNeath/development-processes","commit_stats":null,"previous_names":["redneath/development-processes"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/RedNeath/development-processes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedNeath%2Fdevelopment-processes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedNeath%2Fdevelopment-processes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedNeath%2Fdevelopment-processes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedNeath%2Fdevelopment-processes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RedNeath","download_url":"https://codeload.github.com/RedNeath/development-processes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedNeath%2Fdevelopment-processes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34381758,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-24T05:11:49.601Z","updated_at":"2026-06-15T21:31:08.229Z","avatar_url":"https://github.com/RedNeath.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# development-processes\n\n## Comment démarrer le projet\nComme vous pouvez le voir dans le `docker-compose.yml` à la racine, le projet repose sur cinq conteneurs docker.\nFort heureusement, un fichier Makefile (ne fonctionne que sous Linux) contenant les commandes principales à utiliser pour travailler sur le projet est aussi présent.\n\nPour 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.\n\n### Installer docker\nVous pouvez retrouver la procédure pour installer docker ici : https://docs.docker.com/get-started/get-docker/\n\n### Installer make\nCette 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.\n\nLa commande make est théoriquement disponible dans toutes les distributions Linux. Certaines viennent même avec la commande préinstallée.\n\nSi votre distribution n'en dispose pas, voici un exemple expliquant comment l'installer pour les distributions basées sur Debian :\n```sh\nsudo apt-get install make\n```\n\n\u003e **NOTE :**  \n\u003e 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.\n\n### Lancer le programme !\nUne 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 :\n```sh\nmake start\n```\n\nou\n\n```sh\nmake run\n```\n\nElles 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.\nCela est particulièrement pratique pour exécuter d'autres commandes depuis le même terminal dans lequel vous avez lancé la première commande.\n\n### Exécuter les migrations\nNous 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.\n\nPour ce faire, vous allez devoir ouvrir une session bash sur le conteneur `web`, dont il est question :\n```sh\nmake wsh\n```\n\nEt ensuite exécuter cette commande. Elle exécutera à son tour toutes les migrations qui sont répertoriées :\n```sh\nphp bin/console doctrine:migrations:migrate\n```\n\nEt voilà, votre application est désormais 100% opérationnelle.\n\n\u003e **NOTE :**  \n\u003e Pour aller plus vite, `doctrine:migrations:migrate` peut être résumé à `d:m:m` !\n\n### Arrêter les conteneurs\nSi 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 :\n```sh\nmake stop\n```\n\n## Utiliser l'application\nUne fois l'application démarrée, vous pouvez la voir en action en suivant les URL :\n- http://localhost:8090/api/openapi.json : Redirige vers le fichier JSON contenant la documentation OpenAPI du serveur backend.\n- http://localhost:8091 : Le frontend de l'application.\n- http://localhost:8094 : L'interface graphique pour la documentation OpenAPI du backend (peut être utilisée pour envoyer de requêtes au backend).\n- http://localhost:8095 : L'intercepteur de mails (mailcatcher). C'est à cet endroit que les mails envoyés par l'application apparaîtront.\n\nSi vous souhaitez ajouter la base de données à votre IDE, vous pouvez utiliser la chaîne de connexion suivante :\n```txt\nmysql://development-processes-user:development-processes-user-password@localhost:8096/development-processes-db?charset=utf8mb4\n```\n\n## Notes importantes\n\n### Ownership\nSi vous rencontrez des problèmes de droits avec les fichiers du projet, vous pouvez utiliser la commande :\n```sh\nmake owner\n```\nqui donnera à votre système la propriété sur tous les fichiers et dossiers sous `development-processes-php` et `development-processes-vue`.\n\n### Exécuter les tests\nPour exécuter les tests de l'application, vous avez trois possibilités :\n\n1. Les tests pour le frontend :\n```sh\nmake tests-front\n```\n\n2. Les tests pour le backend :\n```sh\nmake tests-back\n```\n\n3. Tous les tests en même temps :\n```sh\nmake tests\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredneath%2Fdevelopment-processes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredneath%2Fdevelopment-processes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredneath%2Fdevelopment-processes/lists"}