# InfraSProject

Suivi du temps sur les tâches du projet et les frais professionnels.

# 1. PRÉSENTATION DU MODULE

# Présentation du Module

# [![InfraSProject.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/YkrFeTWNMmNa2E0f-infrasproject.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/YkrFeTWNMmNa2E0f-infrasproject.png)

***InfraSProject***<span style="white-space: pre-wrap;"> est un module optionnel pour </span>***Dolibarr*** **ERP &amp; CRM**<span style="white-space: pre-wrap;"> développé par </span>**InfraS**<span style="white-space: pre-wrap;">. Il apporte des améliorations significatives à la gestion native des projets de </span>***Dolibarr***.

#### **PRINCIPALES AMÉLIORATIONS**

- Gestion des consommations de stock par projet/chantier
- Calcul automatique du bénéfice provisoire
- Intégration des coûts de stock dans le coût du projet
- Liaison des consommations / utilisateurs (EPI, outillage)
- Analyse par mois et par consommateur
- Répartition des lignes de facture fournisseur sur différents projets
- Vue d'ensemble enrichie avec indicateurs financiers

# 2. INSTALLATION ET ACTIVATION

# Installation et Activation

#### **1.PRÉREQUIS :**

- **Dolibarr :**<span style="white-space: pre-wrap;"> version minimum selon le changelog du module</span>
- **PHP :**<span style="white-space: pre-wrap;"> version minimum selon le changelog du module</span>
- **Extension PHP XML :**<span style="white-space: pre-wrap;"> activée (recommandée)</span>
- **Modules Dolibarr requis :**<span style="white-space: pre-wrap;"> Projets (modProjet), Stock (modStock)</span>

#### **2.PROCÉDURE D'INSTALLATION :**

1. <span style="white-space: pre-wrap;">Copier le dossier </span>`<span class="editor-theme-code">"infrasproject"</span>`<span style="white-space: pre-wrap;"> dans le répertoire </span>`<span class="editor-theme-code">"htdocs/custom/"</span>`<span style="white-space: pre-wrap;"> de Dolibarr</span>
2. Se connecter à Dolibarr en tant qu'administrateur
3. <span style="white-space: pre-wrap;">Aller dans </span>**Accueil → Configuration → Modules/Applications**
4. <span style="white-space: pre-wrap;">Rechercher </span>**"*****InfraSProject*****"**<span style="white-space: pre-wrap;"> ou </span>**"Gestion avancée des projets"**
5. <span style="white-space: pre-wrap;">Cliquer sur le bouton </span>**"Activer"**

<p class="callout info">**Note importante :**<span style="white-space: pre-wrap;"> À l'activation, le module crée automatiquement les tables nécessaires et sauvegarde ses paramètres. À la désactivation, une sauvegarde automatique des paramètres est effectuée pour faciliter la réactivation.</span></p>

# 3. CONFIGURATION

# Configuration du Module

<span style="white-space: pre-wrap;">📍 Accès : Menu </span>**Outils → InfraS → InfraSProject**

Le module propose deux onglets de configuration principaux pour une personnalisation complète de son comportement :

#### **1.PARAMÈTRES DOLIBARR**

📂 Accès : Menu Outils → InfraS → Paramètres Dolibarr  
🔒 Permission requise : "Modifier les paramètres Dolibarr"

**Options disponibles :**

