Update user/docs/rendez-vous.md

admin/docs/gestion-des-droits.md

@@ -1,3 +1,220 @@
 # Gestion des droits des utilisateurs
 
-TODO
+## Principes de gestion des droits
+
+La gestion des droits permet de contrôler l'accès à différentes entités: échanges, documents, parcours, actions d'accompagnements, dossiers d'usagers, etc.
+
+Pour conférer ces droits, les administrateurs peuvent créer des groupes de permissions, puis les attribuer à chaque travailleur en fonction de leurs lieux de travail.
+
+## Droits
+
+Les droits sont présentés par des actions, comme "visualiser un échange", "créer un échange", "modifier un échange", etc.
+
+A chaque action dans le logiciel, le droit d'accès correspondant est vérifié.
+
+Les droits sont associés à un territoire et, pour certains, à un service.
+
+Une liste complète des droits est reproduite ci-dessous.
+
+## Concepts mis en jeu pour attribuer les permissions
+
+Différents concepts entrent en jeu dans la gestion des permissions des utilisateurs:
+
+- les droits attribués au niveau du groupe de permissions;
+- les territoires (centres) auxquels sont attachés les usagers;
+- les services auxquels sont attachés les entités manipulées.
+
+Au moment d'accorder la permission, Chill effectue des vérifications:
+
+- sur le territoire: l'utilisateur doit avoir le droit pour le territoire concerné;
+- sur le service: l'utilisateur doit avoir le droit pour le service concerné.
+
+::: {.note }
+
+   Lorsque nous parlons d'entités ci-dessous, nous entendons par exemple "échange", "document", "parcours", "action d'accompagnement", "dossier d'usager", etc.
+
+   Il s'agit donc des éléments manipulés et sécurisés par Chill.
+
+:::
+
+### Territoires (centres)
+
+#### Usagers
+
+Chaque usager est associé à un (et un seul) territoire (centre). 
+
+Au moment de la création de l'usager, son territoire est indiqué. Par la suite, le territoire peut évoluer au cours du temps, mais il ne peut être que dans un seul territoire à la fois.
+
+#### Autres entités
+
+Le territoire des autres entités dépend des usagers qui lui sont associés.
+
+Par exemple, les territoires d'un parcours sont ceux de tous les usagers qui sont concernés par le parcours au moment de sa consultation.
+
+
+### Services
+
+Le service est associé à chaque entité:
+
+- soit manuellement, au moment de la création ou de la modification de l'entité;
+- soit parce que l'entité est attachée à un parcours. Dans ce cas, ce sont les services du parcours qui sont associés à l'entité.
+
+Le tableau ci-dessous présente les différentes manières d'associer un service à une entité:
+
+| Entité                               | Manière d'attribuer le service                                                     |
+|--------------------------------------| ---------------------------------------------------------------------------------- |
+| Échange dans le parcours             | au travers des services du parcours                                                |
+| Échange dans le dossier d'usager     | au moment de l'enregistrement, les utilisateurs associent le service à l'échange   |
+| Document dans le parcours            | au travers des services du parcours                                                |
+| Document dans le dossier d'usager    | au moment de l'enregistrement, les utilisateurs associent le service au document   |
+| Tâches dans le parcours              | au travers des services du parcours                                                |
+| Tâches dans le dossier d'usager      | au moment de l'enregistrement, les utilisateurs associent le service à la tâche    |
+| Rendez-vous dans le parcours         | au travers des services du parcours                                                |
+| Rendez-vous dans le dossier d'usager | pas de service                                                                     |
+| Ressource/charge dans le budget      | il n'y a pas de service associé                                                    |
+| Événement                            | au moment de l'enregistrement, les utilisateurs associent le service à l'événement |
+| Action d'accompagnement              | au travers des services du parcours                                                |
+
+### Entités sans services
+
+Certaines entités sont "sans service": il n'est pas tenu compte de cette vérification au moment d'accorder les droits:
+
+| Entité | Logique de permission                                                                                                                                           |
+| ------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ménage | Il n'y a pas de service associé au ménage. Les utilisateurs doivent avoir le droit de visualiser sur un des usagers du ménage                                 |
+| Ressource / charge dans le budget | Il n'y a pas de service associé. Dès qu'un utilisateur a le droit de visualiser le budget de l'entité, il a le droit de visualiser tous les éléments du budget. |
+| Personnes ressources | Dès qu'un utilisateur a le droit de visualiser l'usager, il peut visualiser les personnes ressources                                                            |
+| Adresses de résidence | Dès qu'un utilisateur a le droit de visualiser l'usager, il peut visualiser les adresses de résidence                                                           |
+
+
+## Distribution des permissions
+
+Les permissions sont distribués via l'interface d'administration:
+
+1. l'administrateur crée des "groupes de permission". Au sein de chaque groupe de permission, il peut attribuer les droits et, éventuellement, le service concerné;
+2. ensuite, il distribué les groupes de permissions à chaque utilisateur, pour un ou plusieurs territoires (centres). Il peut distribuer le même groupe de permission pour un ou plusieurs territoires au même utilisateur. Dans ce cas, l'utilisateur disposera de ces droits dans chacun des territoires: c'est sans doute utile lorsqu'un même travailleur officie dans différents territoires.
+
+Les groupes de permissions peuvent être vus comme des "profils" de travailleurs; ils sont souvent attachés à une fonction: "travailleurs social", "psychologue", "éducateur", etc.
+
+Dès lors, les groupes de permissions comportent des droits et les services dans lesquels ces droits peuvent s'exercer.
+
+L'attribution entre le groupe de permission et le ou les territoires est effectué au niveau de l'utilisateur.
+
+::: { .warning }
+
+  Nous conseillons de ré-utiliser les mêmes groupes de permission pour des profils similaires.
+
+  Par exemple, un "éducateur" peut avoir les mêmes droits qu'un "travailleur social". Dans ce cas, nous conseillons de ne créer qu'un seul groupe de permission, et de le ré-utiliser.
+
+  Cela permet de réduire le nombre de groupes de permission, et donc de faciliter la gestion des droits.
+
+:::
+
+## Liste des droits
+
+Un "S" (non-barré) à la fin indique qu'un service est nécessaire, tandis qu'un "~~S~~" (barré) indique qu'un service n'est pas nécessaire.
+
+Les droits listés après les `:` (deux points) sont les droits hérités. Par exemple, pour modifier un document, il est nécessaire de pouvoir visualiser les détails d'un document. Dès lors, le droit "visualiser les détails du document" est hérité.
+
+### Documents dans les parcours d'accompagnement
+- **Créer un document** (S): Voir les documents, Voir les détails d'un document
+- **Modifier un document** (S): Voir les documents, Voir les détails d'un document
+- **Supprimer un document** (S): Voir les documents, Voir les détails d'un document
+- **Voir les documents** (S)
+- **Voir les détails d'un document** (S): Voir les documents
+
+### Parcours d'accompagnement
+- **Créer un parcours d'accompagnement** (S): Vision simplifiée d'un parcours d'accompagnement, Voir les détails d'un parcours d'accompagnement
+- **Modifier la confidentialité de tous les parcours** (S): Voir les parcours confidentiels
+- **Modifier un parcours d'accompagnement** (S): Vision simplifiée d'un parcours d'accompagnement, Voir les détails d'un parcours d'accompagnement
+- **Réassigner les parcours en lot** (S)
+- **Statistiques sur les parcours d'accompagnement** (S)
+- **Supprimer un pacours d'accompagnement** (S): Vision simplifiée d'un parcours d'accompagnement, Voir les détails d'un parcours d'accompagnement
+- **Vision simplifiée d'un parcours d'accompagnement** (S)
+- **Voir les détails d'un parcours d'accompagnement** (S): Vision simplifiée d'un parcours d'accompagnement
+- **Voir les détails, créer, supprimer et mettre à jour un parcours d'accompagnement** (S): Créer un parcours d'accompagnement, Modifier un parcours d'accompagnement, Supprimer un parcours d'accompagnement, Vision simplifiée d'un parcours d'accompagnement, Voir les détails d'un parcours d'accompagnement
+- **Voir les parcours confidentiels** (S)
+
+### Échange
+- **Créer un échange lié à un parcours** (S): Voir le détail des échanges, Voir un échange
+- **Créer un échange lié à un usager** (S): Voir le détail des échanges, Voir un échange
+- **Liste des échanges** (~~S~~)
+- **Modifier un échange** (S): Voir le détail des échanges, Voir un échange
+- **Statistique des échanges** (~~S~~)
+- **Supprimer un échange** (S): Voir le détail des échanges, Voir un échange
+- **Voir le détail des échanges** (S): Voir un échange
+- **Voir les détails, créer, supprimer et mettre à jour un échange** (S): Modifier un échange, Supprimer un échange, Voir le détail des échanges, Voir un échange
+- **Voir un échange** (S)
+
+### Activité annexe
+- **Statistiques pour les activités annexes** (~~S~~)
+
+### Budget
+- **Créer une ressource/charge** (~~S~~): Voir les ressources/charges
+- **Modifier une ressource/charge** (~~S~~): Voir les ressources/charges
+- **Supprimer une ressource/charge** (~~S~~)
+- **Voir les ressources/charges** (~~S~~)
+
+### Rendez-vous
+- **Créer les rendez-vous** (~~S~~): Voir les rendez-vous
+- **Modifier les rendez-vous** (~~S~~): Voir les rendez-vous
+- **Supprimer les rendez-vous** (~~S~~): Voir les rendez-vous
+- **Voir les rendez-vous** (~~S~~)
+
+### Événement
+- **CHILL_EVENT_STATS** (~~S~~)
+- **Créer un événement** (S): Voir les détails d'un événement, Voir un événement
+- **Modifier un événement** (S): Voir les détails d'un événement, Voir un événement
+- **Voir les détails d'un événement** (S): Voir un événement
+- **Voir un événement** (S)
+
+### Exports
+- **Exécuter des exports et les sauvegarder** (~~S~~): Exécuter et modifier des exports préalablement sauvegardés
+- **Exécuter et modifier des exports préalablement sauvegardés** (~~S~~)
+
+### Ménage
+- **Statistiques sur les ménages** (~~S~~)
+
+### Participation
+- **CHILL_EVENT_PARTICIPATION_STATS** (~~S~~)
+- **Créer une participation** (S)
+- **Modifier une participation** (S): Voir le détail d'une participation, Voir une participation
+- **Voir le détail d'une participation** (S): Voir une participation
+- **Voir une participation** (S)
+
+### Usager
+- **Ajouter des usagers** (~~S~~): Voir les usagers
+- **Ajouter des usagers** (~~S~~): Voir les usagers
+- **Gérer les doublons d'usagers** (~~S~~)
+- **Gérer les doublons d'usagers** (~~S~~)
+- **Liste des usagers** (~~S~~)
+- **Liste des usagers** (~~S~~)
+- **Modifier les usagers** (~~S~~): Voir les usagers
+- **Modifier les usagers** (~~S~~): Voir les usagers
+- **Statistiques sur les usagers** (~~S~~)
+- **Statistiques sur les usagers** (~~S~~)
+- **Voir les usagers** (~~S~~)
+- **Voir les usagers** (~~S~~)
+
+### Documents
+- **Ajouter un document** (S): Voir le détail d'un document, Voir un document
+- **Modifier un document** (S): Voir le détail d'un document, Voir un document
+- **Supprimer un document** (S): Voir le détail d'un document, Voir un document
+- **Voir le détail d'un document** (S): Voir un document
+- **Voir un document** (S)
+
+### Actions d'accompagnement
+- **Créer une action d'accompagnement** (S)
+- **Modifier une action d'accompagnement** (S)
+- **Supprimer une action d'accompagnement** (S)
+- **Voir les actions d'accompagnement** (S)
+
+### Tâche
+- **Créer une tâche pour un parcours** (S): Voir une tâche
+- **Créer une tâche pour un usager** (S): Voir une tâche
+- **Modifier une tâche** (S): Voir une tâche
+- **Supprimer une tâche** (S)
+- **Voir une tâche** (S)
+
+### Workflows (suivi de décision)
+- **Appliquer les transitions sur tous les workflows** (~~S~~)

