Resztki kablowe: moduł automatycznego dopasowania do zamówień

---

Problem resztek kablowych w magazynie e-commerce

Skąd się biorą resztki

Kabel elektryczny (np. YDYp 3x2.5) dostarczany jest na szpulach po 100m. Klient zamawia 15m — maszyna ESP odmierza, tnie, nawija. Zostaje 85m resztki. Następny klient zamawia 30m z tej resztki — zostaje 55m. I tak dalej, aż zostanie kawałek za krótki na jakiekolwiek zamówienie.

Co się dzieje bez systemu

Realna strata: Przed wdrożeniem modułu, 80% resztek lądowało na śmietniku. Przy średniej cenie kabla ~3 PLN/m i ~450m zmarnowanego kabla miesięcznie to ~1350 PLN strat miesięcznie tylko na materiale.

---

Jak działa moduł resztek

Lifecycle resztki

Każda resztka przechodzi przez trzy stany:

Dodawanie resztki

Pracownik po cięciu kabla rejestruje resztkę w systemie:

1. Skanuje EAN produktu (kod kreskowy z szpuli) lub wpisuje SKU
2. System automatycznie uzupełnia nazwę, strefę i miniaturę ze cache produktów
3. Wpisuje długość w metrach (np. 8.5m)
4. Opcjonalnie dodaje notatki (np. “lekko zgięty koniec”)
5. Klika “Dodaj resztkę”

Auto-matching: magia modułu

Moment, w którym moduł się zwraca. Przy dodawaniu resztki, system automatycznie szuka pasującego zamówienia:

create_leftover(data)
  → Normalize fields
  → Save to DB (status: AVAILABLE)
  → IF ean OR sku:
      → find_order_needing_product(ean, sku, length)
      → IF match found AND length >= needed_length:
          → reserve(leftover_id, order_id, needed_length)
          → status: AVAILABLE → RESERVED
          → WebSocket broadcast: leftover_updated

Algorytm szuka zamówienia ze statusem “do pakowania”, które zawiera produkt o tym samym EAN/SKU i potrzebuje długości mniejszej lub równej dostępnej resztce.

Przykład: Pracownik dodaje resztkę YDYp 3x2.5, długość 12m. System znajduje zamówienie #98765 które potrzebuje 10m tego kabla. Resztka zostaje automatycznie zarezerwowana dla tego zamówienia. Pracownik przy pakowaniu #98765 widzi informację: “Dostępna resztka 12m — użyj zamiast nowej szpuli.”

Wyszukiwanie produktów

Moduł oferuje inteligentne wyszukiwanie produktów do powiązania z resztką:

---

Rezerwacja, zużycie i częściowe wykorzystanie

Ręczna rezerwacja

Pracownik przy pakowaniu zamówienia może ręcznie zarezerwować resztkę:

1. Widzi na ekranie informację: “Dostępna resztka 12m kabla YDYp 3x2.5”
2. Klika “Użyj resztkę”
3. System rezerwuje resztkę dla tego zamówienia
4. Resztka znika z listy dostępnych — inni pracownicy nie mogą jej zabrać

Zużycie przy pakowaniu

Gdy zamówienie zostanie spakowane (trigger “spis” + “etykieta” odpalony), system automatycznie konsumuje wszystkie resztki zarezerwowane dla tego zamówienia:

consume_reserved_leftovers(order_id)
  → Find all leftovers with status=RESERVED AND reserved_for_order_id=order_id
  → For each: status RESERVED → CONSUMED, consumed_at = now()
  → Return list of consumed leftover IDs

Częściowe wykorzystanie

Kluczowa funkcja: resztka ma 12m, zamówienie potrzebuje 8m. Po zużyciu zostaje 4m — system tworzy nową resztkę 4m z tego samego produktu:

Nowa resztka 4m natychmiast przechodzi przez auto-matching — jeśli ktoś potrzebuje 3m tego kabla, zostanie zarezerwowana automatycznie.

Release (anulowanie rezerwacji)

Jeśli zamówienie zostanie anulowane lub zmienione, pracownik może zwolnić rezerwację:

POST /api/leftovers/{id}/release
→ status: RESERVED → AVAILABLE
→ reserved_for_order_id: null
→ WebSocket broadcast: leftover_updated

Resztka wraca na listę dostępnych i znowu uczestniczy w auto-matchingu.

---

API endpointy modułu resztek

Zapytania BaseLinker API używane przez moduł resztek

Moduł resztek korzysta z kilku metod BaseLinker API:

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

WebSocket: real-time updates

Każda zmiana stanu resztki (dodanie, rezerwacja, zużycie, zwolnienie) generuje broadcast WebSocket:

{"type": "leftover_updated"}

Wszystkie otwarte ekrany automatycznie odświeżają listę resztek. Pracownik A dodaje resztkę — pracownik B natychmiast widzi ją na swoim ekranie.

---

Oszczędności po wdrożeniu modułu

Wykorzystanie resztek kablowych: przed i po wdrożeniu modułu

Porównanie strat materiałowych i efektywności dopasowania

Oszczędność miesięczna

2100 PLN

Średnia resztka

8.5 m

Auto-matching

75%

Skąd te liczby

Przed modułem: 80% resztek lądowało na śmietniku. Pracownicy nie wiedzieli co leży w koszu resztek, nie mieli czasu szukać, więc cieniili nowe szpule. Średnio 450m kabla zmarnowanego miesięcznie.

Po wdrożeniu: 75% resztek jest automatycznie dopasowywanych do zamówień. Pozostałe 25% to kawałki za krótkie na jakiekolwiek zamówienie (poniżej 1m) — te trafiają do utylizacji.

Średnia długość resztki: 8.5m — to 8.5m kabla, który wcześniej lądowałby na śmietniku, a teraz idzie do klienta.

Czas szukania resztki: Z 12 minut (ręczne przeszukiwanie kosza) do 0 minut (auto-matching). Pracownik nie szuka — system informuje go, że resztka jest dostępna.

---

Podsumowanie

Moduł resztek to jeden z elementów systemu Pakowanie Kablowo — pełnego systemu magazynowego zbudowanego z Claude Code dla firmy kablowej. Sprawdź też inne moduły: konfiguracja magazynu i checklisty kontroli jakości.

Kluczowe w całym module: auto-matching. Pracownik nie szuka resztek — system robi to za niego. Jeśli sprzedajesz produkty na metry (kable, tkaniny, profile, rury), ten sam mechanizm zadziała u ciebie.