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énarioSans MedBrainAvec MedBrain
Un prix est modifié par erreurImpossible de savoir qui l'a changé ni quelle était la valeur d'origineEmployé, date et valeur d'origine identifiés en une seconde, restauration en un clic
Un objet est suppriméDonnées perdues définitivementRestauration complète depuis l'historique
Besoin d'un audit des modificationsAucun outil disponible nativementHistorique filtrable + export CSV
Diagnostic d'un problèmeRecherche manuelle longue et incertaineFiltrage par classe/date, diff champ par champ
Responsabilité des employésAucune traçabilitéChaque action est associée à un employé + IP

7. Spécifications techniques

Compatibilité PrestaShopVersion 1.6.0 à 9.x
Compatibilité PHP 5.6, 7.x, 8.x
Langues17 langues incluses
Architecture100% hooks, aucun override
Multi-boutiqueSupport complet multi-shop
Base de données1 table indexée, nettoyage auto
SécuritéTokens CSRF, pSQL(), validation
Version actuellev1.0.0 (janvier 2026)

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 :

  1. Téléchargez le fichier ZIP du module
  2. Dans le back-office PrestaShop, allez dans Modules > Gestionnaire de modules
  3. Cliquez sur « Installer un module » et sélectionnez le fichier ZIP
  4. 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