push release only on event

.drone.yml

@@ -1,32 +1,43 @@
 ---
 kind: pipeline
 type: docker
-name: default
+name: build-release
+
+clone:
+  disable: true
 
 steps:
 
-- name: submodules
+- name: clone
+  image: plugins/git
+  settings:
+    recursive: true
+
+- name: fetch images
   image: alpine/git
   commands:
-  - git submodule init
+    - git lfs fetch
-  - git submodule update --recursive --remote
+    - git lfs checkout
-  when:
-    event: tag
 
 - name: pandoc
-  image: pandoc/alpine:2.14
+  image: pandoc/core:2.18-alpine
   commands:
-    - ls
+    - sh build-pandoc.sh latex user > user/user-manual.tex
-    - sh build-pandoc.sh latex > user-manual.tex
+    - sh build-pandoc.sh latex admin > admin/admin-manual.tex
-  when:
-    event: tag
 
-- name: build-latex
+- name: build-latex-user
-  image: ghcr.io/xu-cheng/texlive-full:latest
+  image: texlive/texlive
   commands:
+    - cd user
     - latexmk -pdf -file-line-error -halt-on-error -interaction=nonstopmode -xelatex user-manual.tex
-  when:
+    - mv user-manual.pdf ../.
-    event: tag
+
+- name: build-latex-admin
+  image: texlive/texlive
+  commands:
+    - cd admin
+    - latexmk -pdf -file-line-error -halt-on-error -interaction=nonstopmode -xelatex admin-manual.tex
+    - mv admin-manual.pdf ../.
 
 - name: release
   image: plugins/gitea-release
@@ -36,9 +47,15 @@ steps:
     base_url: https://gitea.champs-libres.be
     files:
       - user-manual.pdf
+      - admin-manual.pdf
     checksum:
       - sha512
-    title: ${DRONE_COMMIT_REF}
+    title: ${DRONE_TAG:=latest}
-    prerelease: true
     when:
-    event: tag
+      event:
+      - tag
+---
+kind: signature
+hmac: 686b3bf2e6d8ffd370cfde19d9110b6c71af6e2dc4afc3c1b8d7a5016397ee3e
+
+...

.gitattributes

