Dématérialiser et simplifier les démarches administratives
Find a file
2024-01-16 19:43:19 +01:00
.github ci: build ruby with yjit support 2024-01-11 13:46:04 +01:00
app perf(admin): replace ProcedureDetail open struct with proper struct 2024-01-16 19:43:19 +01:00
bin chore(tools): update chrome/chromedriver installation procedure 2023-08-30 14:03:16 +02:00
config Merge pull request #9882 from demarches-simplifiees/add-dossier-reference-in-transfer-email 2024-01-15 15:39:09 +00:00
db add email_merge_token to france connect information 2024-01-11 11:33:38 +01:00
doc tech(doc): documente le process pour re-importer un dossier perdu en prod depuis un backup 2023-06-20 10:38:04 +02:00
lib fix(data): backfill invites where missing user can be linked 2024-01-04 07:05:34 +01:00
log First Commit 2015-08-10 11:05:06 +02:00
patches correctif(dsfr.burger-menu): le burger menu du DSFR n'aime pas le double dans le header 2023-09-12 17:18:31 +02:00
public remove contact email on 500 page 2023-11-09 14:31:24 +01:00
spec Merge pull request #9882 from demarches-simplifiees/add-dossier-reference-in-transfer-email 2024-01-15 15:39:09 +00:00
vendor/assets/stylesheets accessibilite(pages-authentification): evolutions des pages de connexion/creation de compte pour respecter le DSFR et supporter une meilleure accessibilite 2023-01-03 16:26:05 +01: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 chore(npm): update dependencies 2023-09-05 10:53:02 +02:00
.gitignore chore(git): ignore possible local (dev) ruby config 2023-06-29 14:50:13 +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
.node-version fix(node): version 2023-09-04 10:55:48 +02:00
.prettierrc.js fix new prettier defaults 2020-05-12 18:18:37 +02:00
.rspec specs: profile specs runtime 2021-11-09 08:32:31 +01:00
.rubocop.yml feat(DossierAsignment): create model 2023-07-18 16:54:00 +02:00
.ruby-version chore: try ruby 3.3.0 2024-01-11 13:45:58 +01:00
.scss-lint.yml amelioration(review): tech review 2023-12-15 11:23:25 +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 Update CONTRIBUTING.md 2023-08-31 10:36:09 +02:00
Gemfile chore(bundle): rails 7.0.8 for removing deprecation warning 2024-01-11 13:46:03 +01:00
Gemfile.lock chore(bundle): rails 7.0.8 for removing deprecation warning 2024-01-11 13:46:03 +01:00
Guardfile specs: migrate from features to system specs 2021-10-26 12:24:46 +02:00
LICENSE.txt Rename license file 2019-04-02 17:20:47 +02:00
package.json tech(clean): drop drag and drop champs in editor, ux not ok 2024-01-12 11:00:29 +01:00
postcss.config.js feat(css): add dsfr 2022-08-31 14:53:50 +02:00
Procfile.dev chore(build): use vitejs 2022-06-23 15:22:54 +02:00
publiccode.yml [doc] expose link to find releaseDate 2022-05-31 08:09:41 +02:00
Rakefile db: alphabetize schema.rb 2022-03-16 10:30:25 +01:00
README.md fix(doc): update magick policy, we need JSON code to extract information 2023-12-15 09:33:49 +01:00
SECURITY.md add SECURITY.md 2022-04-28 15:57:01 +02:00
spectaql_config.yml chore(js): update jsdom dep thus updating tough cookie 2023-12-13 17:45:24 +01:00
tsconfig.json chore(build): use vitejs 2022-06-23 15:22:54 +02:00
vite.config.ts Revert "Revert "Merge pull request #8985 from tchak/chore-update-dependencies"" 2023-05-04 14:01:35 +02:00
vitest.config.ts test(js): add vitest 2022-07-05 13:38:00 +02:00
yarn.lock tech(clean): drop drag and drop champs in editor, ux not ok 2024-01-12 11:00:29 +01: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
  • imagemagick et gsfonts pour générer les filigranes sur les titres d'identité ou générer des minitiatures d'images.

Warning

Pensez à restreindre la policy d'ImageMagick pour bloquer l'exploitation d'images malveillantes. La configuration par défaut est généralement insuffisante pour des images provenant du web. Par exemple sous debian/ubuntu dans /etc/ImageMagick-6/policy.xml :

<!-- en plus de la policy par défaut, ajoutez à la fin du fichier -->
<policymap>
    <policy domain="coder" rights="none" pattern="*"/>
    <policy domain="coder" rights="read | write" pattern="{JPG,JPEG,PNG,JSON}"/>
    <policy domain="module" rights="none" pattern="{MSL,MVG,PS,SVG,URL,XPS}"/>
</policymap>

Nous sommes en cours de migration de delayed_job vers sidekiq pour le traitement des jobs asynchrones. Pour faire tourner sidekiq, vous aurez besoin de :

  • redis

Développement

Tests

Si l'emplacement d'installation de Chrome n'est pas standard, ou que vous utilisez Brave ou Chromium à la place, il peut être nécessaire d'overrider pour votre machine le path vers le binaire Chrome, par exemple :

# create file spec/support/spec_config.local.rb

Selenium::WebDriver::Chrome.path = "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"

# Must exactly match the browser version
Webdrivers::Chromedriver.required_version = "103.0.5060.53"

Il est également possible de faire une installation et mise à jour automatique lors de l'exécution de bin/update en définissant la variable d'environnement UPDATE_WEBDRIVER. Les binaires seront installés dans le repertoire ~/.local/bin/ qui doit être rajouté manuellement dans le path.

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/dev

L'application tourne alors à l'adresse http://localhost:3000 avec en parallèle un worker pour les jobs et le bundler vitejs.

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
    
  • Lancer un ou des tests systèmes avec un browser

      NO_HEADLESS=1 bin/rspec spec/system
    
  • Afficher les logs js en error issus de la console du navigateur console.error('coucou')

      JS_LOG=error bin/rspec spec/system
    
  • Augmenter la latence lors de tests end2end pour déceler des bugs récalcitrants

      MAKE_IT_SLOW=1 bin/rspec spec/system
    

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

Voir les notes de déploiement dans DEPLOYMENT.md

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.