Profesjonalny moduł dla administratorów sklepów PrestaShop

Ten moduł uzupełnia standardowy log PrestaShop o ultra-precyzyjne informacje nt wszystkich akcji wykonywanych akcji, w tym informacje o wartościach przed i po zapisaniu wszystkich wartości możliwych do zmiany w panelu administracyjnym sklepu.

Moduł obsługuje ogromne ilości danych i wydajnie zapisuje je w 4-poziomowym systemie fallbacków: Redis → Memory → RAM → Plik

Funkcjonalności

• 4-poziomowy system fallbacków: Redis → Memory → RAM → Plik
• Logowanie działań administracyjnych: dodawanie, edycja, usuwanie obiektów
• Logowanie działań API: identyfikacja kluczy API
• Interfejs administratora: przeglądanie i filtrowanie logów
• Migracja automatyczna: skrypty CRON do przetwarzania logów
• Wydajność: minimalny wpływ na działanie sklepu

Automatyczne logowanie

• Obiekty: Product, Category, Order, Customer, etc.
• Moduły: instalacja/deinstalacja
• Konfiguracja: zmiany ustawień sklepu
• API: wywołania z identyfikacją klucza

Architektura logowania

Jeśli któryś z systemów jest wyłączony lub niedostępny, moduł automatycznie przeskoczy do następnego poziomu. 

1. Redis (najwyższa wydajność, rekomendowany)
   • RPUSH logów do kolejki activity_log
   • Asynchroniczne przetwarzanie przez cron
2. MySQL Memory Table (wysoka wydajność)
   • Tabela ps_activity_log_buffer (ENGINE=MEMORY)
   • Szybkie operacje w pamięci RAM
3. In-memory Buffer (średnia wydajność)
   • Tablica PHP w pamięci przez cały request
   • Flush na końcu wykonania (shutdown)
4. Plik NDJSON (fallback)
   • Zapis do var/logs/activity_fallback.ndjson
   • Migracja przez cron do bazy danych

Struktura loga

{
    "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": "Test Product",
        "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"
}

Rozszerzony kontekst dla różnych obiektów

• Product: product_reference, product_active
• Category: category_active, parent_category
• Order: order_state, order_total
• Customer: customer_email, customer_active
• Module: module_name, module_version, module_author, module_display_name

Śledzenie zmian Before/After

Moduł automatycznie śledzi zmiany na poziomie pól używając hooków Before/After:

• Hooki Before: hookActionObjectUpdateBefore, hookActionObjectDeleteBefore
• Hooki After: hookActionObjectUpdateAfter, hookActionObjectDeleteAfter
• Definicje ObjectModel: Wykorzystuje $definition['fields'] dla precyzyjnego śledzenia
• Wykrywanie zmian: Porównuje wartości przed i po modyfikacji

Przykład kontekstu zmian pól:

{
    "field_changes": {
        "name": {
            "from": "Stara nazwa produktu",
            "to": "Nowa nazwa produktu"
        },
        "price": {
            "from": 19.99,
            "to": 29.99
        },
        "active": {
            "from": 0,
            "to": 1
        }
    }
}

cd modules/pshowlogger
vendor/bin/phpunit