Produkty

Katalog produktów wymienia artykuły sprzedawane w kafejce internetowej lub centrum gamingowym. Obejmuje to jedzenie, napoje, przekąski, akcesoria i wszelkie inne towary oferowane klientom. Każdy produkt ma zdefiniowaną cenę, kategorię, stawkę podatkową i stan magazynowy. Produkty integrują się z systemem zamówień, umożliwiając kasjerom tworzenie zamówień, śledzenie sprzedaży i zarządzanie stanem magazynowym.

Produktami zarządza się na zakładce Produkty strony Magazyn w głównej nawigacji. Zakładka oferuje widok tabeli i widok siatki. Karty w widoku siatki pokazują zdjęcie produktu, cenę oraz odznakę W magazynie lub Brak w magazynie.

Pola produktu

Każdy rekord produktu zawiera następujące informacje:

Pole	Opis
`name`	Nazwa produktu wyświetlana w interfejsie zamówień. Musi być unikalna (bez rozróżniania wielkości liter).
`category`	Etykieta tekstowa grupująca powiązane produkty (np. "Napoje", "Przekąski", "Akcesoria"). Używana do filtrowania i raportowania.
`unit`	Jednostka miary do śledzenia stanów magazynowych (np. "sztuka", "kg", "litr", "puszka", "butelka").
`barcode`	Opcjonalna wartość kodu kreskowego do integracji ze skanerem. Kasjerzy mogą zeskanować kod kreskowy produktu, aby szybko dodać go do zamówienia.
`sale_price`	Cena sprzedaży w mniejszych jednostkach walutowych (np. grosze). To jest kwota pobierana od klienta za jednostkę.
`vat_rate`	Stawka VAT (podatku od towarów i usług) stosowana do tego produktu (np. 18 dla 18% VAT). Używana do obliczania komponentu podatkowego każdej sprzedaży.
`stock`	Bieżący stan magazynowy jako wartość dziesiętna. Aktualizowany automatycznie gdy zamówienia są realizowane i gdy rejestrowane są przyjęcia towarów. Stanu nie edytuje się na samym produkcie. Użyj zakładki Status magazynu strony Magazyn.
`min_stock`	Próg ponownego zamówienia. Gdy stan magazynowy spadnie do tej wartości lub poniżej, produkt jest oznaczany jako krytyczny na zakładce Status magazynu. Zero oznacza brak progu.
`description`	Opcjonalny opis tekstowy z dodatkowymi szczegółami produktu.
`photo`	Opcjonalne zdjęcie produktu pokazywane w widoku siatki oraz w menu kafeterii.

Wycofanie produktu ze sprzedaży

Produkt, który nie powinien być już oferowany, usuwa się akcją Usuń ze sprzedaży na zakładce Produkty. Potwierdzenie wyjaśnia, że usuwa to produkt z katalogu i nie można tego cofnąć. Wcześniejsze zamówienia zawierające ten produkt zachowują zrzuty swoich pozycji, więc historyczne dane sprzedażowe są zachowane.

Śledzenie stanów magazynowych

HandyCafe utrzymuje bieżący stan magazynowy każdego produktu. Ta wartość jest automatycznie aktualizowana przez system w odpowiedzi na:

Sprzedaż: Gdy produkt jest sprzedany przez zamówienie, stan magazynowy zmniejsza się o zamówioną ilość.
Przyjęcia towarów: Gdy nowy towar jest przyjęty i zarejestrowany na zakładce Przyjęcie towaru strony Magazyn, stan magazynowy odpowiednio wzrasta.
Ręczne korekty: Zakładka Status magazynu oferuje akcje Popraw stan, Strata i Inwentaryzacja, aby uwzględnić przeterminowanie, uszkodzenia, rozbieżności w liczeniu lub inne niezgodności.

Stanu magazynowego nie da się edytować w edytorze produktu. Wszystkie zmiany stanu przechodzą przez zakładkę Status magazynu, dzięki czemu każda zmiana trafia do historii ruchów.

Dziennik stanów magazynowych

