replace variable name

missing values in ThirdParty, Address

.drone.yml

@@ -30,14 +30,14 @@ steps:
   commands:
     - cd user
     - latexmk -pdf -file-line-error -halt-on-error -interaction=nonstopmode -xelatex user-manual.tex
-    - mv user-manual.pdf ../.
+    - mv user-manual.pdf ../Manuel\ utilisateur.pdf
 
 - 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 ../.
+    - mv admin-manual.pdf ../Manuel\ administrateur.pdf
 
 - name: release
   image: plugins/gitea-release
@@ -46,16 +46,14 @@ steps:
       from_secret: gitea_key
     base_url: https://gitea.champs-libres.be
     files:
-      - user-manual.pdf
-      - admin-manual.pdf
-    checksum:
-      - sha512
+      - "Manuel administrateur.pdf"
+      - "Manuel utilisateur.pdf"
     title: ${DRONE_TAG:=latest}
-    when:
-      event:
-      - tag
+  when:
+    event:
+    - tag
 ---
 kind: signature
-hmac: 686b3bf2e6d8ffd370cfde19d9110b6c71af6e2dc4afc3c1b8d7a5016397ee3e
+hmac: dc200b08e09b83e734ff829ac62c7daf5f80986f725edac1b974b07793adb4b0
 
 ...

admin/generation-documents.md

@@ -92,7 +92,8 @@ Les administrateurs fonctionnels peuvent activer les paramètres suivants:
 #### Variables
 
 * `creator`: (User) le créateur;
