InfraSTructure
Gestion des documents commerciaux de Dolibarr : propositions/commandes/factures.

1. PRÉSENTATION DU MODULE

Présentation du module
Le module InfraStructure enrichit la gestion des documents commerciaux de Dolibarr en permettant d'organiser leurs lignes de manière claire et professionnelle. 
 FONCTIONNALITÉS APPORTÉES : 
 TITRES En-têtes de sections, imbriqués jusqu'à 9 niveaux (titre, sous-titre, sous-sous-titre…), permettant de regrouper les lignes en sections distinctes. SOUS-TOTAUX Calculés automatiquement pour chaque section : Total HT, quantité, TVA, réduction, marge. TEXTE LIBRE Lignes de description, conditions ou commentaires insérables librement entre les lignes de produits/services. DICTIONNAIRE Bibliothèque de textes prédéfinis réutilisables d'un document à l'autre. GLISSER-DÉPOSER Réorganisation intuitive des lignes et blocs par drag-and-drop. MODES PDF Trois modes d'impression : standard, liste, condensé. SOMMAIRE Sommaire rapide flottant pour naviguer rapidement dans les documents longs. TRANSFORMATIONS Préservation des structures lors des conversions devis → commande → facture. 
 Toutes les fonctionnalités sont optionnelles et paramétrables depuis la page de configuration du module.

2. DOCUMENTS CONCERNÉS

Documents concernés
InfraStructure est disponible sur l'ensemble des documents commerciaux et techniques de Dolibarr , couvrant aussi bien la chaîne des ventes que des achats. 
 Chaîne des ventes : 
 Propositions commerciales (devis) Commandes clients Factures clients (standard, acompte, situation, avoir) 
 Chaîne des achats : 
 Demandes de prix fournisseurs Commandes fournisseurs Factures fournisseurs 
 Documents techniques : 
 Bons de livraison Bons de réception

3.INSTALLATION ET ACTIVATION

Installation et activation
PROCÉDURE D'INSTALLATION 
 1 .Déploiement du module 
 Déployez le module de préférence via l'outil de déploiement des modules externes de Dolibarr . 
 2. Activation 
 Activez-le depuis : Accueil > Configuration > Modules/Applications 
 3. Initialisation automatique 
 Les attributs nécessaires sont créés automatiquement : champs complémentaires sur les lignes, dictionnaire de textes, constantes par défaut. 
 Important : Il est impératif de désactiver puis réactiver le module pour appliquer les modifications nécessaires. 
 Attention : InfraStructure est incompatible avec le module Milestone / Jalon (iNodbox) . Les deux ne peuvent pas être activés simultanément : l'activation est bloquée si l'autre est déjà présent. 
 Si le module Sous-Total (ATM Consulting) est présent et actif lors de l'activation, InfraStructure migre automatiquement ses données (paramètres, structures existantes, dictionnaire) puis le désactive. Aucune perte de vos titres/sous-totaux existants.

4. CONCEPTS DE BASE

Concepts
Le module ajoute trois types de lignes spéciales dans vos documents commerciaux. 
 TITRE 
 En-tête de section. Peut être imbriqué sur 9 niveaux (titre, sous-titre, sous-sous-titre…). Il marque le début d'un regroupement de lignes. 
 SOUS-TOTAL 
 Ligne de totalisation placée à la fin d'une section. Additionne automatiquement les lignes situées entre le titre parent et elle-même. 
 TEXTE LIBRE 
 Bloc de texte explicatif inséré entre des lignes standards. Sans montant associé. 
 PRINCIPE DE CALCUL D'UN SOUS_TOTAL 
 Le sous-total remonte jusqu'au titre parent (ou au sous-total de même niveau précédent) et additionne toutes les lignes standards rencontrées. Sont exclus automatiquement du calcul : 
 les titres, sous-totaux et textes libres ; les lignes masquées d'un bloc « caché » ; les lignes optionnelles ; les lignes de remise (module InfraSDiscount ). 
 Exemple de structure
Titre « Matériel »
 Produit A 100,00 EUR
 Produit B 200,00 EUR
Sous-total « Matériel » 300,00 EUR

Titre « Services »
 Service X 150,00 EUR
Sous-total « Services » 150,00 EUR

5. UTILISATION DU MODULE