admin/docs/index.md

@@ -1,3 +1,7 @@
-# Documentation administrateur
+# Accueil
 
-En construction.
+Bienvenue dans le manuel à destination des administrateurs de l'outil CHILL.
+
+Ce manuel est en constante évolution afin de mieux répondre à vos besoins.
+
+N'hésitez pas à nous faire part de vos suggestions d'amélioration ou à signaler toute information qui pourrait être précisée..

mkdocs/hooks/pandoc-to-mkdocs.py

@@ -10,7 +10,7 @@ def on_page_markdown(markdown: str, page, config, files) -> str | None:
     cmd = [
         "pandoc",
         f"--lua-filter={lua_filter_path}",
-        "--to", "markdown"
+        "--to", "gfm"
     ]
 
     try:

pandoc/filters/admonitionTransformer/table.md

@@ -0,0 +1,14 @@
+| Entité                               | Manière d'attribuer le service                                                     |
+|--------------------------------------| ---------------------------------------------------------------------------------- |
+| Échange dans le parcours             | au travers des services du parcours                                                |
+| Échange dans le dossier d'usager     | au moment de l'enregistrement, les utilisateurs associent le service à l'échange   |
+| Document dans le parcours            | au travers des services du parcours                                                |
+| Document dans le dossier d'usager    | au moment de l'enregistrement, les utilisateurs associent le service au document   |
+| Tâches dans le parcours              | au travers des services du parcours                                                |
+| Tâches dans le dossier d'usager      | au moment de l'enregistrement, les utilisateurs associent le service à la tâche    |
+| Rendez-vous dans le parcours         | au travers des services du parcours                                                |
+| Rendez-vous dans le dossier d'usager | pas de service                                                                     |
+| Ressource/charge dans le budget      | il n'y a pas de service associé                                                    |
+| Événement                            | au moment de l'enregistrement, les utilisateurs associent le service à l'événement |
+| Action d'accompagnement              | au travers des services du parcours                                                |
+

