first draft about calendar

.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
 ---
 kind: signature
-hmac: 686b3bf2e6d8ffd370cfde19d9110b6c71af6e2dc4afc3c1b8d7a5016397ee3e
+hmac: dc200b08e09b83e734ff829ac62c7daf5f80986f725edac1b974b07793adb4b0
 
 ...

admin/generation-documents.md

@@ -199,6 +199,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;
@@ -275,6 +276,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 +312,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 }
 
@@ -513,6 +521,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);
@@ -645,7 +675,8 @@ TODO
 * `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.
+* `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;
 
 ### Location (lieu)
 
@@ -717,7 +748,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)
 

build-pandoc.sh

@@ -35,6 +35,7 @@ if [ $kind = 'user' ]; then
     social_actions.md
     notifications.md
     tasks.md
+    calendar.md
     workflows.md
     choisir_une_adresse.md
   "

user/calendar.md

@@ -0,0 +1,56 @@
+# Agenda
+
+
+
+## Synchronisation avec les agendas électroniques
+
+::: .warning
+
+La synchronisation avec les agendas électroniques distants est optionnelle et n'est pas active sur toutes les instances.
+
+Pour l'instant, seule une synchronisation avec les agendas de Microsoft Office 365 est possible.
+
+:::
+
+<! -- TODO note pour l'administrateur: les utilisateurs doivent avoir la même adresse email que celle utilisée dans Office 365 -->
+
+### Depuis Chill vers l'agenda distant
+
+Chill permet de synchroniser les rendez-vous sur les agendas distants des utilisateurs. Lorsque cette fonctionnalité est activée:
+
+* chaque plage de disponibilité dans Chill est recopiée dans l'agenda distant de l'utilisateur qui l'a créée;
+* chaque rendez-vous créé dans Chill est copié dans l'agenda distant de l'utilisateur principal du rendez-vous;
+* lorsqu'un utilisateur est invité à un rendez-vous, une invitation est également générée dans l'agenda distant de l'utilisateur invité.
+* lorsqu'un utilisateur répond à une invitation dans Chill, cette réponse est également transférée dans l'agenda distant de l'utilisateur invité.
+
+### Depuis l'agenda distant vers Chill
+
+Chill permet également de synchroniser des modifications effectuée depuis un agenda distant:
+
+* lorsqu'un utilisateur change l'horaire d'une plage de disponibilité ou la supprime depuis l'agenda distant, la modification est répercutée dans Chill: l'horaire de la plage est modifiée ou, si c'est le cas, elle est supprimée (pour autant qu'elle ne soit pas liée à un rendez-vous);
+* lorsqu'un utilisateur déplace l'horaire d'un rendez-vous, la modification est également enregistrée dans Chill: l'horaire du rendez-vous est modifié. 
+
+  Le rendez-vous est alors marqué comme "modifié" dans Chill.
+
+* lorsqu'un utilisateur supprime un rendez-vous dans l'agenda distant, Chill marque le rendez-vous comme "annulé". Il n'indique cependant pas de motif pour l'annulation;
+* lorsqu'un utilisateur répond à une invitation depuis son agenda distant, cette information est également enregistrée;
+* si un utilisateur invite un autre utilisateur de Chill depuis l'agenda distant, cet utilisateur est également ajouté aux "TMS concernés" du rendez-vous.
+
+Il n'est pas possible de créer un rendez-vous depuis l'agenda distant, en dehors de Chill, et que ce rendez-vous soit enregistré automatiquement dans Chill dans le dossier d'un usager ou d'un parcours.
+
+::: .note
+
+**Bon à savoir**
+
+Seule une partie des informations sont reprises depuis l'agenda distant:
+
+* l'heure de début et de fin du rendez-vous ou de la plage;
+* l'éventuelle suppression de la plage;
+* et la réponse à une invitation.
+
+En particulier, les modifications dans la description du rendez-vous, ou la localisation ne sont pas enregistrées dans Chill.
+
+De même, seule la suppression du rendez-vous provoque l'annulation dans Chill. Certains agendas offrent ensuite la possibilité de rétablir un événement déjà annulé, mais cela n'est pas supporté dans Chill: il est nécessaire de re-créer un rendez-vous depuis l'interface de Chill.
+
+:::
+