Les CaenCamp.s sont une série de rencontres caennaises organisées par, animées par et à destination des développeurs. Cette initiative existe depuis 2012.
Les rencontres ont lieu une fois par mois, et c’est très chouette. Mais pour aller plus loin, nous nous réunissons aussi régulièrement pour mettre les mains dans le code lors des Coding CaenCamp.
Ce projet de site d’offres d’emploi web est l’un de nos projets communs mis en place lors de ces rencontres.
Le guide du contributeur détaille les pré-requis et les différents mode d’installation du projet. Mais en partant du postulat que Docker et Docker Compose sont installés sur votre environnement, vous pouvez lancer l’installation du projet avec la commande
make install
et lancer les différentes applications avec :
make start
Vous pouvez ainsi accéder à :
- l’application web sur http://localhost:8000
- l’api sur http://localhost:8001
- la documentation de l'API sur http://localhost:8001/documentation
- Une interface d'administration sur http://localhost:8002
En utilisant la commande
make storybook
Vous lancerez le storybook (documentation des composants Svelte) sur http://localhost:6006/
Lors du premier lancement du projet, vous devrez également initialiser la base de données :
make migrate-latest
make import-fixed-fixtures
Vous devrez également créer un premier utilisateur pour pouvoir vous connecter à l'interface d'administration. Pour cela, vous devrez définir sont username
ainsi que son password
(respectant la définition d'un mot de passe sécurisé de OWASP via des variables d'environement temporaires. Par exemple :
USERNAME=myFirstUser PASSWORD=n33dToB3+Str0ng node ./cli/create-user.js
Remarque: Si vous utilisez Docker, vous devrez être dans le conteneur du service api pour lancer cette commende.
Merci à vous 👍
Et c’est très simple :
- Si vous ne savez pas trop par où commencer, vous pouvez jeter un coup d’œil aux issues: elles décrivent les taches à réaliser classées par type (code, design, integration, etc.),
- Une fois que vous savez quoi faire, vous pouvez consulter le guide du contributeur pour vous lancer.
Et si vous ne trouvez toujours pas quoi faire dans les issues existantes et/ou que vous avez d’autres idées, n’hésitez pas à créer une nouvelle issue.
jobs-caen-camp est sous license GNU GPLv3