user/docs/audit-trail.md

@@ -0,0 +1,69 @@
+# Trace des accès
+
+Le logiciel Chill enregistre les accès aux dossiers pour permettre de retracer quel utilisateur a accédé et modifié les données.
+
+Ces données de consultation ne sont accessibles que par les utilisateurs autorisés. Elles sont conservées pendant six mois (cette durée peut être adaptée par un administrateur technique).
+
+## Consulter les données
+
+Les données sont accessibles via le menu `Section`, nommé `Historique des accès`.
+
+La page permet de visualiser la liste des accès. Elle peut être filtrée par:
+
+- date de l'accès;
+- utilisateur;
+- identifiant du parcours
+- identifiant de l'usager.
+
+::: {.note}
+
+L'identifiant du parcours et de l'usager est accessible via l'interface graphique.
+
+:::
+
+### Données d'un accès
+
+Pour chaque accès, les informations suivantes sont visibles:
+
+- la date de l'accès;
+- l'utilisateur qui a effectué l'accès ;
+- l'élément qui est consulté ou modifié ;
+- si l'accès est la création de l'élément, la visualisation de celui-ci, l'affichage d'une liste, la mise à jour où la suppression ;
+- les éventuelles entités associées ;
+- une éventuelle description, qui permet de mieux comprendre l'action qui a été effectuée par l'utilisateur.
+
+### Notion d'entités associées
+
+Les entités associées sont celles qui participent à un objet et sont pertinentes pour la recherche ou la consultation des accès.
+
+Par exemple, un fichier est associé à un échange, et cet échange est au sein d'un parcours, qui lui-même est associé à différents usagers. Les entités associées seront donc l'échange, le parcours, et les utilisateurs de ce parcours.
+
+::: {.note}
+
+La recherche des accès par identifiant de parcours ou d'usager porte aussi sur les entités associées. 
+
+Ainsi, une recherche par identifiant d'un parcours permettra de visualiser tous les accès à tous les éléments du parcours: autant les échanges que les consultations et modification des actions d'accompagnement.
+
+:::
+
+## Télécharger les données
+
+Depuis la liste des accès, un bouton `Télécharger` permet de télécharger les accès au format `csv` pour une exploitation ultérieure. Le fichier généré récupérera les accès avec les mêmes filtres que ceux appliqués à la liste.
+
+Un maximum de 100 000 lignes est autorisé: si les filtres appliqués sélectionnent un plus grand nombre d'accès, le bouton ne sera pas visible.
+
+## Accorder les accès en consultation des traces
+
+::: { .warning }
+
+Cette opération ne peut être réalisée que par un administrateur fonctionnel.
+
+:::
+
+Les administrateurs fonctionnels peuvent attribuer un droit spécifique "Visualiser l'historique des accès" depuis la fiche de l'usager.
+
+::: { .note }
+
+Le droit de visualisation de l'historique des accès est attribué pour tous les territoires.
+
+:::

