Dématérialiser et simplifier les démarches administratives
Find a file
Kara Diaby f5f4aa9bf2
Merge pull request #6292 from betagouv/add-error-message-to-csv-import
Renvoie un message d'erreur si les headers du fichier CSV ne sont pas au format attendu
2021-06-22 16:46:40 +02:00
.github ci: update the 'rebase' github action 2021-06-22 08:33:15 +02:00
app return error if the csv headers are wrong 2021-06-22 16:33:38 +02:00
bin app: update code to Rails 6.1 2021-03-25 13:24:53 +01:00
config routes: replace the email param in the Avis URLs by a query param 2021-06-17 11:15:51 +02:00
db Prevent double processing of declarative dossiers 2021-06-04 17:55:40 +02:00
doc doc: add a visualization of the database models 2020-08-27 12:02:28 +02:00
lib percentile returns always an integer 2021-06-17 16:31:53 +02:00
log First Commit 2015-08-10 11:05:06 +02:00
public add public csv exemple for import groupe instructeurs 2021-06-15 19:36:46 +02:00
spec test file 2021-06-22 16:33:38 +02:00
vendor/assets/stylesheets Use leaflet and freedraw from npm 2018-10-05 09:55:41 +02:00
.browserslistrc ajout d'une bannière de dépréciation pour IE11 2020-07-06 10:01:02 +02:00
.editorconfig Add poor man’s ASN1 parsing 2019-06-17 16:16:28 +02:00
.erdconfig doc: add a visualization of the database models 2020-08-27 12:02:28 +02:00
.eslintrc.js Update webpacker and replace vue with react 2019-04-03 14:38:07 +02:00
.gitignore Chore(test): enable rspec only-failures support 2021-04-15 14:17:39 +02:00
.haml-lint.yml added a custom haml linter in order to avoid hardcoding application name 2020-07-23 16:16:36 +02:00
.prettierrc.js fix new prettier defaults 2020-05-12 18:18:37 +02:00
.rspec specs: always require rails_helper 2020-03-31 12:48:32 +02:00
.rubocop.yml Refactor (Rubocop): replace map{ … }.compact by filter_map 2021-06-11 15:38:09 +02:00
.ruby-version update to ruby 2.7.1 2020-09-14 16:17:02 +02:00
.scss-lint.yml Remove old css and js 2021-02-02 15:26:11 +01:00
babel.config.js Upgrade core-js 2020-02-24 19:43:07 +01:00
bors.toml add bors jobs to check 2020-06-29 13:26:14 +00:00
config.ru app: update code to Rails 6.1 2021-03-25 13:24:53 +01:00
CONTRIBUTING.md doc: clarify wording in CONTRIBUTING.md 2019-06-17 15:54:41 +02:00
Gemfile update administrate 2021-05-07 11:15:22 +02:00
Gemfile.lock gems: upgrade sentry to 4.4.0 2021-05-27 14:33:13 +02:00
Guardfile Remove a useless comment 2019-01-05 11:54:42 +01:00
LICENSE.txt Rename license file 2019-04-02 17:20:47 +02:00
package.json Bump highcharts from 8.1.1 to 9.0.0 2021-06-01 08:56:16 +00:00
postcss.config.js Update webpacker and replace vue with react 2019-04-03 14:38:07 +02:00
Procfile mise à jour de Procfile 2020-07-09 09:33:17 +02:00
Rakefile Extract the deploy_ha task in a dedicated file 2018-09-20 11:20:23 +02:00
README.md docs: remove geos from the README 2021-06-22 12:41:28 +02:00
yarn.lock Bump postcss from 7.0.30 to 7.0.36 2021-06-17 15:14:12 +00:00

demarches-simplifiees.fr

Contexte

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.

Comment contribuer ?

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.

Installation pour le développement

Dépendances techniques

Tous environnements

  • postgresql

Développement

Tests

Création des rôles de la base de données

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

Initialisation de l'environnement de développement

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

Lancement de l'application

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

Utilisateurs de test

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

Programmation des tâches récurrentes

rails jobs:schedule

Voir les emails envoyés en local

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

Mise à jour de l'application

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

bin/update

Exécution des tests (RSpec)

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
    

Ajout de taches à exécuter au déploiement

    rails generate after_party:task task_name

Linting

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

Régénérer les binstubs

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

Déploiement

Dans le cas dun déploiement sur plusieurs serveurs, lapplication 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.

Tâches courantes

Tâches de gestion des comptes super-admin

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

Tâches daide au support

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

Compatibilité navigateurs

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.

Performance

View performance data on Skylight

Nous utilisons Skylight pour suivre les performances de notre application.