Módulo profesional para administradores de tiendas PrestaShop

Este módulo está diseñado para administradores de tiendas profesionales que desean tener una visión completa del historial de cambios de todos los ajustes y campos del panel de administración de su tienda PrestaShop.

El módulo complementa el registro estándar de PrestaShop con información ultraprecisa sobre todas las acciones realizadas, incluida información sobre los valores antes y después de guardar todos los valores modificables en el panel de administración de la tienda.

El módulo maneja enormes cantidades de datos y los almacena de manera eficiente en un sistema de reserva de 4 niveles: Redis → Memoria → RAM → Archivo

Funcionalidad

• Sistema fallback de 4 niveles: Redis → Memoria → RAM → Archivo
• Registro de acciones administrativas: añadir, editar, eliminar objetos
• Registro de acciones de la API: identificación de claves de la API
• Interfaz de administración: navegación y filtrado de registros
• Migración automática: secuencias de comandos cron para procesar los registros
• Eficiencia: impacto mínimo en el rendimiento de la tienda

Registro automático

• Objetos: Producto, Categoría, Pedido, Cliente, etc.
• Módulos: instalación/desinstalación
• Configuración: cambios en los ajustes de la tienda
• API: llamadas con clave de identificación

Arquitectura de inicio de sesión

Si uno de los sistemas está deshabilitado o no disponible, el módulo saltará automáticamente al siguiente nivel.

1. Redis (mayor rendimiento, recomendado)
   • RPUSH de logs a la cola activity_log
   • Procesamiento asíncrono mediante cron
2. Tabla de memoria MySQL (alto rendimiento)
   • Tabla Ps_activity_log_buffer (ENGINE=MEMORY)
   • Operaciones RAM rápidas
3. Buffer en memoria (rendimiento medio)
   • Tabla PHP en memoria durante toda la petición
   • Flush al final de la ejecución(shutdown)
4. Archivo NDJSON (fallback)
   • Escritura en var/logs/activity_fallback.ndjson
   • Migración vía cron a base de datos

Estructura del registro

{ "acción": "crear|actualizar|eliminar|configurar|instalar|desinstalar", "object_type": "producto", "object_id": 123, "employee_id": 1, "api_key": "Bearer xyz...", "context": "{"controller": "AdminProducts", "object_name": "Test Product", "product_reference": "REF123", "product_active": "1", "campos_cambiados": "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" }

Contexto ampliado para diferentes objetos

• Producto: product_reference, product_active
• Categoría: category_active, parent_category
• Pedido: order_state, order_total
• Cliente: customer_email, customer_active
• Módulo: module_name, module_version, module_author, module_display_name

Seguimiento de cambios Antes/Después

El módulo realiza un seguimiento automático de los cambios a nivel de campo utilizando ganchos Before/After:

• Ganchos Antes: hookActionObjectUpdateBefore, hookActionObjectDeleteBefore
• Ganchos After: hookActionObjectUpdateAfter, hookActionObjectDeleteAfter
• Definiciones ObjectModel: utiliza $definition['fields'] para un seguimiento preciso
• Detección de cambios: Compara los valores antes y después de la modificación

Ejemplo de contexto de cambios de campo:

{ "cambios_campo": { "name": { "from": "Antiguo nombre del producto", "a": "Nuevo nombre del producto" }, "price": { "from": 19.99, "to": 29.99 }, "active": { "desde": 0, "to": 1 } } }

cd modules/pshowlogger vendor/bin/phpunit