Utilisation au quotidien
Ouvrez un document en mode BROUILLON . Les boutons d'action InfraStructure apparaissent au-dessus ou en dessous des lignes du document. 
 5.1 AJOUTER UN TITRE 
 Cliquez sur « Ajouter un titre » (ou « Ajouter un sous-titre » pour un niveau inférieur). Saisissez le libellé du titre. Validez : le titre s'insère dans le document. Selon la configuration, un sous-total manquant peut être ajouté automatiquement au-dessus du nouveau titre. 
 5.2 AJOUTER UN SOUS-TOTAL 
 Cliquez sur « Ajouter un sous-total » (ou « Ajouter un sous-sous-total »). Saisissez le libellé. Le montant se calcule automatiquement à partir des lignes situées au-dessus, jusqu'au titre parent. 
 OPTIONS D' AFFICHAGE 
 Afficher le Total HT Afficher la quantité totale du bloc Afficher la réduction moyenne du bloc Afficher la marge (si activé dans la configuration) 
 5.3 AJOUTER UNE LIGNE DE TEXTE LIBRE 
 Cliquez sur « Ajouter une ligne de texte » . Saisissez directement votre texte, OU sélectionnez un texte prédéfini dans le dictionnaire (voir 5.10). Le texte s'insère comme une ligne à part entière, sans montant. 
 5.4 RÉORGANISER PAR GLISSER-DÉPOSER 
 Saisissez une ligne par sa poignée de déplacement et déplacez-la. Pour déplacer un titre avec tout son contenu , utilisez l'action « Déplacer le bloc titre complet ». Les sous-totaux sont recalculés automatiquement après réorganisation. 
 Remarque : le glisser-déposer nécessite que JavaScript/AJAX soit activé dans Dolibarr . 
 5.5 DUPLIQUER UN BLOC OU UNE LIGNE 
 « Dupliquer » sur un titre : copie le titre et l'ensemble de ses lignes. « Dupliquer » sur une ligne : copie la ligne seule. 
 Ces actions peuvent être désactivées dans la configuration. 
 5.6 MASQUER LE DÉTAIL D'UN BLOC 
 Sur un titre, vous pouvez masquer les lignes pour obtenir une présentation synthétique (seuls le titre et son sous-total restent visibles). Les lignes masquées restent comptabilisées dans les sous-totaux. 
 Modes de pliage disponibles : 
 default Un bouton masque/affiche les lignes. keepTitle Deux boutons : masquer les lignes directes / masquer tout le contenu y compris les titres imbriqués. hideAll Deux boutons : masquer les lignes directes / masquer tout le contenu du bloc. 
 5.7 LIGNES / BLOCS OPTIONNELS (« Opt ») 
 Si la gestion des lignes optionnelles est activée, une colonne « Opt » apparaît. Cocher une ligne ou un bloc la marque comme optionnelle : 
 Son montant : Reste affiché 
 Calculs : Exclu des sous-totaux parents et du total général 
 Utile pour proposer des options chiffrées sans les inclure au total. 
 5.8 APPLIQUER UNE TVA OU UNE PROGRESSION AU BLOC 
 Depuis un titre, deux actions sont disponibles : 
 « Appliquer une TVA au bloc » : applique un taux de TVA unique à toutes les lignes du bloc. « Appliquer une progression au bloc » : applique un pourcentage d'avancement à toutes les lignes (factures de situation). 
 5.9 LE SOMMAIRE RAPIDE FLOTTANT 
 Sur un document comportant des titres, un bouton flottant apparaît dans le coin inférieur droit. Cliquez dessus pour dérouler la liste des titres ; cliquez sur un titre pour faire défiler le document jusqu'à lui. 
 Peut être désactivé dans la configuration. S'adapte automatiquement au thème Oblyon . 
 5.10 LE DICTIONNAIRE DE TEXTES LIBRES 
 Le dictionnaire stocke des textes récurrents réutilisables d'un document à l'autre. 
 GESTION DES ENTRÉES 
 Accueil > Configuration > Dictionnaires > « Ligne de texte prédéfini » . Chaque entrée comporte un libellé et un contenu. 
 UTILISATION 
 Lors de l'ajout d'une ligne de texte, sélectionnez un texte prédéfini dans la liste pour le réutiliser immédiatement.

6. Impression PDF

Impression PDF
Les titres et sous-totaux sont rendus dans le PDF avec un style et des couleurs paramétrables. Trois modes d'impression sont disponibles par titre. 
 STANDARD : Affichage complet, sous forme de tableau. Mode par défaut. 
 LISTE : Le contenu du titre est rendu sous forme de liste à puces. 
 CONDENSÉ : Affichage compact, avec agrégation selon les options choisies. 
 OPTIONS COMPLÉMENTAIRES PAR TITRE : 
 Cacher les lignes du bloc (seuls titre et sous-total apparaissent dans le PDF). Répéter l'en-tête du tableau juste avant ce titre. Ajouter un saut de page avant le titre. 
 Numérotation automatique : Une numérotation des titres/sections peut être activée sur le PDF depuis la configuration du module. 
 Récapitulatif par titre : Un document récapitulatif (par titre/lot) peut être généré et fusionné en fin de PDF, sur les devis, commandes et/ou factures (configuration).

7. TRANSFORMATIONS DE DOCUMENTS

Transformations de documents
Les structures (titres, sous-totaux, textes libres) sont préservées lors de toutes les opérations de transformation de documents. 
 OPÉRATION SUPPORTÉES 
 Conversion en chaîne Devis → commande → facture. La structure est intégralement conservée à chaque étape. Clonage La duplication d'un document reproduit fidèlement sa structure. Facturation groupée Un bloc titre peut être ajouté entre chaque commande. Le texte est personnalisable avec les clés __REFORDER__ et __REFCUSTOMER__ . Expéditions Génération d'expéditions depuis une commande. La liste des bons d'expédition/livraison liés peut être ajoutée à la description du titre. Factures récurrentes Création de factures récurrentes depuis un modèle — la structure est préservée. 
 CHAÎNE DE TRANSFORMATION 
 Devis → Commande → Facture Structure préservée