Je donne mon avis

Developpement

Containers Elastic, Kibana et Postgres

Copiez le fichier .env.example en utilisant la commande suivante :

cp .env.example .env

Démarrez les conteneurs Docker pour Elastic, Kibana et Postgres avec la commande :

docker compose up -d

Au premier run ELK, lancez cette commande pour initialiser le mot de passe du user "kibana_system" (remplacer {ES_ADDON_PASSWORD} et {KIBANA_PASSWORD} par les mots de passe de votre environnement) :

docker exec elasticsearch curl -s -X POST --cacert config/certs/ca/ca.crt -u "elastic:{ES_ADDON_PASSWORD}" -H "Content-Type: application/json" https://elasticsearch:9200/_security/user/kibana_system/_password -d "{\"password\":\"{KIBANA_PASSWORD}\"}"

Au premier run ELK, lancez cette suite de commande

cd webapp-form
mkdir -p certs/ca
docker cp elasticsearch:/usr/share/elasticsearch/config/certs/ca/ca.crt ./certs/ca/ca.crt

Webapp Administration

Accédez au dossier de l'application NextJS webapp-backoffice :

cd webapp-backoffice

Copiez le fichier .env.example :

cp .env.example .env

Afin que l'application puisse envoyer des e-mails, veuillez configurer le service de messagerie dans votre fichier .env :

Variable	Description
NODEMAILER_HOST	Adresse hôte du service de messagerie.
NODEMAILER_PORT	Numéro de port du service de messagerie.
NODEMAILER_USER	Identifiants utilisateur pour accéder au service de messagerie.
NODEMAILER_PASSWORD	Mot de passe associé à l'utilisateur du service de messagerie.
NODEMAILER_FROM	Adresse e-mail utilisée comme adresse de l'expéditeur.

Installez les dépendances nécessaires :

yarn

Initialisez la base de données Postgres :

npx prisma migrate dev

Effectuez un seeding de la base de données Postgres :

npx prisma db seed

Lancez l'application, qui sera accessible sur le port 3000 :

yarn dev

Voici les informations des utilisateurs prêts à être utilisés en développement grâce aux données de test :

Email	Rôle	Compte activé	Ancien compte observatoire	Mot de passe
user1@example.com	Porteur	Non	Non	jdma
user2@example.com	Porteur	Non	Oui	jdma
user3@example.com	Porteur	Oui	Oui	jdma
user4@example.com	Porteur	Oui	Non	jdma
admin@example.com	Administrateur	Oui	Non	jdma

Création/Édition des templates d'e-mails

Dans le dossier webapp-backoffice/react-email, vous trouverez les templates d'e-mails utilisant la bibliothèque react-email.

Pour prévisualiser les templates d'e-mails depuis ce dossier, vous pouvez utiliser la commande suivante :

Premièrement, assurez-vous d'être dans le dossier webapp-backoffice/react-email puis d'installer les dépendances :

yarn

Ensuite, lancez le serveur de prévisualisation :

yarn dev

Webapp Formulaire

Accédez au dossier de l'application NextJS webapp-form :

cd webapp-form

Copiez le fichier .env.example :

cp .env.example .env

Installez les dépendances nécessaires :

yarn

Lancez l'application, qui sera accessible sur le port 3001 :

yarn dev

Tests Cypress

Ce dépôt est configuré pour éxécuter des tests via Cypress avant chaque merge sur les branches /clevercloud et /main. Un fichier docker-compose est disponible afin de fournir un environnement propice à l'éxécution des tests en local.

Prérequis

Avant de commencer, assurez-vous que les éléments suivants sont installés :

• Docker
• Docker Compose

Containers

Afin de monter l'environnement propice aux tests en local, utilisez la commande suivante :

docker compose -f docker-compose.tests.yaml up -d

Afin de supprimer les différents containers, utilisez la commande :

docker compose -f docker-compose.tests.yaml down

Cypress

Pour run les tests cypress en mode headless, tapez :

npx cypress run --browser firefox

Pour ouvrir l'utilitaire cypress et run les tests avec l'interface, tapez

npx cypress open