APAJH — Documentation

Apparence

Journal des actions ​

Les créations, modifications et suppressions réalisées par l'API sur les fiches salariés, leurs contrats et leurs affectations, sur les absences, et sur les journées modulées du planning et sur les demandes de modification de planning — ces deux dernières aussi quand elles sont écrites au back-office. Ce journal permet de retrouver qui a changé quoi, sur quel objet et à quel moment.

Pour qui : un super-utilisateur, ou un compte avec le statut équipe et la permission audit.view_actionlog · Où : section Audit du menu

Écrans couverts : Journal des actions

Les colonnes, filtres, champs de recherche et droits sont dans la référence des écrans.

Comprendre ​

  • Une ligne correspond à une écriture qui a réellement modifié une ressource. Réenregistrer une fiche sans changer sa valeur ne produit pas de ligne.
  • Une journée modulée (« modification de planning ») porte ses créneaux dans la clé slots : heures, poste, établissement, pause et options de chacun.
  • L'Identité de l'acteur est figée au moment de l'action. Elle reste lisible si le compte est renommé ou supprimé ; le lien Acteur devient alors vide.
  • Le Type d'objet, son Identifiant et sa Représentation désignent la ressource métier. Le journal ne conserve ni l'adresse IP, ni l'URL appelée.
  • Les Modifications montrent les valeurs before et after. Une création n'a pas de valeur before ; une suppression n'a pas de valeur after.

Retrouver une modification ​

  1. Ouvrez Journal des actions.

  2. Filtrez par Action, Type d'objet, Acteur ou Date de l'action.

  3. Utilisez la recherche pour retrouver une identité, un libellé d'objet ou un identifiant précis.

  4. Ouvrez la ligne voulue.

  5. Lisez les Modifications pour comparer chaque valeur avant et après.

    ✅ Vous devriez voir l'identité qui a réalisé l'action, l'objet ciblé, la date et uniquement les données dont la valeur a changé.

Points d'attention ​

  • Le journal contient des données personnelles. Les anciennes et nouvelles valeurs sont conservées sans masquage. N'accordez audit.view_actionlog qu'aux membres de l'équipe qui en ont besoin.
  • Aucune ligne n'est modifiable ou supprimable depuis le back-office, y compris par un super-utilisateur.
  • Les actions réalisées directement dans le back-office sont dans le journal d'administration natif de Django, pas ici — sauf sur les modifications de planning et les demandes de modification de planning, dont chaque écriture rejoint aussi ce journal, avec ses créneaux.
  • Une purge automatique retire chaque dimanche les lignes ayant dépassé la durée définie par AUDIT_LOG_RETENTION_DAYS — 1 095 jours dans la configuration de référence.