[![Doliparams.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/wdcyUlPOcbTd5DUk-doliparams.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/wdcyUlPOcbTd5DUk-doliparams.png)

#### **2.PARAMÈTRES GÉNÉRAUX DU MODULE**

📂 Accès : Menu Outils → InfraS → Paramètres généraux  
🔒 Permission requise : "Modifier les paramètres principaux du module"

**💾 Sauvegarde / Restauration**

- Télécharger un fichier de sauvegarde des paramètres
- Restaurer une configuration précédemment sauvegardée
- Copie de sécurité automatique dans le répertoire d'administration

**Paramètres du module :**

[![proj1.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/6z4RKukqxzE75SCg-proj1.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/6z4RKukqxzE75SCg-proj1.png)

# 4. GESTION DES PERMISSIONS

# Gestion des Permissions

<span style="white-space: pre-wrap;">Le module propose </span>**6 permissions distinctes**<span style="white-space: pre-wrap;"> pour une gestion fine des droits d'accès et de modification. Chaque permission peut être attribuée individuellement aux utilisateurs ou groupes.</span>

<table id="bkmrk-permissioncodedescri"><colgroup><col></col><col style="width: 124px;"></col><col></col></colgroup><tbody><tr style="height: 35px; background-color: rgb(2, 121, 145); color: rgb(255, 255, 255);"><th>Permission

</th><th>Code

</th><th>Description

</th></tr><tr><td>Afficher le menu secondaire vers les paramètres du module

</td><td>**paramMenu**

</td><td>Permet aux utilisateurs non administrateurs d'accéder au menu de configuration du module. Essentiel pour déléguer la gestion du module sans donner les droits administrateur complets.

</td></tr><tr><td>Modifier les paramètres Dolibarr

</td><td>**paramDolibarr**

</td><td>Permet de modifier les paramètres natifs de Dolibarr via le module (gestion des projets, commentaires, tâches, etc.). Cette permission contrôle l'accès à l'onglet "Paramètres Dolibarr".

</td></tr><tr><td>Modifier les paramètres principaux du module

</td><td>**paramSetup**

</td><td>Permet de configurer les paramètres spécifiques à InfraSProject (préfixes, catégories, entrepôts, taux de marque, etc.). Cette permission contrôle l'accès à l'onglet "Paramètres généraux".

</td></tr><tr><td>Sauvegarder / Restaurer les paramètres du module

</td><td>**paramBkpRest**

</td><td>Permet d'effectuer des sauvegardes et restaurations de configuration. Cette permission est critique car elle permet de modifier massivement les paramètres via l'import d'un fichier de sauvegarde.

</td></tr><tr><td>Lire les consommations sur les projets

</td><td>**readproject**

</td><td>Permet de visualiser les consommations de stock liées aux projets. L'utilisateur peut consulter l'onglet "Consommations de Stock" mais ne peut pas ajouter ou modifier de consommations.

</td></tr><tr><td>Créer des consommations sur les projets

</td><td>**writeproject**

</td><td>Permet d'ajouter, modifier et supprimer des consommations de stock. Cette permission inclut automatiquement la permission de lecture. C'est la permission opérationnelle principale pour la gestion quotidienne des consommations.

</td></tr></tbody></table>

**⚙️ Configuration des permissions :**

**Chemin :**<span style="white-space: pre-wrap;"> </span>**Accueil → Configuration → Utilisateurs &amp; Groupes → Sélectionner un utilisateur → Onglet "Permissions" → Rechercher "InfraSProject"**

- [x] Cochez les permissions souhaitées pour chaque utilisateur selon son rôle dans l'entreprise.

# 5. FONCTIONNALITÉS PRINCIPALES

# Fonctionnalités Principales

#### **1.CONSOMMATIONS DE STOCK**

<span style="white-space: pre-wrap;">Un nouvel onglet </span>**"Consommations de Stock"**<span style="white-space: pre-wrap;"> est ajouté à chaque projet pour gérer les consommables utilisés sur le chantier.</span>

**Ajouter une consommation :**

1. Ouvrir un projet
2. Cliquer sur l'onglet "Conso" (Consommations de Stock)
3. Cliquer sur "Nouvelle consommation"
4. Sélectionner le produit (filtré selon les catégories configurées)
5. Indiquer la quantité
6. Choisir l'entrepôt (présélectionné selon configuration)
7. Sélectionner l'utilisateur (**si l'option est activée**)
8. Indiquer la date de consommation
9. Valider[![proj2stock.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/N6WooWblARkuPqqc-proj2stock.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/N6WooWblARkuPqqc-proj2stock.png)

**Fonctionnalités incluses :**

- [x] Suivi détaillé des consommations par projet
- [x] Historique complet avec dates et utilisateurs
- [x] Intégration automatique dans le coût du projet
- [x] Génération de mouvements de stock avec préfixe personnalisé
- [x] Analyse possible par mois et par consommateur
- [x] Export des données

**Cas d'usage typiques :**

- Gestion des EPI (**É**<span style="white-space: pre-wrap;">quipement de </span>**P**<span style="white-space: pre-wrap;">rotection </span>**I**ndividuelle)
- Suivi de l'outillage
- Consommables de chantier
- Matières premières
- Fournitures diverses

#### **2.VUE D'ENSEMBLE AMÉLIORÉE**

La page "Vue d'ensemble" des projets est enrichie avec de nombreux indicateurs financiers et options d'affichage personnalisables.

***Indicateurs financiers disponibles :***

- Total des devis signés
- Total des commandes clients
- Total des factures clients
- Total des commandes fournisseurs
- Reste à payer des commandes fournisseurs
- Total des factures fournisseurs
- Répartition des lignes de factures fournisseurs sur plusieurs projets
- Total des notes de frais (avec filtres par type)
- Total des consommations de stock
- Bénéfice provisoire calculé automatiquement
- Calcul du droit à dépenser selon différents taux de marque

[![profit.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/LRcSvJ6oygXdN9Oq-profit.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/LRcSvJ6oygXdN9Oq-profit.png)

**Améliorations d'affichage :**

- Masquage optionnel des tableaux vides
- Ordre d'affichage personnalisable
- Boutons de création/liaison masquables
- Affichage du dernier échange (avec ContactTracking)
- Affichage de la prochaine action (avec ContactTracking)

[![proj1.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/6z4RKukqxzE75SCg-proj1.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/6z4RKukqxzE75SCg-proj1.png)

#### **3.BÉNÉFICE PROVISOIRE**

Le module calcule automatiquement le bénéfice provisoire du projet en temps réel.

**Formule de base :**

##### <span style="white-space: pre-wrap;">Bénéfice provisoire = Total des devis signés </span>**-**<span style="white-space: pre-wrap;"> (Total commandes fournisseurs, factures fournisseurs non liées, notes de frais, conso stock)</span>

**Éléments configurables :**

- Choix des éléments à additionner (devis, commandes, factures clients)
- Choix des éléments à soustraire (commandes, factures fournisseurs, frais)
- Inclusion/exclusion de types de notes de frais spécifiques
- Prise en compte des factures fournisseurs non liées à une commande
- Intégration des consommations de stock

**Calcul du droit à dépenser :**

Le module calcule automatiquement combien vous pouvez encore dépenser pour atteindre un objectif de marge selon 3 taux de marque configurables.

**📝 Exemple pratique :**  
  
<span style="white-space: pre-wrap;">Si vous avez signé pour </span>**100 000 €**<span style="white-space: pre-wrap;"> et dépensé </span>**60 000 €**<span style="white-space: pre-wrap;"> :</span>

- <span style="white-space: pre-wrap;">Bénéfice provisoire : </span>**40 000 €**
- <span style="white-space: pre-wrap;">Pour une marque de </span>**25%**<span style="white-space: pre-wrap;"> : vous pouvez dépenser encore </span>**20 000 €**
- <span style="white-space: pre-wrap;">Pour une marque de </span>**30%**<span style="white-space: pre-wrap;"> : vous pouvez dépenser encore </span>**10 000 €**
- <span style="white-space: pre-wrap;">Pour une marque de </span>**35%**<span style="white-space: pre-wrap;"> : vous avez déjà </span>**dépassé l'objectif**

## [![profitProv.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/5O3MSQUObsoKO1HE-profitprov.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/5O3MSQUObsoKO1HE-profitprov.png)

# 6. UTILISATION

# Utilisation Quotidienne

#### **1.WORKFLOW RECOMMANDÉ :**

**Création d'un projet :**

- Manuellement ou automatiquement à la signature d'un devis (si configuré)
- Saisie des informations de base (client, référence, budget prévisionnel)
- Validation immédiate ou statut brouillon selon configuration

**Liaison des documents :**

- Devis signés =&gt; Chiffre d'affaires prévu
- Commandes clients =&gt; Engagements fermes
- Commandes fournisseurs =&gt;Coûts prévisionnels
- Factures fournisseurs =&gt;Répartition possible sur plusieurs projets

**Enregistrement des consommations de stock :**

- Au fur et à mesure des besoins du chantier
- Avec indication de l'utilisateur si nécessaire
- Vérification des stocks restants
- Utilisation du préfixe de code inventaire défini

**Suivi de l'avancement :**

- Consultation régulière du bénéfice provisoire
- Vérification du droit à dépenser restant
- Ajustement des commandes si nécessaire
- Anticipation des dépassements budgétaires

**Clôture du projet :**

- Vérification de tous les éléments liés
- Analyse des écarts prévisionnel/réel
- Documentation de la base de connaissances Dolibarr si activé
- <span style="white-space: pre-wrap;"> Archivage et changement de statut</span>

#### **2.BONNES PRATIQUES :**

1. Définir un préfixe de code inventaire cohérent dès le début (ex: "PROJ-", "CHANT-")
2. Configurer les catégories de produits consommables au démarrage
3. Définir l'entrepôt par défaut selon l'organisation de l'entreprise
4. Former les utilisateurs aux permissions et workflow avant le démarrage
5. Attribuer les bonnes permissions selon les rôles dans l'entreprise (lecture et écriture)
6. Consulter régulièrement le bénéfice provisoire pour anticiper les dérives

##

# 7. SAUVEGARDE ET RESTAURATION

# Sauvegarde et Restauration

<span style="white-space: pre-wrap;">Le module intègre un </span>**système complet de sauvegarde/restauration**<span style="white-space: pre-wrap;"> des paramètres pour faciliter la migration, la réinstallation ou la duplication des configurations.</span>

#### **1.TYPES DE SAUVEGARDES**

**SAUVEGARDE AUTOMATIQUE :**

- - - Le module effectue automatiquement une sauvegarde des paramètres lors de sa désactivation.
        - <span style="white-space: pre-wrap;">Cette sauvegarde est stockée dans le </span>**répertoire d'administration des documents**.

**SAUVEGARDE MANUELLE :**

- - - <span style="color: rgb(52, 73, 94); white-space: pre-wrap;">Aller dans </span>**Outils → InfraS → Paramètres généraux**
        - <span style="color: rgb(52, 73, 94);">Cliquer sur le bouton "Sauvegarder"</span>
        - <span style="color: rgb(52, 73, 94);">Un fichier de sauvegarde est téléchargé</span>

#### **2.RESTAURATION :**

- - - <span style="color: rgb(52, 73, 94); white-space: pre-wrap;">Aller dans </span>**Outils → InfraS → Paramètres généraux**
        - <span style="color: rgb(52, 73, 94);">Cliquer sur le bouton "Restaurer"</span>
        - <span style="color: rgb(52, 73, 94);">Sélectionner le fichier de sauvegarde</span>
        - <span style="color: rgb(52, 73, 94);">Valider</span>
        - <span style="color: rgb(52, 73, 94);">Rafraîchir la page (F5) pour visualiser le résultat</span>

<p class="callout warning">**Attention :**<span style="white-space: pre-wrap;"> La restauration écrase </span>**tous les paramètres actuels**<span style="white-space: pre-wrap;"> du module. Une copie de sécurité de la configuration actuelle est automatiquement créée avant la restauration, mais il est recommandé de faire une sauvegarde manuelle préalable.</span></p>

#### **3.CONTENU DE LA SAUVEGARDE :**

Ce qui EST sauvegardé :

- [x] Tous les paramètres du module (onglets "Dolibarr" et "Généraux")
- [x] Configuration des catégories de produits
- [x] Préfixes et codes personnalisés
- [x] Choix d'affichage et masquage des éléments
- [x] Configuration des taux de marque
- [x] Entrepôt par défaut
- [x] Mode de recherche et options avancées
- [x] Tous les réglages de permissions et droits

Ce qui N'est PAS sauvegardé :

- **✗**<span style="white-space: pre-wrap;"> Les données de consommation (historique des consommations de stock)</span>
- **✗**<span style="white-space: pre-wrap;"> Les projets et leur contenu</span>
- **✗**<span style="white-space: pre-wrap;"> Les mouvements de stock générés</span>
- **✗**<span style="white-space: pre-wrap;"> Les liaisons entre éléments et projets</span>

<p class="callout info">**Note :**<span style="white-space: pre-wrap;"> Seule la </span>**configuration**<span style="white-space: pre-wrap;"> du module est sauvegardée, pas les </span>**données opérationnelles**.</p>

# 8. SUPPORT ET ASSISTANCE

# Support et Assistance

#### **SUPPORT TECHNIQUE :**

***Contactez l'équipe InfraS***

<span style="white-space: pre-wrap;">📧 Email : </span><support@infras.fr>

<span style="white-space: pre-wrap;">🌐 Site web : </span>[www.infras.fr](https://www.infras.fr)

Support professionnel pour installation, configuration, personnalisation et résolution de problèmes

#### **INFORMATIONS TECHNIQUES :**

📍 Accès via l'interface

**Menu Outils → InfraS → Changelog / Support**

📋 Contenu disponible

- Visualisation du changelog complet du module
- Vérification automatique des mises à jour disponibles
- Informations de version actuelle
- Compatibilité avec votre version de Dolibarr
- Versions PHP minimum et maximum supportées
- Historique détaillé des modifications par version

#### **CHANGELOG :**

Le module intègre un système de consultation du changelog et de vérification des mises à jour.

Historique des modifications

Chaque version est documentée avec :

- **Numéro de version**<span style="white-space: pre-wrap;"> (ex: 1.2.3)</span>
- **Date de publication**
- **Liste des modifications**<span style="white-space: pre-wrap;"> (nouvelles fonctionnalités, corrections, améliorations)</span>
- **Notes de compatibilité**<span style="white-space: pre-wrap;"> si nécessaire</span>

Téléchargement du changelog

Le module peut télécharger automatiquement le changelog de la dernière version disponible pour vous informer des nouveautés et améliorations.

#### **MODULES COMPLÉMENTAIRES :**

InfraS propose une gamme complète de modules pour étendre les fonctionnalités de Dolibarr.

##### **Où trouver les modules InfraS ?**

- **Dolistore officiel**<span style="white-space: pre-wrap;"> - Boutique de modules Dolibarr</span>
- **Site InfraS**<span style="white-space: pre-wrap;"> - </span>[https://www.infras.fr](https://www.infras.fr)

**Module recommandé : ContactTracking**  
<span style="white-space: pre-wrap;"> Développé par </span>**Inovea Conseils**  
<span style="white-space: pre-wrap;"> Améliore le suivi des échanges et actions dans InfraSProject</span>  
<span style="white-space: pre-wrap;"> Affichage du dernier échange et de la prochaine action sur les projets</span>

**Autres modules InfraS**  
<span style="white-space: pre-wrap;"> Découvrez toute la gamme de modules InfraS sur le site </span>**InfraS**<span style="white-space: pre-wrap;"> et sur le Dolistore pour personnaliser votre Dolibarr selon vos besoins métier</span>

#### **NOTES IMPORTANTES**

- <span style="white-space: pre-wrap;">L'extension PHP </span>**XML**<span style="white-space: pre-wrap;"> doit être activée pour bénéficier de toutes les fonctionnalités (notamment la gestion du changelog et des mises à jour).</span>
- <span style="white-space: pre-wrap;">Après toute modification de paramètres, pensez à cliquer sur le bouton </span>**"Modifier"**<span style="white-space: pre-wrap;"> pour valider les changements.</span>
- <span style="white-space: pre-wrap;">Après une restauration de paramètres, rafraîchissez la page </span>**(F5)**<span style="white-space: pre-wrap;"> pour visualiser les modifications.</span>
- <span style="white-space: pre-wrap;">Le module vérifie automatiquement la </span>**compatibilité avec votre version de Dolibarr**. Si la version minimum requise n'est pas atteinte, le module se désactive automatiquement (sauf si l'option de désactivation du contrôle de version est activée).
- <span style="color: rgb(224, 62, 45);">Les</span><span style="white-space: pre-wrap;"> </span><span style="color: rgb(224, 62, 45); white-space: pre-wrap;">consommations de stock génèrent des </span>**mouvements de stock réels**<span style="color: rgb(224, 62, 45); white-space: pre-wrap;"> dans Dolibarr</span>. Vérifiez vos paramètres avant la mise en production.
- <span style="white-space: pre-wrap;">Pour une gestion </span>**multi-entités**, les paramètres sont sauvegardés et gérés séparément par entité.

##