Module Projets

Le module Projets d'HtkDoli vous permet de consulter, créer et gérer vos projets Dolibarr. Il couvre l'ensemble du cycle de vie d'un projet (Brouillon → Ouvert → Clôturé), avec affichage du budget, des opportunités commerciales associées et des tâches rattachées.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos projets, regroupés ou non en sections selon le tri choisi.

Consultation et Recherche

• Barre de recherche : Recherche par référence, libellé du projet ou nom du tiers associé.
• Tri (icône dédiée dans l'en-tête) :
  • Date (Plus récent)
  • Date (Plus ancien)
  • Nom (A-Z)
  • Nom (Z-A)
• Filtres par statut (icône dédiée), avec compteur affiché en regard de chacun :
  • Tous
  • Brouillon
  • Ouvert
  • Clôturé

Lorsque la recherche est vide, la liste est automatiquement organisée en sections : par lettre initiale (tri par nom) ou par mois de création (tri par date).

Actions sur la liste

• Création rapide : Un bouton « + » dans la barre du haut permet de créer un nouveau projet.
• Glisser pour agir :
  • Balayez une ligne de projet vers la droite pour le modifier.
  • Balayez vers la gauche pour le supprimer (uniquement possible si le projet est à l'état Brouillon).
• Menu contextuel (appui long) :
  • Créer une tâche et Créer un ticket : ces actions ouvrent directement l'éditeur correspondant, pré-rattaché au projet.
  • Modifier.
  • Supprimer (uniquement si le projet est à l'état Brouillon).

Informations affichées (Cartes Projet)

Chaque ligne représentant un projet présente :

• Le libellé du projet.
• La référence du projet sous forme de badge (ex : PJ2404-0001).
• Les dates (début → fin, ou date de début seule, ou à défaut date de création).
• Le tiers associé (nom et logo si disponibles).
• La probabilité d'opportunité (« X% de chance ») ou, à défaut, la réf. client.
• Le statut sous forme de badge coloré (Brouillon, Ouvert, Clôturé).

Pagination et États

• Synchronisation par paquets de 50 projets.
• Pull-to-refresh pour resynchroniser.
• Indicateur de l'état de rafraîchissement (gris/bleu/vert/rouge) dans l'en-tête, qui repasse en « périmé » au-delà de 60 secondes.

Vue Détail (Consultation d'un projet)

En touchant un projet dans la liste, vous accédez à sa fiche complète.

En-tête (Hero Section)

• Référence du projet.
• Libellé.
• Badge de statut.

Informations

• Référence Dolibarr.
• Réf. client (si renseignée).
• Libellé du projet.
• Tiers lié (si renseigné), cliquable pour ouvrir sa fiche lorsque le tiers est présent localement.
• Date de début et date de fin prévisionnelles (si renseignées).
• Créé le et Modifié le.

Budget et opportunité

Cette section regroupe les informations commerciales :

• Projet public : Oui / Non (visibilité dans Dolibarr).
• Temps facturable : Oui / Non.
• Budget estimé.
• Montant opportunité.
• Probabilité de gain (en %).
• Statut opportunité (libellé Dolibarr : prospection, négociation, gagnée, perdue, etc.).

Catégories

Une section dédiée affiche les catégories (tags) associées au projet sous forme de chips colorées (couleur Dolibarr ou bleu par défaut). Chaque chip reprend le libellé de la catégorie.

• Si aucune catégorie n'est rattachée au projet, l'encart « Aucune catégorie associée » s'affiche.
• Le bouton « Modifier les catégories » (ou « Ajouter une catégorie » lorsque la liste est vide) ouvre une feuille modale permettant de :
  • rechercher une catégorie de type projet dans le catalogue Dolibarr ;
  • cocher / décocher chaque catégorie pour la lier ou la délier ;
  • enregistrer en lot via les endpoints POST /categories/{id}/objects/project/{obj_id} et DELETE /categories/{id}/objects/project/{obj_id}.

⚠️ L'accès à la modification des catégories est conditionné par la permission project.creer. La liste se rafraîchit automatiquement à la fermeture de la feuille et lors d'un pull-to-refresh.

Description

Texte descriptif libre du projet. Si vide, un encart « Aucune description fournie. » s'affiche.

Tâches

Liste de toutes les tâches associées au projet, triées par date de début (plus récent en premier). Chaque tâche est cliquable pour ouvrir sa fiche détaillée.

Si aucune tâche n'est associée, un encart d'état vide s'affiche.

Le bouton « Ajouter une tâche » (conditionné par la permission task.creer) permet de créer une nouvelle tâche pré-rattachée au projet.

Documents

Consultation, aperçu PDF, téléchargement et ajout de documents attachés au projet. Le bouton « Ajouter un document » est conditionné par la permission project.creer.

Notes

• Note Publique (visible dans les exports clients si applicable).
• Note Privée (cadenas, usage interne).

Si aucune note n'est renseignée, un encart « Aucune note associée à ce projet. » s'affiche.

Actions disponibles

Depuis l'en-tête flottant :

• Modifier (icône crayon) : Édition complète du projet (si vous disposez du droit project.creer).
• Supprimer (menu « … ») : Suppression définitive (alerte de confirmation).

Un bouton « Rafraîchir » en bas de fiche permet de recharger documents et catégories à la demande.

Création et modification

L'écran de création/modification d'un projet permet de renseigner :

• Le tiers associé (optionnel, via un sélecteur recherchable).
• Le libellé (obligatoire).
• La réf. client.
• La date de début et la date de fin (chacune activable/désactivable par un interrupteur).
• L'indicateur « projet public (partagé) ».
• Le budget, le temps consommé facturable, le montant opportunité, la probabilité (%) et le statut opportunité.
• La description.

⚠️ À la création, la référence est provisoire côté application (PROV-…) ; la référence définitive est attribuée par Dolibarr selon ses masques de numérotation. La création et la modification sont enregistrées localement puis synchronisées en arrière-plan (file d'attente de modifications).

Comportement Métier et Dolibarr

Cycle de vie

• Brouillon (0) : Phase de définition initiale, modifications libres.
• Ouvert (1) : Projet en cours, peut recevoir des tâches, des opportunités, des liens vers devis/commandes/factures.
• Clôturé (2) : Projet terminé. Reste consultable mais n'est plus actif.

Droits et Permissions

• Lecture : Permission de lecture du module Projets requise.
• Création / Modification : Bouton de modification, bouton « + » de la barre du haut, gestion des catégories et ajout de documents conditionnés par la permission project.creer.
• Ajout de tâche : Permission task.creer.

Synchronisation

• Liste paginée par paquets de 50.
• Les tâches associées sont affichées depuis le cache local (rattachées par identifiant de projet).
• Les documents et catégories sont récupérés à l'ouverture de la fiche et à la demande.
• Un système de rafraîchissement automatique vérifie périodiquement la fraîcheur des données et bascule l'état d'icône en conséquence.

Captures d'écran

2 captures — cliquez pour agrandir

Fermer