improve doc for variable thirdParty in Doc gen

Signed-off-by: Julien Fastré <julienfastre@noreply.localhost>

.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

@@ -159,6 +159,7 @@ Les administrateurs fonctionnels peuvent activer les paramètres suivants:
 * un champ "usager 1", qui permet ensuite à l'utilisateur de choisir un usager parmi ceux concernés par le parcours, les interlocuteurs privilégiés qui sont des usagers (à l'exclusion des tiers), et les personnes ressources associées à un usager concerné du parcours (à l'exclusion des ressources tiers et "texte libre");
 * un champ "usager 2", qui permet aux utilisateurs de choisir un deuxième usager parmis ceux concernés par le parcours, les interlocuteurs privilégiés qui sont des usagers (à l'exclusion des tiers), et les personnes ressources associées à un usager concerné du parcours (à l'exclusion des ressources tiers et "texte libre");
 * un champ "usager principal du parcours", qui permet, cette fois, de choisir parmi les usagers concernés par le parcours, les interlocuteurs privilégiés qui sont des usagers (à l'exclusion des tiers), et les personnes ressources associées à un usager concerné du parcours (à l'exclusion des ressources tiers et "texte libre");
+* un champ "tiers", qui permet de choisir un tiers parmi les tiers "personnes ressources" du parcours, ou le demandeur du parcours (s'il s'agit d'un tiers);
 
 #### Variables
 
@@ -168,6 +169,7 @@ Le document présente:
 * si `usager principal du parcours` est coché, une variable `mainPerson`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`;
 * si `usager 1` est coché, une variable `person1`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
 * si `usager 2` est coché, une variable `person2`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
+* une variable `thirdParty`, de type `ThirdParty`, uniquement si l'administrateur fonctionnel l'a configuré.
 
 ### Document générés pour un parcours, contexte "liste des activités"
 
@@ -187,6 +189,7 @@ Le document présente:
 * si `usager principal du parcours` est coché, une variable `mainPerson`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`;
 * si `usager 1` est coché, une variable `person1`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
 * si `usager 2` est coché, une variable `person2`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`;
+* une variable `thirdParty`, de type `ThirdParty`, uniquement si l'administrateur fonctionnel l'a configuré.
 
 ### Document générés pour un échange
 
@@ -204,7 +207,8 @@ Il est possible également d'injecter des dossiers d'usagers, parmi ceux associ
 
 ### Documents générés dans le dossier d'une personne: contexte "personne basique"
 
-* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`.
+* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`;
+* une variable `thirdParty`, de type `ThirdParty`, uniquement si l'administrateur fonctionnel l'a configuré.
 
 ### Documents générés dans le dossier d'une personne: contexte "personne avec un tiers"
 
@@ -470,10 +474,28 @@ Seul le champ `comment` est donc disponible.
 
 
 * `id` (int): l'identifiant du ménage;
-* `members` (liste de HouseholdMember): liste des membres du ménages;
+* `current_address` (Adress) : adresse actuelle du ménage
+* `current_composition` (HouseholdComposition): Composition **actuelle** du ménage
+* `currentMembers` (liste de HouseholdMember): liste des membres **actuels** du ménage;
+* `members` (liste de HouseholdMember): liste des membres du ménages. Cette liste inclut également les anciens membres;
 * `waitingForBirth` (bool): `true` si une naissance est attendue;
 * `waitingForBirthDate` (Date): date de la naissance attendue;
 
+### HouseholdComposition
+
+La composition du ménage entre deux dates. Cette entité associe une `HouseholdCompositionType` avec une date de début et une date de fin
+
+* `id` (int): L'identifiant de la composition
+* `startDate` (Date): date de début de validité de la composition du ménage;
+* `endDate` (Date): date de fin de validité de la composition du ménage (vide si actif)
+* `numberOfChildren` (int): nombre d'enfants
+* `householdCompositionType` (HouseholdCompositionType): Type de composition choisie, entre deux dates
+
+### HouseholdCompositionType
+
+* `id` (int): L'identifiant du type de composition
+* `label` (texte): Le libellé de la composition
+
 ### HouseholdMember (Membre d'un ménage)
 
 * `comment` (texte): texte du commentaire;

build-pandoc.sh

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

user/intro.md

@@ -1,4 +1,3 @@
-\newpage
 
 # Qu'est-ce que Chill?
 

user/metadata.yaml

@@ -3,9 +3,13 @@ title: Manuel utilisateur de Chill
 lang: fr-BE
 toc: true
 page: a4
-book: true
 
-titlepage: true,
+# specitfic to template eisvoger
+titlepage: true
+toc-own-page: true
+# cause the numbering to be 0.x for every chapter
+book: false
+float-placement-figure: H
 #logo: "img/logo-chill-outil-accompagnement.svg"
 
 header-includes: |

user/notifications.md

@@ -3,7 +3,9 @@
 # Notifications
 <!-- fr/notification/inbox -->
 
-Les notifications sont des messages envoyés par un utilisateur à un ou plusieurs autres. Les notifications ont pour but d'échanger rapidement des informations sur des dossiers sociaux en cours entre travailleurs sociaux. Par exemple, les notifications permettent d'informer un travailleur social à propos d'un parcours.
+Les notifications sont des messages envoyés par un utilisateur à un ou plusieurs autres utilisateurs. Les notifications ont pour but d'échanger rapidement des informations sur des dossiers sociaux en cours entre travailleurs sociaux. Par exemple, les notifications permettent d'informer un travailleur social à propos d'un parcours.
+
+Chill peut également envoyer des notifications systèmes lors de certains événements.
 
 On y accède soit depuis la page d'accueil de Chill, sous l'onglet "Mes notifications", soit n'importe où dans l'application via le
 menu "utilisateur" en haut à droite de l'écran. Selon la configuration choisie par les administrateurs du logiciel, les notifications sont aussi envoyées par courriel au travailleur social concerné.
@@ -17,16 +19,13 @@ Des notifications peuvent être envoyées à partir de plusieurs endroits du log
 
 Il est possible d'envoyer une notification:
 
-- de la page résumé d'un parcours
+- à propos d'un parcours, de la page résumé d'un parcours
-- d'une activité/échange
+- à propos d'une activité/échange
+- à propos d'une action d'accompagnement
+- à propos d'un document dans une action d'accompagnement
 
 Les notifications envoyées, par exemple, à partir d'un parcours, sont listées dans le résumé du parcours.
 
-<!-- TODO: Y a t il d'autres endroits où sont utilisées les notifications?  -->
-
-Il y a en outre des notifications automatiquement envoyées lors de certaines manipulations.
-
-
 ![Créer une notification](./img/notification_parcours.png)
 
 ## Discuter dans une notification
@@ -38,5 +37,9 @@ Lorsqu'une notification est reçue, il est possible d'engager une discussion ave
 
 Dans la liste des notifications, lorsqu'on clique sur une notification, on peut déplier le contenu de la notification et accéder à la discussion avec l'icône "Voir le fil de commentaire associé".
 
+## Notification système
 
+Il y a en outre des notifications automatiquement envoyées lors de certaines manipulations.
+
+Pour ces notifications, il n'est pas possible d'entamer une conversation.
 

user/nouveautes.md

@@ -0,0 +1,39 @@
+```{=latex}
+\cleardoublepage
+```
+
+# Nouveautés
+
+## Mai 2023
+
+### Statut "hors file active" et "pré-archivé" dans les parcours
+
+Jusqu'à maintenant, on avait des parcours avec les statuts "brouillon", "en file active" et "cloturé".
+ 
+Deux autres statuts sont ajoutés:
+
+- "hors file active"
+- pré-archive
+
+Cela correspondra à des parcours ouverts et qui n'ont pas eu d'activité depuis:
+ 
+- six mois pour "hors file active";
+- deux ans pour "pré-archive"
+
+Pour ces parcours "hors file active" et "pré-archive", il est possible d'ajouter des échanges, des actions, des rendez-vous, etc. Et de clôturer ces parcours. Lorsque cela est le cas, le parcours repassera, dans les heures qui suivent, en statut "en file active".
+ 
+Le passage vers ces deux statuts est effectué automatiquement, sans intervention de l'utilisateur. Sont pris en compte:
+ 
+- la date des échanges;
+- la date de début, de fin, des actions d'accompagnements;
+- la date de début, de fin des évaluations
+- l'ajout d'une évaluation, d'un document dans une évaluation, la mise à jour d'un document ou la mise à jour d'un commentaire dans une évaluation;
+- et, évidemment, la date d'ouverture du parcours.
+
+Les rendez-vous ne sont pas pris en compte.
+ 
+Pour les parcours existants qui étaient inactifs de puis plus de six mois ou deux ans, un passage automatique à ce nouveau statut est prévu: le nouveau statut sera indiqué six mois ou deux ans après la dernière activité prise en compte.
+
+### Notification depuis des actions et des documents dans les évaluations
+
+Il est maintenant possible d'envoyer une notification à propos d'une action d'accompagnement ou d'un document dans une évaluation.

user/parcours.md

@@ -44,7 +44,15 @@ Il est important de distinguer les différents états pour un parcours. Un badge
 
 ::: { .note }
 
-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.
+Le passage vers ces les statuts **HORS FILE ACTIVE** et **PRÉ-ARCHIVÉ** est effectué automatiquement, sans intervention de l'utilisateur. Pour calculer "l'inactivité", le logiciel prend en compte la date de différents événements dans le parcours. Si aucun de ces événement n'a eu lieu, Chill change automatiquement le statut du parcours. Sont pris en compte:
+ 
+- la date des échanges;
+- la date de début, de fin, des actions d'accompagnements;
+- la date de début, de fin des évaluations;
+- l'ajout d'une évaluation, d'un document dans une évaluation, la mise à jour d'un document ou la mise à jour d'un commentaire dans une évaluation;
+- et, évidemment, la date d'ouverture 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é automatiquement également, mais avec un délai de quelques heures.
 
 :::