# CHAPITRE 26 — Diagnostic et résolution des incidents Lorsqu'un comportement inattendu apparaît, ce chapitre vous guide dans la résolution. Le réflexe à adopter est simple : commencer par la page Diagnostic, lire les journaux, et n'envisager une action plus radicale qu'en dernier recours. ### Toujours commencer par la page Diagnostic ***Outils → InfraSStudio → onglet Diagnostic***. Le contrôle visuel (vert, orange, rouge) couvre : - Versions de Dolibarr et de PHP, présence des extensions PHP requises. - État du module et de sa dépendance Website. - Présence des cinq tables SQL du module. - Permissions d'écriture sur `DOL_DATA_ROOT`. - Hooks chargés, présence du trigger, déclaration des tâches planifiées. - Pour chaque site géré : résolution du docroot, mode média, dossier de données.

**À retenir —** 80 % des incidents signalés sont en réalité une ligne rouge ou orange du Diagnostic ignorée. Demandez systématiquement à toute personne qui rapporte un dysfonctionnement de joindre d'abord cette capture.

### Lire les journaux Dolibarr Le module utilise `dol_syslog()` pour tracer les opérations sensibles, avec le préfixe `infrasstudio`. ##### **Emplacement** ``` htdocs/documents/dolibarr.log ``` ##### **Filtrer les entrées du module** ``` # Toutes les entrées du module grep "infrasstudio" htdocs/documents/dolibarr.log # Uniquement les erreurs grep "infrasstudio.*LOG_ERR" htdocs/documents/dolibarr.log # Suivi en temps réel pendant qu'un utilisateur reproduit le problème tail -f htdocs/documents/dolibarr.log | grep infrasstudio ```

**Conseil — Activer le niveau DEBUG —** Pour traquer un incident subtil, augmentez temporairement le niveau de journalisation Dolibarr (Configuration → Sécurité → Système) à `LOG_DEBUG`. Pensez à le rabaisser une fois le diagnostic terminé.

### Incidents fréquents et solutions ##### **Le menu InfraS n'apparaît pas dans Outils**

Cause probable	L'utilisateur ne possède pas la permission `paramMenu` .
Solution	Onglet Permissions de l'utilisateur, cocher `paramMenu` dans la section InfraSStudio.

##### **Les modifications ne sont pas visibles publiquement**

Cause probable	Modifications restées en brouillon sans être publiées.
Solution	Cliquer sur « Publier les modifications » dans la barre d'outils. Voir le Chapitre 12.

##### **L'aperçu affiche une erreur 404**

Cause probable	La page possède un type\_container `other` , `menu` ou `setup` , et le filtre du noyau la bloque.
Solution	Le module corrige automatiquement ce comportement depuis la version 1.8.7. Vérifiez que vous êtes en version 1.8.7 ou supérieure.

##### **Erreur réseau dans l'éditeur (erreur AJAX)**

Cause probable	Session Dolibarr expirée, ou avertissement PHP émis avant les en-têtes HTTP.
Solution	Recharger la page Studio (F5). Si le problème persiste, consultez `dolibarr.log` pour identifier l'erreur PHP réelle.

##### **Les images téléversées ne s'affichent pas publiquement**

Cause probable	Lien symbolique `medias` manquant ou cassé en mode native.
Solution	Recréer le lien symbolique avec `ln -sfn ...` , ou basculer le site en mode média `module` .

##### **Les wrappers solution-\*.php ne se génèrent pas**

Cause probable	`INFRASSTUDIO_WEBSITE_KEY` ou `INFRASSTUDIO_PUBLIC_DOCROOT` non configurées.
Solution	Configurer ces deux constantes dans Outils → InfraSStudio → Configuration → Wrappers.

##### **Les slots ne se mettent pas à jour après modification du tpl.php**

Cause probable	Le scanner n'a pas été lancé.
Solution	Outils → InfraSStudio → Contenu → bouton « Rescanner ». Ou en ligne de commande : `php scripts/rescan_slots.php ` .

### Réinitialiser le module Si le module se trouve dans un état incohérent (utilisation impossible, erreurs SQL persistantes), vous pouvez le réinitialiser : 1. ***Configuration → Modules → InfraSStudio*** → cliquer sur **Désactiver**. 2. Le module sauvegarde toutes ses constantes sous le préfixe `INFRASSTUDIOBKP_`. 3. Cliquer à nouveau sur **Activer**. 4. Le module restaure ses constantes, recrée les tables manquantes et réenregistre les hooks.

**Aucune perte de données —** Les valeurs de slot, les médias et les traductions sont conservés dans leurs tables respectives. La désactivation puis réactivation ne touche qu'au descripteur et aux hooks.

### Demander de l'aide Si rien ne fonctionne, préparez ces trois informations avant toute demande d'aide : 1. Capture d'écran de la page Diagnostic complète. 2. Les vingt dernières lignes de `dolibarr.log` filtrées sur `infrasstudio`. 3. La version exacte du module et de Dolibarr (visibles en haut de la page Diagnostic). Avec ces trois éléments, n'importe quel développeur connaissant le module peut établir un diagnostic en quelques minutes. ### Récapitulatif **Vous savez désormais :** - Lancer la page Diagnostic comme premier réflexe. - Lire et filtrer les journaux Dolibarr. - Identifier les sept incidents fréquents et leurs solutions. - Réinitialiser le module proprement (désactivation et réactivation). - Préparer un rapport d'incident efficace en trois étapes.