Konfiguracja magazynu: regały, półki, strefy i quiz lokalizacji

Struktura magazynu — hierarchia obiektów

Moduł modeluje magazyn jako hierarchię: od typu regału po konkretną lokalizację produktu.

Dodatkowo na boku hierarchii istnieją:

• ContainerType — typy pojemników/kontenerów (karton duży, kosz metalowy, paleta). Wymiary i kolor.
• Zone — strefy magazynowe (SKRETKI, PESZLE, OLIWY). Regały mogą być przypisane do stref.

Typy regałów i kontenerów

Definiowanie typu regału

Każdy typ regału (RackType) ma precyzyjne wymiary fizyczne, które wpływają na rendering mapy magazynu:

Typy kontenerów

Kontenery to pojemniki umieszczone na półkach — kartony, kosze, palety. Każdy ma wymiary i kolor:

Regały, półki i layout magazynu

Tworzenie regału

Regał to instancja typu regału umieszczona na planie magazynu:

• Label — czytelna nazwa: R01, A3, KABLE-LEWY-1
• Pozycja — (pos_x, pos_y) w centymetrach od lewego górnego rogu planu
• Rotacja — 0, 90, 180 lub 270 stopni
• Przypisanie strefowe — regał może należeć do jednej lub wielu stref (np. SKRETKI + GLOSNIKOWE)

Layout magazynu

Cały layout zapisywany jest jako JSON w endpoincie:

GET /api/warehouse/layout → {"racks": [...], "zones": [...], "dimensions": {...}}
PUT /api/warehouse/layout → zapisz nowy layout

Frontend renderuje regały na mapie 2D z uwzględnieniem wymiarów, rotacji i koloru typu. Pracownik widzi wizualną mapę magazynu z zaznaczonymi strefami.

Półki w regale

Każdy regał ma tablicę półek, numerowanych od dołu (position 0 = najniższa). Półka może mieć przypisany typ kontenera i status:

Mapowanie produktów do lokalizacji

Przypisywanie produktu do półki

Admin przypisuje produkt (po product_id lub SKU) do konkretnej półki:

POST /api/warehouse/product-locations
{
  "shelf_id": 42,
  "product_id": 12345,
  "sku": "YDYP-3x2.5-100m",
  "notes": "Cała szpula 100m"
}

Przy pakowaniu zamówienia, system może wyświetlić lokalizację: “R07, Półka 3” — pracownik wie, gdzie iść.

Skan-based confirmation

Pracownik może potwierdzić lokalizację skanując kod kreskowy produktu przy regale:

POST /api/warehouse/scan-confirm
{
  "ean": "5901234567890",
  "rack_label": "R07",
  "shelf_position": 3
}

System sprawdza czy produkt rzeczywiście jest przypisany do tej lokalizacji. Jeśli nie — alert.

AI Vision service

Eksperymentalny moduł: pracownik robi zdjęcie regału telefonem, system AI analizuje co widzi i porównuje z oczekiwanym stanem. Przydatne do szybkiego audytu: czy na regale R07, półka 3 naprawdę leży YDYp 3x2.5?

Quiz lokalizacji — gamifikacja wiedzy magazynowej

Problem: wdrożenie nowego pracownika

Magazyn ma setki SKU na dziesiątkach regałów. Nowy pracownik potrzebuje 1-2 tygodni, żeby zapamiętać rozkład. W tym czasie jest wolniejszy, popełnia więcej błędów (bierze z niewłaściwej półki), potrzebuje ciągłej pomocy kolegów.

Rozwiązanie: quiz z gamifikacją

Moduł quizu zadaje pytania o lokalizację produktów:

Funkcje quizu

API quizu

Status modułu — co działa, co planujemy

Zapytania BaseLinker API używane przez moduł magazynu

Moduł magazynu korzysta z następujących metod BaseLinker API:

Szczegółowa tabela wszystkich metod BaseLinker (priorytety, częstotliwość, rate limiting) jest w głównym artykule.

Integracja z flow pakowania

Moduł magazynu integruje się z głównym systemem pakowania przez pole strefa. Każdy produkt w katalogu BaseLinker ma custom field extra_field_15043 (strefa), który określa fizyczną lokalizację:

• SKRETKI → regały R01-R12 (strefa kabli)
• PESZLE → regały P01-P06 (strefa peszli)
• OLIWY → regały O01-O03 (strefa olejów)
• GLOSNIKOWE → regały G01-G04 (kable głośnikowe)

Gdy pracownik otwiera widok pakowania “Skrętki”, widzi tylko zamówienia z produktami ze strefy SKRETKI. Wie, że wszystkie kable są na regałach R01-R12. Moduł magazynu dokładnie mówi mu, na którym regale i półce leży konkretny kabel.

Podsumowanie

Moduł konfiguracji magazynu to fundament pod optymalizację operacji magazynowych. Nawet bez pełnego visual editora (który jest w roadmapie), sam fakt posiadania zmapowanych lokalizacji produktów + quizu znacząco skraca czas wdrożenia pracownika i redukuje błędy pickingu.

Ten moduł jest częścią systemu Pakowanie Kablowo. Sprawdź też: moduł resztek kablowych i checklisty kontroli jakości.

Zmapowanie lokalizacji dla magazynu z >100 SKU to inwestycja zwracająca się natychmiast. Pracownicy przestają szukać, a quiz gamifikuje nudny proces nauki rozkładu.