MedBrain : l'audit trail indispensable pour votre boutique PrestaShop

Qui a modifié ce produit ? Quand ? Pourquoi le prix a-t-il changé ? Un employé a supprimé une catégorie par erreur… MedBrain répond à toutes ces questions et vous permet de restaurer n'importe quel objet en un clic.
1. Le problème : naviguer à l'aveugle
Tout gérant de boutique PrestaShop a déjà vécu cette situation : un prix qui change sans explication, une fiche produit modifiée par un collaborateur sans que personne ne s'en souvienne, ou pire, un objet supprimé par erreur sans aucun moyen de le récupérer.
Par défaut, PrestaShop ne conserve aucun historique des modifications apportées aux objets du back-office. Que ce soit un produit, un client, une commande, un transporteur ou une règle de prix, chaque modification écrase purement et simplement la version précédente. Il n'existe aucun journal d'activité natif permettant de savoir :
- Qui a effectué la modification
- Quand elle a eu lieu
- Quels champs ont été modifiés
- Quelles étaient les valeurs avant et après le changement
Cette absence de traçabilité pose de sérieux problèmes sur les boutiques gérées par plusieurs personnes : conflits entre collaborateurs, erreurs non détectées, impossibilité de revenir en arrière et temps considérable passé à diagnostiquer l'origine d'un problème.
2. La solution : MedBrain
MedBrain est un module PrestaShop d'audit trail complet qui transforme votre back-office en un environnement entièrement traçable. Il enregistre automatiquement chaque création, modification et suppression d'objet, stocke les données avant et après chaque changement, et vous offre la possibilité de restaurer n'importe quelle version antérieure en un seul clic.
Pensez-y comme un système de versioning — similaire à Git pour le code source — mais appliqué à l'ensemble des données de votre boutique PrestaShop. Chaque changement est tracé, chaque version est conservée, et rien n'est jamais définitivement perdu.
En résumé, MedBrain vous apporte :
- Un historique complet et automatique de toutes les modifications
- La traçabilité par employé, date, heure et adresse IP
- La comparaison champ par champ des versions (diff)
- La restauration instantanée d'objets modifiés ou supprimés
- L'export CSV de l'historique pour audit externe
3. Comment ça fonctionne
MedBrain s'appuie sur le système de hooks natifs de PrestaShop pour intercepter les opérations sur les objets. Cette approche est non invasive : le module n'utilise aucun override et ne modifie aucun fichier core de PrestaShop.
3.1. Détection automatique
Dès qu'un objet PrestaShop est créé, modifié ou supprimé dans le back-office, MedBrain intercepte l'événement via les hooks actionObjectAddAfter, actionObjectUpdateBefore, actionObjectUpdateAfter et actionObjectDeleteBefore. Le module capture l'état complet de l'objet à chaque étape.
3.2. Enregistrement intelligent
Pour chaque événement, MedBrain enregistre :
- La classe de l'objet (Product, Customer, Order, Category…)
- L'identifiant de l'objet
- Le type d'action (création, modification, suppression)
- Les données complètes avant et après modification (format JSON)
- La liste précise des champs modifiés avec leurs valeurs avant/après
- L'employé responsable de l'action
- La date et l'heure exactes
- L'adresse IP de l'employé
- L'identifiant de la boutique (support multi-shop)
3.3. Détection intelligente des changements
MedBrain ne se contente pas d'enregistrer aveuglément. Le module compare les données avant et après la modification et détecte les champs qui ont réellement changé. Les champs système comme date_upd ou updated_at sont automatiquement ignorés pour éviter les faux positifs. Si une opération de « mise à jour » ne modifie aucun champ significatif, aucune entrée n'est créée dans l'historique.
4. Fonctionnalités détaillées
4.1. Suivi automatique de +48 classes d'objets
Par défaut, MedBrain surveille les principales classes d'objets PrestaShop :
Classes suivies par défaut
- Commerce : Product, Category, Customer, Address, Order, OrderState, Cart, CartRule, Carrier, SpecificPrice
- Catalogue : CMS, Feature, FeatureValue, Image, Manufacturer, Supplier, Tax, TaxRule
- Administration : Employee, Profile, Group, Contact, Language, Currency
- Configuration : Country, Zone, Meta, Page, RangePrice, RangeWeight
Les classes purement techniques (Cache, Log, SearchEngine, StockAvailable…) sont exclues par défaut pour éviter un volume excessif de données. Vous pouvez personnaliser cette liste à tout moment depuis la configuration du module.
4.2. Restauration en un clic
C'est la fonctionnalité phare de MedBrain. Depuis la vue détaillée d'une entrée de l'historique, un bouton « Restaurer » permet de rétablir l'objet dans son état antérieur. Cela fonctionne pour :
- Les modifications : revenez à n'importe quelle version précédente d'un objet
- Les suppressions : recréez un objet supprimé avec toutes ses données d'origine, en conservant son identifiant original
Un dialogue de confirmation détaille exactement ce qui va être restauré avant de procéder, pour éviter toute erreur.
4.3. Comparaison champ par champ
Pour chaque modification, MedBrain affiche un tableau clair indiquant, pour chaque champ modifié, la valeur avant et après le changement. Cette vue diff permet d'identifier instantanément ce qui a été changé et d'évaluer si le changement était intentionnel.
4.4. Interface d'administration complète
Le module ajoute un contrôleur d'administration dédié avec :
- Liste paginable et filtrable de toutes les entrées de l'historique
- Filtres rapides par classe d'objet (les 15 plus fréquentes)
- Tri par date, classe, action, employé, IP
- Actions en masse (suppression groupée)
- Statistiques en temps réel (nombre total d'entrées, entrées du jour)
- Badges colorés pour identifier visuellement les types d'action (vert = création, orange = modification, rouge = suppression)
4.5. Gestion de la rétention
Pour éviter une croissance incontrôlée de la base de données, MedBrain propose deux mécanismes de nettoyage automatique :
- Nombre maximum de versions par objet : conservez uniquement les N dernières versions de chaque objet (les plus anciennes sont automatiquement supprimées)
- Durée de rétention : supprimez automatiquement les entrées datant de plus de X jours
Les deux paramètres peuvent être désactivés (valeur 0) pour un historique illimité.
4.6. Export CSV
L'historique complet peut être exporté au format CSV pour un traitement dans un tableur ou une intégration avec des outils d'audit externes. L'export respecte les filtres actifs, ce qui permet d'extraire uniquement les données pertinentes.
5. Cas d'utilisation concrets
Cas n°1 — Modification accidentelle d'un prix
Un employé modifie par erreur le prix d'un produit phare, passant de 49,90 € à 4,99 €. Sans MedBrain, plusieurs commandes partent au mauvais prix avant que l'erreur ne soit détectée. Avec MedBrain, l'administrateur reçoit l'alerte dans l'historique, identifie le changement en une seconde grâce à la vue diff, et restaure le prix correct en un clic.
Cas n°2 — Suppression d'une catégorie
Un collaborateur supprime accidentellement une catégorie contenant 200 produits. Normalement, cette catégorie est perdue définitivement. Avec MedBrain, l'entrée de suppression est enregistrée avec toutes les données de la catégorie. L'administrateur la restaure avec son identifiant d'origine.
Cas n°3 — Audit interne
Le responsable de la boutique souhaite vérifier toutes les modifications apportées aux fiches clients au cours du dernier mois. Il filtre l'historique par classe « Customer » et exporte le résultat en CSV. En quelques minutes, il dispose d'un rapport complet indiquant qui a modifié quoi, quand et depuis quelle adresse IP.
Cas n°4 — Diagnostic d'un bug
Un transporteur ne fonctionne plus correctement depuis quelques jours. Plutôt que de chercher aveuglément, l'administrateur filtre l'historique par la classe « Carrier » et identifie immédiatement qu'un employé a modifié la plage de poids du transporteur il y a trois jours. Il compare les valeurs et restaure la configuration correcte.
Cas n°5 — Gestion multi-employés
Sur une boutique gérée par 5 personnes, un désaccord survient sur qui a modifié les conditions d'une règle de panier. MedBrain règle la question en quelques secondes : l'historique indique clairement l'employé, la date et les changements exacts apportés à la règle.
6. Avant / Après MedBrain
| Scénario | Sans MedBrain | Avec MedBrain |
|---|---|---|
| Un prix est modifié par erreur | Impossible de savoir qui l'a changé ni quelle était la valeur d'origine | Employé, date et valeur d'origine identifiés en une seconde, restauration en un clic |
| Un objet est supprimé | Données perdues définitivement | Restauration complète depuis l'historique |
| Besoin d'un audit des modifications | Aucun outil disponible nativement | Historique filtrable + export CSV |
| Diagnostic d'un problème | Recherche manuelle longue et incertaine | Filtrage par classe/date, diff champ par champ |
| Responsabilité des employés | Aucune traçabilité | Chaque action est associée à un employé + IP |
7. Spécifications techniques
Le module utilise une seule table en base de données (medbrain_history) avec des index optimisés sur les colonnes les plus interrogées : object_class, id_object, action, id_employee et date_add. Les données avant/après sont stockées en JSON dans des champs LONGTEXT.
8. Installation et configuration
8.1. Installation
L'installation suit le processus standard de tout module PrestaShop :
- Téléchargez le fichier ZIP du module
- Dans le back-office PrestaShop, allez dans Modules > Gestionnaire de modules
- Cliquez sur « Installer un module » et sélectionnez le fichier ZIP
- Le module crée automatiquement sa table en base de données et s'enregistre sur les hooks nécessaires
8.2. Configuration
Après l'installation, accédez à la configuration du module pour paramétrer :
- Activation/Désactivation : activez ou désactivez le suivi à tout moment
- Classes suivies : cochez les classes d'objets à surveiller parmi la liste complète des classes PrestaShop détectées
- Champs ignorés : listez les noms de champs à exclure du suivi (un par ligne)
- Nombre max de versions : limitez le nombre de versions conservées par objet (0 = illimité)
- Durée de rétention : supprimez automatiquement les entrées de plus de X jours (0 = jamais)
Le module est opérationnel dès l'installation avec une configuration par défaut sensée. Les champs système (date_upd, date_update, updated_at, last_update) sont automatiquement ignorés.
9. Conclusion
Dans un environnement e-commerce où chaque donnée compte, naviguer sans historique des modifications revient à conduire sans rétroviseur. MedBrain comble cette lacune critique de PrestaShop en apportant une traçabilité complète, une capacité de restauration et une transparence indispensables à la gestion professionnelle d'une boutique en ligne.
Qu'il s'agisse de sécuriser les modifications de vos employés, de diagnostiquer rapidement un problème ou de récupérer des données supprimées, MedBrain s'installe en quelques secondes et fonctionne immédiatement, sans configuration complexe et sans modifier le moindre fichier de PrestaShop.
Protégez votre boutique dès maintenant
Installez MedBrain et ne perdez plus jamais une modification sur votre boutique PrestaShop.
Obtenir MedBrain