> ## 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 : Requêtes

> Spécifications techniques du module de gestion des demandes membres : flux de validation, analyse des deltas et archivage.

La ressource **Requêtes** sert d'interface de validation entre les modifications soumises par les membres sur leur portail et la base de données officielle. Elle garantit l'intégrité de l'annuaire par une relecture humaine systématique.

## 1. Typologie technique (`type`)

Chaque requête est catégorisée pour adapter son traitement administratif :

* **Modification (`modification`)** : Signalement de changement de coordonnées civiles ou de contact.
* **Ajout d'enfant (`children`)** : Demande de création d'un lien de parenté vers un nouveau profil mineur.
* **Question (`question`)** : Message de support libre envoyé au secrétariat.

***

## 2. Table de données et Suivi

La table est configurée pour prioriser le traitement des dossiers en souffrance.

### Indicateurs de Statut

* **En attente** : Représenté par une icône **Horloge** (<iconify-icon inline icon="heroicon-o-clock" />). La valeur `status` est nulle en base.
* **Terminé** : Représenté par une icône **Coche** (<iconify-icon inline icon="heroicon-o-check-circle" />). La valeur `status` est égale à `done`.

### Colonnes techniques

* **Propriétés** : Affiche les données de la requête formatées en HTML.
  * *Comportement* : Pour les modifications, Tiiva souligne et met en évidence uniquement les champs qui diffèrent de la valeur actuelle en base.
* **Auteur (`causer`)** : Identifie le contact physique ayant soumis la demande.
* **Date (`created_at`)** : Horodatage relatif (ex: "il y a 2 heures").

***

## 3. Système de Filtrage

* **À faire uniquement** : Filtre actif par défaut masquant toutes les requêtes déjà classées (`status is null`).
* **Par Type** : Permet d'isoler les flux (ex: traiter toutes les questions de support en une seule session).

***

## 4. Actions de gestion

### Actions de ligne

* **Marquer comme terminé** :
  * *Effet* : Bascule le `status` à `done` et enregistre l'horodatage actuel dans `read_at`.
  * *Audit* : Mémorise l'ID de l'administrateur ayant effectué l'action de clôture.

***

## 5. Logique métier et Sécurité

### Le stockage JSON

Les données soumises sont persistées dans un champ JSON `properties`. Tiiva n'applique jamais automatiquement ces données aux fiches contacts pour éviter les usurpations d'identité ou les erreurs de saisie. La modification du contact reste une action manuelle déclenchée par l'administrateur après vérification de la requête.

### Isolation

Les requêtes sont strictement liées au `tenant_id` de l'organisation. Un administrateur ne voit que les demandes concernant les membres de son propre club.