Add documentation for audit-trail

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.
+
+:::