Każda zmiana stanu magazynowego produktu jest rejestrowana w dzienniku stanów magazynowych, tworząc pełną ścieżkę audytu:

Powód	Opis
`sale`	Stan zmniejszył się wskutek zamówienia klienta. Powiązany z konkretnym rekordem zamówienia.
`purchase`	Stan zwiększył się wskutek zakupu inwentaryzacyjnego. Powiązany z konkretnym wpisem inwentaryzacyjnym.
`adjustment`	Stan został ręcznie skorygowany przez kasjera lub administratora.
`waste`	Stan zmniejszył się wskutek przeterminowania, uszkodzenia lub odpisu.
`return`	Stan zwiększył się wskutek zwrotu klienta lub anulowania zamówienia.

Każdy wpis dziennika rejestruje zmianę ilości (wartość dodatnia dla wzrostów, ujemna dla spadków), nowy stan magazynowy po zmianie, kto dokonał zmiany oraz opcjonalną notatkę wyjaśniającą powód.

Kategorie produktów

Produkty są grupowane według kategorii za pomocą pola tekstowego. Typowe kategorie to:

Napoje (napoje gazowane, woda, napoje energetyczne)
Napoje gorące (kawa, herbata, gorąca czekolada)
Przekąski (chipsy, cukierki, batony czekoladowe)
Jedzenie (kanapki, wrapy, ciepłe dania)
Akcesoria (słuchawki, pendrivy, podkładki pod mysz)

Kategorie służą do filtrowania w interfejsie zamówień. Kasjerzy mogą szybko przełączać się między kategoriami, aby znaleźć odpowiedni produkt. Kategorie służą również do grupowania w raportach sprzedaży.

Nie ma osobnego interfejsu zarządzania kategoriami. Kategorie są tworzone niejawnie gdy przypisujesz nazwę kategorii do produktu. Aby zmienić nazwę kategorii, zaktualizuj pole kategorii we wszystkich produktach używających starej nazwy.

Tworzenie produktu

Aby dodać nowy produkt do katalogu:

Otwórz stronę Magazyn z paska bocznego i przejdź na zakładkę Produkty.
Kliknij przycisk Nowy produkt.
Wpisz nazwę (musi być unikalna).
Wybierz lub wpisz kategorię.
Wybierz jednostkę miary.
Ustaw cenę sprzedaży (kwotę pobieraną od klientów).
Ustaw stawkę VAT.
Opcjonalnie wpisz kod kreskowy do obsługi skanera i dodaj zdjęcie.
Kliknij Zapisz.

Początkowego stanu magazynowego nie ustawia się tutaj. Zarejestruj ilość początkową przyjęciem towaru albo akcją Inwentaryzacja na zakładce Status magazynu. Produkt można też utworzyć bezpośrednio z linii przyjęcia, gdy dostawa zawiera artykuł, którego nie ma jeszcze w katalogu.

Edycja produktu

Wybierz produkt z listy, aby otworzyć jego edytor. Możesz zaktualizować dowolne pole w tym nazwę, cenę, kategorię, stawkę VAT, kod kreskowy i zdjęcie. Zmiany wchodzą w życie natychmiast. Jeśli zaktualizujesz cenę, nowa cena dotyczy wszystkich przyszłych zamówień. Akcja Usuń ze sprzedaży usuwa produkt z katalogu po potwierdzeniu.

Wcześniejsze zamówienia nie są objęte zmianami cen. Każda pozycja zamówienia przechowuje unit_price z momentu sprzedaży jako zrzut.

Integracja z zamówieniami

Gdy kasjer tworzy zamówienie i dodaje produkt:

Bieżąca cena sprzedaży i stawka VAT produktu są kopiowane do pozycji zamówienia jako zrzuty.
Suma pozycji jest obliczana jako cena_jednostkowa * ilość.
Gdy zamówienie jest finalizowane, stan magazynowy produktu jest zmniejszany o zamówioną ilość.
Tworzony jest wpis dziennika stanów z reason = 'sale' powiązany z zamówieniem.

Jeśli zamówienie zostanie później anulowane lub zwrócone, stan magazynowy może być przywrócony poprzez wpis dziennika zwrotu.