-* `createdAt` (Date): la date de création;
+* `createdAt` (Date): la date et l'heure de création;
+* `createdAtDate` (Date): la date de la création (sans l'heure). Utilisable pour indiquer la date d'un courrier, par exemple;
 * `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
@@ -147,10 +148,20 @@ Il est possible également d'injecter des dossiers d'usagers, parmi ceux associ
 * 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
+### Documents générés dans le dossier d'une personne: contexte "personne basique"
 
-* une variable `person`, de type Person, avec les variants `relations`, `household` (ménage) et `budget`.
+* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`.
 
+### Documents générés dans le dossier d'une personne: contexte "personne avec un tiers"
+
+Ce contexte permet de générer un courrier avec, en paramètre, un tiers.
+
+Cela peut être utile pour, par exemple, générer un courrier vers un tiers déjà enregistré dans la base de donnée de Chill.
+
+Les variables disponibles sont les suivantes:
+
+* une variable `person`, de type `Person`, avec les variants `relations`, `household` (ménage) et `budget`.
+* une variable `thirdParty`, de type `ThirdParty`;
 
 ## Champs par objet { #sec:gendoc-champs-objets }
 
@@ -199,6 +210,7 @@ ${courseStartDateShort} // 15/01/2021
 * `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;
+* `closingMotive` (ClosingMotive): 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;
@@ -207,7 +219,21 @@ ${courseStartDateShort} // 15/01/2021
 * `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
+* `works` (liste de AccompanyingPeriodWork): liste des actions d'accompagnement créées dans le cadre de ce parcours;
+* `comments` (liste de AccompanyingPeriodComment): liste des commentaires;
+* `pinnedComment` (AccompanyingPeriodComment): commentaire épinglé;
+
+### AccompanyingPeriodComment
+
+* `id` (int): identifiant
+* `content` (texte): contenu du commentaire
+* `createdAt` (Date): date de création
+* `creator` (User): Créateur du commentaire
+
+### AccompanyingPeriodOrigin
+
+* `id` (int): identifiant;
+* `label` (texte): libellé de l'origine;
 
 
 ### AccompanyingPeriodParticipation
@@ -223,13 +249,9 @@ ${courseStartDateShort} // 15/01/2021
 * `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);
+* `comment` (texte): commentaire associé à la personne ressource.
 
 
-### AccompanyingPeriodOrigin
-
-* `id` (int): identifiant;
-* `label` (texte): libellé de l'origine;
-
 ### Activity (échange)
 
 * `id` (int): identifiant;
@@ -275,6 +297,12 @@ Présence à l'échange
 * `id` (int): identifiant;
 * `name` (texte): libellé
 
+### ClosingMotive
+
+* `id` (int): identifiant;
+* `name` (texte): libellé
+
+
 ### Date
 
 * `short` (texte): la date au format dd/mm/yyyy, vide si la date est absente;
@@ -305,6 +333,7 @@ Présence à l'échange
 * `memo` (texte): le mémo
 * `numberOfChildren` (texte): le nombre d'enfants
 * `address` (Adresse): l'adresse actuelle
+* `resources` (PersonResource): les personnes ressources, ajoutées depuis le dossier de l'usager.
 
 ::: { .vendee }
 
@@ -392,21 +421,21 @@ 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.autoriteParentaleFr` (texte)
 * `extras.mineur.autoriteParentaleComment` (Comment): Commentaire (avec la date de la dernire mise à jour)
-* `extras.mineur.identificationAutoriteParentale1` (texte)
-* `extras.mineur.identificationAutoriteParentale2` (texte)
+* `extras.mineur.identificationAutoriteParentale1Fr` (texte)
+* `extras.mineur.identificationAutoriteParentale2Fr` (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.delegationBool` (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.tuteurBool` (bool): TRUE si tuteur
 * `extras.mineur.tuteurThirdParty` (tiers): entité ThirdParty
 * `extras.mineur.administrateurAdhoc` (bool): `true` si administrateurAdhoc
 * `extras.mineur.administrateurAdhocDate` (Date)
@@ -513,6 +542,28 @@ Téléphone du père: ${personFatherFirstphonenumber} // 01 23 45 67 89
 
 ::: { .vendee }
 
+### PersonResource (Ressources associée à l'usager)
+
+Pour rappel, les ressources peuvent être:
+
+* des tiers;
+* des usagers;
+* ou un champ de texte libre.
+
+
+* `comment` (Comment)
+* `freeText` (texte): commentaire, quand la personne ressources un texte libre
+* `id` (int)
+* `kind` (PersonResourceKind): le type de personne ressources (voisin, etc.)
+* `thirdParty` (ThirdParty): le tiers, quand la ressources est liée à un tiers
+* `person` (Person): l'usager, quand la ressources liée à un autre usager
+* `resourceKind` (texte): un discriminateur qui permet de vérifier si la ressources est lié à un usager (alors égal à `person`, un tiers (`thirdparty`) ou un texte libre (`freetext`). A utiliser dans les conditions dans les documents.
+
+### PersonResourceKind (Type de personne ressource)
+
+* `id` (int)
+* `title` (texte)
+
 ### StatutLogement
 
 * `id` (int): identifiant (utile pour des comparaisons);
@@ -591,18 +642,31 @@ Téléphone du père: ${personFatherFirstphonenumber} // 01 23 45 67 89
 * `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);
+* `firstname` (texte): Prénom du tiers;
 * `parent` (ThirdParty): tiers parent (pour les contacts)
 * `profession` (ThirdPartyProfession)
 * `telephone` (texte): numéro de téléphone du tiers
+* `kind` (texte): permet de distinguer les personnes morales, les contacts et les personnes physiques (voir ci-après)
+* `child` (bool) vaut TRUE s'il existe un parent (contact), false sinon;
+* `parent` (ThirdParty): s'il s'agit d'un contact d'une personne morale, contient la fiche d'une personne morale
+
+
+`kind` vaut:
+
+* `company` lorsqu'il s'agit d'une personne morale
+* `child` lorsuq'il s'agit d'un  contact d'une personne morale
+* `contact` lorsqu'il s'agit d'une personne **physique** (à ne pas confondre avec un contact d'une personne morale)
 
 ### ThirdPartyCategory (catégorie de tiers)
 
-TODO
+* `id` (int): identifiant
+* `name` (texte)
+
 
 ### ThirdPartyProfession (profession du tiers)
 
-TODO
+* `id` (int): identifiant
+* `name` (texte)
 
 ### Adresse
 
@@ -620,6 +684,15 @@ TODO
 * `extra` (texte): champs extras
 * `validFrom` (Date): date de début de validité;
 * `validTo` (Date): date de fin de validité (vide si toujours valide);
+* `lines` (liste de texte): les lignes de l'adresses, comme elles devraient être formatées dans une adresses
+
+Il est possible de représenter l'adresse au format postal en effectuant une boucle sur les lignes. Par exemple, pour l'adresse d'une personne (chaque ligne est un "renvoi > substituant" dans l'exemple ci-dessous):
+
+```
+for each="line in v.person.address.lines
+line
+/for
+```
 
 ### Postcode
 
@@ -643,9 +716,16 @@ TODO
 * `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
+* `user_job` (UserJob): 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.
+* `main_location` (Location): 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;
+* `civility` (Civility): la civilité de l'utilisateur;
+
+### UserJob 
+
+* `id` (int): identifiant
+* `label` (texte): nom du métier
+
 
 ### Location (lieu)
 
@@ -717,7 +797,8 @@ Les variables présentent le nom de la relation (`text`), et la personne avec qu
 * `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
+* `evaluations` (AccompanyingPeriodWorkEvaluation): liste des évaluations générées;
+* `referrers` (liste de User): liste des agents traitants;
 
 ### SocialAction (type d'action d'accompagnement)
 

admin/start.md

@@ -0,0 +1,77 @@
+
+# Démarrer la configuration de Chill
+
+A la livraison, Chill ne dispose d'aucune configuration, vous recevez l'instance avec une base de donnée vide.
+
+Voici les premières étapes à configurer pour pouvoir commencer à l'utiliser.
+
+## Se connecter en tant qu'administrateur
+
+Sur la page d'accueil de votre nouvelle instance, utilisez le login d'administration et le mot de passe qui vous a été fourni.
+
+Vous serez alors redirigé vers l'interface d'administration.
+
+## Que faut-il créer ?
+
+### Premier utilisateurs, et les droits minimums
+
+Pour qu'un utilisateur puisse utiliser Chill, voici les opérations à réaliser:
+
+* Créer un Centre. 
+
+  Choisissez un nom qui représente votre service. Si vous n'en utilisez qu'un seul, il ne sera que très rarement visible des utilisateurs.
+
+* Créer un Cercle;
+
+  Si vous choisissez de laisser visibles tous les éléments, il ne sera jamais visualisés par les utilisateurs. Dans le cas inverse, utilisez un nom de service qui soit cohérent avec la séparation que vous voulez réaliser.
+
+* Créer un Groupe de permissions
+
+  C'est sans doute la phase la plus complexe: elle vise à créer un groupe de droits cohérents. Chaque droit s'exerce sur un cercle défini.
+
+  Si vous choississez de laisser accessibles toutes les informations, indiquez les permissions les plus larges, et le cercle que vous avez créé.
+
+* Créer un utilisateur
+
+  Les seuls champs obligatoires sont son nom d'utilisateur (qu'il rentrera pour s'authentifier − il n'est pas sensible à la casse), son adresse de courriel et un libellé (le nom qui s'affichera dans tous les menus). Vous devez également indiquer un mot de passe.
+
+  Les autres champs sont optionnels.
+
+  Une fois créé, associez votre nouvel utilisateur avec le groupe de permission, et le centre.
+
+Avec ces premières étapes, un utilisateur devrait déjà être capable de s'authentifier et, si les droits sont configurés correctement, créer un premier dossier de personne.
+
+### Le nécessaire pour un premier parcours
+
+Continuez pour pouvoir saisir un premier parcours (si vous utilisez cette fonctionnalité):
+
+* Créer un "type de localisation". Le type de localisation permettra d'indiquer le lieu où sera localisé le parcours. Un des types les plus courants est, par exemple, un type "implantation".
+
+  Par la suite, vous pourrez créer des types de lieux pour, par exemple, le "domicile de l'usager", "rendez-vous en hôpital", etc.
+
+* Créer une "localisation", que vous allez attacher au "type de localisation" créé précédemment.
+
+* Créer une "Origine" pour les parcours.
+
+  Par exemple: "Appel téléphonique", "Rencontre en maraude", etc.
+
+* Créer une première "problématique sociale"
+
+  Impossible de confirmer un parcours sans problématique!
+
+* Créer un Métier
+
+  Le métier sera nécessaire pour pouvoir confirmer le parcours. Vous pouvez associer le premier utilisateur créé au métier: il sera plus aisément sélectionné.
+
+Vous êtes maintenant en mesure de créer un usager et un parcours!
+
+### Une première activité !
+
+Pour pouvoir créer une activité (tant dans un parcours qu'auprès d'une personne), ajoutez un "type d'activité".
+
+
+### Une configuration minimale...
+
+Cette première configuration est minimale! Elle suffit pour commencer.
+
+Par la suite, vous pourrez vous plonger dans les différents menus pour alimenter votre instance de Chill et qu'elle soit à votre image.

build-pandoc.sh

@@ -40,6 +40,7 @@ if [ $kind = 'user' ]; then
   "
 elif [ $kind = 'admin' ]; then
   export files="
+    start.md
     generation-documents.md
   "
 else