Checklisty: kontrola jakości i protokoły wydania przesyłek

---

Dlaczego checklisty w magazynie kablowym

Trzy problemy bez checklist

Co dają checklisty

Kontrola jakości kabli to nie jest “sprawdź czy OK”. To konkretne kroki:

• Czy metraż zgadza się z zamówieniem (pomiar kontrolny)?
• Czy kabel jest poprawnie nawinięty (nie poplątany)?
• Czy etykieta jest na właściwym zamówieniu?
• Czy opakowanie jest zabezpieczone taśmą?
• Czy gabaryt paczki jest prawidłowy (A/B/C)?

Protokoły wydania przesyłek dokumentują moment przekazania paczek przewoźnikowi:

• Ile paczek wydano (count per carrier)?
• Kto wydał (pracownik magazynu)?
• Kto odebrał (kierowca — podpis/zdjęcie)?
• O której godzinie (timestamp)?
• Zdjęcie załadowanego samochodu

---

Szablony checklist — admin tworzy, system wykonuje

Tworzenie szablonu

Admin definiuje szablon checklisty z listą kroków:

Parametry szablonu

Parametry kroku

Każdy krok szablonu ma:

• description — opis czynności do wykonania
• media_description — co dokładnie sfotografować/nagrać (np. “zdjęcie taśmy zabezpieczającej”)
• media_required — czy zdjęcie/video jest obowiązkowe
• estimated_minutes — szacowany czas na krok
• requires_package_count — czy krok wymaga wpisania liczby paczek

---

Instancje i wykonanie krok po kroku

Codzienne instancje

System automatycznie tworzy instancje checklist na podstawie szablonów. Pracownik otwiera “Checklisty” i widzi dzisiejsze zadania:

Wykonanie kroku

Pracownik klika na checklist, widzi listę kroków i realizuje je po kolei:

POST /api/checklists/instances/{id}/complete-step
{
  "step_id": 3,
  "notes": "Wszystkie paczki zabezpieczone taśmą",
  "package_count": 47,
  "completed_by": "worker1"
}

Po wykonaniu kroku, można uploadować media (zdjęcie/video) jako dowód.

Zakończenie checklisty

Gdy wszystkie kroki wykonane:

POST /api/checklists/instances/{id}/complete
{
  "notes": "Wydanie DPD kompletne, 47 paczek",
  "completed_by": "worker1"
}

System zapisuje timestamp zakończenia i notuje kto wykonał. WebSocket broadcast informuje panel admina.

Force-create (ad-hoc)

Czasem potrzebna jest checklist poza planem — np. kontrola po reklamacji klienta lub niespodziewana wizyta audytora:

POST /api/checklists/force-create
{
  "template_id": 5,
  "reason": "Reklamacja klienta #12345 — kontrola serii"
}

System tworzy instancję natychmiast, niezależnie od harmonogramu.

---

Upload zdjęć i video — dokumentacja wizualna

System mediów

Każdy krok checklisty może mieć załączone media:

Organizacja plików

Media organizowane automatycznie w strukturze katalogowej:

uploads/
  checklists/
    2026/
      04/
        03/
          a1b2c3d4-kontrola-dpd-taśma.jpg
          e5f6g7h8-wydanie-inpost-załadunek.mp4
  transport/
    2026/
      04/
        03/
          i9j0k1l2-trip-dpd-załadunek.jpg

UUID prefix zapewnia unikalność nazw (brak kolizji). Oryginalna nazwa na końcu pozwala na identyfikację zawartości bez otwierania pliku.

Metadane pliku

Każdy upload zapisuje:

• uploaded_by — kto uploadował (user ID + nazwa)
• uploaded_at — timestamp
• mime_type — typ pliku (image/jpeg, video/mp4)
• file_size — rozmiar w bajtach
• original_filename — oryginalna nazwa pliku

Pobieranie mediów

GET /api/checklists/media/{media_id}
→ FileResponse (bezpośredni download pliku)

Admin może przeglądać media z panelu — klikając w krok checklisty widzi wszystkie załączone zdjęcia i video.

---

Protokoły wydania przesyłek (shipment handover)

Specjalny typ checklisty: shipment_handover — dedykowany do dokumentowania przekazania paczek przewoźnikowi.

Flow wydania

Carrier group filtering

Szablony checklisty mogą być filtrowane po grupie przewoźnika. Szablon “Wydanie DPD” pojawia się tylko gdy są paczki DPD do wydania. Nie zaśmieca listy, gdy dany przewoźnik danego dnia nie jest obsługiwany.

Powiązanie z transportem

Zakończenie checklisty wydania automatycznie tworzy wpis w module transportowym:

POST /api/orders/transport/{group}/depart
→ VehicleTrip created (departure_at, group, package_count)

Historia kursów jest dostępna w panelu admin: kto, kiedy, ile paczek, jakim przewoźnikiem.

---

Mini-inwentaryzacja powiązana z checklistami

Kontrola strefowa

Checklisty mogą zawierać kroki inwentaryzacyjne: pracownik liczy produkty na wybranych regałach i porównuje z stanem w systemie.

API inwentaryzacji

Rozbieżności powyżej progu (np. >5%) generują alert na dashboardzie admina.

Zapytania BaseLinker API używane przez moduł checklist

Checklisty (szczególnie inwentaryzacja i wydanie przesyłek) korzystają z metod BaseLinker API:

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

---

Pełne API modułu checklist

WebSocket events

Każda zmiana checklisty generuje broadcast:

{"type": "checklist_updated", "instance_id": 789}

Panel admina i ekrany pracowników odświeżają się automatycznie.

---

Podsumowanie

Checklisty to element systemu Pakowanie Kablowo. Sprawdź też: moduł resztek kablowych i konfiguracja magazynu.

Najprostsza forma dokumentacji pakowania to checklist z wymogiem zdjęcia per krok. Daje ci dowód w sporze z klientem — co, kiedy, kto sprawdził.