Module Interventions (Fiches d'intervention)

Le module Interventions d'HtkDoli est conçu pour les techniciens en mobilité. Il permet de consulter, créer et compléter une fiche d'intervention sur le terrain, d'enregistrer le temps passé via un chrono, de faire signer le client et de convertir directement l'intervention en facture.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de toutes les interventions, triées par défaut de la plus récente à la plus ancienne.

Consultation et Recherche

• Barre de recherche : Recherche par référence d'intervention ou nom du tiers.
• Tri :
  • Date (Récent → Ancien) — tri par défaut
  • Date (Ancien → Récent)
  • Référence
• Filtres par statut, avec compteur affiché en regard de chaque filtre :
  • Tous
  • Brouillon (statut 0)
  • Validée (statut 1)
  • Facturé (statut 2)
  • Traitée (statut 3)
• Affichage groupé : Les interventions sont regroupées par mois et année (ex : Février 2024) lors d'un tri par date, ou par initiale lors d'un tri par référence. Une bulle flottante indique la section courante pendant le défilement.

Informations affichées (Cartes Intervention)

Chaque ligne représente une intervention avec :

• Le nom du tiers (ou ses initiales / son logo si disponible).
• Sa référence (badge).
• Sa date prévisionnelle ou, à défaut, de création.
• Sa description courte si renseignée.
• Sa durée totale si elle est supérieure à zéro.
• Son statut sous forme de pastille colorée.

Actions rapides (Glissement / Swipe)

• Glissez vers la droite pour Modifier l'intervention.
• Glissez vers la gauche pour Supprimer l'intervention (uniquement pour les brouillons, statut 0).
• Un appui long (menu contextuel) propose : Voir le PDF, Valider (brouillons), Modifier, Supprimer (brouillons).

Pagination

• Liste paginée par paquets de 50 avec bouton « Charger plus ».
• Pull-to-refresh disponible, ainsi qu'un bouton de rafraîchissement dans l'en-tête.
• Raccourci clavier Cmd + R (rafraîchir) et Cmd + N (nouvelle intervention) avec un clavier externe.

Vue Détail (Consultation d'une intervention)

En-tête (Hero Section)

• Référence de l'intervention.
• Tiers concerné.
• Badge de statut (Brouillon, Validée, Facturé, Traitée).

Bannière Chrono (si actif)

Si un chrono est en cours sur l'intervention, une bannière en haut de la fiche affiche :

• Une icône de timer pulsée.
• Le temps écoulé au format hh:mm:ss, actualisé chaque seconde.
• Un bouton Arrêter qui clôt le chrono et ouvre la feuille de saisie de temps pré-remplie avec la durée mesurée.

Workflow (actions de cycle de vie)

Les actions disponibles dépendent du statut :

Statut Brouillon (0)

• Valider : Passe l'intervention au statut Validée.

Statut Validée (1)

• Marquer Traitée : Clôture l'intervention (passage au statut suivant).
• Faire signer le client : Ouvre un pavé de signature, capture la signature et l'attache à l'intervention.
• Convertir en Facture : Crée une facture client brouillon à partir de l'intervention.

Statut Facturé (2)

• Repasser en Validée : Permet de rouvrir l'intervention.
• Faire signer le client.
• Convertir en Facture.

Statut Traitée (3)

• Repasser en Validée : Permet de rouvrir l'intervention.

Statut > 3 (verrouillé)

• Aucune action disponible. Mention « Intervention facturée ou verrouillée ».

Outils

• Cloner / Dupliquer : Crée une nouvelle intervention brouillon avec le même tiers, la même description et les mêmes lignes.

Actions

• Voir le PDF : Aperçu du document PDF de l'intervention. Si aucun PDF n'a encore été généré côté serveur, un lien permet d'ouvrir la fiche dans Dolibarr web pour le générer.
• Voir sur Web : Ouvre la fiche dans l'interface Dolibarr web.

Informations

• Tiers concerné (cliquable, navigue vers la fiche du tiers).
• Projet lié (cliquable).
• Date de l'intervention (avec un bouton crayon pour Replanifier, réservé aux brouillons).
• Durée totale.
• Date de création.

Description

Texte libre décrivant le travail à effectuer.

Lignes d'intervention

Liste détaillée des opérations / produits / temps consommés pour cette intervention. Sur une intervention modifiable, un appui sur une ligne permet de la modifier.

Contacts

Liste des contacts associés (technicien, suiveur, contact client sur site…), avec leur rôle. Bouton « Ajouter un contact » et possibilité de délier un contact (icône corbeille). L'ajout propose de choisir un contact du tiers et un rôle : Contact Client (défaut), Facturation, Responsable Suivi.

Documents

Consultation, aperçu PDF, téléchargement et ajout de documents (dont la signature client une fois capturée).

Notes

• Note Publique (visible des clients).
• Note Privée (usage interne).
• Sur une intervention distante, un bouton crayon permet d'éditer rapidement les deux notes.

Actions de l'en-tête flottant

• Modifier : Ouvre l'écran d'édition complète. Le bouton n'apparaît qu'avec la permission ficheinter.creer. Si l'intervention n'est pas modifiable (statut autre que Brouillon ou Validée), une alerte propose, le cas échéant, de la repasser en Validée ; si elle est facturée (statut > 3), elle ne peut plus être modifiée.
• Menu (•••) :
  • Ajouter au calendrier : Crée un événement dans l'agenda iOS local.
  • Démarrer le chrono (uniquement si statut Validée et aucun chrono en cours).
  • Supprimer (permission ficheinter.supprimer).

Replanifier

Une feuille dédiée permet de modifier rapidement la date et l'heure de l'intervention sans rouvrir l'écran complet d'édition.

⚠️ Uniquement sur un brouillon. La date d'une intervention est calculée par Dolibarr d'après celle de ses lignes ; replanifier revient donc à décaler toutes les lignes du même écart, ce que le serveur refuse dès que l'intervention est validée. Le bouton n'apparaît pas dans ce cas. Une intervention sans ligne n'a pas non plus de date à décaler, et l'application le signale.

Saisie de Temps Passé

Au-delà du chrono, une feuille dédiée (« Saisir du temps ») permet la saisie manuelle d'une période :

• Durée (heures + minutes).
• Description (optionnelle).

Cette action ajoute une nouvelle ligne à l'intervention et met à jour la durée totale.

Le chrono démarré sur le terrain est sauvegardé localement (dans les réglages de l'appareil) : si l'application est mise en arrière-plan ou redémarrée, le compteur reprend correctement à la reprise. Sur iOS 16.1 et plus, une Live Activity affiche le chrono en cours.

Signature Client

L'action Faire signer le client ouvre un pavé tactile :

• Le client signe directement à l'écran.
• La signature est convertie en JPEG.
• Le fichier est automatiquement attaché à l'intervention dans Dolibarr, avec un nom standardisé incluant la référence d'intervention et un horodatage.

⚠️ La signature est mise en file d'attente puis propagée au serveur lors de la prochaine synchronisation.

Création et modification

L'écran d'édition (InterventionEditView) permet de renseigner toutes les informations de l'intervention :

• Tiers (sélection obligatoire à la création ; le tiers d'une intervention existante ne peut pas être changé, limite de l'API Dolibarr).
• Statut (Brouillon, Validée, Facturé).
• Date et heure de début, avec calcul automatique d'une fin estimée d'après la durée des lignes. Modifiable à la création seulement : sur une intervention existante, le champ est désactivé, la date se déplaçant par les lignes (voir « Replanifier »).
• Référence client.
• Description.
• Projet et Contact liés.
• Notes publique et privée.
• Lignes d'intervention : produit/service (optionnel), description, date, quantité, taux de TVA et durée (heures/minutes). La durée totale est recalculée automatiquement.

⚠️ L'enregistrement nécessite au moins une ligne. À la création, un tiers est obligatoire.

L'écran de création apparaît également depuis le bouton « + » de la barre du haut de la liste (permission ficheinter.creer).

Comportement Métier et Dolibarr

Cycle de vie

• Brouillon (0) : Saisie initiale. Modification et suppression libres.
• Validée (1) : Intervention confirmée ; le chrono peut tourner. Modification encore possible.
• Facturé (2) : Intervention clôturée / facturée.
• Traitée (3) : Intervention marquée comme traitée.
• > 3 : Verrouillée, plus aucune action.

⚠️ Dans Dolibarr, la numérotation des statuts d'une fiche d'intervention ne suit pas un ordre linéaire évident : le statut 2 correspond à « Facturé » et le statut 3 à « Traitée ». HtkDoli reprend fidèlement cette correspondance.

Couleurs des statuts

• Brouillon : gris.
• Validée : bleu.
• Facturé : vert.
• Traitée : bleu.

Droits et Permissions

• Lecture : Permission de lecture du module Interventions requise pour accéder à la liste.
• Création / Modification : Permission ficheinter.creer.
• Suppression : Permission ficheinter.supprimer.

Synchronisation

• Liste paginée (50 par page).
• Les documents et contacts sont chargés à l'ouverture de la fiche.
• Les créations, modifications, transitions de statut, ajouts de temps, clonages, conversions en facture et signatures passent par une file d'attente locale propagée au serveur lors de la synchronisation.
• Le chrono dispose d'un état persistant local : il survit aux redémarrages de l'application.

Captures d'écran

3 captures — cliquez pour agrandir

Fermer