Weglob: FR categories: TemplateDocUtil + Category:Modules complémentaires

2026-11-12T20:01:45Z

FR categories: TemplateDocUtil + Category:Modules complémentaires

← Older revision		Revision as of 20:01, 12 November 2026
Line 5:		Line 5:
	<!-- END interlang links -->		<!-- END interlang links -->

	{{~~TemplateDocUser~~}}		{{TemplateDocUtil}}
	{{TemplateModuleInfo		{{TemplateModuleInfo
	\|modulename=AIRA BI		\|modulename=AIRA BI
Line 120:		Line 120:
	* LinkedIn : [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi]		* LinkedIn : [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi]

	[[Category~~:Complementary modules]]~~		[[Category:Modules complémentaires]]
	~~[[Catégorie~~:Modules complémentaires]]
	~~[[Catégorie:DocUserFR~~]]

Weglob: Version 1.4.3

2026-11-12T16:33:15Z

Version 1.4.3

← Older revision		Revision as of 16:33, 12 November 2026
Line 26:		Line 26:
	\| Statut \|\| Stable		\| Statut \|\| Stable
	\|-		\|-
	\| Version \|\| 1.4.2		\| Version \|\| 1.4.3
	\|-		\|-
	\| ID module \|\| 500100		\| ID module \|\| 500100

Weglob: New page: Module AIRA BI (FR) (Weglob module documentation)

2026-11-12T16:15:55Z

New page: Module AIRA BI (FR) (Weglob module documentation)

New page

[[en:Module_AIRA_BI]]


{{TemplateDocUser}}
{{TemplateModuleInfo
|modulename=AIRA BI
|editor=Weglob
|web=https://weglob.com
|webbuy=https://www.dolistore.com/product.php?id=2841
|status=stable
|prerequisites=Dolibarr 19.0+, PHP 8.0+, une clé API d'un fournisseur IA
|minversion=19.0
|note=ID module 500100
}}

= Module AIRA BI =

{| class="wikitable"
! Nom !! Valeur
|-
| Éditeur || Weglob
|-
| Statut || Stable
|-
| Version || 1.4.2
|-
| ID module || 500100
|-
| Compatibilité Dolibarr || 19.0 et plus
|-
| Licence || GPL v3 ou ultérieure
|-
| Langues || Français, anglais
|}

== Description ==
'''AIRA BI''' est un assistant IA intégré à Dolibarr. Les utilisateurs posent leurs questions sur les données de l'ERP en langage naturel et obtiennent la réponse en texte, en tableau ou en graphique.

Exemples :
* ''ventes par mois sur 6 mois''
* ''top 10 clients par chiffre d'affaires''
* ''factures impayées par client''
* ''solde des comptes bancaires''
* ''état des projets par statut''

Le moteur suit un circuit contrôlé : '''question → contexte du schéma → plan IA → validation → SQL en lecture seule → affichage dans le chat'''. C'est un assistant Dolibarr, pas un chatbot généraliste.

== Fonctionnalités ==
* Réponse en '''texte, tableau ou graphique''' selon la question.
* '''Mémoire de conversation''' : questions de suivi, affiner un filtre, demander une autre vue.
* Conversations enregistrées '''par utilisateur et par entité''', réouverture ou suppression depuis le panneau latéral.
* '''Liens vers les rapports natifs''' (''customreports.php'') quand le résultat correspond à un rapport Dolibarr.
* Suggestions d'accueil affichées seulement si l'utilisateur a les droits nécessaires.
* Aide à l'utilisation de Dolibarr (« comment créer une facture ? ») sans lecture de la base.
* Choix du fournisseur IA : '''OpenRouter''' (des centaines de modèles, dont des gratuits), '''OpenAI''', '''Google Gemini''', '''NVIDIA'''.
* Messages d'erreur clairs (fournisseur, modèle, erreur technique) si l'API IA échoue.

== Sécurité ==
Chaque requête passe par un garde-fou SQL :
* ''SELECT'' uniquement, une seule instruction, sans commentaires ni variables.
* Aucune requête d'écriture, aucun export (''INTO OUTFILE''), aucun schéma système.
* Liste blanche des tables métier : chaque table exige le module Dolibarr correspondant '''et''' le droit de l'utilisateur (ex. factures : « Lire les factures »).
* Colonnes sensibles interdites (mots de passe, clés API, jetons).
* Filtre ''entity'' imposé (sûr en multi-société).
* Nombre de lignes et durée d'exécution plafonnés.
* Exécution dans une transaction en lecture seule, ou avec un utilisateur MySQL en lecture seule (recommandé).

Les clés API et le mot de passe MySQL lecture seule sont chiffrés en base et jamais réaffichés.

== Confidentialité ==
Envoyé au fournisseur IA : la question, l'historique de la conversation et la description des tables autorisées. '''Les résultats des requêtes ne sont pas envoyés.''' Les offres gratuites (modèles OpenRouter '':free'', Gemini gratuit, crédits d'essai NVIDIA) peuvent conserver les requêtes : préférez une offre payante pour les données sensibles.

== Captures d'écran ==
<gallery widths=400 heights=250>
File:AIRA_BI_welcome.png|Écran d'accueil et suggestions
File:AIRA_BI_chart.png|Réponse en graphique : ventes par mois
File:AIRA_BI_setup.png|Configuration : choix du fournisseur IA
</gallery>

== Installation ==
# Acheter et télécharger le zip du module sur DoliStore.
# Aller dans ''Accueil > Configuration > Modules/Applications > Déployer/installer un module externe'' et envoyer le zip.
# Ou le décompresser manuellement dans ''htdocs/custom/'' pour obtenir ''htdocs/custom/aichat''.

== Configuration ==
# Activer le module '''AIRA BI'''.
# Ouvrir la page de configuration du module.
# Choisir le fournisseur : OpenRouter, OpenAI, Google Gemini ou NVIDIA.
# Saisir la clé API (le bouton « Obtenir une clé » ouvre la page du fournisseur).
# Choisir le modèle. Pour OpenRouter, la liste vient du catalogue en direct avec prix et taille de contexte ; un avertissement s'affiche si le modèle configuré a été retiré.
# Enregistrer.
# Optionnel mais recommandé : créer un utilisateur MySQL en lecture seule et le saisir dans la configuration :
<pre>
CREATE USER 'dolibarr_ro'@'localhost' IDENTIFIED BY 'motdepasse';
GRANT SELECT ON dolibarr.* TO 'dolibarr_ro'@'localhost';
</pre>
# Optionnel : activer la fonction BI / rapports de Dolibarr pour obtenir les liens ''customreports'' dans le chat.

Le serveur Dolibarr doit joindre l'API du fournisseur en HTTPS (paramètre PHP ''curl.cainfo'' renseigné avec les certificats racine).

== FAQ ==
;L'assistant répond par une erreur IA
:Vérifier la clé API, le quota et que le modèle est toujours disponible. Le message indique le fournisseur et le modèle utilisés.

;« Aucune donnée trouvée »
:Aucun enregistrement Dolibarr ne correspond. Modifier la période ou le filtre.

;Un utilisateur ne voit pas certaines suggestions ou reçoit un refus
:Il n'a pas le droit Dolibarr sur le module concerné (factures, commandes, banque...). C'est voulu.

;Peut-il modifier mes données ?
:Non. Seules les requêtes ''SELECT'' en lecture seule sont autorisées.

== Support ==
* E-mail : contact@weglob.com
* Site : [https://weglob.com weglob.com]
* LinkedIn : [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi]

[[Category:Complementary modules]]
[[Catégorie:Modules complémentaires]]
[[Catégorie:DocUserFR]]

Module AIRA BI (FR) - Revision history

Weglob: FR categories: TemplateDocUtil + Category:Modules complémentaires

Weglob: Version 1.4.3

Weglob: New page: Module AIRA BI (FR) (Weglob module documentation)