Kowal Reservation Cleaner dla Magento 2

MAGENTO 2 · ERP · MSI · WYBRANE STOCKI

Kowal Reservation Cleaner

W wyspecjalizowanym wdrożeniu ERP-first uruchamiaj kontrolowane czyszczenie rezerwacji dla całej tabeli lub wybranych stocków. Dobierz harmonogram, logowanie, reindeksację i blokadę procesu.

Cron lub CLI · Log Only i Dry Run · Pełne lub selektywne czyszczenie

JAK TO DZIAŁA W PRAKTYCE

Moduł sprawdzi się, jeśli:

• stany magazynowe są regularnie importowane z ERP
• Magento nie jest głównym systemem magazynowym
• rezerwacje MSI zaburzają salable quantity
• potrzebne jest szybkie, przewidywalne i automatyczne czyszczenie rezerwacji
• sklep działa na wielu stockach i czyszczenie ma obejmować tylko wybrane z nich

Moduł nie jest przeznaczony dla sklepów, które zarządzają stanami wyłącznie po stronie Magento i polegają na pełnej logice MSI w czasie rzeczywistym.

W standardowym Magento 2 z MSI kolejne zamówienia, anulowania i wysyłki zapisują dane w inventory_reservation. W środowiskach z integracją ERP te rekordy często przestają być potrzebne operacyjnie, ale nadal wpływają na dostępność produktów i diagnozowanie stanów.

Najczęstsze skutki:

• zaniżone salable quantity
• rozjazdy między Magento i ERP
• narastająca liczba rekordów w inventory_reservation
• trudniejsza diagnostyka problemów magazynowych
• dodatkowe obciążenie obliczeń związanych z dostępnością

• automatyczne uruchamianie z Magento CRON
• ręczne uruchamianie przez CLI
• tryby full_reset, log_only i clean_after_erp_sync
• blokada przed równoległym uruchomieniem procesu
• opcjonalna reindeksacja po czyszczeniu
• opcjonalny cache clean po zakończeniu
• logowanie techniczne do pliku
• możliwość ograniczenia czyszczenia do wybranych stocków

Moduł rejestruje zadanie CRON uruchamiane często, ale rzeczywiste wykonanie następuje tylko wtedy, gdy aktualny czas zgadza się z konfiguracją. Dzięki temu nie trzeba dynamicznie przebudowywać harmonogramu systemowego po każdej zmianie ustawień.

Przebieg procesu:

1. Sprawdzenie, czy moduł jest aktywny.
2. Sprawdzenie, czy środowisko jest dozwolone.
3. Sprawdzenie harmonogramu.
4. Założenie blokady procesu.
5. Zliczenie rekordów rezerwacji.
6. Wykonanie czyszczenia lub tylko logowania.
7. Opcjonalna reindeksacja.
8. Opcjonalny cache clean.
9. Zwolnienie blokady i zapis logu.

Najprostszy i najszybszy wariant dla sklepów ERP-first.

Gdy czyszczenie dotyczy wszystkich stocków, moduł używa:

TRUNCATE TABLE inventory_reservation

To rozwiązanie jest najbardziej wydajne przy dużej liczbie rekordów.

Tryb diagnostyczny. Moduł nie usuwa danych, a jedynie zlicza rekordy i zapisuje wynik w logu.

Tryb przeznaczony do uruchamiania tuż po imporcie stanów z ERP. Funkcjonalnie czyści rezerwacje tak jak full_reset, ale porządkuje model wdrożenia i harmonogram.

Moduł obsługuje także scenariusz czyszczenia tylko dla wskazanych stocków.

Działanie:

• jeśli lista stocków jest pusta, czyszczona jest cała tabela rezerwacji
• jeśli wskazano konkretne stocki, moduł usuwa tylko rekordy dla tych stock_id

W takim przypadku używane jest zapytanie selektywne:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

To podejście jest wolniejsze niż TRUNCATE, ale pozwala zachować rezerwacje dla pozostałych stocków i daje większą kontrolę w bardziej złożonych wdrożeniach.

• lepsza zgodność stanów między Magento a ERP
• mniej błędów związanych z salable quantity
• prostsza diagnostyka stanów magazynowych
• mniejsze ryzyko narastania niepotrzebnych danych w MSI
• możliwość wdrożenia bez wyłączania Magento MSI
• przewidywalny i szybki proces możliwy do zautomatyzowania

