demarches-simplifiees.fr est un site web conçu afin de répondre au besoin urgent de l'État d'appliquer la directive sur le 100 % dématérialisation pour les démarches administratives.

demarches-simplifiees.fr est un logiciel libre sous licence AGPL.

Vous souhaitez y apporter des changements ou des améliorations ? Lisez notre guide de contribution.

• postgresql

• rbenv : voir https://github.com/rbenv/rbenv-installer#rbenv-installer--doctor-scripts
• Yarn : voir https://yarnpkg.com/en/docs/install

• Chrome
• chromedriver :
  • Mac : brew cask install chromedriver
  • Linux : voir https://sites.google.com/a/chromium.org/chromedriver/downloads

Les informations nécessaire à l'initialisation de la base doivent être pré-configurées à la main grâce à la procédure suivante :

su - postgres
psql
> create user tps_development with password 'tps_development' superuser;
> create user tps_test with password 'tps_test' superuser;
> \q

Sous Ubuntu, certains packages doivent être installés au préalable :

sudo apt-get install libcurl3 libcurl3-gnutls libcurl4-openssl-dev libcurl4-gnutls-dev zlib1g-dev

Afin d'initialiser l'environnement de développement, exécutez la commande suivante :

bin/setup

On lance le serveur d'application ainsi :

bin/rails server

L'application tourne alors à l'adresse http://localhost:3000, et utilise le mécanisme par défaut de rails pour les tâches asynchrones. C'est ce qu'on veut dans la plupart des cas. Une exception: ça ne joue pas les tâches cron.

Pour être une peu plus proche du comportement de production, et jouer les tâches cron, on peut lancer la message queue dans un service dédié, et indiquer à rails d'utiliser delayed_job:

bin/rake jobs:work
RAILS_QUEUE_ADAPTER=delayed_job bin/rails server

En local, un utilisateur de test est créé automatiquement, avec les identifiants [email protected]/this is a very complicated password !. (voir db/seeds.rb)

rails jobs:schedule

Ouvrez la page http://localhost:3000/letter_opener.

Pour mettre à jour votre environnement de développement, installer les nouvelles dépendances et faire jouer les migrations, exécutez :

bin/update

Les tests ont besoin de leur propre base de données et certains d'entre eux utilisent Selenium pour s'exécuter dans un navigateur. N'oubliez pas de créer la base de test et d'installer chrome et chromedriver pour exécuter tous les tests.

Pour exécuter les tests de l'application, plusieurs possibilités :

• Lancer tous les tests

    bin/rake spec
    bin/rspec
  

• Lancer un test en particulier

    bin/rake spec SPEC=file_path/file_name_spec.rb:line_number
    bin/rspec file_path/file_name_spec.rb:line_number
  

• Lancer tous les tests d'un fichier

    bin/rake spec SPEC=file_path/file_name_spec.rb
    bin/rspec file_path/file_name_spec.rb
  

• Relancer uniquement les tests qui ont échoué précédemment

    bin/rspec --only-failures
  

    rails generate after_party:task task_name

Le projet utilise plusieurs linters pour vérifier la lisibilité et la qualité du code.

• Faire tourner tous les linters : bin/rake lint
• Vérifier l'état des traductions : bundle exec i18n-tasks health
• AccessLint tourne automatiquement sur les PRs

bundle binstub railties --force
bin/rake rails:update:bin

Dans le cas d’un déploiement sur plusieurs serveurs, l’application peut être déployée avec la tâche :

DOMAINS="web1 web2" BRANCH="main" bin/rake deploy

En interne, cette tâche utilise mina pour lancer les commandes de déploiement sur tous les serveurs spécifiés.

Des tâches de gestion des comptes super-admin sont prévues dans le namespace superadmin. Pour les lister : bin/rake -D superadmin:.

Des tâches d’aide au support sont prévues dans le namespace support. Pour les lister : bin/rake -D support:.

L'application gère les navigateurs récents, parmis lequels Firefox, Chrome, Safari et Edge (voir config/initializers/browser.rb).

La compatibilité est testée par Browserstack.

Nous utilisons Skylight pour suivre les performances de notre application.