Registre opérateur

Le registre opérateur regroupe, pour un utilisateur Dolibarr donné, toutes les pièces et consommables qu'il a saisis ou validés en tant qu'opérateur certifié sur des interventions SmartInterventions. Il répond aux obligations réglementaires françaises et européennes pour les fluides frigorigènes (F-Gas règlement UE 517/2014, décret français 2015-1790) et les biocides / phytosanitaires (certibiocide, certiphyto).

À quoi sert le registre

Trois usages principaux :

• Conformité réglementaire -- Les opérateurs habilités fluides ou biocides doivent pouvoir produire à tout moment un journal de leurs actes (charge, récupération, traitement) avec la date, le client, le numéro de lot, la quantité, le matériel concerné et la catégorie de certification requise.
• Audit interne -- Un manager qui veut vérifier l'activité d'un opérateur (volume de fluide manipulé sur le mois, surfaces traitées en biocide, équipements installés) consulte la même vue.
• Contrôle externe -- En cas d'inspection (DREAL, DDPP), le registre peut être exporté en CSV et fournit une trace horodatée immédiatement consultable.

Accès et permissions

Le registre opérateur est accessible depuis :

• la page de consultation transverse partline_registry_operator.php (sélecteur d'opérateur en haut),
• l'API REST GET /smartinterventions/operator/{id}/partlines pour une consommation programmatique.

La page de registre exige la permission smartinterventions->partline->admin (dans tous les cas, y compris pour son propre registre). La route REST, elle, est ouverte avec smartinterventions->partline->read.

La fiche utilisateur Dolibarr porte par ailleurs un onglet "Certifications" (distinct du registre) pour gérer les certifications de l'utilisateur.

Contenu du registre

Chaque ligne du registre porte les informations suivantes :

• date de l'intervention,
• référence et nom du client,
• numéro et titre de l'intervention,
• produit (référence, libellé),
• rôle de la ligne (consommable, nouvel équipement, pièce de remplacement, dépose seule),
• quantité et unité,
• numéro de lot ou numéro de série (selon la traçabilité du produit),
• numéro de lot déposé (pour les dépose seules, fluides récupérés notamment),
• date de péremption éventuelle,
• équipement parent (pour les pièces de remplacement ou les nouvelles poses),
• catégorie de certification minimale requise par le produit,
• pour les biocides : dose appliquée, surface traitée, cible (espèce ou nuisible).

Les lignes sont triées par date décroissante. Les filtres disponibles sont : période (date début / date fin), type de produit (fluide, biocide, autre), client, statut (brouillon, validée, annulée).

Export CSV

Le registre se télécharge en CSV depuis le bouton CSV de la page : format texte, encodage UTF-8, séparateur point-virgule, compatible Excel, LibreOffice et Google Sheets. Chaque colonne est un champ logique (pas de mise en forme), prêt pour un import dans un outil tiers ou un tableur d'analyse.

L'export respecte le filtre actif au moment du clic (opérateur, périmètre).

Catégories de certification

Les catégories de certification reconnues par le module sont :

• I, II, III, IV -- Catégories fluides frigorigènes selon le règlement européen F-Gas. La catégorie I autorise tous les actes sur les équipements contenant des fluides fluorés ; la catégorie IV ne couvre que la récupération sur de petits équipements scellés.
• CERTIBIOCIDE -- Certificat individuel pour l'achat et l'utilisation de produits biocides à usage professionnel.
• CERTIPHYTO_DECIDEUR, CERTIPHYTO_APPLICATEUR -- Certificats individuels phytosanitaires (décideur ou applicateur en collectivité, exploitation agricole, entreprise).

La catégorie courante d'un opérateur est portée par l'extrafield frigorist_cert_cat de la fiche utilisateur. Elle peut être modifiée à tout moment par un administrateur. Le registre ne fige pas la catégorie de l'opérateur ligne par ligne : la colonne "Catégorie de certification" affiche la catégorie minimale requise par le produit (min_cert_cat), pas la catégorie détenue par l'opérateur au moment de la saisie.

Mode strict ou mode avertissement

Le module dispose d'un paramètre global SMARTINTERVENTIONS_OPERATOR_CERT_ENFORCE :

• 0 (défaut) -- Mode avertissement : une ligne dont l'opérateur n'a pas la catégorie requise est acceptée, mais un message est affiché côté front et un avertissement est journalisé côté serveur.
• 1 -- Mode strict : la même ligne est refusée avec une erreur OperatorCategoryInsufficient (HTTP 400). L'opérateur doit corriger sa catégorie ou désigner un confrère habilité avant de valider.

Le passage en mode strict se fait en posant la constante SMARTINTERVENTIONS_OPERATOR_CERT_ENFORCE à 1 directement en base : elle n'est pas exposée dans l'interface de configuration.

FAQ

Que se passe-t-il si un opérateur change de catégorie ?

La catégorie de l'opérateur vit sur sa fiche utilisateur (frigorist_cert_cat) et sert au contrôle de conformité au moment de la saisie. Le registre ne stocke pas de catégorie historique par ligne : il affiche, pour chaque produit, la catégorie minimale requise. Une modification de la catégorie de l'opérateur s'applique donc aux contrôles des saisies suivantes.

Peut-on consulter le registre d'un opérateur qui a quitté l'entreprise ?

Oui, tant que sa fiche utilisateur Dolibarr n'a pas été définitivement supprimée. Désactiver l'utilisateur (statut "Inactif") suffit à interdire toute nouvelle saisie tout en préservant son registre.

Le registre couvre-t-il les pièces hors catalogue ?

Oui, les lignes saisies en mode "Hors catalogue" (libellé libre, fk_product = NULL) apparaissent dans le registre avec un libellé descriptif au lieu d'une référence catalogue. Elles sont distinguables grâce à la colonne dédiée.

Comment justifier d'une rétention de fluide récupéré ?

Saisir une ligne en rôle "dépose seule" (removed_only) avec le fluide récupéré comme produit, la quantité récupérée en kilogrammes et le numéro de bouteille de récupération dans removed_batch_number. Le devenir de la dépose est sélectionné via le sélecteur "Devenir" (retour fournisseur sous garantie, détruite, recyclée, etc.).