From fbad53df360b0d6c7903fed179857c6c405a2b45 Mon Sep 17 00:00:00 2001 From: Michael Date: Mon, 23 Feb 2026 22:52:21 +0100 Subject: [PATCH] feat(ai-copilot): add AI analysis engine with prompt generation, recommendation extraction, and insight cleaning capabilities. --- src/app/(dashboard)/docs/ai-analysis/page.tsx | 95 ++++++++----------- .../ai-copilot/business/analysis-engine.ts | 78 +++++++-------- 2 files changed, 76 insertions(+), 97 deletions(-) diff --git a/src/app/(dashboard)/docs/ai-analysis/page.tsx b/src/app/(dashboard)/docs/ai-analysis/page.tsx index faf4675..95c6845 100644 --- a/src/app/(dashboard)/docs/ai-analysis/page.tsx +++ b/src/app/(dashboard)/docs/ai-analysis/page.tsx @@ -25,77 +25,64 @@ export default function AiAnalysisDocPage() { {/* Grid of Rules */}
- {/* 1. Équité Territoriale */} + {/* 1. Loi de Pareto */}

- Pour éviter qu'un produit présent dans un seul magasin ne soit pénalisé par son volume brut, le système - double automatiquement toutes ses statistiques (Ventes, CA, Marge). - Cela simule sa performance s'il était présent sur les deux points de vente de référence. + L'IA identifie les produits Indiscutables. Si un produit pèse + {"> 10%"} du CA total de son fournisseur, il est jugé stratégique. + Mary refusera de suggérer sa sortie [Z] pour protéger la relation fournisseur et + garantir la stabilité de l'assortiment.

- {/* 2. Run Rate */} - -

- Si un produit a moins de 12 mois de présence, l'IA calcule un Run Rate 12 mois. -

- - Projection = Volume_Réel * (12 / Mois_Présence) - -

- Cela permet de confirmer un produit Permanent [A] dès ses premiers mois s'il a une forte vélocité. -

- - - {/* 3. Saisonnalité */} - -

- L'IA analyse la récence des ventes. Si aucune vente n'est constatée depuis plus de - 2 mois : -

-
    -
  • - - {"< 2 mois : Lancement probable (actif)"} -
    • -
  • - - {"> 2 mois : Alerte Saison [C] ou Sortie [Z]"} -
    • -
- - - {/* 4. Score Global */} + {/* 2. Équité & Normalisation */}

- Le score affiché dans la grille combine la Quantité, le CA et la Marge. - L'IA utilise ce score comme garde-fou : + Pour une comparaison juste, les statistiques des produits présents sur un seul magasin sont + doublées (x2). L'IA compare ensuite ces données pondérées aux + Benchmarks du Rayon (Moyenne du Niveau 2) pour détecter les sur-performances. +

+ + + {/* 3. Cycle de Vie */} + +

+ Mary distingue les produits récents des produits établis :

    -
  • • {"> 70"} : Candidat naturel au maintien.
    • -
  • • {"< 30"} : Signal fort de déréférencement.
    • +
  • • Run Rate : Projection sur 12 mois pour les produits de moins d'un an.
    • +
  • • Inactivité : Une alerte est levée après 2 mois sans vente, + orientant le verdict vers le [C] (Saisonnier) ou [Z] (Sortie).
 + + {/* 4. PMV & Trafic */} + +

+ Un produit peut être maintenu même avec un faible CA s'il génère du Trafic (Volumes {">"} Moyenne Rayon). + À l'inverse, un produit à faible volume peut être un Contributeur de Marge précieux s'il possède un Prix Moyen de Vente (PMV) élevé. +

+
{/* Footer / Tip */} diff --git a/src/features/ai-copilot/business/analysis-engine.ts b/src/features/ai-copilot/business/analysis-engine.ts index d290e65..8724370 100644 --- a/src/features/ai-copilot/business/analysis-engine.ts +++ b/src/features/ai-copilot/business/analysis-engine.ts @@ -2,82 +2,74 @@ import { ProductAnalysisInput } from "../models/ai-analysis.types"; export class AnalysisEngine { static generateSystemPrompt(): string { - return `Tu es Mary, une experte en stratégie retail. Ton rôle est de conseiller un acheteur sur le maintien ou l'arrêt d'un produit. -Tu reçois des données de vente sur 12 mois, la marge, le score de performance (0-100), et surtout le POIDS RELATIF du produit chez son fournisseur. + return `Tu es Mary, une experte Senior en Stratégie Retail et Category Management. Ton rôle est d'arbitrer l'assortiment avec une rigueur de consultant. +Tu analyses les performances d'un produit par rapport à son Fournisseur et son Rayon (Niveau 2). ---- CRITÈRES DE DÉCISION (Priorité Décroissante) --- -1. POIDS STRATÉGIQUE (% CA ou % MARGE) : - - Si un produit pèse > 8% du CA Total du fournisseur, il est STRATÉGIQUE. Ne JAMAIS le classer en [Z], sauf si la marge est négative ou la régularité < 3/12. - - Si un produit pèse > 15% du CA, il doit être classé [A] même avec un score moyen, car son arrêt déstabiliserait le fournisseur. +--- HIÉRARCHIE DE DÉCISION MÉTIER (Priorité Décroissante) --- -2. TYPOLOGIE DE PERFORMANCE : - - [A] (Maintenir/Protéger) : Produits piliers, forte contribution CA/Marge, ou "Générateurs de Trafic" (Volumes élevés vs moyenne rayon). - - [C] (À surveiller) : Produits récents à potentiel, ou produits de service stables mais à faible impact. - - [Z] (Arrêter/Sortir) : Produits à faible poids (< 2%), mauvaise régularité, faible marge, ET volume inférieur à la moyenne. +1. INDISCUTABLES (Poids Stratégique > 10% du CA Fournisseur) : + - Ce sont les "Piliers" du fournisseur. Ne JAMAIS suggérer [Z] (Sortie), sauf accident industriel (Marge < 0 ET Régularité < 3/12). + - Si Poids > 15%, la recommandation [A] est quasi-obligatoire pour protéger la relation fournisseur. -3. VOLUME VS VALORISATION (PMV) : - - Un produit à faible CA peut être un "Générateur de Trafic" si son volume est > à la moyenne du Rayon. - - Un produit à faible volume peut être un "Contributeur de Marge" s'il a un PMV (Prix Moyen de Vente) élevé et une marge excellente. +2. PILIERS & VACHES À LAIT (Score > 65 + Régularité > 8/12) : + - Produits performants et stables. Recommandation [A] (Permanent). + - Justifie par la "Moyenne Rayon" : Si Volume > Moyenne Rayon, c'est un moteur de trafic. ---- TON TON ET STYLE --- -Sois brève (max 2-3 phrases). Justifie toujours par le poids (%) ou le volume comparatif. -Sois directe : "Pèse 12% du CA", "Volume 2x supérieur au rayon", etc. -Commence toujours par ta recommandation entre crochets : [A], [C] ou [Z]. +3. DILEMMES & SAISONNIERS (Score moyen OU Régularité faible OU Inactivité > 2) : + - [C] (À surveiller) : Produits récents avec fort "Run Rate" (Projection 12m) ou produits au comportement saisonnier cyclique. + - Un produit récent (Régularité < 6) mais avec une projection 12m élevée mérite d'être protégé [C] pour lui laisser sa chance. -Options de recommandation : -- [A] - PERMANENT : Produit dont la valeur business, le trafic ou le service client est prouvé. -- [C] - SAISONNIER : Pics de ventes concentrés, inactivité hors saison. -Ta réponse doit être courte, directe et sans complaisance. -Format : "[Recommandation] : [Justification factuelle]"`; +4. POIDS MORTS (Poids < 2% + Score < 30 + Volume < Moyenne Rayon) : + - [Z] (Sortie) : Produits marginaux qui encombrent le linéaire sans rentabilité ni débit suffisant. + +--- TON, STYLE & FORMAT --- +- Sois chirurgicale : Cite toujours le poids (%) et compare le volume au benchmark. +- Maximum 2-3 phrases. Pas de blabla, juste des faits. +- Format strict : "[Recommandation] : [Justification factuelle]" +- Exemple : "[A] : Produit pilier (12% du CA Fournisseur) avec un volume 1.5x supérieur à la moyenne du rayon."`; } static generateUserMessage(p: ProductAnalysisInput): string { const pmv = p.totalQuantite > 0 ? p.totalCa / p.totalQuantite : 0; - const monthlySummary = Object.entries(p.sales12m || {}) .map(([k, v]) => `${k}: ${Math.round(v)}u`) .join(", "); - const volumeInfo = `Volumes : ${Math.round(p.totalQuantite)}u sur ${p.storeCount} mag.`; + const volumeInfo = `VOLUMES : ${Math.round(p.totalQuantite)}u sur ${p.storeCount} mag.`; - // Contexte comparatif et contribution + // Contexte comparatif const avgRef = p.avgQtyRayon || p.avgQtyFournisseur || 0; const refName = p.avgQtyRayon ? "rayon" : "fournisseur"; const relativeVolume = avgRef > 0 ? ` (Moyenne du ${refName} : ${avgRef.toFixed(1)}u)` : ""; + // Poids Stratégique const weights = p.shareCa !== undefined ? ` CONTRIBUTION (%) : - Chiffre d'Affaires : ${p.shareCa.toFixed(1)}% du total fournisseur - Marge Brute : ${p.shareMarge?.toFixed(1)}% du total fournisseur -- Volumes : ${p.shareQty?.toFixed(1)}% du total fournisseur -` : ""; +- Volumes : ${p.shareQty?.toFixed(1)}% du total fournisseur` : ""; - const totalContext = p.totalFournisseurCa ? `TOTAL FOURNISSEUR : ${p.totalFournisseurCa.toFixed(0)}€ CA` : ""; + const totalContext = p.totalFournisseurCa ? `\nVALEUR TOTALE FOURNISSEUR : ${p.totalFournisseurCa.toFixed(0)}€ CA` : ""; - const projectionInfo = p.regularityScore > 0 && p.regularityScore < 12 ? ` ---- ANALYSE DE POTENTIEL (Produit récent : ${p.regularityScore}/12 mois active) --- -Projection 12 mois : ${Math.round(p.projectedTotalQuantite || 0)}u (${(p.projectedTotalCa || 0).toFixed(2)}€)` : ""; + const projectionInfo = (p.regularityScore || 0) > 0 && (p.regularityScore || 0) < 12 ? ` +--- ANALYSE DE POTENTIEL (Produit récent : ${p.regularityScore}/12 mois) --- +Projection 12 mois (Run Rate) : ${Math.round(p.projectedTotalQuantite || 0)}u (${(p.projectedTotalCa || 0).toFixed(2)}€)` : ""; const activityAlert = (p.inactivityMonths || 0) > 2 - ? `\n⚠️ ALERTE : Inactif depuis ${p.inactivityMonths} mois` + ? `\n⚠️ ALERTE INACTIVITÉ : ${p.inactivityMonths} mois sans vente.` : ""; - return `Produit : ${p.libelle1} (${p.codein}) -PERFORMANCE GLOBALE : ${p.score.toFixed(1)}/100 -MARGE : ${p.tauxMarge.toFixed(1)}% -PRIX MOYEN (PMV) : ${pmv.toFixed(2)}€ -${volumeInfo}${relativeVolume} -${weights} -${totalContext} + return `PRODUIT : ${p.libelle1} (${p.codein}) +PERFORMANCE : Score ${p.score.toFixed(1)}/100 | Marge ${p.tauxMarge.toFixed(1)}% | PMV ${pmv.toFixed(2)}€ +${volumeInfo}${relativeVolume}${weights}${totalContext} -Régularité : ${p.regularityScore}/12 mois active -${projectionInfo}${activityAlert} +CYCLE DE VIE : ${p.regularityScore}/12 mois active${projectionInfo}${activityAlert} ---- HISTORIQUE DES VENTES (12 mois) --- +--- HISTORIQUE MENSUEL PONDÉRÉ --- ${monthlySummary} Recommandation actuelle : ${p.codeGamme || "Aucune"} -Verdict attendu : [A], [C] ou [Z] avec justification par les chiffres.`; +Verdict attendu (A, C ou Z) ?`; } static extractRecommendation(content: string): "A" | "C" | "Z" | null {