View source for Module AIRA BI (FR)

<!-- BEGIN origin interlang links -->
<!-- You can edit this section but do NOT remove these comments
     Links below will be automatically replicated on translated pages by PolyglotBot -->
[[en:Module_AIRA_BI]]
<!-- END interlang links -->

{{TemplateDocUtil}}
{{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.3
|-
| 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:Modules complémentaires]]