Merge pull request 'Parallelization of drone builds, where possible' (#3) from drone/parallelization into main

Reviewed-on: #3

.drone.yml

@@ -18,12 +18,16 @@ steps:
   commands:
     - git lfs fetch
     - git lfs checkout
+  depends_on:
+    - clone
 
 - name: pandoc
   image: pandoc/core:2.18-alpine
   commands:
     - sh build-pandoc.sh latex user > user/user-manual.tex
     - sh build-pandoc.sh latex admin > admin/admin-manual.tex
+  depends_on:
+    - fetch images
 
 - name: build-latex-user
   image: texlive/texlive
@@ -31,6 +35,8 @@ steps:
     - cd user
     - latexmk -pdf -file-line-error -halt-on-error -interaction=nonstopmode -xelatex user-manual.tex
     - mv user-manual.pdf ../Manuel\ utilisateur.pdf
+  depends_on:
+    - pandoc
 
 - name: build-latex-admin
   image: texlive/texlive
@@ -38,6 +44,8 @@ steps:
     - cd admin
     - latexmk -pdf -file-line-error -halt-on-error -interaction=nonstopmode -xelatex admin-manual.tex
     - mv admin-manual.pdf ../Manuel\ administrateur.pdf
+  depends_on:
+    - pandoc
 
 - name: release
   image: plugins/gitea-release
@@ -49,11 +57,14 @@ steps:
       - "Manuel administrateur.pdf"
       - "Manuel utilisateur.pdf"
     title: ${DRONE_TAG:=latest}
+  depends_on:
+    - build-latex-user
+    - build-latex-admin
   when:
     event:
     - tag
 ---
 kind: signature
-hmac: dc200b08e09b83e734ff829ac62c7daf5f80986f725edac1b974b07793adb4b0
+hmac: a83892d8f9bb967bd2a6335e2b34008e05f9bec482f270237c6764918434f97c
 
 ...

admin/generation-documents.md

@@ -11,7 +11,10 @@ Seuls les documents suivants peuvent être utilisés:
 * .ods
 * .odp
 
-## Rappel du parcours des utilisateurs
+Des exemples sont disponibles [en ligne](https://gitea.champs-libres.be/Chill-project/manuals/src/branch/main/admin/generation-documents-templates).
+
+
+## Rappel de "l'expérience utilisateur": comment les utilisateurs génèrent un document ?
 
 Les utilisateurs peuvent générer un document depuis plusieurs contextes du logiciel:
 

build-pandoc.sh

@@ -36,7 +36,7 @@ if [ $kind = 'user' ]; then
     notifications.md
     tasks.md
     workflows.md
-    choisir_une_adresse.md
+    adresses.md
   "
 elif [ $kind = 'admin' ]; then
   export files="

user/adresses.md

@@ -0,0 +1,66 @@
+\newpage
+
+# Gestion des adresses
+
+## Choisir une adresse {#sec:choisir-une-adresse}
+
+
+Que ce soit dans un ménage, dans un tiers ou encore pour localiser un échange, il y a plusieurs endroits où vous pouvez saisir une adresse dans Chill.
+
+### Création d'une d'adresse
+
+Lorsque le formulaire d'adresse s'ouvre, vous pouvez soit sélectionner une adresse "de référence", soit en saisir une nouvelle. Il est en effet possible de pré-charger une liste d'adresses de référence provenant de sources officielles dans Chill. Suivant votre installation, cela a peut-être été fait pour votre région, votre département ou le pays entier.
+
+![Création d'une d'adresse](./img/choisir-une-adresse.png)
+
+La case à cocher "Adresse confidentielle" permet d'indiquer qu'une adresse doit apparaitre par défaut floutée dans le logiciel ou tout document exporté du logiciel.
+
+La case à cocher "Pas d'adresse complète" permet d'indiquer une adresse uniquement en indiquant la pays et une localité, sans définir la rue et le numéro de bâtiment. Si cette case n'est pas cochée, vous devez remplir la rue et le numéro de bâtiment.
+
+Si des adresses de référence ont été pré-chargées dans le logiciel, vous pouvez successivement choisir la localité (ville ou village), puis l'adresse précise (rue et numéro de bâtiment). Si l'adresse est inconnue par le logiciel, que ce soit au niveau de la localité ou de l'adresse précise, écrivez le nom dans le champ correspondant et le formulaire vous proposera de saisir une nouvelle adresse. Attention, la recherche d'une adresse pré-chargée est sensible à des fautes de frappes ou d'orthographe, donc assurez-vous de l'orthographe de votre saisie avant de créer une nouvelle adresse.
+
+Lorsqu'une adresse de référence est sélectionnée, la localisation de l'adresse est connue et le pointeur se déplace sur la carte à l'endroit de l'adresse. Lors de la création d'une adresse inconnue par le logiciel, la localisation ne peut pas être définie.
+
+En bas du formulaire, une série de champs optionnels peuvent être complétés pour préciser l'adresse (étage, couloir, escalier, complément d'adresse, etc.). En remplissant adéquatement ces champs, le logiciel pourra générer des adresses postales valides utiles pour la génération de documents.
+
+### Dates de validité
+
+Dans le cas d'une adresse d'un ménage, lors de la création d'une adresse, une date de validité doit être choisie, indiquant à partir de quand l'adresse est valide. Lors d'un changement d'adresse, le logiciel va garder l'historique des adresses d'un ménage en tenant compte de ces dates de validité.
+
+## Édition d'une adresse existante
+
+Dans le cas d'une erreur, ou bien dans le cas d'un changement d'adresse d'un tiers, il est possible d'éditer une adresse existante en cliquant sur le bouton "Modifier l'adresse".
+
+## Visualiser les détails d'une adresse
+
+A côté de chaque adresse, un bouton indiquant une carte permet de visualiser les détails d'une adresse, et notamment:
+
+- visualiser l'adresse sur une carte;
+- ouvrir, dans une nouvelle fenêtre ou un nouvel onglet, une carte détaillée sur Google maps ou OpenStreetMap, pour visualiser l'endroit de manière plus confortable et éventuellement calculer un itinéraire;
+- lister les zones statistiques géographiques qui recouvrent l'adresse.
+
+::: {.note}
+
+La page de visualisation sur Google Maps où OpenStreetMap s'ouvre dans un nouvel onglet, ou une nouvelle fenêtre.
+
+:::
+
+![Une adresse, le bouton avec une carte permettant de visualiser les détails de cette adresse](img/address_inline_with_button.png)
+
+![Visualisation des détails d'une adresse](img/address_details_modal.png)
+
+## Mise à jour des adresses de référence
+
+Les adresses de références devraient être régulièrement mises à jour. Il est probable que des changements aient lieu dans des adresses de référence qui sont associées aux adresses des tiers et des ménages.
+
+Dans ce cas, cela est indiqué dans l'affichage de l'adresse et dans la modale qui permet de visualiser les détails. Vous pouvez alors choisir de mettre à jour cette adresse ou d'ignorer les changements.
+
+![Adresse dont l'adresse de référence a été modifiée](img/address_inline_with_button_and_warning.png)
+
+![Mettre à jour une adresse de référence modifiée](img/address_details_modal_with_address_reference_change.png)
+
+::: {.note}
+
+Il existe un filtre permettant de lister les ménages dont l'adresse de référence a fait l'objet d'une mise à jour. 
+
+:::

user/choisir_une_adresse.md

@@ -1,30 +0,0 @@
-\newpage
-
-# Choisir une adresse  {#sec:choisir-une-adresse}
-
-
-Que ce soit dans un ménage, dans un tiers ou encore pour localiser un échange, il y a plusieurs endroits où vous pouvez saisir une adresse dans Chill.
-
-## Création d'une d'adresse
-
-Lorsque le formulaire d'adresse s'ouvre, vous pouvez soit sélectionner une adresse prédéfinie soit en saisir une nouvelle. Il est en effet possible de pré-charger une liste d'adresses dans Chill. Suivant votre installation, cela a peut-être été fait pour votre région, votre département ou le pays entier.
-
-![Création d'une d'adresse](./img/choisir-une-adresse.png)
-
-La case à cocher "Adresse confidentielle" permet d'indiquer qu'une adresse doit apparaitre par défaut floutée dans le logiciel ou tout document exporté du logiciel.
-
-La case à cocher "Pas d'adresse complète" permet d'indiquer une adresse uniquement en indiquant la pays et une localité, sans définir la rue et le numéro de bâtiment. Si cette case n'est pas cochée, vous devez remplir la rue et le numéro de bâtiment.
-
-Si des adresses ont été pré-chargées dans le logiciel, vous pouvez successivement choisir la localité (ville ou village), puis l'adresse précise (rue et numéro de bâtiment). Si l'adresse est inconnue par le logiciel, que ce soit au niveau de la localité ou de l'adresse précise, écrivez le nom dans le champ correspondant et le formulaire vous proposera de saisir une nouvelle adresse. Attention, la recherche d'une adresse pré-chargée est sensible à des fautes de frappes ou d'orthographe, donc assurez-vous de l'orthographe de votre saisie avant de créer une nouvelle adresse.
-
-Lorsqu'une adresse pré-chargée est sélectionné, la localisation de l'adresse est connue et le pointeur se déplace sur la carte à l'endroit de l'adresse. Lors de la création d'une adresse inconnue par le logiciel, la localisation ne peut pas être définie.
-
-En bas du formulaire, une série de champs optionnels peuvent être complétés pour préciser l'adresse (étage, couloir, escalier, complément d'adresse, etc.). En remplissant adéquatement ces champs, le logiciel pourra générer des adresses postales valides utiles pour la génération de documents.
-
-## Dates de validité
-
-Dans le cas d'une adresse d'un ménage, lors de la création d'une adresse, une date de validité doit être choisie, indiquant à partir de quand l'adresse est valide. Lors d'un changement d'adresse, le logiciel va garder l'historique des adresses d'un ménage en tenant compte de ces dates de validité.
-
-## Édition d'une adresse existante
-
-Dans le cas d'une erreur, ou bien dans le cas d'un changement d'adresse d'un tiers, il est possible d'éditer une adresse existante en cliquant sur le bouton "Modifier l'adresse".

user/parcours.md

@@ -21,15 +21,30 @@ En bref, il s'agit du tableau de bord du parcours à partir duquel vous pouvez n
 
 ## Les différents états d'un parcours
 
-Il est important de distinguer trois états principaux pour un parcours. Un badge se trouve en haut à droite du bandeau ou de l'élément de liste pour identifier cet état.
+Il est important de distinguer les différents états pour un parcours. Un badge se trouve en haut à droite du bandeau ou de l'élément de liste pour identifier cet état.
+
+* **BROUILLON** : le formulaire du parcours est en cours de rédaction, en attente de confirmation.
+
+  Le parcours n'est visible que par son créateur pendant cette période (via le menu utilisateur `Mes parcours brouillon`). Il reste disponible pendant 15 jours à cet état. Ensuite, il est automatiquement supprimé.
+
+* **EN FILE ACTIVE** : le formulaire de création du parcours a été complété, et le parcours est confirmé.
+
+  Il est, dès lors, visible par tous les utilisateurs. Des échanges, des actions d'accompagnements, des documents et des tâches peuvent être ajoutés.
+
+* **HORS FILE ACTIVE** : le parcours n'a plus reçu d'échange ni d'actions d'accompagnements depuis plus de six mois.
+
+  Il est toujours possible d'ajouter de nouvelles actions ou échanges. 
+
+* **PRÉ-ARCHIVÉ** : le parcours n'a plus reçu d'échanges ni d'actions d'accompagnement depuis plus de deux ans.
+
+  Il est toujours possible d'ajouter de nouvelles actions ou échanges. 
 
-* **BROUILLON** : le formulaire du parcours comporte des informations manquantes et ne peut donc pas être confirmé (couleur du badge : gris).
-* **EN FILE ACTIVE** : toutes les informations requises ont été fournies et d'autres actions, activités, etc peuvent être ajoutées (couleur du badge : bleu foncé).
 * **CLÔTURÉ** : le parcours d'accompagnement social est arrivée à son terme, la raison peut être définie (couleur du badge : rouge).
 
+
 ::: { .note }
 
-Un parcours "brouillon" n'est visible que par l'auteur du parcours.
+Notez que, lorsqu'un parcours reçoit des nouvelles actions ou échanges, un parcours redevient **EN FILE ACTIVE**. Ce changement de statut est effectué avec un délai de quelques heures.
 
 :::