user/docs/index.md

@@ -1,3 +1,7 @@
-Documentation utilisateur de chill
+# Accueil
 
-En construction.
+Bienvenue dans le manuel à destination des utilisateurs de l'outil CHILL.
+
+Ce manuel est en constante évolution afin de mieux répondre à vos besoins.
+
+N'hésitez pas à nous faire part de vos suggestions d'amélioration ou à signaler toute information qui pourrait être précisée.

user/docs/rendez-vous.md

@@ -1,7 +1,14 @@
+Cette partie vous explique comment:
+- créer des plages de disponibiltiés pour fixer par la suite des rendez-vous
+- créer créer ou inviter un autre utilisateur à un rendez-vous
+- fixer un rendez-vous avec un usager dans un parcours
+- quelles sont les actions possibles sur un rendez-vous
+
+
 # Comment créer des plages de disponibilité?
 
 
-Ce guide explique comment créer des plages de disponibilité pour fixer par la suite des rendez-vous.
+
 
 * * *
 
@@ -163,7 +170,7 @@ Si l'heure et le lieu vous conviennent, cliquez sur la plage horaire pour réser
 Envoyer un SMS à l'usager
 -------------------------
 
-Il est possible de configurer l'envoi d'un SMS à l'usager concerné par le rendez-vous. Le SMS sera envoyé 48h avant le rendez-vous avec le lieu et l'heure du rendez-vous.
+Il est possible de configurer l'envoi d'un SMS à l'usager concerné par le rendez-vous. Le SMS sera envoyé 48h avant le rendez-vous avec le lieu et l'heure du rendez-vous. Attention, très important: l'usager doit avoir marqué son accord pour l'envoi de SMS. Pour indiquer son accord, allez dans l'univers Usager, puis dans l'onglet Généralités, cliquez sur modifier et en-dessous du champs Numéro de téléphone, cochez la case "L'usager a donné l'autorisation d'utiliser ce no de téléphone pour l'envoi de rappel par SMS".
 
 * * *
 

user/mkdocs.yml

@@ -39,6 +39,7 @@ nav:
         - Exports liés aux évaluations: exports_accompanying_period_work_evaluation.md
     - Evénements: evenements.md
     - Rendez-vous: rendez-vous.md
+    - Historique des accès: audit-trail.md
 
 
 hooks: