visual_merchandising.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script visual_merchandising.py

Version 1.0.0

Date de création 19/03/2026

Auteur / Demandeur Gemini (Basé sur le code fourni)

Objectif principal Gérer l’inventaire, analyser les performances de vente et optimiser le placement de produits pour une boutique de mode/luxe.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script est un outil de gestion hybride (Inventaire + Business Intelligence). Il permet de saisir des produits avec des critères de merchandising (emplacement, visibilité), d’enregistrer des ventes en temps réel, et de générer un rapport Excel professionnel automatisé incluant des KPIs financiers et des alertes de stock.

📌 Problème résolu

Il remplace les suivis manuels fastidieux en centralisant les données de stock, les calculs de rentabilité (ROI, marges) et les recommandations stratégiques de réassort ou de repositionnement en rayon.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.10+

OS cible Windows / Linux / MacOS

Mode d’exécution CLI (Console Interactive)

📦 Dépendances / Librairies

Standard : os, sys, json, datetime, pathlib.

Externes : * pandas : Manipulation des données.

openpyxl : Création et stylisation poussée des rapports Excel (graphiques, bordures, couleurs).

📥 ENTRÉES (INPUTS)

📂 Fichiers / Sources de données

Type Chemin / Format Description

JSON ./boutique_data.json Base de données locale (produits, ventes, config).

Clavier Input utilisateur Saisie interactive des prix, stocks et emplacements.

📤 SORTIES (OUTPUTS)

📂 Fichiers / Données en sortie

Type Chemin / Format Description

Excel merchandising_[Nom]_[Date].xlsx Rapport complet avec 5 feuilles (Dashboard, Catalogue, Finance, Ventes, Alertes).

JSON ./boutique_data.json Mise à jour de la base de données après chaque action.

🧱 STRUCTURE DU SCRIPT

visual_merchandising.py

📌 CONFIG : Palette de couleurs « Luxe » (Or, Noir, Gris) et listes de référence (Catégories, Emplacements).

📌 GESTION DATA : Fonctions load_data / save_data.

📌 MOTEUR DE CALCUL : Logique métier (Marges, ROI, Rotation, Score Merch).

📌 INTERFACE : Menus de saisie et sélection de listes.

📌 MOTEUR EXPORT : Construction du fichier Excel stylisé avec openpyxl.

📌 MAIN : Boucle de menu principal.

🔧 Détail des fonctions clés

Fonction Paramètres Retour Rôle

calc_marge() Px Achat, Px Vente dict Calcule marge brute, taux de marque et coeff.

calc_score_merchandising() Produit (dict) int Note /100 basée sur la visibilité et l’emplacement.

recommandation_auto() Produit (dict) str Génère un conseil d’action (ex: « Déplacer en zone premium »).

export_excel() Data (dict) str Génère le rapport Excel formaté avec styles « Luxe ».

🔄 LOGIQUE / ALGORITHME

Initialisation : Chargement du JSON ou création du profil boutique.

Boucle Menu :

Saisie Produit : L’utilisateur entre les données -> Calcul immédiat des KPIs -> Ajout au JSON.

Vente : Sélection produit -> Décrémentation stock -> Archivage transaction.

Analyse : Calcul des moyennes globales (Score Merch, CA estimé sur 30j).

Export : Conversion des dictionnaires en feuilles Excel avec application de styles conditionnels (Rouge pour les ruptures, Vert pour les performances).

🚨 GESTION DES ERREURS

Saisie numérique : input_float et input_int forcent l’utilisateur à recommencer en cas de texte invalide.

Stock insuffisant : Alerte si on tente de vendre plus que le stock disponible (vente partielle).

ID introuvable : Message d’erreur lors de l’enregistrement d’une vente si l’ID est erroné.

✅ CONTRAINTES & RÈGLES MÉTIER

Calcul ROI : Basé sur une projection à 30 jours contre investissement merchandising.

Score Visibilité : Les emplacements « Vitrine » et « Îlot central » reçoivent des bonus automatiques.

Formatage : Le rapport Excel doit respecter strictement la charte graphique définie (Police Calibri, couleurs HEX spécifiques).

🧪 TESTS ATTENDUS

Cas nominal : Ajout d’un produit, vente de 1 unité, vérification de la baisse de stock.

Rupture : Saisir un stock actuel à 0 -> Vérifier que l’export Excel affiche « 🔴 RUPTURE » en cellule de statut.

Calcul Marge : Vérifier qu’un achat à 50€ et vente à 100€ donne un taux de marque de 50% et coeff de 2.0.

📊 PERFORMANCES ATTENDUES

Temps d’export : < 2 secondes pour 500 produits.

Taille fichier : JSON léger (< 1Mo), Excel optimisé sans images lourdes.