feat: Introduce AI copilot with a refined analysis engine for product recommendations based on strategic weight and relative contribution.

task.md

@@ -1,58 +1,27 @@
-# Context
+# Tâches en cours : Optimisation de l'Analyse IA (Phase 2 - Contextualisation)
 
-Activation de l'Agent Master BMAD pour la gestion du projet CollectFlow selon la méthodologie BMAD.
+## Contexte
 
-# Current Focus
+L'IA (Mary) donne des recommandations incohérentes (ex: [Z] pour un produit plus performant qu'un [A]) car elle manque de repères relatifs. Elle ne connaît pas le poids réel d'un produit dans le chiffre d'affaires total du fournisseur ou du rayon.
 
-Activation et initialisation de l'Agent Master BMAD.
+## Focus Actuel
 
-- [x] Étape 1 : Lecture de la configuration et de la persona de l'Agent Master
-- [x] Étape 2 : Initialisation des variables de session (user_name, language, output_folder)
-- [x] Étape 3 : Accueil de l'utilisateur et affichage du menu principal
-- [x] Étape 4 : Exécution du workflow Party Mode ([PM])
-- [x] Étape 5 : Discussion multi-agents : Refonte de la logique de recommandation
-- [x] Étape 6 : Proposition technique et plan d'implémentation
-- [x] Étape 7 : Application des modifications dans `analysis-engine.ts`
-- [x] Étape 8 : Vérification et validation
-- [x] Étape 9 : Relativisation des recommandations (Abandon Benchmarking)
-- [x] Étape 10 : Ajustement du seuil de protection (Score < 20)
-- [x] Étape 11 : Intégration de l'analyse critique systématique (même score > 50)
-- [x] Étape 12 : Validation finale et correction TS
-- [x] Étape 13 : Implémentation du modal pour les explications IA détaillées
-- [x] Étape 14 : Correction du design et du positionnement du modal (z-index/Portal)
-- [x] Étape 15 : Polissage final et validation Michael
-- [x] Étape 16 : Correction graphique selon la charte CollectFlow (Slate-950/Apple)
-- [x] Étape 17 : Optimisation de l'analyse (Volumes, PMV & Produits de Trafic)
-- [x] Étape 18 : Validation finale des recommandations sur cas réels
+**Recherche & Développement** : Mieux définir les critères de ranking pour Mary afin d'éliminer les faux négatifs (Score 70+ classé en Z).
+
+## Master Plan
+
+- [x] Correction graphique du modal (Slate-950/Apple)
+- [x] Étape 20 : Intégration des poids (%) et contribution relative (Analyse de Cohérence)
+- [x] Étape 21 : Sanctuarisation des produits stratégiques dans le prompt
+- [x] Étape 22 : Test et validation des recommandations (Élimination des faux Z)
+- [ ] Recherche de meilleures pratiques pour le ranking IA (Analyse ABC/XYZ enrichie)
+- [ ] Implémentation du calcul des poids (%) dans `score-engine.ts`
+- [ ] Mise à jour des types `ProductAnalysisInput`
+- [ ] Enrichissement du prompt Mary avec les notions de contribution (%)
+- [ ] Test et validation sur les cas limites (Score 70+ classé en Z par erreur)
 
 ## Progress Log
 
-- Initialisation de la tâche d'activation de l'Agent Master BMAD.
-- Variables de session chargées : Michael, French, _bmad-output.
-- Michael a sélectionné "pm" (Party Mode). Lancement du workflow.
-- Manifeste des agents chargé (20 agents détectés).
-- Session Party Mode activée.
-- Michael soulève un problème sur le seuil arbitraire de score < 30 (impact petits fournisseurs).
-- Analyse en cours de `src/features/ai-copilot/business/analysis-engine.ts`.
-- Plan d'implémentation validé par Michael.
-- Déploiement de la nouvelle hiérarchie d'analyse (CA/Marge > Score).
-- Suppression des seuils de blocage score < 30.
-- Mise en avant des "Produits de Service".
-- Michael signale une inflation des recommandations [A] (86 articles).
-- Michael demande d'abandonner l'analyse par rayon.
-- Mise en place d'une protection stricte : Score < 20 => Sortie [Z] automatique.
-- Arbitrage IA maintenu entre 20 et 50 basé sur CA / Marge / Quantité.
-- Michael exige une analyse critique systématique même pour les scores > 50.
-- Logique finale implémentée et validée (Score < 20 = Z).
-- Demande de Michael : Ajouter une icône + modal pour voir l'explication complète.
-- Recherche du composant de la grille en cours.
-- Nouveau composant `AiExplanationModal` créé.
-- Intégration dans `AiInsightBlock` terminée (icône + déclenchement).
-- Correction du modal : utilisation de `createPortal` et `z-index: 9999` pour passer au-dessus de tout.
-- Opacité du fond renforcée (0.85).
-- Validation Michael reçue (LGTM).
-- Refonte visuelle complète du modal : passage aux variables CSS de `globals.css`.
-- Suppression des bordures blanches et du fond noir pur pour le thème `Slate-950`.
-- Intégration de `tabular-nums` pour les indicateurs financiers.
-- Ajout du calcul du PMV (CA/Qté) et des indicateurs de volume relatif dans l'IA.
-- Mise à jour du prompt pour protéger les produits "Générateurs de trafic" (Fort volume, faible CA).
+- **Phase 1 terminée** : Modal UI polie et Portail React opérationnel.
+- **Phase 1.5 terminée** : Mary prend désormais en compte le volume moyen du rayon et le PMV.
+- **Découverte** : Mary a besoin du "Poids CA" et du "Total Fournisseur" pour donner un avis juste. Un CA de 552€ est faible pour un géant, mais vital pour un petit artisan.