---
title: "Configuration"
weight: 20
description: "Paramétrer les pastilles de durée, le filtrage des services et le secret de signature des QR."
---

# Configuration

La page de configuration est accessible depuis **Accueil > Configuration > Modules > Saisie de temps projet (mobile) > onglet Configuration**.

![Page de configuration du module avec les pastilles de durée et le filtre des services](screenshots/configuration-generale.webp)

## Pastilles de durée

Liste séparée par des virgules des durées à afficher comme boutons sur la page mobile, en minutes. Par défaut : `15,30,60,120`.

Vous pouvez ajouter ou retirer des valeurs librement. Une pastille **Autre** (avec champ libre en minutes) est toujours présente en plus de votre liste, indépendamment de la configuration. Si vous laissez la liste vide ou n'entrez que des valeurs non valides, la liste précédente est conservée et un avertissement est affiché.

Exemples utiles selon votre activité :

- `15,30,60,120` (défaut) -- granularité quart d'heure jusqu'à 2 h.
- `30,60,90,120,240` -- granularité demi-heure jusqu'à 4 h pour des sessions longues.
- `5,10,15,30,60` -- granularité fine pour du support ou du dépannage.

## Services proposés

La page mobile affiche un menu déroulant pour associer une ligne de temps à un service (au sens "produit de type Service" dans Dolibarr). Le module propose trois modes de filtrage de cette liste :

- **Tous les services** : tous les produits de type Service marqués "à vendre" dans Dolibarr apparaissent dans la liste. Pratique si vous avez peu de services.
- **Services d'une catégorie** : seuls les services rattachés à la catégorie choisie apparaissent. Utile si vous avez beaucoup de services et que vous voulez n'exposer que ceux dédiés à la facturation au temps passé.
- **Liste manuelle de services** : vous choisissez explicitement les services à exposer dans le menu déroulant. Mode le plus restrictif et le plus précis.

Si le mode "Services d'une catégorie" est choisi sans catégorie sélectionnée, ou si le mode "Liste manuelle" est choisi sans service coché, un avertissement est affiché à l'enregistrement et aucun service n'apparaîtra sur la page mobile (le menu déroulant sera absent et chaque ligne sera saisie sans `fk_product`).

![Sélecteur de services avec les trois modes de filtrage](screenshots/configuration-services.webp)

## Secret de signature du QR

Le module signe les URL des QR codes avec un secret HMAC stocké en base. Ce secret est généré aléatoirement à la première activation et n'est plus régénéré ensuite, sauf demande explicite.

- **Configuré** (badge vert) : tout va bien, les QR sont signés.
- **Manquant** (badge rouge) : le secret n'est pas en base. Réactivez le module pour le regénérer.

Le bouton **Régénérer le secret** invalide immédiatement tous les QR codes en circulation. À utiliser dans deux cas :

- Vous avez photographié l'écran d'un QR et la photo a fuité (peu probable mais possible).
- Vous voulez forcer tous les utilisateurs à re-scanner depuis leur poste de travail (par exemple après un changement d'organisation).

Une boîte de dialogue de confirmation s'affiche avant la régénération. Après confirmation, les téléphones qui tenteront de réutiliser un ancien lien recevront une page "Lien expiré".

## Validité des liens

Chaque QR code généré sur la page de saisie des temps d'une tâche est valable **24 heures**. Au-delà, le téléphone doit re-scanner depuis le poste. Cette durée est volontairement non configurable : 24 h couvre largement le cas "je saisis mes temps pendant une session", sans laisser un lien exploitable indéfiniment si quelqu'un photographie l'écran.