Module professionnel pour les administrateurs de PrestaShop

Ce module complète le journal standard de PrestaShop avec des informations ultra-précises sur toutes les actions effectuées, y compris des informations sur les valeurs avant et après l'enregistrement de toutes les valeurs qui peuvent être modifiées dans le panneau d'administration de la boutique.

Le module gère d'énormes quantités de données et les stocke efficacement dans un système de repli à 4 niveaux : Redis → Mémoire → RAM → Fichier

Fonctionnalité

• Système de secours à 4 niveaux: Redis → Mémoire → RAM → Fichier
• Enregistrement des actions administratives: ajout, modification, suppression d'objets
• Enregistrement des actions API: identification des clés API
• Interface d'administration: navigation et filtrage des journaux
• Migration automatique: scripts CRON pour le traitement des journaux
• Efficacité: impact minimal sur les performances de la boutique

Journalisation automatique

• Objets: Produit, catégorie, commande, client, etc.
• Modules: installation/désinstallation
• Configuration: modification des paramètres de la boutique
• API: appels avec identification de la clé

Architecture de connexion

Niveaux de repli

1. Redis (performances les plus élevées, recommandé)
   • RPUSH des journaux dans la file d'attente activity_log
   • Traitement asynchrone via cron
2. Table mémoire MySQL (haute performance)
   • Table Ps_activity_log_buffer (ENGINE=MEMORY)
   • Opérations rapides en RAM
3. Tampon en mémoire (performance moyenne)
   • Table PHP en mémoire tout au long de la requête
   • Vidage à la fin de l'exécution(shutdown)
4. Fichier NDJSON (fallback)
   • Écriture dans var/logs/activity_fallback.ndjson
   • Migration via cron vers la base de données

Structure du journal

{"action" : "create|update|delete|config|install|uninstall", "object_type" : "Product", "object_id" : 123, "employee_id" : 1, "api_key" : "Bearer xyz...", "context" : "{"controller" : "AdminProducts", "object_name" : N "Produit test", {"product_reference" : "REF123", "product_active" : "1", "changed_fields" : "update_detected", "update_timestamp" : "2024-01-01 12:00:00", "ip_address" : "192.168.1.1", "user_agent" : "Mozilla/5.0...}", "created_at" : "2024-01-01 12:00:00" }

Contexte étendu pour différents objets

• Produit: référence_produit, produit_actif
• Catégorie: catégorie_active, catégorie_parent
• Commande: état de la commande, total de la commande
• Client: customer_email, customer_active
• Module: nom_du_module, version_du_module, auteur_du_module, nom_d'affichage_du_module

Suivi des modifications avant/après

Le module suit automatiquement les modifications au niveau du champ à l'aide de crochets Avant/Après :

• Crochets avant: hookActionObjectUpdateBefore, hookActionObjectDeleteBefore
• Crochets après: hookActionObjectUpdateAfter, hookActionObjectDeleteAfter
• Définitions du modèle d'objet: utilise $definition['fields'] pour un suivi précis
• Détection des changements: Comparaison des valeurs avant et après modification

Exemple de contexte de changement de champ :

{ "field_changes" : { "name" : { "from" : "Ancien nom de produit", "à" : "Nouveau nom de produit" }, "price" : { "from" : "Old product name", "to" : "New product name" }, "price" : { "from" : 19.99, "à" : 29.99 }, "actif" : { "from" : 0, "à" : 1 } } }

cd modules/pshowlogger vendor/bin/phpunit