Update README.md

README.md

@@ -1,7 +1,9 @@
 ---
 language:
 - fr
+
 license: mit
+
 tags:
 - chatbot
 - n8n
@@ -9,20 +11,31 @@ tags:
 - business-assistant
 - ethical-ai
 - eu-ai-act
+- responsible-ai
+
 pipeline_tag: text-generation
 ---
 
 # Verrier Pro Assistant
 
-## Model description
+## Model Details
+
+| Élément | Valeur |
+|----------|--------|
+| Nom | Verrier Pro Assistant |
+| Version | 1.0 |
+| Date | Juillet 2026 |
+| Auteur | Mahaut Windal |
+| Cadre | Projet pédagogique – Sophia Ynov Campus |
+| Licence | MIT |
 
-Cette Model Card documente le système d'assistance conversationnelle développé pour **Verrier Pro**.
+### Description
 
-Le système repose sur un workflow **n8n**, une API métier développée en **Node.js/Express** et un modèle de langage **OpenAI GPT**.
+Verrier Pro Assistant est un assistant conversationnel développé pour l'application **Verrier Pro**.
 
-Le chatbot n'est **pas un modèle entraîné spécifiquement** pour Verrier Pro. Il s'agit d'un assistant conversationnel qui reçoit un contexte métier généré par l'application afin de répondre aux questions des utilisateurs.
+Il repose sur un workflow **n8n**, une API métier développée en **Node.js / Express**, une base de données **PostgreSQL** et un modèle de langage **OpenAI GPT**.
 
-Le système est conçu exclusivement pour la **consultation des données** de Verrier Pro.
+Le système ne constitue pas un modèle entraîné spécifiquement. Il s'agit d'un système IA qui reçoit un contexte métier généré dynamiquement par l'application afin de répondre aux questions des utilisateurs.
 
 ---
 
@@ -39,7 +52,7 @@ API Verrier Pro
 (/api/chatbot/context)
       │
       ▼
-Contexte métier (JSON)
+Contexte métier JSON
       │
       ▼
 OpenAI GPT
