> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumicoda.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence : Journal d'activité

> Spécifications techniques du moteur de traçabilité : structure des logs, types d'événements et analyse des changements de données.

La ressource **Activités** est le système d'audit central de la plateforme. Elle enregistre chaque action significative pour garantir la transparence de la gestion et permettre la récupération de données en cas d'erreur.

## 1. Typologie des Événements (`event`)

Tiiva catégorise chaque log par un type sémantique associé à un code couleur :

* **Créé (`created`)** : Badge Vert. Nouvel objet ajouté (Contact, Événement, Inscription).
* **Mis à jour (`updated`)** : Badge Orange. Modification d'un objet existant.
* **Supprimé (`deleted`)** : Badge Rouge. Passage en corbeille (Soft Delete).
* **Connexion (`login`)** : Badge Bleu. Accès réussi d'un membre à son portail.

***

## 2. Table de données et Audit

La table est conçue pour une analyse forensique rapide des modifications.

### Colonnes techniques

* **Événement** : Badge de couleur identifiant la nature de l'action.
* **Description** : Phrase lisible résumant l'action métier (ex: "A mis à jour le contact Marc Dupont").
* **Auteur (`causer`)** : Identifie l'administrateur (User) ou le membre (Contact) à l'origine du changement.
* **Modifications** : Affiche le détail des champs impactés.
  * *Comportement* : Pour les mises à jour, Tiiva liste les valeurs "Avant" et "Après" pour chaque propriété modifiée.
* **Date** : Horodatage précis synchronisé sur le fuseau horaire du Tenant.

***

## 3. Système de Filtrage Avancé

* **Par Type de sujet** : Permet d'isoler les logs concernant une ressource précise (ex: ne voir que l'historique des "Présences").
* **Par Nature d'événement** : Isole uniquement les suppressions ou les connexions.
* **Par Période** : Filtre sur une plage de dates précise (du/au).

***

## 4. Logique métier et Rétention

### Structure technique (`properties`)

Les changements sont stockés dans un champ JSON contenant deux clés :

* `old` : Les valeurs présentes en base avant l'action.
* `attributes` : Les nouvelles valeurs enregistrées.

### Sécurité et Isolation

* **Visibilité** : Le journal est accessible uniquement aux profils possédant les droits d'audit (généralement restreint au Super Admin).
* **Partitionnement** : Chaque ligne est marquée d'un `tenant_id`. Un administrateur ne peut jamais auditer les actions d'une autre organisation.
* **Intégrité** : Le journal d'activité est une ressource en "lecture seule". Aucune entrée ne peut être modifiée ou supprimée manuellement depuis l'interface.