@@ -0,0 +1,7 @@
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+admin-manual.pdf filter=lfs diff=lfs merge=lfs -text
+user-manual.pdf filter=lfs diff=lfs merge=lfs -text
+*.odt filter=lfs diff=lfs merge=lfs -text
+*.svg filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -1,2 +1,2 @@
 build/*
-user-manual.*
+*-manual.pdf

README.md

@@ -1,5 +1,13 @@
-Manuel utilisateur Vendée
+Manuels Vendée
-=========================
+==============
+
+## LFS
+
+:warning: Git LFS is activated on this report.
+
+Ensure that `git lfs` is installed on your system. You can install git lfs with the command `git lfs install`.
+
+Since you install it on your machine, no further step is required.
 
 ## Compilation
 
@@ -11,9 +19,17 @@ Commande:
 docker-compose up
 ```
 
-Le fichier généré est `user-manual.pdf`
+Le fichier généré est `user-manual.pdf` et `admin-manual.pdf`
 
 
+Si vous avez une (bonne) version de pandoc sur votre PC, on peut faire sans docker avec:
+
+```bash
+bash build-pandoc.sh
+bash build-pandoc.sh pdf admin
+```
+où ` bash build-pandoc.sh` est par défaut équivalent à `bash build-pandoc.sh pdf user`.
+
 ### Utilisateur
 
 L'utilisateur qui exécute la compilation est, par défaut, l'utilisateur ayant l'id `1000`.
@@ -23,3 +39,27 @@ L'utilisateur qui exécute la compilation est, par défaut, l'utilisateur ayant
 ### Awesomebox
 
 Pour créer des "box": https://www.ctan.org/tex-archive/graphics/awesomebox
+
+
+### Taille des images
+
+Pour changer la taille de toutes les images d'un coup, par ex. à 85%:
+
+remplacer dans `eisvogel.tex` la ligne
+
+```
+\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
+
+```
+
+par
+
+```
+\setkeys{Gin}{width=.85\maxwidth,height=\maxheight,keepaspectratio}
+```
+
+Si on laisse les images à 100%, beaucoup de pages blanches apparaissent.
+
+### Correcteur orthographiques
+
+Please, utilisons un correcteur orthographique pour le français pour nous éviter toutes les fautes de frappes et autres. Ex: https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker-french

admin/generation-documents.md

@@ -0,0 +1,760 @@
+
+# Génération de documents
+
+L'administrateur fonctionnel prépare la génération des documents.
+
+Cela consiste à configurer le gabarit et ses éventuelles options via l'interface d'administration. Pour chaque gabarit, un document est joint et contient des "zones substituantes", qui permettent d'insérer des informations issues de Chill.
+
+Seuls les documents suivants peuvent être utilisés:
+
+* .odt (LibreOffice Writer);
+* .ods
+* .odp
+
+## Rappel du parcours des utilisateurs
+
+Lors de la génération de document, les utilisateurs parcourrent trois étapes, dont l'un est optionnelle:
+
+1. Étape optionnelle: un formulaire demande des précisions à l'utilisateur.
+
+    Il peut s'agir, par exemple, de préciser les destinataires du document, de choisir un signataire, etc.
+
+    Ce formulaire est soit:
+
+    * natif au nœud. Dans ce cas, il apparait systématiquement ou dans certaines conditions;
+    * configuré par l'admnistrateur fonctionnel parmi des options disponibles;
+
+2. le document est effectivement généré en arrière-plan. Cela peut nécessiter éventuellement quelques secondes;
+3. le document est ouvert pour édition dans un éditeur en ligne. L'enregistrement est automatique. Lorsqu'ils ferment l'éditeur **depuis l'interface de l'éditeur**, l'utilisateur est redirigé vers l'interface de Chill, généralement la page de génération du document.
+
+    Notez que, pour que la redirection soit effective, l'utilisateur doit fermer **dans l'interface de l'éditeur**: fermer la fenêtre ou l'onglet fait perdre les informations de redirection - cependant, le document est normalement enregistré.
+
+## Syntaxe de génération d'un document
+
+Les documents sont préparés par l'administrateur fonctionnel.
+
+## Indiquer un champ dans un document
+
+Aux endroits où cela est nécessaire, l'administrateur indique un "champ substituant".
+
+Cela est accessible via le menu "Insertion > Renvoi...", puis choisir l'onglet "Fonction", "Substituant", "Texte", et indiquer la valeur du champ.
+
+La valeur à indiquer dans le champ "substituant" est à déduire des informations ci-dessous.
+
+## Principes liés au variables
+
+### Nommage de variables
+
+TODO
+
+#### Exemple: application aux objets "date"
+
+Les dates sont disponibles dans deux formats:
+
+* le format "court", ou dd/mm/yyyy (par exemple, 15/06/1980, 18/08/2021, …). Ce format est accessible par le champ `short`;
+* le format "long": 15 juin 1980, 18 août 2021, … Ce format est accessible par le champ `long`;
+
+lorsqu'une date est disponible, il est donc possible d'avoir accès à son format en précisant sa chaine de caractère. Exemple avec la date de naissance de la personne:
+
+```
+person.Birthdate.Short=15/06/1980
+person.Birthdate.Long=15 juin 1980
+```
+
+
+### Cas où une variable est optionnelle
+
+Lorsqu'une variable est optionnelle, si sa valeur est inconnue ou vide, alors tout ses champs apparaissent avec une chaine de caractère vide.
+
+L'arbre des variables est toujours identique, sur toute la profondeur de celles-ci. L'administrateur est garanti qu'un champ existera, même si sa valeur n'est pas présente dans la base de donnée.
+
+## Variables disponibles par document
+
+Pour chaque contexte où un document est généré, les variables disponibles sont listées [dans la section suivante](#sec:gendoc-champs-documents). Le type des variables est indiqué.
+
+Les variables pour chaque type sont décrites [dans la section suivante](#sec:gendoc-champs-objets):
+
+* si le type commence par une majuscule, alors cette variable comporte des sous-champs, et il faut se reporter à la description des variables pour ce type;
+* si le type commence par une minuscule, alors cette variable peut être utilisée directement dans le document:
+
+    * s'il s'agit d'un booléen (`bool`), le champ peut être utilisé dans des tests;
+    * les champs `text` et `int` peuvent faire l'objet de test sur l'égalité;
+    * les champs de type `int` peuvent faire l'objet de comparaison sur l'ordre de grandeur (par exemple, le champs `age` des objets de type `Person` peut être filtré `> 18` ou `< 18` pour distinguer les adultes des enfants).
+
+### Pour chaque document { #sec:gendoc:champs-documents }
+
+#### Paramètres pour l'administrateur fonctionnel
+
+Les administrateurs fonctionnels peuvent activer les paramètres suivants:
+
+* un champ "lieu", qui permettra de choisir parmi les lieux pré-enregistrés. Le lieu pré-sélectionné sera celui choisi par l'utilisateur;
+
+#### Variables
+
+* `creator`: (User) le créateur;
+* `createdAt` (Date): la date de création;
+* `location` (Location): le lieu sélectionné par le créateur, au moment de la génération **ou** celui choisi par l'étape 1.
+
+### Document générés pour un parcours
+
+#### Paramètres pour l'administrateur fonctionnel
+
+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");
+
+#### Variables
+
+Le document présente:
+
+* une variable `course`, de type `AccompanyingPeriod`;
+* 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`;
+
+### Document générés pour un parcours, contexte "liste des activités"
+
+Le contexte présente les mêmes variables et paramètre que les documents générés par un parcours.
+
+La variable suivante est ajoutée:
+
+* `activities` (liste de Activity): Liste d'activités, variant "light". Aucun filtre n'est appliqué sur les échanges récupérés.
+
+### Document générés pour une évaluation
+
+Le document présente:
+
+* une variable `evaluation` de type `AccompanyingPeriodWorkEvaluation`: l'évaluation concernée;
+* une variable `work` de type `AccompanyingPeriodWork`: l'action d'accompagnement au sein de laquelle l'évaluation est générée;
+* une variable `course`, de type `AccompanyingPeriod`: le parcours au sein duquel l'évaluation est générée;
+* 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`;
+
+### Document générés pour un échange
+
+Le document présente:
+
+* une variable `activity`, de type `Activity`: l'évaluation concernée
+* une variable `course`, de type `AccompanyingPeriod`: le parcours concerné, à condition que l'échange ait été créé dans un contexte parcours
+* une variable `person`, de type `Person`: la personne concernée, à condition que l'échange ait été créée dans un contexte d'usager.
+
+Il est possible également d'injecter des dossiers d'usagers, parmi ceux associés **à l'échange** (l'utilisateur peut choisir parmis les usagers de l'échange, et pas les usagers concernés du parcours).
+
+* 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`;
+
+### Documents générés dans le dossier d'une personne
+
+* une variable `person`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`.
+
+
+## Champs par objet { #sec:gendoc-champs-objets }
+
+Les champs ci-dessous étendent les variables disponibles dans les documents.
+
+Par exemple, le document généré à partir d'un parcours présente la variable `startDate` qui contient la date de début du parcours. Ce champ peut être exploité de la manière suivante:
+
+```
+${courseStartDateLong} // 15 janvier 2021
+
+ou dans la forme courte:
+
+${courseStartDateShort} // 15/01/2021
+```
+
+### AccompanyingPeriod
+
+* `id` (texte): l'identifiant du parcours
+* `type` (texte): toujours égal à `accompanying_course`
+* `isNull`: (bool) renvoie `true` si est une entité nulle (toutes les variables sont vides);
+* `closingDate` (Date): date de clotûre;
+* `confidential` (bool): `true` si confidentiel;
+* `confidentialText` (texte): "Confidentiel" si le parcours est confidentiel, texte vide sinon;
+* `createdAt` (Date): date de création;
+* `createdBy` (User): utilisateur ayant créé le parcours;
+* `emergency` (bool): `true` si parcours en urgence;
+* `emergencyText` (texte): "Urgent" si le parcours est urgent, texte vide sinon;
+* `openingDate` (texte): la date de confirmation du parcours;
+* `origin` (AccompanyingPeriodOrigin): l'origine du parcours;
+* `originText` (texte): Le titre de l'origine, directement utilisable dans le document;
+* `participations` (liste de AccompanyingPeriodParticipation): les participations du parcours, actuelles **et anciennes**;
+* `currentParticipations` (liste de AccompanyingPeriodParticipation): les participations actuelles du parcours;
+* `requestorAnonymous` (bool): `true` si le demandeur du parcours est anonyme;
+* `hasRequestor` (bool): `true` si le parcours a un demandeur (il peut être un tiers ou une personne);
+* `requestorKind` (texte): `person` si le demandeur est une personne, `thirdparty` si c'est un tiers;
+* `requestorPerson` (Person): demandeur, si le demandeur est une personne;
+* `hasRequestorPerson` (bool): `true` si le demandeur est une personne;
+* `requestorThirdParty` (ThirdParty): demandeur, si le demandeur est un tiers;
+* `hasRequestorThirdParty` (bool): `true` si le demandeur est un tiers;
+* `resources` (liste de AccompanyingPeriodResource): les ressources du parcours;
+* `scopes` (liste de Scope): services associés au parcours;
+* `scopesText` (texte): titre des services associés au parcours, séparés par une virgule;
+* `socialIssues` (liste de SocialIssues): problématiques sociales associées au parcours;
+* `socialIssuesText` (texte): Liste des problématiques sociales, séparées par une virgule;
+* `intensity` (texte): texte traduit de l'intensité: "ponctuel" ou "régulier";
+* `step` (texte): texte traduit de l'étape du parcours: "Brouillon", ou "En cours";
+* `isClosed` (bool): `true` si le parcours est fermé (la date de clotûre est renseignée);
+* `closingMotiveText` (texte): titre du motif de clotûre;
+* `ref` (User): référent du parcours;
+* `hasRef` (bool): `true` si un référent est désigné;
+* `hasLocation` (bool): `true` si un parcours a une localisation;
+* `hasLocationPerson` (bool): `true` si un parcours a une localisation auprès d'un personne. `false` si c'est une localisation temporaire;
+* `location` (Adresse): l'adresse de localisation du parcours
+* `locationPerson` (Person): l'utilisateur qui localise le parcours (s'il y en a un, peut être vide);
+* `administrativeLocation` (Location): localisation administrative du parcours;
+* `hasAdministrativeLocation` (bool): `true` si une localisation administrative est définie;
+* `works` (liste de AccompanyingPeriodWork): liste des actions d'accompagnement créées dans le cadre de ce parcours
+
+
+### AccompanyingPeriodParticipation
+
+* `id` (int): identifiant
+* `person` (Person): usager associé au parcours;
+* `startDate` (Date): date de début;
+* `endDate` (Date): date de fin. Vide si la participation est toujours en cours;
+
+
+### AccompanyingPeriodResource
+
+* `id` (int): identifiant;
+* `person` (Person): usager ressource (vide, avec le paramètre `isNull` à `true`, si la ressource est un tiers);
+* `thirdParty` (ThirdParty): tiers ressource (vide, avec le paramètre `isNull` à `true`, si la ressource est une personne);
+
+
+### AccompanyingPeriodOrigin
+
+* `id` (int): identifiant;
+* `label` (texte): libellé de l'origine;
+
+### Activity (échange)
+
+* `id` (int): identifiant;
+* `activityType` (ActivityType): Type d'échange
+* `attendee` (ActivityPresence): Présence à l'échange
+* `comment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `date` (Date): Date de l'échange
+* `durationTimeMinute` (int): Durée de l'échange, en minutes
+* `emergency` (bool): True si en urgence
+* `location` (Location): Lieu de l'échange
+* `reasons` (liste de ActivityReason): Sujets de l'échange (pas utilisé en Vendée)
+* `scope` (Scope): Service (pas utilisé  en Vendée)
+* `sentReceived` (text): sera `received` si reçu, et `sent` si envoyé;
+* `socialActions` (liste de SocialAction): liste d'actions sociales associées
+* `socialIssues` (liste de SocialIssue): liste de problématiques sociales associées
+* `thirdParties` (liste de ThirdParty): liste de tiers associés
+* `travelTimeMinute` (int): durée du trajet en minutes
+* `user` (User): l'utilisateur pour lequel l'échange a été créé;
+* `users` (liste de Users): les utilisateurs qui sont associés à l'échange.
+
+#### variant `light`
+
+Un variant `light` est utilisé dans les listes d'`Activity`, comme par exemple pour le contexte "Liste des activités pour un parcours".
+
+Ce variant comporte les mêmes attributs, avec les différences suivantes:
+
+* le champ `user` n'est pas présent;
+* le champ `scope` n'est pas présent;
+* le champ `reasons` n'est pas présent;
+* le champ `comment` est également présenté avec le variant `light`.
+
+### ActivityType
+
+Type d'activité.
+
+* `id` (int): identifiant;
+* `name` (texte): libellé
+
+### ActivityPresence
+
+Présence à l'échange
+
+* `id` (int): identifiant;
+* `name` (texte): libellé
+
+### Date
+
+* `short` (texte): la date au format dd/mm/yyyy, vide si la date est absente;
+* `long` (texte): la date au format jour mois années: 15 août 1980, vide si al date est absente;
+
+### Person
+
+* `id` (texte): Identifiant du dossier usager;
+* `isNull` (bool): `true` si le dossier usager est vide;
+* `civility` (Civility): Civilité
+* `firstName` (texte): Prénom
+* `lastName` (texte): Nom
+* `altNames` (texte): noms supplémentaire (nom de naissance, …)
+* `text` (texte): représentation du nom, prénom, et noms alternatifs: prénom, nom, et noms alternatifs.
+* `birthdate` (Date)
+* `age`: (int) age de la personne;
+* `deathdate` (Date)
+* `gender` (texte): genre (texte traduit);
+* `maritalStatus` (texte): représentation textuelle de l'état civil;
+* `maritalStatusDate` (Date): date à la quelle le statut de l'état civil a été mis à jour;
+* `maritalStatusComment` (Comment): Commentaire sur l'état civil (avec la date de la dernière mise à jour)
+* `email` (texte): adresse email
+* `firstPhoneNumber` (texte): soit le numéro de mobile s'il existe, soit le numéro fixe s'il existe, sinon vide;
+* `fixPhoneNumber` (texte): le numéro de téléphone fixe;
+* `mobilePhoneNumber` (texte): le numéro de téléphone portable;
+* `nationality` (texte): nationalité (nom du pays);
+* `placeOfBirth (texte): le lieu de naissance
+* `memo` (texte): le mémo
+* `numberOfChildren` (texte): le nombre d'enfants
+* `address` (Adresse): l'adresse actuelle
+
+::: { .vendee }
+
+Au 23 mars 2022, ces champs ne sont plus disponibles:
+
+* `numCaf` (texte): le numéro CAF;
+* `numSS` (texte): le numéro de sécurité sociale;
+* `numMSA` (texte): le numéro MSA;
+* `mutuelle` (texte): le nom de la mutuelle
+* `doctor` (ThirdParty): le médecin traitant;
+* `situationProf` (texte): la situation professionnelle;
+* `situationProfDate` (Date): date de la situation professionnelle;
+
+Par ailleurs, la nature de ces champs a changé:
+
+* `statutLogement`
+* `niveauEtude`
+
+Ces champs sont disponibles, dès le 22 mars:
+
+* `extras.majeur.isNull` (bool): si un dossier "majeur" a été créé
+* `extras.majeur.numeroCAF` (texte): le numéro CAF;
+* `extras.majeur.numeroSecuriteSociale` (texte): le numéro de sécurité sociale;
+* `extras.majeur.numMSA` (texte): le numéro MSA;
+* `extras.majeur.mutuelle` (texte): le nom de la mutuelle
+* `extras.majeur.medecinTraintant` (ThirdParty): le médecin traitant;
+* `extras.majeur.situationProfessionelle` (texte): la situation professionnelle;
+* `extras.majeur.situationProfessionelleComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.situationProfessionelleStartDate` (Date)
+* `extras.majeur.statutLogement` (StatutLogement): statut au regard du logement;
+* `extras.majeur.niveauEtude` (NiveauEtude): le niveau d''étude;
+* `extras.majeur.identifiantPoleEmploi` (texte)
+* `extras.majeur.accompagnementMissionLocale` (texte)
+* `extras.majeur.gensDuVoyage` (bool): `true` si la personne fait partie des gens du voyage
+* `extras.majeur.titreDeSejour` (TitreDeSejour): entité TitreDeSejour
+* `extras.majeur.titreDeSejourComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.situationProfessionelle` (SituationProfessionelle): entité SituationProfessionelle
+* `extras.majeur.aidantFamilial` (bool): `true` si la personne fait partie des gens du voyage
+* `extras.majeur.tempsDeTravail` (TempsDeTravail): entité TempsDeTravail
+* `extras.majeur.niveauEtude` (NiveauEtude): entité NiveauEtude
+* `extras.majeur.mobilite` (mMbilite): entité Mobilite
+* `extras.majeur.permisDeConduire` (bool): `true` si la personne a un permis de conduire
+* `extras.majeur.moyenDeTransport` (bool): `true` si la personne a un moyen de transport
+* `extras.majeur.infoSocioProComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.entourage` (Entourage): entité Entourage
+* `extras.majeur.entourageComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.numeroSecuriteSociale` (texte)
+* `extras.majeur.caisseSecuriteSociale` (texte)
+* `extras.majeur.pasDeMedecinTraitant` (bool): `true` si la personne n'a pas de médecin traitant
+* `extras.majeur.medecinTraitant` (Tiers): entité ThirdParty
+* `extras.majeur.medecinTraitantTexteLibre` (texte)
+* `extras.majeur.mdph` (texte)
+* `extras.majeur.mdphStartDate` (Date)
+* `extras.majeur.mdphEndDate` (Date)
+* `extras.majeur.mdphComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.aah` (texte)
+* `extras.majeur.aahStartDate` (Date)
+* `extras.majeur.aahEndDate` (Date)
+* `extras.majeur.aahComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.rqth` (texte)
+* `extras.majeur.rqthStartDate` (Date)
+* `extras.majeur.rqthEndDate` (Date)
+* `extras.majeur.rqthComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.pcdh` (texte)
+* `extras.majeur.pcdhStartDate` (Date)
+* `extras.majeur.pcdhEndDate` (Date)
+* `extras.majeur.pcdhComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.adpa` (texte)
+* `extras.majeur.adpaStartDate` (Date)
+* `extras.majeur.adpaEndDate` (Date)
+* `extras.majeur.adpaComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.gir` (texte)
+* `extras.majeur.girStartDate` (Date)
+* `extras.majeur.girEndDate` (Date)
+* `extras.majeur.girComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.infoMedicaleComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.statutLogement` (StatutLogement): entité StatutLogement
+* `extras.majeur.statutLogementComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.caisseDeRetraitePrincipale` (texte)
+* `extras.majeur.caisseDeRetraiteComment` (Comment): Commentaire (avec la date de la dernière mise à jour)
+* `extras.majeur.caisseDeRetraiteComplementaire` (liste de texte): les caisses de retraite complémentaires, en liste de texte;
+* `extras.majeur.caissesDeRetraiteComplementairesText` (texte): les caisses de retraite complémentaires, dans un seul champ texte, séparé par des virgules;
+En outre, si la personne est mineure, on a accès aux champs suivants:
+
+* `extras.majeur.isNull` (bool): si un dossier "mineur" a été créé
+* `extras.mineur.enfantConfie` (bool): `true` si enfant confié
+* `extras.mineur.dossierASE` (texte)
+* `extras.mineur.autoriteParentale` (texte)
+* `extras.mineur.autoriteParentaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.identificationAutoriteParentale1` (texte)
+* `extras.mineur.identificationAutoriteParentale2` (texte)
+* `extras.mineur.autoriteParentale1Date` (Date)
+* `extras.mineur.autoriteParentale2Date` (Date)
+* `extras.mineur.retraitAutoriteParentale` (bool): `true` si retraitAutoriteParentale
+* `extras.mineur.retraitAutoriteParentaleDate` (Date)
+* `extras.mineur.retraitAutoriteParentaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.delegation` (bool): `true` si délégation
+* `extras.mineur.delegationDate` (Date)
+* `extras.mineur.delegationComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.delegationThirdParty` (tiers): entité ThirdParty
+* `extras.mineur.delegationPerson` (person): entité Person
+* `extras.mineur.tuteur` (texte)
+* `extras.mineur.tuteurThirdParty` (tiers): entité ThirdParty
+* `extras.mineur.administrateurAdhoc` (bool): `true` si administrateurAdhoc
+* `extras.mineur.administrateurAdhocDate` (Date)
+* `extras.mineur.administrateurAdhocComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.pupilleEtat` (bool): `true` si pupilleEtat
+* `extras.mineur.pupilleEtatDate` (Date)
+* `extras.mineur.pupilleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.tuteurPerson` (person): entité Person
+* `extras.mineur.enfantEmancipe` (bool): `true` si enfantEmancipe
+* `extras.mineur.enfantEmancipeDate` (Date)
+* `extras.mineur.gardeAlternee` (bool)
+* `extras.mineur.decisionJAF` (bool): `true` si decisionJAF
+* `extras.mineur.decisionJAFDate` (Date)
+* `extras.mineur.decisionJAFEnfantConfie` (bool): `true` si decisionJAFEnfantConfie
+* `extras.mineur.decisionJAFDateEnfantConfie` (Date)
+* `extras.mineur.fratrieComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.droitDeVisiteComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.infoFamilialeComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.residenceMineur` (texte)
+* `extras.mineur.derniereVisiteMedicaleDate` (Date)
+* `extras.mineur.visiteMedicaleText` (texte)
+* `extras.mineur.prochaineVisiteMedicaleDate` (Date)
+* `extras.mineur.autresRDV` (texte)
+* `extras.mineur.infoMedicaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.scolarise` (bool): `true` si scolarisé
+* `extras.mineur.derniereClasseScolaire` (texte)
+* `extras.mineur.etablissementScolaire` (texte)
+* `extras.mineur.classeScolaire` (texte)
+* `extras.mineur.alternance` (bool): `true` si alternance
+* `extras.mineur.alternanceEntreprise` (texte)
+* `extras.mineur.enseignantReferant` (texte)
+* `extras.mineur.scolariteComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.mineurComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.autresIntervenantsComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.dispositifs` (texte)
+* `extras.mineur.dossierMDPH` (texte)
+* `extras.mineur.notificationMDPH` (texte)
+* `extras.mineur.notificationMDPHStartDate` (Date)
+* `extras.mineur.notificationMDPHEndDate` (Date)
+* `extras.mineur.dispositifsComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
+* `extras.mineur.adresseDeRelais` (adresse): liste d'adresses
+:::
+
+#### variant `household`
+
+* `household` (Household): le ménage actuel de l'usager;
+
+#### variant `relations`
+
+* `relations` (liste de Relationship): les relations (filiations) de l'usager;
+
+#### variant `budget`
+
+Le budget des usagers et de leur ménage est accessible de manière synthétisée: la somme globale de chaque "ligne" de budget est effectuée et disponible pour l'inclusion.
+
+Chaque "ligne" dépend de la configuration de votre instance.
+
+Toutes les lignes de budget possibles sont toujours présentes. Il est possible d'ajouter une condition dans le document pour n'afficher que les lignes ayant une somme supérieure à zéro.
+
+##### Attributs pour une `Ligne de budget`
+
+Pour chaque ligne, les informations suivantes sont disponibles:
+
+* `sum` (nombre décimal): la somme de toutes les lignes du budget du même type;
+* `label` (texte): le libellé de cette ligne dans l'interface;
+* `comment` (texte): les commentaires des lignes du budget de même type. Tous les commentaires sont concaténés les uns à la suite des autres, et séparés par le caractère `|`.
+
+##### Méthode de globalisation de chaque ligne
+
+Pour chaque ligne de budget, la somme de toutes les lignes de budget du même type est disponible. Ainsi, si une entrée dans les ressources permet de saisir une charge "frais de communication téléphonique":
+
+* pour un usager, si plusieurs lignes `frais de communication` sont enregistrées, alors c'est la somme de celles-ci qui apparaitra dans la génération de documents;
+* pour un ménage, alors ce sera la somme de tous les `frais de communication` de chaque membre du ménage **au moment de la génération du document** qui apparaitra, mais également la somme des `frais de communications` enregistrés directement dans le dossier du ménage.
+
+    On verra donc apparaitre non seulement les frais payés par chaque usager (pour leur abonnement individuel au téléphone mobile, par exemple), mais également la somme payée par le ménage (pour le téléphone fixe ou l'accès à internet).
+
+Enfin, seules les lignes _actives_ **au moment de la génération du document** sont prises en compte. Ainsi, par exemple, si un CDI a expiré la veille de la génération, son montant ne sera pas pris en compte.
+
+Le calcul du caractère actif d'une ligne est effectué comme suit:
+
+* la date de début est antérieure à la date de génération du document;
+* la date de fin est vide, ou postérieure à la date de génération du document.
+
+##### Attributs supplémentaire avec le variant `budget`:
+
+Les attributs suivants sont disponibles, pour chaque objet `Person` qui a un variant `budget`:
+
+* `budget.person.resources.<clé du type de ligne de budget>` (Ligne de budget): une ligne de budget pour la ressource dont la clé est indiquée par `<clé du type de ligne de budget>`. La liste des clés est à obtenir auprès de l'administrateur technique. Seules les lignes du budget associées au dossier de l'usager sont présentes ici;
+* `budget.person.charges.<clé du type de ligne de budget>` (Ligne de budget): une ligne de budget pour la charge dont la clé est indiquée par `<clé du type de ligne de budget>`. La liste des clés est à obtenir auprès de l'administrateur technique. Seules les lignes du budget associées au dossier de l'usager sont présentes ici;
+* `budget.household.resources.<clé du type de ligne de budget>` (Ligne de budget): une ligne de budget pour la ressource dont la clé est indiquée par `<clé du type de ligne de budget>`. La liste des clés est à obtenir auprès de l'administrateur technique. Les lignes de budget de tous les usagers actuels du ménages sont globalisées, ainsi que les lignes de budget associées directement au dossier ménage;
+* `budget.household.charges.<clé du type de ligne de budget>` (Ligne de budget): une ligne de budget pour la charge dont la clé est indiquée par `<clé du type de ligne de budget>`. La liste des clés est à obtenir auprès de l'administrateur technique. Les lignes de budget de tous les usagers actuels du ménages sont globalisées, ainsi que les lignes de budget associées directement au dossier ménage;
+
+
+
+#### Exemple d'utilisation
+
+```
+Nom de la personne: ${personLastname} // Dupuis
+Prénom de la personne: ${personFirstname} // Gérard
+Date de naissance: ${personBirthdateLong} // le 7 juillet 1974
+Nom du père: ${personFatherLastName} ${personFatherFirstname} // Dupuis Marcel
+Téléphone du père: ${personFatherFirstphonenumber} // 01 23 45 67 89
+```
+
+::: { .vendee }
+
+### StatutLogement
+
+* `id` (int): identifiant (utile pour des comparaisons);
+* `active` (bool): si le statut est encore utilisé;
+* `name` (texte): titre
+
+### NiveauEtude
+
+* `id` (int): identifiant (utile pour des comparaisons);
+* `active` (bool): si le niveau d'étude est encore utilisé;
+* `name` (texte): titre
+
+### SituationProfessionelle
+
+* `id` (int): identifiant (utile pour des comparaisons);
+* `active` (bool): si la situation professionelle est encore utilisée
+* `name` (texte): titre
+
+:::
+
+### Civility
+
+* `abbreviation` (texte): abbréviation;
+* `id` (int): identifiant (utile pour des comparaisons);
+* `name` (texte): titre, label de la civilité;
+
+::: { .vendee }
+### Entourage
+
+* `person` (person): entité Person
+* `thirdParty` (tiers): entité ThirdParty
+* `text` (texte)
+* `comment` (comment):  Commentaire (avec la date de la dernire mise à jour)
+* `aidantProche` (bool): `true` si aidantProche
+
+:::
+
+### Household
+
+
+* `id` (int): l'identifiant du ménage;
+* `members` (liste de HouseholdMember): liste des membres du ménages;
+* `waitingForBirth` (bool): `true` si une naissance est attendue;
+* `waitingForBirthDate` (Date): date de la naissance attendue;
+
+### HouseholdMember
+
+* `comment` (texte): texte du commentaire;
+* `id` (int): identifiant de la participation au ménage;
+* `endDate` (Date): date de fin de participation au ménage;
+* `holder` (bool): `true` si le participant est titulaire;
+* `person` (Person): l'usager qui est membre du ménage;
+* `position` (HouseholdPosition): la position du membre dans le ménage;
+* `startDate` (Date): date de début de participation au ménage;
+
+### HouseholdPosition
+
+* `id` (int): identifiant de la position;
+* `label` (texte): label de la position dans le ménage;
+
+
+::: { .vendee }
+### Mobilite, NiveauEtude, SituationProfessionelle, StatutLogement, TempsDeTravail, TitreDeSejour
+
+* `active` (bool): `true` si active
+* `name` (texte)
+:::
+
+### ThirdParty
+
+* `id` (int): identifiant du tiers;
+* `acronym` (text): acronyme;
+* `address` (Adress): adresse du tiers
+* `categories` (liste de ThirdPartyCategory): liste des catégories;
+* `civility` (Civility): civilité
+* `contactDataAnonymous` (bool): `true` si le tiers est anonyme;
+* `email` (texte): email;
+* `name` (texte): nom du tiers;
+* `nameCompany` (texte): nom du service du tiers (pour une personne morale);
+* `parent` (ThirdParty): tiers parent (pour les contacts)
+* `profession` (ThirdPartyProfession)
+* `telephone` (texte): numéro de téléphone du tiers
+
+### ThirdPartyCategory (catégorie de tiers)
+
+TODO
+
+### ThirdPartyProfession (profession du tiers)
+
+TODO
+
+### Adresse
+
+* `address_id` (int): l'identifiant de l'adresse;
+* `text` (texte): une chaine de caractère représentant l'adresse complète;
+* `street` (texte): le nom de la rue (exemple: "RUE DES ÉGLANTIERS");
+* `streetNumber` (texte): le numéro de police;
+* `postcode` (PostCode): le code postal;
+* `country` (Country): le pays de l'adresse;
+* `floor` (texte): l'étage;
+* `corridor` (texte): le couloir;
+* `flat` (texte): l'appartement;
+* `buildingName` (texte): le nom du bâtiment / résidence;
+* `distribution` (texte): service particulier de distribution;
+* `extra` (texte): champs extras
+* `validFrom` (Date): date de début de validité;
+* `validTo` (Date): date de fin de validité (vide si toujours valide);
+
+### Postcode
+
+* `id` (int): identifiant
+* `name` (texte): localité
+* `code` (texte): code postal
+
+### Country
+
+* `id` (int): identifiant
+* `name` (texte): nom du pays
+* `code` (texte): deux lettres du code ISO pays
+
+
+### User { #sec:gendoc-var-user }
+
+* `id` (int): identifant
+* `type` (texte): vaut toujours `user`
+* `username` (texte): le login
+* `email` (texte): l'email de l'utilisateur
+* `text` (texte): le libellé complet de l'utilisateur (avec son métier et son service entre parenthèse);
+* `label` (texte): le libellé de l'utilisateur, tel qu'il est enregistré par l'administrateur fonctionnel
+* `main_scope` (Scope): service principal
+* `user_job.label` (texte): métier principal
+* `current_location` (Location): lieu de l'utilisateur, celui actuellement choisi par l'utilisateur par le menu "utilisateur";
+* `main_location` (Locatin): localisation de l'utilisateur définie par l'administrateur fonctionnel (parfois appelé "résidence administrative"). L'utilisateur ne peut pas la modifier lui-même.
+
+### Location (lieu)
+
+* `id` (int): identifant;
+* `name` (texte): nom;
+* `address` (Address): adresse du lieu;
+* `phonenumber1` (texte): numéro de téléphone;
+* `phonenumber2` (texte): numéro de téléphone;
+* `email` (email): email
+* `locationType` (LocationType): le type de lieu
+
+### LocationType (type de lieu)
+
+* `id` (int): identifant;
+* `title` (texte): titre du type de lieu;
+
+
+### Social Issue (problématique sociale)
+
+* `name`: le nom de la problématique seule
+* `text`: le nom de la problématique et des problématiques parentes
+
+### Relationship (relations (filiations) entre usagers)
+
+Pour faciliter l'usager, les relations sont toujours représentée à partir d'un usager d'origine.
+
+Les variables présentent le nom de la relation (`text`), et la personne avec qui la relation est formée (`opposite`).
+
+* `id` (int): identifant;
+* `fromPerson` (Person): personne d'origine;
+* `toPerson` (Person): personne de destination;
+* `text` (texte): le titre ou le titre inversé de la `Relation`, selon l'usager d'origine;
+* `opposite` (Person): l'usager avec qui la relation est formée;
+* `relationId` (int): identifiant du lien de filiation;
+
+**Note**: la différence entre `fromPerson` et `toPerson` est arbitraire.
+
+### AccompanyingPeriodWorkEvaluation (évaluation dans une action d'accompagnement)
+
+* `id` (texte): l'identifiant de l'évaluation;
+* `type` (texte): le libellé de l'évaluation;
+* `startDate` (Date): la date de début de l'évaluation;
+* `endDate` (Date) la date de fin de l'évaluation;
+* `maxDate` (Date): la date d'échéance de l'évaluation;
+* `comment` (texte): le commentaire de l'évaluation;
+* `createdBy` (User): le créateur de l'évaluation;
+* `createdAt` (Date): la date de création de l'évaluation;
+* `evaluation` (Evaluation): le type d'évaluation;
+
+### Evaluation (type d'évaluation)
+
+* `id` (texte): l'identifiant du type d'évaluation;
+* `title` (texte): le titre du type d'évaluation;
+
+### AccompanyingPeriodWork (Action d'accompagnement)
+
+* `id` (texte): l'identifiant de l'action;
+* `note` (texte): la note;
+* `persons` (liste de Person): liste des usagers concernés par l'action
+* `results` (liste de Result): liste des résultats directement associé au parcours (résultats sans objectifs)
+* `socialAction` (SocialAction): type d'action sociale;
+* `startDate` (Date): la date de début de l'action (vide si inexistant)
+* `endDate` (Date): la date de début de l'action (vide si inexistant)
+* `thirdParties` (liste de ThirdParty): les tiers associés à l'action comme tiers intervenants;
+* `updatedBy` (User): utilisateur ayant fait la mise à jour;
+* `updatedAt` (Date): date de mise à jour;
+* `handlingThierParty` (ThirdParty): tiers traitant;
+* `goals` (AccompanyingPeriodWorkGoal): objectifs
+* `createdBy` (Date): date de mise à jour;
+* `createdAt` (User): utilisateur ayant fait la mise à jour;
+* `createdAutomatically` (bool): `true` si l'action a été créée automatiquement (par exemple, en créant un échange);
+* `evaluations` (AccompanyingPeriodWorkEvaluation): liste des évaluations générées
+
+### SocialAction (type d'action d'accompagnement)
+
+* `id` (texte): identifiant
+* `text` (texte): texte, avec les parents inclus, séparés par un ` > `;
+* `title`: titre du type d'action, sans les parents;
+
+### Result (résultat d'une action)
+
+* `id` (texte): identifiant
+* `title` (texte): le titre du résultat
+
+### Goal (objectif d'une action)
+
+* `id` (texte): identifiant
+* `title` (texte): le titre du résultat
+
+### AccompanyingPeriodWorkGoal (objectifs et résultats d'une action d'accompagnement)
+
+* `id` (texte): identifiant
+* `goal` (Goal): objectif d'une action
+* `results` (liste de Result): liste des résultats
+
+### Comment
+
+Certains champs commentaire enregistrent également l'utilisateur qui a effectué la dernière mise à jour, et la date de celle-ci, en plus du commentaire en tant que tel. Ces champs ont les attributs suivants:
+
+* `comment` (texte): le commentaire en tant que tel;
+* `date` (Date): la date de la dernière modification;
+* `user` (User): l'utilisateur qui a effectué la dernière modification;
+
+#### Variant `light`
+
+Dans le variant `light`,
+
+* le champ `date` n'est pas présent;
+* le champ `user` n'est pas présent.
+
+Seul le champ `comment` est donc disponible.
+

admin/known-limits.md

@@ -0,0 +1,23 @@
+
+# Limites connues
+
+## Dimensionnement du logiciel et temps de réponse des pages
+
+Chill pourra supporter un très grand nombre d'usagers accompagnés, sans craindre pour les performances.
+
+Des tests ont été réalisés avec plus d'un millions d'usagers enregistrés. L'utilisation du logiciel reste satisfaisante.
+
+Il en ressort cependant que les fonctionnalités de recherche parmi les usagers sont affectées lorsqu'un grand nombre de résultats sont renvoyés par une recherche. Autrement dit, si plusieurs milliers d'usager portent le même nom que celui recherché, alors elle est plus lente à traiter.
+
+Une recherche sur des termes plus long (par exemple, le nom complet plutôt que des parties du noms) est donc plus rapide qu'une recherche par uniquement quelques lettres de ce nom.
+
+Chill est donc plus affecté par l'hétérégonéité des noms des usagers, que par le volume d'usagers, tiers, et contacts enregistrés dans la base de donnée.
+
+A l'heure d'écrire ces lignes (septembre 2021), le travail d'optimalisation des recherches de termes qui renverraient plusieurs milliers d'usagers n'a pas été optimisé.
+
+## Résolution du territoire par usager, et mise en cache
+
+La recherche du territoire de l'usager en fonction de l'adresse est une requête coûteuse. Pour accélérer le chargement des pages, cette information est mise en cache pendant une durée relativement courte, de l'ordre de 30 minutes.
+
+Lorsqu'un ménage change d'adresse, et que la nouvelle adresse est un nouveau territoire, le nouveau territoire ne sera donc pris en compte qu'après ce délai. Cela concerne l'affichage du territoire dans l'interface, mais également les droits des utilisateurs.
+

admin/metadata.yaml

@@ -0,0 +1,12 @@
+---
+title: Manuel administrateur de Chill
+subtitle: Chill en Vendée
+lang: fr-BE
+toc: true
+page: a4
+book: true
+
+
+header-includes: |
+    \usepackage{awesomebox}
+...

build-pandoc.sh

@@ -1,12 +1,11 @@
 #!/bin/sh
 
+set -e
+
 # enter the current directory
 cd "$(dirname $0)"
-export PANDOC_DIR=pandoc/cl
+export PANDOC_DIR="/pandoc/cl"
 
-export files="
-  src/parcours.md
-"
 
 if [ -z $1 ]; then
   export target=pdf
@@ -14,38 +13,77 @@ else
   export target=$1
 fi
 
+if [ -z $2 ]; then
+  export kind=user
+else
+  export kind=$2
+fi
+
+if [ $kind = 'user' ]; then
+  export files="
+    intro.md
+    concept.md
+    interface.md
+    search.md
+    person.md
+    person-vendee.md
+    activite.md
+    document.md
+    thirdparty.md
+    menage.md
+    parcours.md
+    social_actions.md
+    notifications.md
+    tasks.md
+    workflows.md
+    choisir_une_adresse.md
+  "
+elif [ $kind = 'admin' ]; then
+  export files="
+    generation-documents.md
+  "
+else
+  echo "kind '$kind' is not valid";
+  exit 1;
+fi
+
+cd $kind
+
 export ARGS="
   --from markdown
+  --number-sections
+  --resource-path ./.
   --metadata-file ./metadata.yaml
-  --lua-filter "${PANDOC_DIR}/format-link.lua"
+  `#--lua-filter "../${PANDOC_DIR}/format-link.lua`
 "
-export PDF_TEMPLATE="./pandoc/template/eisvogel.tex"
+export PDF_TEMPLATE="./../pandoc/template/eisvogel.tex"
 export LATEX_ARGS="
+  --metadata=footer-left:$(date +%d-%m-%Y)
   --template "${PDF_TEMPLATE}"
-  --lua-filter "${PANDOC_DIR}/boxes.lua"
+  --lua-filter "../${PANDOC_DIR}/boxes.lua"
 "
 
 
-if [ $target == "latex" ]; then
+if [ $target = "latex" ]; then
   pandoc $ARGS $LATEX_ARGS \
     --to latex \
     $files;
-elif [ $target == "pdf" ]; then
+elif [ $target = "pdf" ]; then
   pandoc $ARGS $LATEX_ARGS \
     --to pdf \
     --pdf-engine xelatex \
-    -o ./user-manual.pdf \
+    -o "./../$kind-manual.pdf" \
     $files
-elif [ $target == "html" ]; then
+elif [ $target = "html" ]; then
   # check target directory exists
-  if [ ! -d "./build/html" ]; then
+  if [ ! -d "./../build/html" ]; then
     echo "create build/html directory"
-    mkdir -p "./build/html"
+    mkdir -p "./../build/html"
   fi
 
   pandoc $ARGS \
    --to html \
-   -o ./build/html/index.html \
+   -o ./../build/html/index.html \
   $files
 fi
 

docker-compose.yaml

@@ -1,11 +1,21 @@
 version: "3"
 
 services:
-    texlive:
+    texlive.user:
         image: chill_user_manual_build
         build:
             context: docker/latex
-        command: ./build-pandoc.sh
+        command: ./build-pandoc.sh pdf user
+        # currently hardcoded, sorry
+        user: "1000"
+        volumes:
+            - .:/workdir
+        working_dir: /workdir
+    texlive.admin:
+        image: chill_user_manual_build
+        build:
+            context: docker/latex
+        command: ./build-pandoc.sh pdf admin
         # currently hardcoded, sorry
         user: "1000"
         volumes:

screenshot/.gitignore

@@ -0,0 +1 @@
+img/*.png

screenshot/README.md

@@ -0,0 +1,23 @@
+# Requirements
+
+This script assumes that you have installed wkhtmltopdf.
+
+```bash
+sudo apt install wkhtmltopdf
+```
+
+# Usage
+
+```bash
+python mk_screenshot.py
+```
+
+# Authentification
+
+You have to allow `wkhtmltopdf` to authenticate. To do so, get a valid cookie key/value by copying as curl any request to a Chill page in your browser (Go to the network panel, pick a request and "copy as curl").
+
+Then, copy the 'PHPSESSID=57dee6deabd6e0ae75f7a55421fc2427' value (eg: 57dee6deabd6e0ae75f7a55421fc2427) in `COOKIE_VALUE` in the python script.
+
+# Post-processing
+
+Images are too heavy, so they can be resized.

screenshot/mk_screenshot.py

@@ -0,0 +1,63 @@
+import subprocess
+
+"""
+This script assumes that you have installed wkhtmltopdf (sudo apt install wkhtmltopdf)
+"""
+
+BASE_URL = 'https://quinquina.champs-libres.be/'
+
+"""
+To get a valid cookie key/value, copy as curl a request in your browser:
+
+curl 'https://quinquina.champs-libres.be/_wdt/708fb5' \
+  -H 'Connection: keep-alive' \
+  -H 'sec-ch-ua: " Not A;Brand";v="99", "Chromium";v="99", "Google Chrome";v="99"' \
+  -H 'X-Requested-With: XMLHttpRequest' \
+  -H 'sec-ch-ua-mobile: ?0' \
+  -H 'User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36' \
+  -H 'sec-ch-ua-platform: "Linux"' \
+  -H 'Accept: */*' \
+  -H 'Sec-Fetch-Site: same-origin' \
+  -H 'Sec-Fetch-Mode: cors' \
+  -H 'Sec-Fetch-Dest: empty' \
+  -H 'Referer: https://quinquina.champs-libres.be/fr/person/household/376/relationship' \
+  -H 'Accept-Language: en-US,en;q=0.9' \
+  -H 'Cookie: PHPSESSID=57dee6deabd6e0ae75f7a55421fc2427' \
+  --compressed
+"""
+
+COOKIE_KEY = 'PHPSESSID'
+COOKIE_VALUE = '3232035445fc07851efd717a8f1d687a'
+
+person_id = 2811
+personmineur_id = 2821
+household_id = 376
+notification_id = 126
+parcours_id = 2705
+
+URLS = [
+  'fr/person/new',
+  f'fr/person/{person_id}/general',
+  f'fr/person/{person_id}/residential-address/list',
+  f'fr/person/{person_id}/resources/list',
+  f'fr/activity/?accompanying_period_id={parcours_id}',
+  f'fr/person/{person_id}/document/new',
+  f'fr/person/{person_id}/document',
+  # f'fr/parcours/{parcours_id}/document',
+  f'fr/person/household/{household_id}/summary',
+  f'fr/person/household/{household_id}/addresses',
+  # f'fr/person/household/{household_id}/relationship',
+  'fr/notification/inbox',
+  f'fr/notification/{notification_id}/show',
+  # f'fr/notification/create?entityClass=Chill%5CPersonBundle%5CEntity%5CAccompanyingPeriod&entityId={parcours_id}',
+  f'fr/vendee/vendeeperson/{person_id}/infosociopro/view',
+  f'fr/vendee/vendeeperson/{person_id}/infomedicale/view',
+  f'fr/vendee/vendeepersonmineur/{personmineur_id}/infofamille/view',
+  f'fr/vendee/vendeepersonmineur/{personmineur_id}/scolarite/view'
+]
+
+for u in URLS:
+    url = BASE_URL + u
+    filename = 'img/' + u.replace('/', '_').replace('&', '_').replace('?', '_').replace('=', '_') + '.png'
+    print(f'fetching {url} ...')
+    subprocess.run(f'wkhtmltoimage -q --javascript-delay 3000 --cookie {COOKIE_KEY} {COOKIE_VALUE} "{url}" {filename}', shell=True, check=True)

user/00000-toc.md

@@ -0,0 +1,177 @@
+
+# Qu'est-ce que Chill ?
+
+## A quoi ça sert ?
+
+=~ dossier social électronique
+
+### Objectifs
+
+* consigner les informations;
+* partager avec les collègues;
+* générer des statistiques.
+
+Chill n'est pas un logiciel de statistique. Il est pensé pour être utilisé au quotidien, et générer des statistiques à partir de cette utilisation.
+
+## Comment l'installer
+
+Renvoi à la documentation technique
+
+## Comment l'administrer ?
+
+Renvoi à la documentation administrateur
+
+# Survol des concepts dans Chill
+
+Les trois domaines dans Chill.
+
+Chaque domaine est caractérisé par son bandeau, et son menu.
+
+<!-- ici, c'est un survol. renvoi vers les parties plus détaillées -->
+
+## Fiche usager
+
+## Fiche ménage
+
+## Fiche parcours
+
+# L'interface générale
+
+## Boutons et codes couleurs
+
+<!-- récapitulatif des boutons et codes couleurs -->
+
+* vert: ajouter / créer
+* bleu (oeil): voir
+* etc.
+
+<!-- voir la première page du manuel fait par SB -->
+
+### select2js et multiselect
+
+## Menu section
+
+## Menu utilisateur
+
+# Moteur de recherche
+
+## Recherche directe
+
+Possibilité de recherche par date de naissance, numéro de téléphone, etc.
+
+## Recherche avancée
+
+
+# Fiche usager
+
+## Créer un usager
+
+## Détails de l'usager
+
+## Quelle adresse pour un usager ?
+
+Différence entre les adresses de résidence et les adresses d'un ménage.
+
+## Personnes ressources
+
+## Adresses de résidence
+
+## Historique
+
+## Traiter les doublons
+
+## Autres entrées dans le menu personne
+
+Renvoi vers les partie ad hoc:
+
+* activité
+* rendez-vous
+* documents
+
+# Activités (échanges)
+
+## A quoi ça sert ?
+
+## Activité dans les personnes ou les parcours ?
+
+## Créer et modifier une activité
+
+## Effets de la sélection des problématiques ou des actions sur les parcours
+
+# Documents
+
+## A quoi ça sert ?
+
+## Ajouter un document
+
+## Générer un document
+
+# Rendez-vous
+
+TODO
+
+# Tâches
+
+## Principes des tâches
+
+### Statuts sur les tâches
+
+### Tâches en rappel, tâches arrivées à échéance
+
+## Créer une tâche
+
+# Parcours
+
+## Qu'est-ce qu'un parcours ?
+
+### Les étapes d'un parcours: brouillon, confirmé, etc.
+
+### Problématiques et actions
+
+### Parcours confidentiels
+
+### Parcours réguliers et ponctuels
+
+## Créer un parcours
+
+## Commentaires dans les parcours
+
+## Actions d'accompagnement
+
+### Evaluations et objectifs
+
+## Cloturer un parcours
+
+# Ménages
+
+## Qu'est-ce qu'un ménage ?
+
+### Les positions dans le ménage
+
+<!-- attention, les positions "enfants hors ménage", etc., c'est de la configuration -->
+
+## Ajouter des membres au ménage, quitter un ménage, rejoindre un ménage
+
+## Filiations
+
+## Composition familiale
+
+# Notifications
+
+## Créer une notification
+
+## Discuter dans une notification
+
+# Workflows
+
+## Créer un workflow
+
+## Ajouter une décision à un workflow
+
+## Rejoindre un workflow par un lien d'accès
+
+# Activité annexes
+
+# Choisir une adresse
+
+

user/English/activity.md

@@ -0,0 +1,47 @@
+\newpage
+
+# Activities (exchanges)
+<!-- en/activity/?accompanying_period_id={id} -->
+
+![List of exchanges related to a course](user/img/en_activity__accompanying_period_id_2705.png)
+
+Activities (or exchanges) in Chill are used to record activities or exchanges that have taken place and to link them to users and/or support pathways. By activity, we mean an individual interview, an approach via an external
+partner, a telephone call relating to the person, an e-mail, etc.
+
+The information to be encoded is different according to the type of activity.
+For example, for a telephone call, you can specify the duration of the call, the caller and take a note. For a meeting, you can associate a location (the place where the meeting took place), the parties present at the meeting, notes, documents, etc.
+
+In this way, this information can be centralised and then easily shared between the social workers.
+
+The types of activities and their corresponding fields (location, duration, travel time, documents, presence of the person, users, etc.) can be configured in the administration area.
+
+
+## Activity in persons or trajectories?
+
+The activities can be encoded in the person or in the support path. It is up to you to choose whether to encode activities in the context of a support pathway or in the context of a person. However, as soon as a person is mentioned in an activity, this activity can be found in the list of activities of the person.
+
+Example: In the support path of the user Gabrielle Durant, I create an activity concerning an email where I also mention another user encoded in Chill: Dominique Duchemin. The activity will be visible in Gabrielle Durant's support path, but also in her user file and in Dominique Duchemin's file.
+
+We can therefore access the list of activities of a person via the "user" menu and the list of activities of a support path via the "support path" menu.
+
+## Create and modify an activity
+
+In the list of activities, click on the "Create" button to create a new activity. First choose the type of activity/exchange, then fill in the relevant information. If the activity has been created in a pathway, the social issues and related support actions will be filled in. Depending on the type of activity, you will be able to fill in the parties involved, the date, the location, the duration of the activity, the possible travel time (in case of a trip), documents, the subject, a free note, etc.
+
+The subject is taken from a predefined list, established in the administration area of the software.
+
+Any type of document can be added to an activity: a text document, a pdf, a photo, etc.
+
+The parties involved, users, third parties or users (social worker), are added by searching for people already encoded in Chill or by creating them on the fly. If the activity has been created in a pathway, you can easily add parties involved by clicking on the proposed names. The proposals are based on the parts mentioned in the accompanying course.
+
+::: { .info }
+
+It is possible to transform an appointment into an activity. (TODO)
+
+:::
+
+Users can create a [private comment](./private_comments.md) per activity, which will only be seen by them.
+
+Once an activity has been created, it is always possible to modify it to make corrections or additions.
+
+## Effects of the selection of issues or actions on trajectories

user/English/aside_activities.md

@@ -0,0 +1,33 @@
+/newpage
+
+# Side activities
+
+To allow a user to also keep track of activities that are not directly related to a support trajectory or to a person, there is a side activity section.
+
+A side activity could be a team meeting, a training, but also a phone call or email.
+
+## Listing page
+
+<!-- /fr/asideactivity -->
+
+A user can navigate to his/her list of side activities from within their user menu by clicking on <**My side activities**>. Similar to other sections of the Chill app, you will find here a list that offers a first quick overview of each activity. You can view the activity in more detail, edit, or delete it.
+
+## Creating a side activity
+
+<!-- /fr/asideactivity/new -->
+
+![Creation aside activity](/user/img/new_aside_activity.png)
+
+The form fields of a side activity are self-explanatory. It is important to note however that a user can create a side activity for another user. Multiple users can also be linked, think of a meeting for example.
+
+A side activity can be created for the future, but they can also still be created for activities that already took place. As such it shouldn't be seen as a planning tool, but more to keep record of side activities.
+
+All fields are required, except for any additional note you might want to add.
+
+## Detail page
+
+<!-- /fr/asideactivity/{id}/view -->
+
+Within the detail page the most important thing to note is the option to **duplicate** a side activity. For example, a meeting that is held weekly with more or less the same people can therefore easily be duplicated, while still allowing modifications to be made.
+
+

user/English/bulk_reassign.md

@@ -0,0 +1,13 @@
+# Bulk reassign support trajectories
+
+The need may arise for the support trajectories followed by one user to be reassigned to another user. Example cases could be a user being absent for an extended amount of time, switching functions, etc.
+
+For such situations a functionality has been provided to reassign support trajectories in bulk to another user.
+
+To make use of this functionality the user can click on 'Trajectories per user' in the section menu.
+
+A first select field will be visible. Use this to select the user whose trajectories have to be reassigned. A complete list of the trajectories will be provided.
+
+In a second step the user to whom the trajectories on the current page have to reassigned can be selected. Clicking on the button 'reassign' will complete this action and show the remaining trajectories. The action can be repeated.
+
+Each individual trajectory is displayed with the edit button, allowing it to be individually reassigned within the trajectory edit form. Navigate to the [referrer](./support_trajectory.md#referrer) section to reassign this trajectory. During a bulk reassign this trajectory will no longer be taken into account, as it no longer belongs to the initial user.

user/English/documents.md

@@ -0,0 +1,3 @@
+/newpage
+
+TODO: translate from french

user/English/household.md

@@ -0,0 +1,98 @@
+/newpage
+
+# Households {#sec:household}
+
+## What is a household?
+
+A household is a set of users living 'under the same roof'. This can be members of a family, members of a blended family, members of a foster family, etc.
+<!-- Living "under the same roof" OR living at the same address?  -->
+
+A household is characterised by an address, which corresponds to the home address of its members. This address can change (in case of a move): it is therefore defined between a start date and an end date and there may be a history of household addresses. Similarly, a user may change household and have a history of households.
+
+## Household summary
+
+<!-- /en/person/household/{household_id}/summary -->
+
+![Household Summary](user/img/en_person_household_376_summary.png)
+
+The household summary page is accessed via the "person" menu or by clicking on the household icon in the person search. The household summary page shows the current household address, the household members and the composition of the household.
+
+The household address history can be accessed in the household menu under the heading "Address history". The address history shows all successive household addresses and allows for additions.
+
+<!-- /en/person/household/{household_id}/addresses -->
+
+![Household address history](user/img/en_person_household_376_addresses.png)
+
+A list of the household's trajectories can also be displayed by clicking in the household menu on <**trajectories**>.
+
+
+### Create a household
+
+If there is no household in the list of households for a user, then the software allows you to create a new household. At this stage, you can create a new household or join an existing one. The software will automatically propose possible households by making some suggestions.
+
+#### Which households are suggested?
+
+The software tries to establish links between the persons concerned by the change of household, and other households.
+
+The links made are as follows:
+
+* For each person affected by the change, the software checks whether he or she is present in another support trajectory, with other persons. If these persons are themselves associated with a household, then the software proposes to join that existing household.
+* The software also examines the location of the support trajectories in which the person, concerned by the change, is located. If a support trajectory is located at a reference address, the software looks to see if there are other households living at that address. If it finds any, these households will also be suggested.
+
+At this stage, you can enter an address; this will immediately locate the created household. The software will suggest you to re-use known addresses.
+
+#### Which addresses are suggested?
+
+The software suggests you to re-use the temporary location of the support trajectories associated with the household members.
+
+For each person who is going to "change household", the software examines whether he is currently associated with a trajectory. If this trajectory has a temporary address, then this address will be included in the suggestions.
+
+### Join a household
+
+There are several possible ways of getting a person to join a household:
+
+- when creating a social trajectory for a person who is not in a household, the software suggests that he/she should join a household. The action then positions him/her in a household, whether it is an existing household or one to be created.
+
+- When you are on the household summary page, you can always search for and add a person. To do this, use the "Add a member" button at the bottom of the page.
+
+### Positions in the household
+
+<!-- note that the positions "children outside the household", etc., are configurations -->
+
+Each member of the household is detailed in the "household summary" page. The person can have a certain position in the household: adult or child, as well as being the owner of a household. At any time it is possible to remove a person from a household, or to reposition him/her in the household (e.g. to make him/her the owner).
+
+If necessary, it is also possible to view a former membership, i.e. a person who used to belong to the household but is no longer part of it.
+
+
+## Add members to the household, leave a household, join a household
+
+At the bottom of the household summary page, the <**Add a member**> button allows you to add a user to the household. When clicking on this button, in the following pages, one can:
+
+- add one or more existing persons, or create new ones;
+- position each person in the household, i.e. specify whether he/she is a child or an adult, and possibly qualify him/her as a household member;
+- enter the date when the person joins the household, and possibly a comment;
+- and, finally, save.
+
+In the list of household members, using the buttons on the right, one can
+
+- leave the household: in this case, the person can join another household or leave without joining a household. Again, a change date is encoded.
+- reposition the member: i.e. change the position (adult, child, ...) of the member.
+- fill in the membership: i.e. change the date and the comment of the change
+
+
+## Affiliations
+<!-- /en/person/household/{household_id}/relationship -->
+
+![Affiliations of a houshold](user/img/menage_filiations.png)
+
+The "affiliations" page provides an overview in graph form of the affiliations within a household, i.e. the relationships between its members. This page allows not only to view the relationships but also to edit them. By clicking on <**Create a relationship**>, then selecting 2 persons, it is possible to define the relationship between these 2 persons: mother/father-daughter/son, brother/sister-brother/sister, uncle/aunt-nephew/niece.
+
+In addition, the graph also shows the support trajectories associated with each household member. By displaying the trajectory, persons who may be linked to these trajectories, but belong to other households can be displayed. The elements of the graph can be moved by clicking and dragging. Finally, the graph can be exported as an image.
+
+In short, this page summarises a household and its relationships in an easy-to-understand diagram.
+
+## Family composition
+
+The family composition is a qualification of the household as a household type, e.g. couple with children, couple without children, single mother, single woman, etc. This composition is valid until a certain date and with a maximum of one year.
+
+As with the addresses of a household, it is possible to view the history of the composition of a household.

user/English/metadata.yaml

@@ -0,0 +1,9 @@
+---
+title: Chill user manual
+lang: en-EN
+toc: true
+
+
+header-includes: |
+    \usepackage{awesomebox}
+...

user/English/notifications.md

@@ -0,0 +1,38 @@
+\newpage
+
+# Notifications
+<!-- en/notification/inbox -->
+
+![Notification inbox](user/img/en_notification_inbox.png)
+
+Notifications are messages sent by one user to one or more others. The purpose of notifications is to quickly exchange information about ongoing social cases between social workers. For example, notifications can be used to inform a caseworker about a case.
+
+They can be accessed either from the Chill homepage, under the "My notifications" tab, or anywhere in the application via the "user" menu at the top right of the screen. Depending on the configuration chosen by the software administrators, notifications are also sent by email to the social worker concerned.
+
+## Create a notification
+<!-- en/notification/create?entityClass=Chill%5CPersonBundle%5CEntity%5CAccompanyingPeriod&entityId=2705-->
+
+![Create a notification](user/img/notification_parcours.png)
+
+Notifications can be sent from several places in the software. A notification consists of a subject (such as an email), one or more recipients, a message and the information from which the notification is sent. For example, when sending a notification as part of a course, the general course information is also copied.
+
+It is possible to send a notification:
+
+- from the summary page of a support trajectory
+- from an activity/exchange
+
+Notifications sent, for example, from a support trajectory, are listed in the trajectory summary.
+
+<TODO: Are there any other places where notifications are used?  -->
+
+In addition, there are notifications that are automatically sent when certain actions are taken.
+
+
+## Discuss in a notification
+<!-- en/notification/{notification_id}/show -->
+
+![Discussion in a notification](user/img/en_notification_126_show.png)
+
+When a notification is received, it is possible to start a discussion with the recipient in the notification page. This allows messages to be left between workers, as in an online chat system.
+
+In the list of notifications, when you click on a notification, you can unfold the content of the notification and access the discussion with the "View associated comment thread" icon.

user/English/person.md

@@ -0,0 +1,98 @@
+\newpage
+
+# Person file {#sec:person}
+
+The person file contains all the information specific to the person: surname, first name, contact information, addresses, etc. It is the basis of the person's electronic social file.
+
+It can be accessed by searching for a person on the homepage or in the toolbar. It can also be accessed from other pages by clicking on a person's name and then clicking on "Open person file".
+
+<!-- TODO a déplacer vers une autre section, sur le concept de l'usager?  -->
+A person can be part of one or more households. For each person, it is possible to define support trajectories. Finally, each person is linked to exchanges in which the person is involved.
+
+## Create a person
+<!-- fr/person/new -->
+
+![Create a person](user/img/fr_person_new.png)
+
+To add a person, click on "Sections" > "Add a person", in the top toolbar.
+
+In the creation page, enter the requested information. Only the surname, first name(s) and gender are mandatory. Then click on "Create person". You can then choose between simply creating the person, creating the person and associating him/her with a household or creating the person and creating an associated support trajectory.
+
+::: { .info }
+
+Please note that there is a standard format for entering telephone numbers. Enter your numbers without spaces, "/" bars or "-" dashes.
+<!-- TODO d'autres contraintes sur les numéros de tel?  -->
+:::
+
+## Person detail page
+<!-- fr/person/{id}/general -->
+
+![Person detail page](user/img/fr_person_2811_general.png)
+
+The person record contains all the detailed information of the person, namely:
+
+- surname, first name(s), gender;
+- nationality, languages spoken, number of children, marital status
+- date and place of birth;
+- contact information.
+
+This information can be filled in as you go along, or left blank. At the bottom of the page, the "Edit" button allows you to edit this information. Remarks can also be added.
+
+Some of this information is recalled in the person's banner and in other places in the software when the person's name is clicked on.
+
+## Person addresses
+
+Chill supports two types of addresses:
+
+* home addresses, which are the permanent, official addresses of a person (home address);
+* residence addresses, which are temporary addresses of a person, at which he/she resides only for a certain period of time, and which is not intended to be official.
+
+Therefore, the official address is not attached directly to a person, but to his or her household. Only residential addresses can be entered in the person's file.
+
+## Home address
+<!-- /fr/person/{id}/residential-address/list -->
+
+![Person home address](user/img/fr_person_2811_residential-address_list.png)
+
+Each person can have one or more home addresses. These are accessed by clicking on "Home addresses" in the right-hand menu.
+
+These addresses are not supposed to be official home addresses, declared to the authorities. They are, for example, a temporary residence in a nursing home, accommodation with an acquaintance or friend for a specific period of time, etc.
+
+When adding a residence address, there is a choice between
+
+- taking an address from another person (from another person);
+- taking an address from a third party;
+- create a new address [address](#sec:choose-an-address).
+
+## Resource persons
+<!-- /fr/person/{id}/resources/list -->
+
+![resource persons](user/img/fr_person_2811_resources_list.png)
+
+Resource persons are other persons or third parties associated with the person's file. A contact person may be a friend or neighbour (another person), a health professional (a third party), etc. Other members of the person's household should be entered in the "household" section instead. If the contact person is not encoded, he/she can also be added as a free description.
+
+
+<!-- ## Historique
+<!-- /fr/person/{id}/timeline
+
+TODO -->
+
+## Treating doubles
+<!-- /fr/person/{id}/duplicate/view -->
+
+It is possible that a person has been encoded more than once. The "Dealing with duplicates" page allows you to identify and deal with possible duplicates of a person. The page lists persons with similar names and suggests merging them.
+
+::: { .info }
+
+This page is used to process duplicates, but Chill also automatically detects potential duplicates when encoding a new person.
+
+:::
+## Other person menu entries
+
+There are several entries in the person menu that link to other parts of the software, keeping the link to the person. These entries are:
+
+* Support trajectories: list of the trajectories in which the person is involved;
+* Activities (or exchanges): list of activities in which the person is involved;
+* Documents: list of documents in which the person is involved;
+* Tasks: list of tasks in which the person is involved;
+* Households: management of the person's household.

user/English/private_comments.md

@@ -0,0 +1,7 @@
+## Private comments
+
+Private comments can be created for [activities](./activity.md#create-and-modify-an-activity), [social actions](./social_actions.md#private-comment) and appointments.
+
+Each user can post one private comment per item (eg. per activity). This comment can of course be edited within the edit forms of the concerning item.
+
+Naturally, users can only see their own private comments and not those of other users.

user/English/search.md

@@ -0,0 +1,10 @@
+\newpage
+
+# Recherche
+
+
+In the top banner, there is a person search bar. You can search for persons by surname and first name, the search engine being tolerant of different spellings. For example, if you search for "Mathieu", you will also find first names corresponding to "Matthieu".
+
+If you have not found the person, you can click on the "Advanced search" button. In the advanced search page, you can search on the basis of date of birth, a fragment of telephone number, etc.
+
+![Advanced search for a person](user/img/advanced_search.png)

user/English/social_actions.md

@@ -0,0 +1,75 @@
+/newpage
+
+# Social support actions
+
+Social support actions are actions taken within a trajectory and concerning a certain social issue.
+
+Social support actions are easily recognizable throughout the application by the orange title banner.
+
+__note__: Social actions can only be created for **confirmed** trajectories.
+## Listing page
+
+<!-- /fr/person/accompanying-period/{id}/work -->
+
+![social_action](/user/img/action_accompagnement.png)
+
+Similar to many other sections within the Chill application, a list of social support actions can be found by clicking on <**social support actions**> in the yellow side-menu of a trajectory.
+
+A concise overview of important information is given for each action in the list.
+
+So long a trajectory is in the **confirmed** state each action can be modified, deleted or a [workflow](/user/English/workflow.md) can be created.
+## Creating a social support action
+
+<!-- /fr/person/accompanying-period/{id}/work/new -->
+
+To create a social support action a user will be guided through several steps,
+
+1. Pick one social issue. If the concerning social issue is not amongst the provided choices the user can add it by selecting it from the dropdown menu.
+2. Pick a social action. All actions displayed are linked to the previously selected social issue.
+3. One or more concerning persons can be selected.
+4. Specify a start date.
+5. Specify an ending date (optional).
+
+## Modifying a social support action
+
+Once a social support action has been created it is not considered to be a static recording. The modification form allows for much more information to be added in later stages so as to make it a 'working document'.
+
+### Comment
+
+Here the user is free to give whatever extra information necessary.
+
+### Private comment
+
+Users can create a [private comment](./private_comments.md) per social action, which will only be seen by them.
+
+### Motives and goals
+
+Social support actions are never random. They are taken with certain motives or to attain a certain goal.
+By clicking on a badge (+) within the dropdown menu of this section, the user can add the motive or goal of the action. By clicking on it again (-) it can be removed.
+
+Multiple goals can be selected.
+
+### Results or outcome
+
+Once a motive or goal is identified it is also possible to specify a result or outcome of the action concerning this specific goal. Similarly they can be selected from a dropdown menu and removed again.
+Multiple outcomes can be selected.
+
+### Evaluations, forms or correspondence
+
+Multiple evaluations or forms can be added to a social support action. It is specified which evaluation can be started and clicking on the badge (+) will open a form for the user to fill in.
+
+The form allows a starting date, due date and ending date to be set, as well as a reminder. An extra comment box can be used to give more details and a [document](/user/English/documents.md) can be generated or uploaded.
+
+### Concerned persons
+
+Concerned persons within the trajectory are listed here and the user can select who was involved in this specific social support action.
+
+### Treating thirdparties
+
+If an external partner executed the social action, they can be identified here.
+Think of them as the main actor.
+
+### Intervening thirdparties
+
+These are external partners that participate(d) in the social action, but are not the main actors.
+

user/English/support_trajectory.md

@@ -0,0 +1,195 @@
+/newpage
+
+# Social support trajectory
+
+Providing meaningful social support is often an intricate combination of goals, actions, involved actors, documents, etc... With its social support module, Chill aims to give it's users a tool which they can keep track of trajectories.
+
+You can look at it as the third big module within the application. Like the person and household modules it can be easily identified by the banner at the top of the screen.
+
+![Trajectory banner](/user/img/banner_course.png)
+
+## Trajectory overview
+
+![Trajectory dashboard](/user/img/parcours_dashboard.png)
+
+<!-- /fr/parcours/{id} -->
+
+The overview page assembles the most important information and latest activity within a trajectory, allowing you to take certain quick actions like clicking on associated person badges, linked activities or social actions, sending a new notification, etc...
+
+In short it is the trajectory dashboard from where you can navigate to specific sections.
+
+## Creation of a social support trajectory
+
+<!-- /fr/parcours/{id}/edit -->
+
+A new trajectory can be created from the section menu. Doing so will direct you to a blank trajectory form for you to fill-out.
+
+> Sections > Create a new trajectory
+
+
+A trajectory can also be created from within a person file and will immediately link it to this person. You will see the person added in the first section **concerned persons**
+> Yellow person menu > Trajectories > Create a trajectory button
+
+### Different states of a trajectory
+
+It is important to distinguish three main states for a trajectory. A badge can be found in the top right corner of the banner or list-item to identify this state.
+
+* **DRAFT**: the trajectory form has missing information and can therefore not be confirmed (badge color: gray) *
+* **CONFIRMED**: all required information has been provided and further actions, activities,... can be added (badge color: dark blue).
+* **CLOSED**: the social support trajectory has come to closure, the reason can be defined (badge color: red).
+
+Within your user menu you will find a menu entry to direct you to,
+
+* a listing page of **all** the trajectories to which you are the referrer.
+* a listing page of all your **DRAFT** trajectories (ones you created, but have not yet confirmed).
+
+While the above three are considered the main states, there are additional properties that distinguish the state of a trajectory. They are the following,
+
+* **Confidential**: A confidential trajectory can only be viewed by the referrer. Other users will not have access to it's information.
+* **Intensity**: TODO The intensity can be set to *regular* or *punctual*
+* **Emergency**: This state can be toggled when urgent actions are required within this trajectory.
+
+### Required information
+
+The information required to **confirm** a trajectory is the following:
+
+* It is linked to at least one [concerned person](#concerned-person).
+* It has at least one linked [social issue](#social-issue).
+* It is assigned to at least one [service](#service).
+* It has to be [localised](#trajectory-localisation).
+
+![Confirm trajectory](/user/img/parcours_confirm.png)
+
+All of these requirements are listed at the bottom of the form when you have failed to fulfill them. This serves as a reminder to what you should do in order to confirm the trajectory.
+
+### Concerned person
+
+![Concerned persons](/user/img/concerned_persons.png)
+
+A trajectory can be put started to provide support to multiple persons (eg. support is given to a mother and her two children).
+
+### Trajectory localisation
+
+![Localisation](/user/img/parcours_localisation.png)
+
+Every trajectory **has** to be localised and this can be done in one of two ways.
+
+1. You can indicate a temporary address by clicking the designated button. The address will not automatically be adapted when a concerned person moves. Therefore a message is displayed to remind you as a user that the second option, here listed, is preferable.
+
+2. You can link it to a concerned person's **home address** by clicking the map-marker icon in the concerned persons section. If the person moves it will also be automatically adapted within the trajectory.
+
+__Note__: While a trajectory is linked to a concerned person's address...
+* it is not possible to dissociate this person from the trajectory.
+* the person cannot be moved from a household without indicating another address.
+
+
+#### Why localize a trajectory ?
+
+Localising a trajectory allows for the following:
+
+* The automatic assignment of a referrer.
+* Inclusion in the list of trajectories to be discussed within meetings held by concerning services.
+* The generation of localised statistics.
+* The management of access rights.
+
+#### Locate the trajectory with a concerned person
+
+If a concerned person has an address, it is possible to locate the trajectory with this person.
+
+When a trajectory is located with a person:
+
+* the trajectory "follows" the person's address when he moves;
+* it is not possible to dissociate the concerned person from the trajectory;
+
+In addition,
+
+* the person cannot leave the trajectory as long as the trajectory is located near him/her
+* the person cannot leave the household without leaving an address, as long as he/she is located with at least one trajectory.
+
+#### Temporary location
+
+A temporary address may be assigned to a trajectory.
+
+In this case, this location is associated with the route, and will not be automatically changed if a person moves. To avoid this situation, a warning message reminds persons that it is preferable to indicate a real location for the trajectory.
+
+### Origin of the application for support
+
+Within this section you will find a pre-defined list of possible origins (eg. the application was done by telephone)
+
+### Administrative location
+
+The administrative location is the place where the trajectory is processed. This is useful for organisations with several different locations.
+
+### The applicant
+
+This can be an already existing person/thirdparty or a new applicant can be created from within the search modal. Click on the button <**create 'your-search-name'**> to do so.
+
+### Social issue
+
+Using the dropdown menu multiple social issues can be identified. Link at least one to be able to confirm the trajectory.
+
+### Services
+
+Identify at least one service that is concerned with this trajectory. Multiple services can be selected. This will have an impact on who has the right to access the trajectory files.
+
+### Referrer
+
+The referrer is the colleague to whom you can refer yourself concerning this trajectory. They are responsible for the follow-up and they have specific rights linked to the state of the trajectory.
+* They can mark it as confidential.
+* They can mark it as urgent.
+* They can change the intensity.
+
+__Note__: These three states cannot be modified if a trajectory does not have a referrer assigned.
+Likewise a referrer cannot be removed from a confidential trajectory.
+
+### External partners
+
+A trajectory is setup to provide support to one or more concerned persons. Naturally, there may also be one or more thirdparties or persons involved to offer this support. These partners can be added in this section by searching for their name.
+When a partner does not yet exist they can be created from within the search modal by pressing the button **<create 'your-search-name'>**.
+
+<!-- ## Trajectory history
+
+<!-- /fr/parcours/{id}/history
+TODO -->
+
+## Social support actions
+
+<!-- /fr/person/accompanying-period/{id}/work -->
+
+When a trajectory is confirmed (i.e., it is in the state "Confirmed"), it is possible to add social actions to this trajectory. These are the actions that are taken to realize the support. Please read the documentation about [social actions](/user/English/social_actions.md) for in detail information.
+
+## Comments
+
+<!-- /fr/parcours/{id}/comments -->
+
+Comments can be added to a trajectory to notify co-workers of additional information for which there may not be a designated section. A comment can be **pinned** to the trajectory dashboard by clicking on the flag icon.
+
+__note__: Only one comment can be pinned to the dashboard, but all comments will remain available within the comment section to view,modify, re-pin, or delete.
+
+## Tasks
+
+<!-- /fr/task/single-task/by-course/{id} -->
+
+Just as within the person module, tasks can be created and assigned within a trajectory. Please read the documentation about [tasks](/user/English/tasks.md) for in detail information.
+
+## Documents
+
+<!-- /fr/parcours/{id}/documents -->
+
+Just as within the person module, documents can be attached to a trajectory. The only difference here is that a trajectory document can also be generated from a template. This template can be selected from the dropdown menu.
+
+Please read the documentation about [documents](/user/English/documents.md) for in detail information.
+
+## Close a trajectory
+
+<!-- /fr/parcours/{id}/close -->
+
+At any time a trajectory can be closed by clicking on the sidebar menu entry **<close trajectory'>**.
+
+You will be taken to a small form in which you can specify the date of closure and the reason.
+
+## Re-open a trajectory
+
+When a trajectory is closed the menu will adapt itself to offer the user the possibility to re-open it. No further actions are required after clicking this button.
+
+

user/English/tasks.md

@@ -0,0 +1,43 @@
+/newpage
+
+# Tasks
+
+## Listing page
+
+<!-- /fr/task/single-task/by-course/{id} -->
+
+Clicking on the <**task**> menu entry in the person or trajectory side-menu will bring you to the listing page.
+
+Here you have an overview of all tasks related to this particular person or trajectory.
+
+At the top of the list you find a searchbar and several filtering options,
+
+* Future tasks or tasks without due date
+* Tasks that are almost due
+* Tasks with a passed due date
+* New tasks
+* Tasks that are in progress
+* Closed tasks
+* Removed tasks
+
+Listed tasks are displayed with their title, a badge identifying the state in which the task can be found (new, in progress, closed,...) and their starting date, date on which a reminder will be sent and their due date. Your task reminders can be found on the homepage widget, or displayed in your user menu.
+
+A separate user menu entry will take you directly to a listing page of all your tasks that have surpassed their due date and have not been closed. This menu entry is easily identifiable by the exclamation mark triangle (!).
+
+## Creating a new task
+
+<!-- /fr/task/single-task/new -->
+
+![Creation task](/user/img/new_task.png)
+
+To create a new task you will be given a form to fill in.
+The fields are self-explanatory but do note that only the title is required.
+
+## Detail page
+
+<!-- /fr/task/single-task/{id}/show -->
+
+You can view the task in more detail by clicking on the **eye** icon button. On the detail page you will see the description of the task, but also the task history. The history gives you an overview of state changes and who undertook them on which day. This allows users to easily keep track of tasks.
+
+Within the detail page, as well as in the listing page you have the ability to navigate to an edit page where you can modify the task. A task can also be deleted and it's current state can be changed using the dropdown button <**change state**>.
+

user/English/thirdparty.md

@@ -0,0 +1,59 @@
+/newpage
+# Thirdparty
+
+Within the context of social support you will most likely work together with plenty of professional external partners.  
+Chill allows you to easily link them to a user and their social support trajectory, giving you a complete overview of each partner involved.  
+  
+All thirdparty information can be consulted by going to the section menu in the top-right corner and selecting **thirdparties**.  
+  
+At the top of the list a searchbar allows you to easily find the thirdparty you are looking for on the basis of their name.
+
+## Create a thirdparty
+
+At the bottom of the page you will find the button to create a new thirdparty.
+In doing so you will see a distinction being made between creating a thirdparty as a **legal entity** or a **natural person**.
+
+Choose 'legal entity' if you want to add a thirdparty that is, for example, a doctor's practice or an organization.
+A 'natural person' would be any professional person that you would like to add as a thirdparty, eg. a psychologist.
+
+It is important to note that within a **legal entity** you can add **contacts**.
+These are most likely individual professionals working within the organization or associated with it.
+
+----------
+
+### Legal entity
+
+![Legal entity](/user/img/thirdparty_morale.png)
+
+Creating a **legal entity** takes you to a form which you can complete with the following information.
+
+* **Name**
+* **Acronym** (eg. CPAS)
+* **Service/department**: you can target a specific department or service within the larger entity (eg. elderly support).
+* **Contact information** (phonenumber, email)
+* **Address**:
+    Aside from adding a complete address there are two options to take into account.
+    > **Incomplete address**: In choosing to enter an incomplete address you will only specify a general location (town or city).
+
+    > **Confidential**: The address can be identified as confidential. (eg. the address of a safehouse should not be readily viewable. It will be blurred in overview pages and you will have the option to reveal it.)
+
+* **Contacts**: Contacts are natural persons associated with the legal entity. You can specify their title and role within the entity and add their contact information. As with the address above there is an option to make it a confidential contact. Their information will thus be blurred throughout the application and can be revealed when needed. Each contact can be deleted individually and these changes will be saved when saving the entire entity.
+
+![Thirdparty contact](/user/img/thirdparty_contact.png)
+
+* **Comment**
+* **Active/inactive**: a thirdparty can be set to inactive (eg. they are no longer operational).
+
+---------
+### Natural person
+
+A natural person is a thirdparty that stands on it's own. Although a thirdparty contact is in fact also a natural person, they are two distinct entities in Chill.   
+Within the form the following can be specified,
+
+* **Civil title** (eg. Mrs., Mayor, ...)
+* **Name**
+* **Professional role** (eg. secretary, nurse)
+* **Support category**: the category under which their services fall.
+* **Contact information**: phonenumer, email, address. Contact information can be identified as confidential.
+* **Comment**
+* **Active/Inactive**

user/English/workflow.md

@@ -0,0 +1,3 @@
+/newpage
+
+TODO translate from french

user/_a-classer.md

@@ -0,0 +1,11 @@
+
+## Fonctionnement du moteur de recherche des tiers:
+
+Le moteur de recherche des tiers dans "add person" permet d'effectuer des recherches sur les noms des tiers, les acronymes, et leur service. Il classe également les plus pertinent, en tenant compte éventuellement du nom de la localité du tiers, s'il possède une adresse.
+
+Le moteur sélectionne d'abord les tiers sur base du nom, de l'acronyme ou du nom du service. Lorsqu'une recherche comporte plusieurs mots (séparés par un ou plusieurs espaces), il sélectionne les tiers dont le nom, l'acronyme ou le nom du service contient un de ces mots seulement.
+
+Le moteur affiche les résultats les plus pertinents en premier. Il classe en premier les tiers dont le mot recherché correspond à un des mots du nom, de l'acronyme, ou du nom du service, **ou de la localité du tiers**. Cela permet donc de présenter en premier les tiers dans une localité particulière.
+
+Ainsi, si une recherche est effectuée avec les termes `ADMR roche`, tous les résultats dont l'acronyme est ADMR sont renvoyés. Cependant, les tiers dont la localité est La-Roche-Sur-Yon seront considérés plus pertinents (ils disposeront de deux mots qui correspondent (`admr` et `roche`) plutôt qu'un seul); ils seront donc présentés en premier.
+

user/activite.md

@@ -0,0 +1,45 @@
+\newpage
+
+# Activités (échanges)
+<!-- fr/activity/?accompanying_period_id={id} -->
+
+![Liste des échanges liés à un parcours](./img/fr_activity__accompanying_period_id_2705.png)
+
+Les activités (ou échanges) dans Chill servent à consigner des activités ou des échanges ayant eu lieu et de les associer à des usagers et/ou à des parcours d'accompagnement. Par activité, nous entendons un entretien individuel, une démarche via un
+partenaire extérieur, un appel téléphonique relatif à la personne, un courriel, etc.
+
+Les informations à saisir sont différentes selon le type d'activité. Par exemple, pour un appel téléphonique, on peut spécifier
+la durée de l'appel, l'interlocuteur et prendre une note. Pour une réunion, on peut y associer une localisation (l'endroit où a eu lieu la réunion), les parties présentes à la réunion, des notes, des documents, etc.
+
+Ainsi centralisées, ces informations peuvent ensuite être facilement partagées entre les travailleurs sociaux.
+
+Les types d'activités et leurs champs correspondants (localisation, durée, durée du trajet, documents, présence de la personne, usagers, etc.) sont configurables dans l'espace d'administration.
+
+
+## Activité dans les personnes ou les parcours ?
+
+Les activités peuvent être enregistrées à la personne ou bien au parcours d'accompagnement. C'est à vous de choisir de saisir des activités dans le cadre d'un parcours d'accompagnement, ou bien dans le cadre d'une personne. Toutefois, dès lors qu'une personne est mentionnée dans une activité, on pourra retrouver cette activité dans la liste des activités de la personne.
+
+Exemple: Dans le parcours d'accompagnement de l'usager Gabrielle Durant, je crée une activité concernant un courriel où je mentionne également un autre usager enregistré dans Chill: Dominique Duchemin. L'activité sera visible dans le parcours d'accompagnement de Gabrielle Durant, mais aussi dans sa fiche usager et dans celle de Dominique Duchemin.
+
+On peut donc accéder à la liste des activités d'une personne via le menu "usager" et à la liste des activités d'un parcours d'accompagnement via le menu "parcours d'accompagnement".
+
+## Créer et modifier une activité
+
+Dans la liste des activités, cliquer sur le bouton "Créer" pour créer une nouvelle activité. Choisissez d'abord le type d'activité/échange, puis remplissez les informations utiles. Si l'activité a été créée dans un parcours, on y renseignera les problématiques sociales et les actions d'accompagnement liées. Selon le type d'activité, vous pourrez renseigner les parties concernées, la date, la localisation, la durée de l'activité, la durée éventuelle de trajet (dans le cas d'un déplacement), des documents, le sujet, une note libre, etc.
+
+Le sujet est pris dans une liste prédéfinie, établie dans l'espace d'administration du logiciel.
+
+Tout type de document peut être ajouté dans une activité: un document texte, un pdf, une photo, etc.
+
+Les parties concernées, usagers, tiers ou utilisateurs (travailleur social), sont ajoutés en recherchant les personnes déjà enregistrées dans Chill ou en les créant à la volée. Si l'activité a été créée dans un parcours, vous pouvez facilement ajouter des parties concernées en cliquant sur les propositions de noms. Les propositions se font sur base des parties mentionnées dans le parcours d'accompagnement.
+
+<!-- ::: { .info }
+
+Il est possible de transformer un rdv en activité. (TODO)
+
+::: -->
+
+Lorsqu'une activité a été créée, il est toujours possible de la modifier pour y faire des corrections ou des ajouts.
+<!--
+## Effets de la sélection des problématiques ou des actions sur les parcours -->

user/aside_activities.md

@@ -0,0 +1,31 @@
+/newpage
+
+# Activités annexes
+
+Pour permettre à l'utilisateur de gérer les activités qui ne sont pas directement liées à un parcours d'accompagnement ou à un usager, il existe une section d'activités annexes.
+
+Une activité annexe peut être une réunion d'équipe, une formation, mais aussi un appel téléphonique ou un courriel.
+
+## Page d'inscription
+
+<!-- /fr/asideactivity -->
+
+Un utilisateur peut naviguer vers sa liste d'activités annexes à partir du menu utilisateur en cliquant sur **Mes activités annexes**. Comme pour les autres sections du logiciel, vous trouverez ici une liste qui offre un premier aperçu rapide de chaque activité annexe. Vous pouvez voir l'activité plus en détail, la modifier ou la supprimer.
+
+
+## Créer une activité annexe
+
+<!-- /fr/asideactivity/new -->
+
+Les champs du formulaire d'une activité annexe sont auto-explicatifs. Il est important de noter cependant qu'un utilisateur peut créer une activité annexe pour un autre utilisateur. 
+
+Une activité annexe peut être créée à une date future ou passée. En tant que tel, il ne faut pas le considérer comme un outil de planification, mais plutôt comme un outil d'enregistrement des activités.
+
+Tous les champs sont obligatoires, à l'exception du champ commentaire.
+
+## Page de visualisation
+
+<!-- /fr/asideactivity/{id}/view -->
+
+Dans la page de détail, la chose la plus importante à noter est l'option de **duplication** d'une activité annexe. Par exemple, une réunion qui se tient chaque semaine avec plus ou moins les mêmes personnes peut facilement être dupliquée, tout en permettant d'y apporter des modifications.
+

user/choisir_une_adresse.md

@@ -0,0 +1,30 @@
+\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/concept.md

@@ -0,0 +1,36 @@
+\newpage
+
+# Survol des concepts dans Chill {#sec:concept}
+
+Chill est un logiciel conçu spécialement pour l'accompagnement social. Il est mis en œuvre dans des contextes institutionnel différents mais repose sur un socle de concepts qui peuvent être utilisés dans plusieurs environnements où évoluent des travailleur·euses sociaux.
+
+Les trois concepts de base du logiciel sont:
+
+- l'**usager**: la personne bénéficiaire de l'accompagnement social. L'usager est au centre du logiciel: sur la page d'accueil, il y a une recherche par nom parmi les usagers enregistrés dans le logiciel. La "fiche usager" (voir [la section "usager"](#sec:person)) résume toutes les informations propre à la personne (date de naissance, information de contact, etc.).
+
+- le **parcours d'accompagnement**: le dossier qui accompagne un ou plusieurs usagers. Un [parcours](#sec:parcours) a une date de début et peut être clôturé à une date de fin. Un référent du parcours peut être désigné. Chaque parcours est associé à une ou plusieurs problématiques sociales. Lors du parcours, des **actions d'accompagnements** sont créées et suivies.
+
+- le **ménage**: le ménage dont fait partie l'usager. Comme l'accompagnement social peut se faire aussi à l'échelle d'un ménage plutôt qu'individuellement, la [page du ménage](#sec:household) rassemble les informations pour les usagers d'un même ménage.
+
+
+Les pages du logiciel se divisent entre ces trois domaines, chaque domaine étant caractérisé par un bandeau avec une couleur particulière ainsi que son menu.
+
+L'utilisateur peut passer d'un domaine à l'autre, par exemple en ouvrant la fiche d'un usager depuis un parcours ou un ménage. On peut passer du domaine usager vers le domaine ménage en cliquant sur l'icône symbolisant une maison à droite de l'adresse d'un usager, et repasser vers le domaine usager en cliquant sur le nom d'un des usagers du ménage. Plusieurs sections sont aussi accessibles via plusieurs domaines, comme les activités/échanges ou les tâches, accessibles dans le domaine "usager" et "parcours d'accompagnement".
+
+![Les 3 bandeaux dans Chill](./img/banner_all.png)
+
+Au-dessus des bandeaux se trouve la barre d'outil principale, qu'on retrouve dans chaque page du logiciel.
+
+## Autres entités
+
+D'autres entités sont manipulées dans Chill:
+
+* Les travailleurs sociaux inscrivent leurs rencontres, réunions, appels téléphoniques au sein des **échanges**;
+* Des **documents** peuvent être associés à chaque utilisateur, ou à chaque parcours. Ces documents peuvent être:
+
+    * générés à partir des informations du logiciel (à partir de "gabarits" définis par les administrateurs fonctionnels);
+    * déposés dans le dossier depuis des ressources externes
+* Chill dispose d'un véritable carnet de contact, les **tiers** qui peuvent être associés à différentes entités dans le parcours et le dossier de l'usager;
+* Chill peut enregistrer des **tâches**;
+* Les utilisateurs peuvent s'envoyer des **notifications**;
+* Un suivi des décisions (**Workflow**) peut être activé au sein du logiciel.

user/document.md

@@ -0,0 +1,23 @@
+\newpage
+
+# Documents {#sec:documents}
+
+Un dossier social comporte souvent un certain nombre de documents, propre au travail social effectué, qui peuvent être stockés dans Chill. Il peut s'agir d'attestations administratives, de documents juridiques, etc, que ce soit sous forme de document électronique (par exemple au format pdf) ou bien un document en papier qui a été numérisé. Par ailleurs, le logiciel permet aussi de générer ses propres documents à partir de modèles pré-établis.
+
+Tout comme les activités/échanges, les documents peuvent être enregistré à la personne ou bien au parcours d'accompagnement. L'accès aux documents enregistrés se fait par l'entrée "Documents" via le menu "usager" ou via le menu "parcours d'accompagnement". Les documents enregistrés sont téléchargeables: on peut les retrouver à tout moment par cette liste de documents.
+
+![Liste des documents](./img/fr_person_2811_document.png)
+
+## Ajouter un document
+
+![Ajouter un document](./img/fr_person_2811_document_new.png)
+
+Pour ajouter un document, dans la liste des documents, cliquer sur le bouton "Créer un nouveau document". Il est demandé de rentrer un titre, une date (par défaut la date de jour), une catégorie de document et une courte description. Ensuite, le document (un document au format pdf, un document de traitement de texte, ...) peut être glissé-déposé ou retrouvé sur un ordinateur en cliquant dans la zone de téléversement.
+
+## Générer un document
+
+![Générer un document dans un parcours](./img/generer_document_parcours.png)
+
+Il est possible de générer ses propres documents à partir de modèles pré-établis et des données saisies dans chaque dossier social, que ce soit un dossier d'un usager ou d'un parcours. Les modèles sont des fichiers "templates" qui sont préparés par les administrateurs du logiciel et qui sont généralement propres à une organisation.
+
+Par exemple, un document peut être généré à partir d'un modèle où toutes les informations d'un parcours d'accompagnement seront pré-remplies (personnes concernées et leur coordonnées, travailleurs et services impliqués, etc.)

user/homepage.md

@@ -0,0 +1,7 @@
+
+```{=latex}
+\includepdf[pages=-]{cover-user.pdf}
+
+\newpage
+
+```

user/interface.md

@@ -0,0 +1,30 @@
+\newpage
+
+# L'interface générale {#sec:interface}
+
+## Une page du logiciel
+
+[Comme expliqué auparavant](#sec:concept), le logiciel est organisé en trois domaines principaux: usager, parcours d'accompagnement et ménage. Voyons une page du logiciel en détail dans la figure suivante.
+
+![Une page de Chill](./img/a_chill_page.png)
+
+
+De haut en bas, il y a:
+
+- un premier bandeau bleu foncé;
+- deux bandeaux propre au domaine "parcours d'accompagnement";
+- le contenu de la page à gauche, ici un résumé du parcours d'accompagnement;
+- un menu en jaune, propre au domaine "parcours d'accompagnement".
+
+Dans le premier bandeau, il y a:
+
+- le champ de recherche: ce champ permet de chercher des usagers, et d'aller vers leurs fiches usagers
+- un **menu section**: ce menu, constamment accessible, permet de faire des actions transversales, c'est-à-dire qui ne sont pas directement liées à un usager, un parcours ou un ménage. Par exemple, ce menu permet d'ajouter un nouvel usager ou un parcours, d'ajouter une activité annexe, de gérer la liste des tiers, de réaliser des exports, etc.
+- un **menu utilisateur**: ce menu, où est rappelé le nom de l'utilisateur connecté, permet d'accéder aux dossiers propres à l'utilisateur: ses parcours, ses tâches, rendez-vous, activités annexes, notifications, etc. En outre, une pastille avec un chiffre indique le nombre de notifications et tâches en attente pour lesquelles une action est requise.
+
+## Boutons et codes couleurs
+
+Les mêmes boutons sont utilisés au travers du logiciel. La figure suivante indique la signification de tous les boutons utilisés dans le logiciel.
+
+
+![Les boutons utilisés dans Chill](./img/chill_buttons.png)

user/intro.md

@@ -0,0 +1,37 @@
+\newpage
+
+# Qu'est-ce que Chill?
+
+## A quoi ça sert ?
+
+Chill est un logiciel libre d'accompagnement social. Le logiciel peut être résumé par un système de « dossier social électronique ».
+
+Chill est une application web : on y accède via un navigateur. Le navigateur recommandé est Firefox : il est libre et gratuit et on y accède sur toutes les plates-formes (Windows, Mac, Linux, tablettes android, …). Le logiciel doit être installé sur un serveur, et peut donc être disponible via le réseau local ou internet.
+
+## Le but du logiciel
+
+Chill vise trois buts :
+
+* partager les informations relatives à l'accompagnement social entre collègues ;
+* centraliser, en un seul lieu, les informations relatives aux personnes accompagnées ;
+* alléger la charge administrative des travailleurs sociaux en fournissant automatiquement des statistiques relatives à leur activité.
+
+Les concepteurs de Chill ont remarqué qu'il est essentiel d'allier les trois buts. En effet, ils ont constaté qu'il est désagréable, pour les travailleurs, de « remplir des dossiers pour des statistiques ». Chill doit pouvoir être utilisé au quotidien : les travailleurs auront de l'intérêt à enregistrer les éléments si, continuellement, l'outil est utile dans leur travail quotidien.
+
+## Chill est un logiciel libre
+
+Le caractère « libre » du logiciel est affirmé dès sa création. La logique d'ouverture du code est poussée au maximum :
+
+* la documentation (élément essentiel qui permet à d'autres développeurs de continuer ou compléter le code) est présente et complète (voir http://docs.chill.social) ;
+* le code est sous licence AGPLv3. Il s'agit d'une des plus restrictives et des plus sûres pour l'utilisateur. Elle impose aux éditeurs de rendre disponible tout le code développé, même lorsque la redistribution est faite sous forme de service en ligne ;
+* il n'existe pas de module « propriétaire » : toutes les fonctionnalités sont accessibles.
+
+La libération du code est vécue comme une opportunité pour les éditeurs : c'est en effet l'occasion de mutualiser les coûts de développement en partageant le logiciel entre différentes institutions.
+
+## Comment l'installer ?
+
+Si vous cherchez la documentation d'installation du logiciel, elle se trouve à http://docs.chill.social.
+
+## Comment l'administrer ?
+
+Chill dispose d'une interface d'administration qui sert à configurer le logiciel, afin qu'il corresponde au mieux au métier des travailleur·euses sociaux. Dans ce document, nous appelons "administrateurs" la ou les personnes qui disposent d'un droit d'administration et qui ont configuré le logiciel. La documentation destinée aux administrateurs est rassemblée dans un autre document.

user/menage.md

@@ -0,0 +1,114 @@
+\newpage
+
+# Ménages {#sec:household}
+
+## Qu'est-ce qu'un ménage ?
+
+Un ménage est un ensemble d'usagers vivant "sous le même toit". Cela peut être les membres d'une famille, les membres d'une famille recomposée, les membres d'une famille d'accueil, etc.
+<!-- vivant "sous le même toit" OU domiciliés à la même adresse?  -->
+
+Un ménage est caractérisé par une adresse, qui correspond à l'adresse de domiciliation de ses membres. Cette adresse peut changer (en cas de déménagement): elle est donc définie entre une date de début et une date de fin. Un ménage ne peut avoir **qu'une seule adresse** simultanément. Par contre, un ménage peut changer d'adresse au cours du temps. Chill propose donc d'enregistrer l'historique des adresses du ménage. 
+
+Un usager ne peut être membre que **d'un seul ménage à la fois**, avec une exception cependant: les usagers qui ne partagent pas l'adresse du ménage (par exemple, les enfants en garde alternée). L'appartenance à un ménage est caractérisée par une date de début, et une date de fin; Chill présente donc un **historique** des différents ménages auxquels un usager a appartenu.
+
+Chaque usager se voit attribué une **position** dans un ménage, configurée par un administrateur fonctionnel. Par exemple: "Adulte dans le ménage", "Enfant dans le ménage", "Enfant hors domicile", etc. 
+
+## Résumé du ménage
+
+<!-- /fr/person/household/{household_id}/summary -->
+
+![Résumé d'un ménage](./img/fr_person_household_376_summary.png)
+
+On accède à la page de résumé du ménage via le menu "usager" ou bien en cliquant sur l'icône représentant le ménage dans la recherche par personne. La page de résumé du ménage présente l'adresse actuelle du ménage, les membres du ménage et la composition du ménage.
+
+
+### Associer un usager à un ménage
+
+Lorsqu'aucun ménage n'est renseigné dans la liste des ménages d'un usager, alors le logiciel vous permet de créer un nouveau ménage. Lors de cette étape, on peut créer un nouveau ménage ou rejoindre un ménage existant. Le logiciel va automatiquement proposer des ménages possibles en faisant des suggestions de ménages.
+
+::: { .info }
+
+**Quels ménages sont suggérés ?**
+
+Le logiciel essaye d'établir des liens entre les utilisateurs concernés par le changement de ménage, et d'autres ménages.
+
+Les liens effectués sont les suivants:
+
+* Pour chaque usager concerné par le changement, le logiciel vérifie s'il est présent dans un autre parcours, avec d'autres usagers. Si ces usagers sont eux-mêmes associés à un ménage, alors le logiciel propose de rejoindre ce ménage existant.
+* Le logiciel examine également la localisation des parcours dans lequel se trouve l'usager concerné par le changement. Si le parcours est localisé à une adresse de référence, le logiciel recherche si d'autres ménages habitent à cette adresse. S'il en trouve, ces ménages seront suggérés également.
+
+:::
+
+Dès cette étape, vous pouvez indiquer une adresse; cela permettra de localiser immédiatement le ménage créé. Le logiciel va vous suggérer de ré-utiliser des adresses connues.
+
+
+::: { .info }
+**Quelles adresses sont suggérées ?**
+
+Le logiciel vous propose de ré-utiliser la localisation temporaire des parcours associés aux usagers.
+
+Pour chaque usager qui va "changer de ménage", le logiciel examine s'il est actuellement associé à un parcours. Si ce parcours dispose d'une adresse temporaire, alors cette adresse sera reprise dans les suggestions.
+:::
+
+
+### Rejoindre un ménage
+
+Il y a plusieurs voies possibles pour faire rejoindre un usager à un ménage:
+
+- lorsqu'on crée un parcours pour un usager qui n'est pas dans un ménage, le logiciel suggère de renseigner leur appartenance à un ménage. L'action permet alors de les positionner dans un ménage, que ce soit un ménage existant ou à créer.
+
+- lorsqu'on est sur la page de résumé du ménage, on peut toujours rechercher et ajouter un usager. Pour cela, on utilise le bouton "Ajouter un membre" en bas de la page.
+
+### Les positions dans le ménage
+
+<!-- attention, les positions "enfants hors ménage", etc., c'est de la configuration -->
+
+Chaque membre du ménage est détaillé dans la page "résumé du ménage". L'usager peut avoir une certaine position dans le ménage: adulte ou enfant, ainsi qu'être titulaire d'un ménage. A tout moment il est possible de faire quitter un usager d'un ménage, ou de le repositionner dans le ménage (par exemple le rendre titulaire).
+
+Le cas échéant, il est possible aussi de visualiser une ancienne appartenance, soit un usager ayant appartenu au ménage mais qui n'en fait plus partie actuellement.
+
+
+## Ajouter des membres au ménage, quitter un ménage, rejoindre un ménage
+
+En bas de la page de résumé du ménage, le bouton "Ajouter un membre" permet d'ajouter un usager au ménage. Lors d'un clic sur ce bouton, dans les pages suivantes, on peut:
+
+- ajouter un ou plusieurs usagers existants, ou en créer;
+- positionner chaque usager dans le ménage, c'est-à-dire spécifier si c'est un enfant ou un adulte, et éventuellement le qualifier en tant que titulaire du ménage;
+- inscrire la date où l'usager rejoint le ménage, et éventuellement, un commentaire;
+- et, enfin, enregistrer.
+
+
+
+
+Dans la liste des membres du ménage, en utilisant les boutons à droite, on peut:
+
+- quitter le ménage: dans ce cas, l'usager peut rejoindre un autre ménage ou bien quitter sans rejoindre un ménage. A nouveau, une date de changement est enregistrée.
+- repositionner le membre: c'est-à-dire changer le positionnement (adulte, enfant, ...) du membre.
+- renseigner l'appartenance: c'est-à-dire changer la date et le commentaire du changement
+
+## Historique des adresses d'un ménage
+
+L'historique des adresses du ménage peut être accédé dans le menu du ménage sous le titre "Historique adresse". L'historique des adresses montre toutes les adresses successives des ménages et permet d'en ajouter.
+
+<!-- /fr/person/household/{household_id}/addresses -->
+
+![Historique des adresses d'un ménage](./img/fr_person_household_376_addresses.png)
+
+Une liste des parcours d'accompagnement du ménage peut être également affichée en cliquant dans le menu du ménage sous "parcours d'accompagnement".
+
+## Filiations
+<!-- /fr/person/household/{household_id}/relationship -->
+
+![Filiations d'un ménage](./img/menage_filiations.png)
+
+La page "Filiations" propose une vue d'ensemble sous forme de graphe des filiations au sein d'un ménage, c'est-à-dire les liens de parenté entre ses membres. Cette page permet non seulement de visualiser les filiations mais aussi de les éditer. En cliquant sur "Créer un lien de filiation", puis en sélectionnant 2 personnes, il est possible de définir les liens de filiations entre ces 2 personnes: mère/père-fille/fils, frère/soeur-frère/soeur, oncle/tante-neveu/nièce.
+
+En outre, le graphe montre également les parcours d'accompagnement associé à chaque membre du ménage. En affichant les parcours, des usagers éventuellement liés à ces parcours mais appartenant à d'autres ménages peuvent être affichés. Les éléments du graphe peuvent être déplacés en cliquant dessus et en les glissant. Enfin, on peut exporter ce graphe sous forme d'une image.
+
+En bref, cette page résume un ménage et ses liens de filiations sous forme de diagramme facile à appréhender.
+
+## Composition familiale
+
+La composition familiale est une qualification du ménage en tant que type de ménage, par exemple, couple avec enfants, couple sans enfants, mère seule, femme seule, etc. Cette composition est valide jusqu'à une date donnée.
+
+De même que pour les adresses d'un ménage, il est possible de visualiser l'historique de la composition d'un ménage.

user/metadata.yaml

@@ -2,7 +2,11 @@
 title: Manuel utilisateur de Chill
 lang: fr-BE
 toc: true
+page: a4
+book: true
 
+titlepage: true,
+#logo: "img/logo-chill-outil-accompagnement.svg"
 
 header-includes: |
     \usepackage{awesomebox}

user/notes_privées.md

@@ -0,0 +1,7 @@
+# Notes privées
+
+Des notes privées peuvent être créés pour les [activités](./activity.md#create-and-modify-an-activity), les [actions sociales](./social_actions.md#private-comment) et les rendez-vous.
+
+Chaque utilisateur peut publier une note privé par élément (eg. par activité). Cette note peut toujours être modifiée dans les formulaires d'édition de l'élément concerné.
+
+Naturellement, les utilisateurs ne peuvent voir que leurs propres notes privées et non ceux des autres utilisateurs.

user/notifications.md

@@ -0,0 +1,42 @@
+\newpage
+
+# 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.
+
+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é.
+
+![Boîte de réception des notifications](./img/fr_notification_inbox.png)
+
+## Créer une notification
+<!-- fr/notification/create?entityClass=Chill%5CPersonBundle%5CEntity%5CAccompanyingPeriod&entityId=2705-->
+
+Des notifications peuvent être envoyées à partir de plusieurs endroits du logiciel. Une notification comprend un objet (comme un courriel), un ou plusieurs destinataires, un message et les informations à partir desquelles la notification est envoyée. Par exemple, lors de l'envoi d'une notification dans le cadre d'un parcours, les informations générales du parcours sont également copiées.
+
+Il est possible d'envoyer une notification:
+
+- de la page résumé d'un parcours
+- d'une activité/échange
+
+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
+<!-- fr/notification/{notification_id}/show -->
+
+![Discussion dans une notification](./img/fr_notification_126_show.png)
+
+Lorsqu'une notification est reçue, il est possible d'engager une discussion avec son destinataire dans la page de la notification. Cela permet de laisser des messages entre travailleurs, comme dans un système de discussion en ligne.
+
+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é".
+
+
+

user/parcours.md

@@ -0,0 +1,235 @@
+\newpage
+
+# Parcours d'accompagnement {#sec:parcours}
+
+
+Fournir un soutien social significatif est souvent une combinaison complexe d'objectifs, d'actions, d'acteurs impliqués, de documents, etc. Avec son module de parcours d'accompagnement, Chill vise à donner à ses utilisateurs un outil leur permettant de suivre les trajectoires sociales des usagers.
+
+Vous pouvez le considérer comme le troisième grand module de l'application. Comme pour les domaines "usager" et "ménage", les pages concernant un parcours sont facilement identifiables par son bandeau en haut de l'écran.
+
+![Bandeau d'un parcours d'accompagnement](./img/banner_course.png)
+
+## Résumé du parcours
+
+![Résumé du parcours](./img/parcours_dashboard.png)
+
+<!-- /fr/parcours/{id} -->
+
+La page de résumé rassemble les informations les plus importantes et les dernières activités au sein d'un parcours, vous permettant de prendre certaines actions rapides comme cliquer sur les badges des personnes associées, les activités liées ou les actions sociales, envoyer une nouvelle notification, etc.
+
+En bref, il s'agit du tableau de bord du parcours à partir duquel vous pouvez naviguer vers des sections spécifiques.
+
+## 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.
+
+* **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.
+
+:::
+
+Dans le menu utilisateur, vous trouvez une entrée de menu pour vous diriger vers:
+
+* une page de liste de **tous** les parcours dont vous êtes le référent;
+* une page de liste de toutes vos parcours **BROUILLON** (ceux que vous avez créés, mais pas encore confirmés).
+
+## Parcours confidentiel, intensité, et caractère urgent d'un parcours
+
+Bien que les trois états ci-dessus soient considérés comme les états principaux, il existe des propriétés supplémentaires qui caractérisent l'état d'un parcours. Il s'agit des propriétés suivantes:
+
+* **Confidentiel** : un parcours confidentiel ne peut être consulté que par le référent. Les autres utilisateurs n'auront pas accès aux informations qu'il contient.
+* **Intensité** : Un parcours peut être caractérisé comme *régulier* ou *ponctuel*.
+* **Urgent** : Cet état peut être déclenché lorsque des actions urgentes sont requises dans ce parcours.
+
+::: { .note }
+Seul le référent peut modifier l'intensité et le caractère confidentiel d'un parcours.
+:::
+
+::: { .warning }
+
+Un parcours confidentiel est visible uniquement par:
+
+* le référent du parcours;
+* les personnes qui disposent d'un droit d'accès permettant de voir les parcours confidentiels.
+
+:::
+
+
+## Création d'un parcours d'accompagnement social
+
+<!-- /fr/parcours/{id}/edit -->
+
+Un nouveau parcours peut être créé:
+
+::: { .not-vendee }
+* à partir du menu de section: `Sections > Créer un parcours`. En procédant ainsi, vous êtes dirigé vers un formulaire de parcours vierge à remplir;
+:::
+* à partir des résultats de recherche, en utilisant le bouton "parcours vert" en regard du nom et de l'adresse de l'usager;
+* à partir du dossier de l'usager, depuis la liste des parcours d'un usager;
+* à partir du dossier du ménage, depuis la liste des parcours du ménage. Dans ce cas, un parcours reprenant tous les membres du ménage est créé;
+
+
+## Informations requises à la création
+
+Les informations requises pour **confirmer** un parcours sont les suivantes :
+
+* Il doit être lié à au moins un usager concerné.
+* Il doit être lié à au moins une problématique sociale.
+* Il doit être attribué à au moins un service.
+* Il doit être localisé.
+
+![Confirmer le parcours](./img/parcours_confirm.png)
+
+Toutes ces informations requises sont énumérées au bas du formulaire tant qu'elles ne sont pas remplies. Cela sert à vous rappeler ce que vous devez faire pour confirmer le parcours.
+
+### Usagers concernés
+
+![Usagers concernés](./img/concerned_persons.png)
+
+Un parcours peut être mis en place pour apporter un soutien à plusieurs usagers (par exemple, un soutien est apporté à une mère et son enfant).
+
+### Localisation du parcours
+
+![Localisation](./img/parcours_localisation.png)
+
+Chaque parcours **doit** être localisé et ceci peut être fait de deux manières.
+
+1. Vous pouvez indiquer une adresse temporaire en cliquant sur le bouton désigné. L'adresse ne sera pas automatiquement adaptée en cas de déménagement de la personne concernée. C'est pourquoi un message s'affiche pour vous rappeler, en tant qu'utilisateur, que la deuxième option, indiquée ici, est préférable.
+
+2. Vous pouvez la lier à l'adresse personnelle d'un usager concerné en cliquant sur l'icône du marqueur de carte dans la section des usagers concernés. Si l'usager déménage, elle sera également adaptée automatiquement dans le parcours.
+
+::: {.info}
+Si un parcours est lié à l'adresse d'un usager concerné:
+
+* il n'est pas possible de dissocier cet usager du parcours.
+* l'usager ne peut pas être déplacé d'un foyer sans indiquer une autre adresse.
+:::
+
+#### Localiser le parcours auprès d'un usager concerné
+
+Dans le cas où un usager concerné dispose d'une adresse, il est possible de localiser le parcours auprès de cet usager.
+
+Lorsqu'un parcours est localisé auprès d'un usager:
+
+* le parcours "suit" l'adresse de l'usager lorsqu'il déménage;
+* il n'est pas possible de dissocier l'usager concerné du parcours;
+
+Par ailleurs,
+
+* l'usager ne peut pas quitter le parcours, tant que le parcours est localisé auprès de lui;
+* l'usager ne peut pas quitter son ménage sans laisser d'adresse, tant qu'il localisé auprès d'au moins un parcours.
+
+#### Localisation temporaire
+
+Une adresse temporaire peut être attribuée à un parcours.
+
+Dans ce cas, cette localisation est associée au parcours, et ne sera pas automatiquement modifiée si un usager déménageait. Pour éviter cette situation, un message d'avertissement rappelle qu'il est préférable d'indiquer une réelle localisation pour le parcours.
+
+::: {.vendee}
+
+#### Pourquoi localiser les parcours ?
+
+La localisation des parcours permet:
+
+* de désigner les référents automatiquement, ou d'inclure les parcours dans les listes des réunions de régulation pour les bons services et MDSF;
+* de générer des statistiques localisées;
+* de gérer les droits
+
+:::
+
+### Origine de la demande
+
+Dans cette section, vous trouverez une liste prédéfinie d'origines possibles (par exemple, la demande a été faite par téléphone).
+
+### Localisation administrative
+
+La localisation administrative est l'endroit où le parcours est traité. Cela est utile pour des organisations ayant plusieurs sites différents.
+
+### Demandeur
+
+Il peut s'agir d'un usager/tiers déjà existant ou d'une nouvelle personne qui peut être créé à partir de la modale de recherche. Cliquez sur le bouton <**Créer "votre-recherche"**> pour en créer.
+
+### Problématiques sociales
+
+En utilisant le menu déroulant, plusieurs problématiques sociales peuvent être identifiées. Choisissez-en au moins une pour pouvoir confirmer le parcours.
+
+### Services concernés
+
+Identifiez au moins un service qui est concerné par ce parcours. Plusieurs services peuvent être sélectionnés. Cela a un impact sur les utilisateurs qui ont le droit d'accéder aux dossiers du parcours: seuls les utilisateurs (travailleurs) qui appartiennent à un service peuvent avoir accès à certaines informations du parcours selon les services concernés.
+
+### Référent du parcours
+
+Le référent est un collègue auquel vous pouvez vous adresser pour ce parcours. Il est responsable du suivi et a des droits spécifiques liés à l'état du parcours:
+
+* il peut le marquer comme confidentiel;
+* il peut le marquer comme urgent;
+* il peut changer l'intensité.
+
+::: {.info}
+
+Dans un parcours confirmé, ces trois états ne peuvent pas être modifiés si un parcours n'a pas de référent assigné.
+
+De même, un référent ne peut être supprimé d'un parcours confidentiel.
+
+:::
+
+### Interlocuteurs privilégiés
+
+Un parcours est mis en place pour apporter un soutien à un ou plusieurs usagers concernées. Naturellement, il peut également y avoir un ou plusieurs tiers ou usagers impliqués pour offrir ce soutien. Ces partenaires peuvent être ajoutés dans cette section en recherchant leur nom.
+
+Si un partenaire n'existe pas encore, il peut être créé à partir de la modale de recherche en appuyant sur le bouton <**Créer "votre-recherche"**>.
+
+<!-- ## Historique du parcours -->
+
+<!-- /fr/parcours/{id}/histoire  -->
+
+<!-- TODO -->
+
+## Les actions d'accompagnement social
+<!-- /fr/person/accompagnement-période/{id}/travail -->
+
+Dès qu'un parcours a été confirmé (il est à l'état "en file active"), il est possible d'ajouter des actions d'accompagnement social à ce parcours. Ce sont les actions qui sont entreprises pour réaliser l'accompagnement. Veuillez lire la documentation sur les [actions d'accompagnement](#sec:social_action) pour plus d'informations.
+
+## Commentaires
+
+<!-- /fr/parcours/{id}/comments -->
+
+Des commentaires peuvent être ajoutés à un parcours pour notifier aux collègues des informations supplémentaires pour lesquelles il n'y a peut-être pas de section désignée. Un commentaire peut être **épinglé** au tableau de bord du parcours en cliquant sur l'icône du drapeau.
+
+::: {.info}
+
+Un seul commentaire peut être épinglé au tableau de bord, mais tous les commentaires resteront disponibles dans la section des commentaires pour être consultés, modifiés, ré-épinglés ou supprimés.
+
+:::
+
+## Tâches
+
+<!-- /fr/task/single-task/by-course/{id} -->
+
+Tout comme pour les usagers, des tâches peuvent être créées et assignées dans un parcours. Veuillez lire la documentation sur les [tâches](#sec:tasks) pour des informations détaillées.
+
+## Documents
+
+<!-- /fr/parcours/{id}/documents -->
+
+
+Tout comme pour les usagers, des documents peuvent être attachés à un parcours. La seule différence ici est qu'un document de parcours peut également être généré à partir d'un modèle. Ce modèle peut être sélectionné dans le menu déroulant.
+
+Veuillez lire la documentation sur les [documents](#sec:documents) pour des informations détaillées.
+
+## Fermer un parcours
+
+<!-- /fr/parcours/{id}/close -->
+
+À tout moment, un parcours peut être fermé en cliquant sur l'entrée du menu latéral **"Clôturer le parcours"**.
+
+Vous serez dirigé vers un petit formulaire dans lequel vous pourrez spécifier la date de fermeture et le motif.
+
+## Ré-ouvrir un parcours
+
+Lorsqu'un parcours est fermé, le menu s'adapte pour offrir à l'utilisateur la possibilité de le ré-ouvrir. Aucune autre action n'est requise après avoir cliqué sur ce bouton.

user/parcours_a_trier.md

@@ -1,3 +1,4 @@
+\newpage
 
 # Parcours
 
@@ -22,7 +23,7 @@ Chaque parcours **doit** être localisé.
 La localisation est réalisée par l'une ou l'autre manière:
 
 * soit en indiquant une adresse temporaire sur le parcours;
-* soit en renseignant un usager concerné ou un interlocuteur privilégié du parcours. Dans ce cas, l'adresse du domicile de cet usager sera utilisée pour localiser le parcours.
+* soit en renseignant un des usagers concerné par le parcours. Dans ce cas, l'adresse du domicile de cet usager sera utilisée pour localiser le parcours. S'il déménage, son adresse sera réutilisée dès son déménagement, de manière automatique.
 
 ::: {.vendee}
 
@@ -36,23 +37,20 @@ La localisation des parcours permet:
 
 :::
 
-### Localiser le parcours auprès d'un usager concerné ou d'un interlocuteur privilégié
+### Localiser le parcours auprès d'un usager concerné
 
-Dans le cas où un usager ou un interlocuteur privilégié[^usager-only] dispose d'une adresse, il est possible de localiser le parcours auprès de cet usager.
+Dans le cas où un usager concerné dispose d'une adresse, il est possible de localiser le parcours auprès de cet usager.
-
-[^usager-only]: Uniquement les usagers: les tiers ne sont pas concernés.
 
 Lorsqu'un parcours est localisé auprès d'un usager:
 
 * le parcours "suit" l'adresse de l'usager lorsqu'il déménage;
-* il n'est pas possible de dissocier du parcours l'usager concerné ou l'interlocuteur privilégié;
+* il n'est pas possible de dissocier l'usager concerné du parcours;
 
 Par ailleurs,
 
 * l'usager ne peut pas quitter le parcours, tant que le parcours est localisé auprès de lui;
 * l'usager ne peut pas quitter son ménage sans laisser d'adresse, tant qu'il localisé auprès d'au moins un parcours.
 
-
 ### Localisation temporaire
 
 Une adresse temporaire peut être attribuée à un parcours.

user/person-vendee.md

@@ -0,0 +1,38 @@
+## Informations socio-professionnelles
+<!-- fr/vendee/vendeeperson/{person_id}/infosociopro/ -->
+
+![Informations socio-professionnelles](./img/fr_vendee_vendeeperson_2811_infosociopro_view.png)
+
+La page des informations socio-professionnelles de l'usager rassemble des informations professionnelles (salarié, en recherche d'emploi, ...), le niveau d'étude, des informations de mobilité (permis de conduire, moyen de transport) et les caisses de retraites. Pour ce dernier point, une caisse principale et plusieurs caisses complémentaires peuvent être ajoutées.
+
+Cette page est accessible via le menu "usager".
+
+## Informations médicales
+<!-- fr/vendee/vendeeperson/{person_id}/infomedicale/ -->
+
+![Informations médicales](./img/fr_vendee_vendeeperson_2811_infomedicale_view.png)
+
+La page des informations médicales compte des informations de santé telles que le nom du médecin traitant, les caisses de sécurité sociale et mutuelle, et éventuelles allocations (MDPH, AAH, etc.).
+
+Pour enregistrer le médecin traitant, on peut choisir un tiers existant dans le logiciel, ou bien saisir directement sa dénomination dans un champ texte.
+
+Cette page est accessible via le menu "usager".
+
+## Informations logement
+
+La page des informations relatives au logement permet principalement d'enregistrer le statut de l'usager par rapport à son logement (propriétaire, locataire, etc.).
+
+Cette page est accessible via le menu "usager".
+
+## Informations propres aux mineurs d'âge
+
+Lorsque l'usager est un mineur (<18 ans), des informations supplémentaires peuvent être saisies quant à sa situation familiale et sa scolarité.
+
+La page des informations familiales peut être plus ou moins détaillée selon la situation du mineur. S'il y a des dispositifs tels que délégation, tuteur, JAF, enfant confié, etc., d'autres champs se déplient dans le formulaire.
+
+![Situation familiale](./img/fr_vendee_vendeepersonmineur_2821_infofamille_view.png)
+
+
+La page de la scolarité contient des informations sur l'établissement scolaire, l'enseignant référent, la formation en alternance le cas échéant, et d'autres informations scolaires.
+
+![Scolarité](./img/fr_vendee_vendeepersonmineur_2821_scolarite_view.png)

user/person.md

@@ -0,0 +1,110 @@
+\newpage
+
+# Fiche usager {#sec:person}
+
+La fiche usager renseigne toutes les informations propres à l'usager: nom, prénom, informations de contacts, adresses, etc. C'est la base du dossier social électronique de l'usager.
+
+On y accède par la recherche d'un usager sur la page d'accueil ou dans la barre d'outil. On peut y accéder aussi par d'autres pages en cliquant sur le nom d'un usager, puis en cliquant sur "Ouvrir la fiche de l'usager".
+
+Pour chaque usager, on peut définir des parcours d'accompagnements. Enfin, à chaque usager est relié des échanges dans lesquels l'usager est impliqué.
+
+## Créer un usager
+<!-- fr/person/new -->
+
+![Créer un usager](./img/fr_person_new.png)
+
+Pour ajouter un usager, cliquez sur "Sections" > "Ajout d'un usager", depuis:
+
+::: { .not-vendee }
+* la barre d'outil supérieure.
+:::
+* les résultats de recherche
+
+Dans la page de création, rentrez les informations demandées. Seuls le nom, le(s) prénom(s) et le genre sont obligatoire. Cliquez ensuite sur "Créer l'usager". Vous avez alors le choix entre créer simplement l'usager, créer l'usager et l'associer à un ménage ou bien créer l'usager et créer un parcours d'accompagnement associé.
+
+::: { .info }
+
+À noter que l'inscription des numéros de téléphone doit respecter un certain format standard. Rentrez vos numéros sans espaces, sans barre "/" ou tirets "-".
+
+Les numéros de téléphones sont vérifiés auprès d'un annuaire. Ils doivent donc être actifs auprès d'un opérateur téléphonique.
+:::
+
+Chill va rechercher les doublons potentiels pour un usager qui est créé. La recherche des doublons est effectuée en comparant la similarité entre le nom et le prénom.
+
+## Détails de l'usager
+<!-- fr/person/{id}/general -->
+
+![Page de détails de l'usager](./img/fr_person_2811_general.png)
+
+La fiche de l'usager contient toutes les informations détaillées de l'usager, à savoir:
+
+- nom, prénom(s), genre;
+- nationalité, langues parlées, nombre d'enfants, état matrimonial;
+- date et lieu de naissance;
+- informations de contact.
+
+Ces informations peuvent être remplies au fur et à mesure, ou bien rester inconnues. En bas de la page, le bouton "Modifier" permet d'éditer ces informations. On peut aussi y ajouter des remarques.
+
+Une partie de ces informations sont rappelées dans le bandeau de la personne ainsi qu'à d'autres endroits du logiciel lors d'un clic sur le nom de l'usager.
+
+## Quelle adresse pour un usager ?
+
+Chill supporte deux types d'adresses:
+
+* les adresses de domicile, qui sont les adresses permanentes, officielles, d'un usager (adresse de domiciliation);
+* les adresses de résidences, qui sont des adresses temporaires d'un usager, auquel il ne réside que pour une période de temps déterminée, et qui n'est pas destinée à être officielle.
+
+::: { .warning }
+En conséquence, on n'attache pas l'adresse de domicile directement à un usager, mais bien à son ménage. Seules des adresses de résidence peuvent être saisies dans le dossier de l'usager.
+:::
+
+## Adresses de résidences
+<!-- /fr/person/{id}/residential-address/list -->
+
+![Adresse de résidence pour un usager](./img/fr_person_2811_residential-address_list.png)
+
+
+Chaque usager peut avoir une ou plusieurs adresses de résidences. On y accède en cliquant sur "Adresses de résidence" dans le menu à droite.
+
+Ces adresses ne sont pas censées être des adresses de domicile, officielles, déclarées auprès des autorités. Il s'agit, par exemple, d'une résidence temporaire en maison de repos, d'un logement chez une connaissance ou un ami pendant une période de temps déterminée, etc.
+
+Lors de l'ajout d'une adresse de résidence, il y a le choix entre:
+
+- prendre une adresse d'une autre personne (d'un autre usager);
+- prendre une adresse d'un tiers;
+- créer une nouvelle [adresse](#sec:choisir-une-adresse).
+
+## Personnes ressources
+<!-- /fr/person/{id}/resources/list -->
+
+![Personnes ressources d'un usager](./img/fr_person_2811_resources_list.png)
+
+Les personnes ressources sont des autres usagers ou des tiers (#sec:tiers) associés au dossier de l'usager. Une personne-ressource peut être un ami ou un voisin (un autre usager), un professionnel de la santé (un tiers), etc. Les autres membres du ménage de la personne sont plutôt à saisir dans la partie "ménage". Si la personne-ressource n'est pas enregistrée, on peut également l'ajouter en tant que description libre.
+
+
+<!-- ## Historique
+<!-- /fr/person/{id}/timeline
+
+TODO -->
+
+## Traiter les doublons
+<!-- /fr/person/{id}/duplicate/view -->
+
+Il se peut qu'un usager ait été enregistré plus d'une fois. La page "Traiter les doublons" permet de repérer et de traiter les éventuels doublons d'un usager. La page liste les usagers ayant des noms similaires et propose de les fusionner.
+
+::: { .info }
+
+Cette page est utilisée pour traiter les doublons, mais Chill détecte également de manière automatique les doublons potentiels lors de la création d'un nouvel usager.
+
+:::
+## Autres entrées dans le menu usager
+
+Il y a plusieurs entrées du menu de l'usager qui renvoient vers les autres parties du logiciel, en gardant le lien avec la personne. Ces entrées sont:
+
+* Parcours d'accompagnement: liste des parcours d'accompagnement dans lesquels l'usager est concerné;
+* Activités (ou échanges): liste des activités dans lesquelles l'usager est impliqué;
+* Documents: liste des documents dans lesquels l'usager est impliqué;
+* Tâches: liste des tâches dans lesquelles l'usager est impliqué;
+* Ménages: gestion du ménage de l'usager.
+
+-->

user/reassigner_parcours.md

@@ -0,0 +1,13 @@
+# Réassigner des parcours
+
+Il peut s'avérer nécessaire de réassigner les parcours suivis par un utilisateur à un autre utilisateur. Par exemple, un utilisateur peut être absent pendant une période prolongée, changer de fonction, etc.
+
+Pour de telles situations, une fonctionnalité a été prévue pour réassigner les parcours en lot à un autre utilisateur.
+
+Pour utiliser cette fonctionnalité, cliquez sur "Parcours des utilisateurs" dans le menu "Sections".
+
+Un premier champ de sélection sera visible. Utilisez-le pour sélectionner l'utilisateur dont les parcours doivent être réassignés. Une liste complète des parcours sera fournie.
+
+Dans une deuxième étape, l'utilisateur auquel les parcours de la page actuelle doivent être réassignés peut être sélectionné. En cliquant sur le bouton "Réassigner", cette action sera terminée et les parcours restants seront affichées. L'action peut être répétée.
+
+Chaque parcours individuel est affiché avec le bouton d'édition, ce qui permet de le réassigner individuellement dans le formulaire d'édition du parcours. Accédez à la section [referrant](./support_trajectory.md#referrer) pour réassigner ce parcours. Lors d'un réassignement en lot, ce parcours ne sera plus pris en compte, car il n'appartient plus à l'utilisateur initial.

user/search.md

@@ -0,0 +1,31 @@
+\newpage
+
+# Recherche
+
+
+Dans le bandeau supérieur, il y a une barre de recherche des usagers. On peut y rechercher des usagers par nom et prénoms, le moteur de recherche étant tolérant sur des graphies différentes. Par exemple, si on cherche "Mathieu", on trouvera aussi les prénoms correspondant à "Matthieu".
+
+Si vous n'avez pas trouvé l'usager, vous pouvez cliquer sur le bouton "Recherche avancé". Dans la page de recherche avancée, on peut rechercher sur base de la date de naissance, un fragment de numéro de téléphone, etc.
+
+![Recherche avancée d'un usager](./img/advanced_search.png)
+
+## Motifs de recherche
+
+La recherche est effectuée de la manière suivante:
+
+* par partie du nom et du prénom;
+* par date de naissance:
+
+  La date de naissance doit être formatée de la manière suivante: `15/06/1981`, `15-06-1981` ou, au format anglais, `1981-06-15` (pour exprimer le 15 juin 1981). Le mois et le jour **doit toujours être inscrit avec deux chiffres**, en indiquant donc un "zéro" lorsque le chiffre du mois ou du jour est inférieur à dix.
+
+* par numéro de téléphone
+
+  La recherche par numéro de téléphone s'enclenche à partir de cinq chiffres: il est donc nécessaire d'indiquer au moins cinq chiffres du numéro. Si le premier chiffre est un zéro, alors le numéro est considéré comme étant issu du pays d'installation (paramètre de la configuration du logiciel). Pour une recherche sur des numéros étrangers, le préfixe international est requis (par exemple `+32` pour la Belgique).
+
+::: { .note }
+Ces motifs sont appliqués sur la recherche de la page d'accueil, du bandeau de recherche présent sur chaque page, mais aussi dans toutes les zones de recherche des usagers présent dans les parcours, personnes ressources, etc.
+:::
+
+
+
+

user/social_actions.md

@@ -0,0 +1,92 @@
+\newpage
+
+# Actions d'accompagnement social {#sec:social_action}
+
+Les actions d'accompagnement sont des actions entreprises dans le cadre d'un parcours et concernant une certaine problématique sociale.
+
+Les actions d'accompagnement sont facilement reconnaissables dans l'application grâce à une vignette orange.
+
+::: {.info}
+Les actions d'accompagnement ne peuvent être créées que pour les parcours **confirmés**.
+:::
+
+Les types d'actions sont reliés aux problématiques: des types d'actions sont disponibles en fonction des problématiques.
+
+::: {.note}
+Bien que les types d'actions soient limités par les problématiques du parcours, l'interface permet d'ajouter la problématique au parcours **en même temps** que la création de l'action. 
+:::
+
+## Créer une action d'accompagnement
+
+<!-- /fr/personne/accompagnement-période/{id}/travail -->
+
+![Action d'accompagnement](./img/action_accompagnement.png)
+
+Comme de nombreuses autres sections de l'application Chill, une liste des actions d'accompagnement social peut être trouvée en cliquant sur <**Actions d'accompagnement**> dans le menu latéral jaune d'un parcours.
+
+Un aperçu concis des informations importantes est donné pour chaque action de la liste.
+
+Tant qu'un parcours est à l'état **confirmé**, chaque action peut être modifiée, supprimée ou un [workflow](#sec:workflow) peut être créé.
+
+## Création d'une action d'accompagnement social
+
+<!-- /fr/person/accompanying-period/{id}/work/new -->
+
+Pour créer une action d'accompagnement social, l'utilisateur est guidé à travers plusieurs étapes:
+
+1. Choisir une problématique sociale. Si la problématique en question ne figure pas parmi les choix proposés, l'utilisateur peut l'ajouter en la sélectionnant dans le menu déroulant.
+2. Choisissez une action d'accompagnement. Toutes les actions affichées sont liées à la problématique sociale sélectionnée précédemment.
+3. Un ou plusieurs usagers concernés peuvent être sélectionnés.
+4. Spécifiez une date de début.
+5. Indiquez une date de fin (facultatif).
+
+## Modifier une action d'accompagnement social
+
+Une fois qu'une action d'accompagnement a été créée, elle n'est pas considérée comme un dossier clôturé. Le formulaire de modification permet d'ajouter beaucoup plus d'informations dans les étapes ultérieures afin d'en faire un "document de travail".
+
+### Commentaire
+
+Ici, l'utilisateur est libre de donner toutes les informations supplémentaires nécessaires.
+
+### Motifs et objectifs
+
+Les actions de soutien social ne sont jamais faites au hasard. Elles sont entreprises avec certains motifs ou pour atteindre un certain objectif.
+
+En cliquant sur un badge (+) dans le menu déroulant de cette section, l'utilisateur peut ajouter le motif ou le but de l'action. En cliquant à nouveau sur le badge (-), il peut le supprimer.
+
+Il est possible de sélectionner plusieurs objectifs.
+
+Les motifs et objectifs disponibles dépendent du type d'action d'accompagnement.
+
+### Résultats ou orientations
+
+Une fois qu'un motif ou un objectif est identifié, il est également possible de spécifier un résultat ou une orientation de l'action concernant cet objectif spécifique. De la même manière, ils peuvent être sélectionnés dans un menu déroulant et supprimés à nouveau.
+
+Plusieurs résultats peuvent être sélectionnés.
+
+Les résultats et orientations disponibles dépendant du type d'action d'accompagnement.
+
+::: { .note }
+Certains résultats peuvent être indiqués sans objectif préalables.
+:::
+
+### Évaluations, formulaires ou correspondance
+
+Plusieurs évaluations ou formulaires peuvent être ajoutés à une action d'accompagnement social. Il est précisé quelle évaluation peut être lancée et en cliquant sur le badge (+), un formulaire s'ouvrira pour que l'utilisateur le remplisse.
+
+Le formulaire permet de définir une date de début, une date d'échéance et une date de fin, ainsi qu'un rappel. Un champ de commentaire supplémentaire peut être utilisé pour donner plus de détails et un [document](#sec:documents) peut être généré ou téléversé.
+
+Les gabarits de document dépendent du type d'évaluation.
+
+### Usagers concernés
+
+Les usagers concernés par le parcours sont listés ici et l'utilisateur peut sélectionner les personnes impliquées dans cette action d'accompagnement social spécifique.
+
+### Tiers traitant
+
+Si un partenaire externe a exécuté l'action sociale, il peut être identifié ici. Considérez-le comme l'acteur principal.
+
+### Tiers intervenant
+
+Il s'agit de partenaires externes qui ont participé à l'action sociale, mais qui ne sont pas les acteurs principaux.
+

user/tasks.md

@@ -0,0 +1,40 @@
+\newpage
+
+# Tâches {#sec:tasks}
+
+## Liste des tâches
+
+<!-- /fr/task/single-task/by-course/{id} -->
+
+En cliquant sur l'entrée de menu **Mes tâches** dans le menu latéral de la personne ou de la trajectoire, vous accédez à la page de la liste des tâches.
+
+Ici, vous avez un aperçu de toutes les tâches liées à cette personne ou trajectoire particulière.
+
+En haut de la liste, vous trouverez une barre de recherche et plusieurs options de filtrage:
+
+* Tâches futures ou tâches sans date d'échéance;
+* Tâches dont l'échéance est proche;
+* Tâches dont la date d'échéance est dépassée;
+* Nouvelles tâches;
+* Tâches en cours;
+* Tâches fermées;
+* Tâches supprimées.
+
+Les tâches listées sont affichées avec leur titre, un badge identifiant l'état dans lequel se trouve la tâche (nouvelle, en cours, clôturé,...), leur date de début, la date à laquelle un rappel sera envoyé et leur date d'échéance. Les rappels de vos tâches peuvent être trouvés directement dans la page d'accueil, ou affichés dans le menu utilisateur.
+
+Une entrée de menu utilisateur distincte vous mènera directement à une page de liste de toutes vos tâches dont la date d'échéance est dépassée et qui n'ont pas été clôturées. Cette entrée de menu est facilement identifiable par un sigle "attention" (!).
+
+## Créer une nouvelle tâche
+
+<!-- /fr/task/single-task/new -->
+
+Pour créer une nouvelle tâche, il y a un formulaire à remplir. Les champs sont auto-explicatifs mais notez que seul le titre est obligatoire.
+
+## Page de détail
+
+<!-- /fr/task/single-task/{id}/show -->
+
+Vous pouvez visualiser la tâche de manière plus détaillée en cliquant sur le bouton avec l'icône **œil**. Sur la page de détail, vous avez la description de la tâche, mais aussi l'historique de la tâche. L'historique vous donne un aperçu des changements d'état et de qui les a entrepris à quel jour. Cela permet aux utilisateurs de garder facilement la trace des tâches.
+
+Dans la page de détail, ainsi que dans la page de liste, vous avez la possibilité de naviguer vers une page d'édition où vous pouvez modifier la tâche. Une tâche peut également être supprimée et son état actuel peut être modifié à l'aide du bouton déroulant **changer le statut**.
+

user/thirdparty.md

@@ -0,0 +1,57 @@
+\newpage
+
+# Tiers  {#sec:tiers}
+<!-- /fr/3party/3party -->
+
+Dans le cadre de l'accompagnement social, vous êtes amené à travailler avec de nombreux partenaires professionnels externes (professionels de santé, services administratifs, ...). Chill vous permet de les associer facilement à un utilisateur et à son parcours d'accompagnement, vous donnant ainsi un aperçu complet de chaque partenaire impliqué.
+
+Toutes les informations sur les tiers peuvent être consultées en allant dans le menu de la section dans le coin supérieur droit et en sélectionnant **Tiers**. On peut aussi accéder à la fiche de chaque tiers mentionné dans l'application en cliquant sur le badge du tiers puis en cliquant sur "Voir le tiers".
+
+En haut de la liste, une barre de recherche vous permet de trouver facilement le tiers que vous recherchez sur base de son nom.
+
+## Personnes morales, personnes physiques, et contacts
+
+Chill propose trois types de tiers:
+
+* les **personnes morales**, qui sont, généralement, une institution;
+* les **contacts**, qui sont des tiers associés à une personne morale. Il s'agira, généralement, de tiers qui travaillent au sein d'une institution;
+* les **personnes physiques** qui proposent d'enregistrer des informations adaptées aux personnes physiques. Aucun contact ne peut être associé à une personne physique.
+
+::: { .note }
+Le type de tiers ne peut pas être modifié après la création.
+:::
+
+## Créer un tiers
+
+Au bas de la page, vous trouverez un bouton permettant de créer un nouveau tiers. Ce faisant, vous verrez qu'une distinction est faite entre la création d'un tiers en tant que **personne morale** ou **personne physique**.
+
+Choisissez "personne morale" si vous voulez ajouter un tiers qui est, par exemple, un cabinet médical ou une organisation.
+Une "personne physique" correspond à tout professionnel que vous souhaitez ajouter en tant que tiers, par exemple un psychologue.
+
+### Personne morale
+
+La création d'une **personne morale** vous amène à un formulaire que vous pouvez remplir avec les informations suivantes.
+
+* **Nom**
+* **Acronyme**
+* **Service/département** : vous pouvez cibler un service ou un département spécifique au sein de l'organisation (par exemple, assistance aux personnes âgées, service juridique).
+* **Informations de contact** (numéro de téléphone, email).
+* **Adresse** : l'adresse du tiers. Comme pour toute les adresses, elle peut être rendue confidentielle.
+* **Contacts** : Les contacts sont des personnes physiques associées à l'entité juridique. Vous pouvez préciser leur titre et leur rôle au sein de l'organisation et ajouter leurs coordonnées. Comme pour l'adresse ci-dessus, il existe une option pour en faire un contact confidentiel. Leurs informations seront donc floutées dans toute l'application et pourront être révélées en cas de besoin. Chaque contact peut être supprimé individuellement et ces modifications seront enregistrées lors de la sauvegarde du tiers.
+* **Commentaire**
+* **Actif/inactif** : un tiers peut être mis à l'état inactif (par exemple, il n'est plus opérationnel).
+
+
+### Personne physique
+
+Une personne physique est un tiers équivalent à une personne. Bien qu'un contact soit en fait également une personne physique, il s'agit de deux entités distinctes dans Chill.
+
+Dans le formulaire, les éléments suivants peuvent être spécifiés:
+
+* **Civilité** (ex. Mme, Maire, ...)
+* **Nom**
+* **Qualité (rôle professionnel)** (ex : secrétaire, infirmière)
+* **Catégorie** : la catégorie dont relève les services du tiers.
+* **Informations de contact** : téléphone, courriel, adresse. Les informations de contact peuvent être spécifiées comme confidentielles.
+* **Commentaire**
+* **Actif/Inactif**

user/workflows.md

@@ -0,0 +1,103 @@
+
+``` {=latex}
+\newpage
+```
+
+# Suivi de prise de décisions (workflows) { #sec:workflow }
+
+Chill propose une fonctionnalité de suivi de rédaction, et prise de décision à partir des documents.
+
+## Principe
+
+Le suivi des décisions peut permettre de suivre l'évolution des:
+
+* actions d'accompagnement;
+* documents dans les parcours;
+* documents dans les évaluations des actions d'accompagnement des parcours.
+
+Le suivi est décomposé en plusieurs étapes; entre les étapes, les utilisateurs peuvent appliquer des **décisions**. 
+
+La définition des étapes et des décisions possibles pour chacune d'elle est configurée pour chaque installation.
+
+### Décisions et étapes
+
+Lors de chaque décision, l'utilisateur indique:
+
+* s'il valide ou refuse l'étape actuelle,
+* quelle sera la prochaine étape,
+* et qui pourra prendre la prochaine décision.
+
+Seuls les utilisateurs qui seront désignés à l'étape précédente pourront appliquer la prochaine décision.
+
+Il est possible d'indiquer une adresse email à la place d'un utilisateur. Dans ce cas, l'adresse indiquée recevra un email contenant un lien unique. Lorsqu'ils l'ouvriront, les utilisateurs devront s'authentifier avec leur compte Chill. Une fois authentifié, l'utilisateur qui aura cliqué sur ce lien se verra autorisé à prendre une décision pour la prochaine étape.
+
+### Clotûrer un workflow
+
+Lors d'une décision, l'utilisateur peut décider de cloturer un workflow:
+
+* soit en indiquant une étape finale (clotûre positive);
+* soit en indiquant une étape d'annulation.
+
+### Recevoir des notifications pour un workflow
+
+Les utilisateurs peuvent souscrire à des notifications, soit:
+
+* à chaque fois qu'une étape est décidée,
+* ou uniquement à l'étape finale.
+
+Par défaut, à chaque fois qu'un utilisateur initie un workflow ou prend une décision, il est abonné aux notifications pour toutes les prochaines décisions.
+
+## Créer un workflow
+
+Le workflow est créé à partir de l'entité sur laquelle porte le workflow, en utilisant le bouton suivant:
+
+![Bouton de création de workflow](./img/workflow_create.png)
+
+Lorsqu'un workflow est déjà existant, le bouton prend cette forme. Il est alors possible d'ajouter un workflow depuis la fenêtre qui présente la liste des workflows:
+
+![Bouton de création de workflow avec un workflow existant](./img/workflow_create_with_existing.png)
+
+La liste des workflow associés à une entité est présente de cette manière:
+
+![Liste des workflows pour une entité](./img/workflow_list_associated.png)
+
+## Appliquer une décision à un workflow
+
+La page suivante présente le récapitulatif d'un workflow. Elle permet également d'ajouter une décision lorsque l'utilisateur y est autorisé:
+
+![Page récaptulative d'un workflow](img/workflow_page.png)
+
+La page présente, de haut en bas:
+
+* un récapitulatif de l'entité sur laquelle porte le workflow, ainsi que des actions rapides pour l'utilisateur;
+* des boutons personnels pour permettre à l'utilisateur de s'abonner ou se désabonner des notifications;
+* le formulaire de décision, reprenant l'étape précédente et l'éventuel commentaire laissé par l'utilisateur qui a "envoyé" la décision;
+* un historique des décisions précédentes.
+
+
+::: { .note }
+
+Les boutons pour modifier les notifications indiquent l'action possible. Lorsqu'il est indiqué `Ne plus recevoir de notification à l'étape finale`, cela signifie que l'utilisateur reçoit actuellement les notifications, et qu'il peut choisir de ne plus les recevoir.
+
+:::
+
+## Rappel des décisions en attente et listes de workflows
+
+Chaque utilisateur peut voir les workflows pour lesquels il est invité à prendre une décision en utilisant le menu `Utilisateur > mes workflows`. Le nombre de workflow en attente est indiqué dans le menu.
+
+La liste donne accès à plusieurs pages:
+
+* les workflows suivis:
+
+  il s'agit des workflows pour lesquels l'utilisateur a souscrit à des notifications sur les prochaines décisions.
+* les workflows en attente d'action:
+
+  la page reprend les workflows pour lesquels l'utilisateur peut prendre une décision.
+* les workflows clotûrés après l'action d'un autre utilisateur:
+
+  il s'agit des workflows pour lesquels l'utilisateur courant a été indiqué comme pouvant prendre une décision, mais dont la décision a été prise par un autre utilisateur.
+
+* les anciens workflows:
+
+  la page présente les workflows pour lesquels l'utilisateur a pris une décision auparavant.
+