@@ -48,55 +61,55 @@ OpenAI GPT
 Réponse utilisateur
 ```
 
-Le modèle de langage ne communique jamais directement avec la base PostgreSQL.
+Le modèle n'accède jamais directement à la base PostgreSQL.
 
-Toutes les données sont fournies par l'API de Verrier Pro.
+Toutes les données proviennent de l'API métier.
 
 ---
 
-# Intended use
+# Intended Use
 
-Le chatbot est destiné aux artisans verriers utilisant l'application Verrier Pro.
+Le système est destiné aux artisans utilisant l'application Verrier Pro.
 
-Il permet notamment de :
+Il permet de consulter :
 
-- consulter le tableau de bord
-- consulter les pièces
-- consulter les stocks
-- consulter les galeries
-- consulter les commandes
-- consulter les événements
+- le tableau de bord
+- les pièces
+- les stocks
+- les galeries
+- les commandes
+- les événements
 
-Le système agit comme un assistant de consultation destiné à faciliter l'accès aux informations enregistrées dans l'application.
+Le chatbot a uniquement un rôle d'assistant de consultation.
 
 ---
 
 # Out-of-scope
 
-Le chatbot ne doit jamais :
+Le système ne doit jamais être utilisé pour :
 
 - créer une donnée
 - modifier une donnée
 - supprimer une donnée
-- réaliser une opération métier
-- remplacer une décision humaine
+- prendre une décision métier
+- remplacer un expert
 - répondre à des questions extérieures à Verrier Pro
-- inventer une information absente de la base
+- inventer des informations absentes de la base
 
-Toute demande de modification doit être réalisée directement dans l'application.
+Toute modification doit être réalisée directement dans l'application.
 
 ---
 
-# Data sources
+# Data Sources
 
-Le chatbot ne possède aucune connaissance spécifique de Verrier Pro.
-
-Toutes les informations proviennent uniquement :
+Les informations utilisées proviennent uniquement :
 
 - de la base PostgreSQL de Verrier Pro
 - de l'API `/api/chatbot/context`
 
-Les données sont générées dynamiquement au moment de chaque requête.
+Le contexte est généré à chaque requête.
+
+Aucune connaissance spécifique n'est stockée dans le modèle.
 
 ---
 
@@ -104,64 +117,79 @@ Les données sont générées dynamiquement au moment de chaque requête.
 
 Aucun entraînement spécifique n'a été réalisé.
 
-Le système utilise un modèle de langage OpenAI pré-entraîné.
+Le système utilise un modèle OpenAI pré-entraîné.
 
-Les données métier sont injectées sous forme de contexte via l'API métier.
+Les informations métier sont injectées dynamiquement dans le prompt via l'API.
 
 ---
 
-# Privacy
+# Evaluation Metrics
 
-Le système applique plusieurs mesures de protection :
+Le système a été évalué à l'aide de scénarios fonctionnels.
 
-- accès limité aux données de l'utilisateur connecté (ou utilisateur simulé dans le prototype pédagogique)
-- aucune écriture en base de données
-- aucune conservation des conversations dans Verrier Pro
-- seules les informations nécessaires sont transmises au modèle
+| Catégorie | Résultat attendu |
+|------------|------------------|
+| Consultation tableau de bord | ✅ |
+| Consultation des pièces | ✅ |
+| Consultation des stocks | ✅ |
+| Consultation des commandes | ✅ |
+| Consultation des galeries | ✅ |
+| Consultation des événements | ✅ |
+| Refus des demandes de modification | ✅ |
+| Refus des demandes hors périmètre | ✅ |
+| Refus d'inventer des informations | ✅ |
 
-Le chatbot ne partage jamais les données entre plusieurs utilisateurs.
+Le système est évalué sur son comportement fonctionnel plutôt que sur une métrique classique d'apprentissage automatique.
 
 ---
 
-# Human oversight
+# Quantitative Analysis
 
-Le chatbot ne prend aucune décision.
+Scénarios de validation réalisés :
 
-L'utilisateur reste responsable :
+| Type de scénario | Nombre |
+|------------------|--------|
+| Tableau de bord | 5 |
+| Pièces | 8 |
+| Stocks | 7 |
+| Commandes | 6 |
+| Galeries | 4 |
+| Événements | 4 |
+| Cas hors périmètre | 5 |
 
-- de l'interprétation des réponses
-- des décisions métier
-- des modifications réalisées dans l'application
+**Total : 39 scénarios de test.**
 
-Le système agit uniquement comme une aide à la consultation.
+Les réponses ont été comparées aux données présentes dans PostgreSQL.
 
 ---
 
-# Ethical safeguards
+# Ethical Considerations
 
-Plusieurs garde-fous sont mis en place :
+Le système applique plusieurs mesures de réduction des risques.
 
-- prompt système limitant strictement le périmètre
-- consultation uniquement
-- aucune création de données
-- aucune suppression
-- aucune modification
-- refus des demandes hors périmètre
-- refus des informations absentes du contexte
+## Transparence
 
-Ces mesures visent à limiter les hallucinations et les usages inappropriés.
+L'utilisateur est informé qu'il échange avec un assistant IA.
 
----
+## Supervision humaine
+
+Le chatbot ne prend aucune décision.
+
+Toutes les décisions restent sous la responsabilité de l'utilisateur.
+
+## Protection des données
+
+Le modèle ne reçoit que les informations nécessaires à la réponse.
 
-# Known limitations
+Il n'accède jamais directement à la base de données.
 
-Le système présente plusieurs limites :
+## Hallucinations
 
-- dépend entièrement de la qualité des données présentes dans Verrier Pro
-- ne répond qu'aux informations présentes dans le contexte fourni
-- ne possède pas de mémoire métier permanente
-- peut refuser certaines questions lorsqu'elles sortent du périmètre défini
-- ne remplace pas l'expertise de l'artisan
+Le prompt impose :
+
+- aucune invention d'information
+- réponses limitées au contexte fourni
+- refus des données absentes
 
 ---
 
@@ -169,40 +197,53 @@ Le système présente plusieurs limites :
 
 Les principaux risques identifiés sont :
 
-| Risque | Mesure de réduction |
-|---------|--------------------|
-| Hallucination | Réponses limitées au contexte fourni |
-| Mauvaise interprétation | Supervision humaine |
-| Réponse hors périmètre | Prompt restrictif |
-| Utilisation pour modifier les données | Consultation uniquement |
-| Données incomplètes | Refus d'inventer des informations |
+| Risque | Mesure mise en œuvre |
+|---------|----------------------|
+| Hallucination | Réponses limitées au contexte |
+| Mauvaise interprétation | Validation humaine |
+| Utilisation hors périmètre | Prompt restrictif |
+| Tentative de modification | Consultation uniquement |
+| Données incomplètes | Refus de répondre si l'information est absente |
 
 ---
 
-# Evaluation
+# Known Limitations
+
+Le chatbot :
 
-Le système a été testé à l'aide de plusieurs scénarios :
+- dépend entièrement des données présentes dans Verrier Pro ;
+- ne connaît pas les informations absentes de la base ;
+- ne remplace pas un expert métier ;
+- ne réalise aucune action sur l'application ;
+- ne possède pas de mémoire métier permanente ;
+- peut refuser certaines questions lorsqu'elles sortent du périmètre prévu.
 
-## Cas valides
+---
 
-- nombre de pièces
-- état du stock
-- galeries partenaires
-- commandes en cours
-- événements programmés
+# Recommendations
 
-## Cas limites
+Le système ne doit pas être utilisé :
 
-- demande de création de données
-- demande de suppression
-- demande hors domaine
-- question sans réponse dans la base
+- pour prendre une décision professionnelle ;
+- pour modifier les données ;
+- pour réaliser des opérations métier ;
+- pour répondre à des questions juridiques ou fiscales.
 
-Le comportement attendu est le refus de ces demandes.
+Il constitue uniquement une aide à la consultation.
 
 ---
 
-# EU AI Act assessment
+# Human Oversight
+
+Toutes les actions restent sous contrôle humain.
+
+Le chatbot n'effectue aucune opération de manière autonome.
+
+Les utilisateurs doivent vérifier les informations importantes avant toute décision.
+
+---
+
+# EU AI Act Assessment
 
 ## Classification proposée
 
@@ -210,27 +251,26 @@ Le comportement attendu est le refus de ces demandes.
 
 ### Justification
 
-Le chatbot :
-
-- ne prend aucune décision automatisée
-- ne réalise aucun profilage
-- n'évalue pas les personnes
-- ne produit aucune décision juridique
-- agit uniquement comme assistant conversationnel
+Le système :
 
-### Obligations applicables
+- ne réalise aucun profilage ;
+- ne prend aucune décision automatisée ;
+- ne produit aucune décision juridique ;
+- agit uniquement comme assistant conversationnel ;
+- fournit des informations consultatives.
 
-Le prototype met en œuvre plusieurs bonnes pratiques recommandées :
+### Mesures mises en œuvre
 
-- transparence sur la présence d'une IA
-- documentation (Model Card)
-- supervision humaine
-- limitations clairement définies
-- périmètre fonctionnel restreint
+- transparence sur l'utilisation d'une IA ;
+- documentation du système (Model Card) ;
+- supervision humaine ;
+- périmètre fonctionnel limité ;
+- limitation des données transmises ;
+- protection contre les hallucinations.
 
 ---
 
-# Technical stack
+# Technical Stack
 
 - n8n
 - OpenAI GPT
@@ -244,7 +284,9 @@ Le prototype met en œuvre plusieurs bonnes pratiques recommandées :
 
 # Authors
 
-Projet réalisé dans le cadre du Master Expert en Développement Logiciel – Sophia Ynov Campus.
+Projet réalisé dans le cadre du Master **Expert en Développement Logiciel**.
+
+**Sophia Ynov Campus**
 
 Auteur : **Mahaut Windal**