Panel administracyjny:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Najważniejsze ustawienia:

• włączenie lub wyłączenie modułu
• wybór trybu działania
• godzina i minuta uruchomienia
• wybór stocków do czyszczenia
• włączenie reindeksacji
• typ reindeksacji
• cache clean po procesie
• logowanie
• czas ważności locka
• ograniczenie działania do wybranych środowisk

Podstawowa komenda:

bin/magento kowal:reservation:clean

Przykładowe użycie:

bin/magento kowal:reservation:clean --mode=full_reset bin/magento kowal:reservation:clean --mode=log_only bin/magento kowal:reservation:clean --reindex=inventory_only bin/magento kowal:reservation:clean --dry-run=1 bin/magento kowal:reservation:clean --stocks=1,2

To pozwala uruchamiać moduł ręcznie, testowo albo bezpośrednio po zakończeniu importu ERP.

Log techniczny jest zapisywany do:

var/log/kowal_reservation_cleaner.log

Moduł zawiera:

• blokadę procesu
• obsługę wyjątków
• kontrolę środowiska
• kontrolę slotu czasowego
• możliwość pracy w trybie log_only

Najbardziej praktyczny wariant dla sklepów ERP-first:

• tryb full_reset
• aktywne logowanie
• harmonogram uruchamiany chwilę po imporcie ERP
• reindeksacja inventory_only lub osobno w procesie integracyjnym
• puste pole stocków dla pełnego czyszczenia albo wskazane stocki tam, gdzie wymagany jest wariant selektywny

Ten moduł:

• nie naprawia logiki MSI
• nie rekonstruuje historii rezerwacji
• nie zastępuje poprawnie zaprojektowanej integracji ERP
• nie jest uniwersalnym rozwiązaniem dla wszystkich sklepów Magento

To wyspecjalizowane narzędzie dla wdrożeń, w których ERP zarządza realnym stanem magazynowym.

• Magento module: Kowal_ReservationCleaner
• Composer package: kowal/reservation-cleaner

Potrzebujesz wdrożenia lub dopasowania modułu do integracji ERP, wielu stocków albo niestandardowego harmonogramu? Skontaktuj się z nami przez kowal.store i opisz swój model synchronizacji magazynu.

Full Reset i Clean After ERP Sync usuwają rekordy rezerwacji w wybranym zakresie. Przy pustej liście stocków proces opróżnia całą tabelę inventory_reservation; przy wskazanych stockach usuwa tylko ich rekordy.

Wdrożenie wymaga modelu, w którym ERP zapewnia właściwe stany po uwzględnieniu procesu zamówień. Samo skasowanie rezerwacji nie potwierdza poprawności dostępności i nie odtwarza historii MSI.

Nazwa clean_after_erp_sync opisuje zastosowanie; nie stanowi automatycznej integracji ze zdarzeniem zakończenia importu ERP. Uruchomienie po synchronizacji organizujesz przez CLI lub odpowiednio dobrany harmonogram.

Cron sprawdza ustawiony slot czasowy oraz środowisko. Obsługa środowiska korzysta z APP_ENV lub MAGENTO_ENV i trybu Magento. Blokada ogranicza równoległe wykonania.

Log Only oraz --dry-run=1 służą do zliczenia rekordów bez ich usuwania. Zweryfikuj stock_id, zakończenie importu ERP i oczekiwane salable quantity przed włączeniem czyszczenia.

Reindeksacja i cache clean są opcjonalnymi etapami. Dobierz inventory_only, pełną reindeksację lub osobny proces indeksowania do rzeczywistej integracji magazynowej.

Pakiet kowal/reservation-cleaner, moduł Kowal_ReservationCleaner. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.

1. Ustalasz model synchronizacji
Potwierdzasz, kiedy ERP przekazuje właściwe stany.

2. Sprawdzasz zakres
Wybierasz stocki i analizujesz wynik Log Only lub Dry Run.

3. Uruchamiasz proces
Harmonogram lub CLI wykonuje czyszczenie i opcjonalną reindeksację.

ERP zakończył import stanów. Integracja uruchamia proces CLI dla ustalonego zakresu stocków, a wynik trafia do logu.

Tryb clean_after_erp_sync sam nie wykrywa zakończenia importu. Kolejność etapów zapewnia harmonogram lub integracja ERP.