Cartographie qui permet de localiser les permanences des conseillers numériques France Service sur le territoire.
L'application est disponible ici : https://carte.conseiller-numerique.gouv.fr/
- Exécuter
yarn install
pour installer les dépendances.
Exécuter yarn start
, puis naviguer vers http://localhost:4200/
.
Cette méthode est recommandée pour permettre aux développeurs d'utiliser une configuration locale au lieu de la configuration par défaut.
- Créer le fichier
environment.local.ts
dans le dossier/src/environments/
- Copier le contenu du fichier
environment.ts
versenvironment.local.ts
- Modifier le fichier
environment.local.ts
pour obtenir la configuration souhaitée - Exécuter
yarn start:local
, puis naviguer vershttp://localhost:4200/
Exécuter yarn build
pour construire le projet. Les fichiers de sortie sont écrits dans le dossier dist/
.
Exécuter yarn test
pour tester le projet.
Exécuter yarn lint
pour une analyse statique des fichiers .ts
du projet.
Exécuter yarn stylelint
pour une analyse statique des fichiers .scss
du projet.
Exécuter yarn prettier
pour mettre à niveau la syntaxe de l'ensemble des fichiers du projet.
Les opérations prises en compte par les pre-commits hooks sont :
- prettier
- lint-staged: analyse des fichiers ajoutés pour le prochain commit.
- Une branche qui apporte une nouvelle fonctionnalité doit ête préfixé par
feature/
:feature/ma-fonctionnalite
- Une branche qui apporte une correction doit ête préfixé par
fix/
:fix/ma-correction
Chaque branche avec le préfixe feature/
ou fix/
est automatiquement déployée à la première publication et mise à jour lors des publications suivantes.
Une notification dans le canal mattermost conseiller-numerique-alertes
permet de récupérer le lien correspondant à l'environnement ainsi déployé, il est aussi possible de récupérer ce lien dans les logs de l'action correspondante sur GitHub.
Ces environnements dédiés pour chaque branche permettent de faire l'étape de recette en indépendance des autres développements.
Chaque publication de code est soumise à une revue fonctionnelle dans un environnement de recette et deux revues techniques sous forme de "pull request" vers la branche main
.
Une fois que la revue fonctionnelle et que les revues techniques sont valides, la branche peut être fusionnée dans la branche main
terminant ainsi la "pull request".
La fusion sur la branche main
entraîne automatiquement un déploiement sur l'environnement de recette en commun disponible ici : https://app-d9a716c2-299f-4f16-ad90-30965ae57d13.cleverapps.io/
Pour mettre en production il faut lancer ce workflow sur la branche main
: https://github.com/anct-cnum/portail-usager/actions/workflows/production-continuous-deployment.yml
- TypeScript est un langage open-source construit à partir de JavaScript
- Angular est une boîte à outils open-source pour construire des clients web
- Leaflet est une bibliothèque JavaScript open-source pour créer des cartes interactives
- Dsfr est le système de design de l'État
- API adresse - data.gouv référence l’intégralité des adresses du territoire et les rend utilisables par tous
- Webpack Bundle Analyser est un outil d'analyse pour les fichiers générés à partir de webpack, un "module bundler" qui génère des fichiers statiques à partir d'un ensemble de fichiers sources en JavaScript
- Jest est une boîte à outils pour écrire des tests automatisés en JavaScript
- Eslint est un analyseur statique de JavaScript avec les plugins suivants :
- Prettier est un magnificateur de code source en JavaScript
- Stylelint est un analyseur statique de scss
- Husky est un utilitaire pour exécuter des tâches automatisées lors des commits
- Lint-staged est un utilitaire pour lancer une analyse statique sur les fichiers ajoutés pour le prochain commit
Voir le fichier LICENSE | ETALAB-Licence-Ouverte-v2.0 du dépôt.
- Plateforme des acteurs de la médiation numérique pour être l'inspiration originale du projet.
- Carte France Services est un excellent exemple de cartographie de localisation d'éléments en France métropolitaine et outre-mer.