Pointage (temps de travail)

Le pointage enregistre le temps réellement passé sur une intervention, par technicien, sous forme de sessions (un début, une fin). Il alimente le coût de main-d'œuvre et les indicateurs de productivité du tableau de bord de pilotage.

Contrairement à une mesure déduite des changements de statut, le pointage repose sur des sessions explicites : cela permet plusieurs passages (pauses, reprises), plusieurs techniciens sur une même intervention, et la correction manuelle d'un oubli.

Activation

La fonctionnalité est désactivée par défaut. Dans Configuration du module > onglet Pilotage :

Activer le pointage : met en service la capture des sessions, l'exposition par l'API et l'affichage du temps passé.
Coût horaire de main-d'œuvre par défaut : taux utilisé quand un technicien n'a pas de coût horaire moyen renseigné sur sa fiche utilisateur (champ "coût horaire moyen" de Dolibarr).
Durée maximale avant clôture automatique : au-delà de cette durée (24 h par défaut), une session restée ouverte (oubli du "Je termine") est clôturée par la tâche planifiée pour éviter de fausser les indicateurs.

Fonctionnement

Une session ouvre un compteur pour un technicien sur une intervention.
Un technicien n'a qu'une seule session ouverte à la fois : démarrer une nouvelle session clôture automatiquement la précédente (elle n'est pas perdue).
À la clôture, la durée est calculée et la session devient définitive ; elle peut encore être corrigée ou annulée.

Pas encore d'écran dédié. Les sessions n'ont aujourd'hui aucune page back-office : elles se consultent et se corrigent uniquement par l'API du module. Le bloc "Temps passé" sur la fiche d'intervention est prévu pour une version ultérieure (voir "Périmètre actuel" en bas de page).

Le coût de main-d'œuvre est calculé côté serveur (somme des durées x coût horaire de chaque technicien). C'est une donnée sensible : elle n'est jamais exposée au technicien ni dans l'application mobile ; seul le total agrégé est restitué côté back-office, au responsable.

Droits

Consulter les sessions de pointage (timesheet / read).
Démarrer/arrêter et corriger les sessions (timesheet / write).
La saisie ou la correction du temps pour un autre technicien (correction back-office) est réservée aux profils administrateur ou répartiteur (droit dispatch) : avec le seul droit timesheet / write, un technicien ne peut pointer que pour lui-même.

Tâche planifiée

Une tâche "Clôture automatique des sessions de pointage oubliées" est fournie, désactivée par défaut. Activez-la dans Accueil > Configuration > Tâches planifiées en même temps que le pointage si vous souhaitez la sécurité anti-oubli.

Périmètre actuel

Sont disponibles : la capture des sessions, l'invariant "une session ouverte par technicien", le calcul du coût (back-office), la correction manuelle, la tâche de clôture et l'API.

Sont prévus pour une version ultérieure : le bouton chronomètre "Je commence / Je termine" directement dans l'application mobile (avec fonctionnement hors ligne) et un bloc "Temps passé" sur la fiche d'intervention back-office.