From 596aaed76ae0c2fad2b8d1f9ae893e29fb1bece6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Fastr=C3=A9?= <julien.fastre@champs-libres.coop>
Date: Fri, 10 Jun 2022 14:18:53 +0200
Subject: [PATCH] first draft about calendar

---
 build-pandoc.sh  |  1 +
 user/calendar.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 user/calendar.md

diff --git a/build-pandoc.sh b/build-pandoc.sh
index 8c5dfa6..478b131 100755
--- a/build-pandoc.sh
+++ b/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
   "
diff --git a/user/calendar.md b/user/calendar.md
new file mode 100644
index 0000000..838c27b
--- /dev/null
+++ b/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.
+
+:::
+