Architektura

Szybka referencja, co jest w pluginie — przydatna dla developerów theme’a, autorów pluginów i każdego diagnozującego nieoczekiwane zachowanie.

Top-level packages

P2Lab\Cache\
├── Api/              REST controllers (endpointy admin)
├── Command/          Komendy konsoli Symfony
├── Decorator/        Dekoratory wokół core serwisów Shopware
├── DependencyInjection/
├── Entity/           Definicje DAL dla własnych tabel pluginu
├── Enum/             Stałe trybów / strategii
├── Factory/          Fabryka cache-adapter
├── Framework/        Implementacja cache store
├── Helper/
├── Message/          Async message dispatchowane przez plugin
├── MessageHandler/   Handlery dla tych message
├── Migration/        Migracje bazy danych
├── P2LabCache.php    Entry point pluginu (lifecycle)
├── Resources/
├── ScheduledTask/    Trzy nocne zadania czyszczące (+ handlery)
├── Service/          Serwisy domenowe (większość logiki)
├── Storefront/
├── Subscriber/       Event subscribery wpinające się w Shopware
└── ValueObject/

Kluczowe serwisy

Serwis	Co robi
`CacheEntryService`	Czyta / zapisuje tabelę metadanych `p2lab_cache_entry`
`CacheInvalidationService`	Top-level API inwalidacji — `clearAll()`, `clearAllProducts()` itp.
`CacheWarmupService`	Odkrywa cache’owalne URL-e, tworzy wpisy progress, batchuje je
`CacheSizeService`	Raportuje całkowity rozmiar cache (dysk dla Filesystem; baza dla Redis / APCu)
`SmartInvalidationAnalyzer`	Mapowanie pole-do-tagu dla trybu Smart inwalidacji
`CacheInvalidationLogService`	Persystuje wiersze w `p2lab_cache_invalidation_log`
`ReverseProxyLogService`	Persystuje wiersze w `p2lab_cache_reverse_proxy_log`, plus query analityczne
`CacheTagService`	Buduje zestaw tagów dla danej odpowiedzi
`TagParserService`	Parsuje nazwy tagów z powrotem na referencje encji dla widoków logu
`RequestService`	Inspekcjonuje żądania, by zdecydować o cacheability i wyliczyć klucz cache
`SettingsService`	Czyta wartości `system_config` z fallbackiem per kanał sprzedaży

Dekoratory

Dekoruje	Cel
`SalesChannelContextFactory`	Cache’owany sales-channel context dla workerów warmupu
`ReverseProxyGateway`	Dodaje strategię xkey + blocklistę + splitowanie / skracanie przed wysłaniem purge do Varnisha

Subscribery

Subscriber	Słucha	Co robi
`CacheEntryFlushSubscriber`	`KernelEvents::TERMINATE`	Persystuje metadane nowo zapisanych wpisów po wysłaniu odpowiedzi
`CacheInvalidationSubscriber`	Eventy entity-written	Triggeruje pipeline inwalidacji (Manual / Basic / Extended / Precise / Smart)
`CacheResponseSubscriber`	`KernelEvents::RESPONSE`	Zapisuje odpowiedź do backendu, jeśli cache’owalna; ustawia nagłówki `Cache-Control`
`NotificationMessageSubscriber`	Custom plugin events	Pushuje notyfikacje admin (ukończenie warmupu itp.)
`TagCollectionSubscriber`	Eventy entity-loaded	Zbiera zestaw tagów, który odpowiedź powinna nieść
`XkeySubscriber`	Pre-purge event	Aplikuje blocklistę, splitowanie i skracanie na wychodzące nagłówki xkey

Async message

Message	Handler	Cel
`CacheWarmupStartMessage`	`CacheWarmupStartHandler`	Odpala run warmupu; spawnuje message batchowe
`CacheWarmupBatchMessage`	`CacheWarmupBatchHandler`	Przetwarza jeden batch URL-i

Zadania zaplanowane

Zadanie	Domyślny interwał	Co robi
`p2lab_cache.cleanup_cache_entries`	24 h	Usuwa osierocone wiersze `p2lab_cache_entry`
`p2lab_cache.cleanup_invalidation_log`	24 h	Usuwa wiersze logu inwalidacji starsze niż 30 dni
`p2lab_cache.cleanup_reverse_proxy_log`	24 h	Usuwa wiersze logu reverse-proxy starsze niż 30 dni

Zobacz Zadania zaplanowane.

Tabele bazy danych

Tabela	Cel
`p2lab_cache_entry`	Metadane każdego wpisu cache (rozmiar, typ, czas generowania / hit)
`p2lab_cache_invalidation_log`	Każde zdarzenie inwalidacji
`p2lab_cache_reverse_proxy_log`	Każdy xkey purge wysłany do Varnisha
`p2lab_cache_warmup_progress`	Jeden wiersz na run warmupu; śledzi offset i liczniki
`p2lab_cache_warmup_failed_url`	URL-e, które failowały podczas warmupu

Konwencje nazewnictwa tagów

Tagi cache tworzone przez plugin wszystkie zaczynają się od p2c-. Konwencje:

p2c-product-<id> — pełny tag produktu (jakakolwiek zmiana pola purguje)
p2c-product-<id>.<field> — tag na poziomie pola w trybie Smart (np. .price, .stock)
p2c-product-stock_<id> — tag tylko-stock, wystawiony osobno, by kategoria blocklisty product_stock mogła go izolować
p2c-category-<id> — pełny tag kategorii
p2c-listing-<categoryId> — tag listingu (purgowany, gdy pole członkowskiego produktu listing-affecting się zmienia)
p2c-cms-page-<id> — tag strony CMS
p2c-buybox-<productId> — tag async buyboxa

Te tagi są wysyłane do Varnisha przez xkey i też napędzają lokalny lookup inwalidacji.

Rozszerzanie pluginu

Dodaj nowy typ cache: zasubskrybuj KernelEvents::RESPONSE, ustaw typ przez obiekt odpowiedzi i dodaj prefiks tagu. Zaktualizuj getCacheStatsByType(), by o nim wiedział.
Dodaj pole do mapowania Smart: dekoruj SmartInvalidationAnalyzer i nadpisuj analyzeProductChange() lub analyzeCategoryChange().
Dodaj kategorię blocklisty xkey: rozszerz config xkeyTagBlocklist + dodaj pasujący wzorzec w XkeySubscriber.