Produkty

Strona Produkty zarządza katalogiem artykułów sprzedawanych 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 inwentarzem.

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 zakupy inwentaryzacyjne są rejestrowane.
`active`	Przełącznik kontrolujący czy produkt pojawia się w interfejsie zamówień. Nieaktywne produkty są ukryte przed kasjerami, ale zachowane w bazie danych do raportowania historycznego.
`description`	Opcjonalny opis tekstowy z dodatkowymi szczegółami produktu.

Przełącznik Aktywny / Nieaktywny

Produkty mogą być przełączane między stanami aktywnym i nieaktywnym:

Aktywne produkty pojawiają się w interfejsie zamówień i mogą być dodawane do nowych zamówień.
Nieaktywne produkty są ukryte w interfejsie zamówień, ale pozostają w bazie danych. Wcześniejsze zamówienia zawierające ten produkt zachowują swoje referencje, więc historyczne dane sprzedażowe są zachowane.

Jest to przydatne dla artykułów sezonowych, wycofanych produktów lub artykułów tymczasowo niedostępnych, które nie powinny być oferowane klientom.

Ś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ść.
Zakupy inwentaryzacyjne: Gdy nowy towar jest przyjęty i zarejestrowany na stronie Inwentaryzacja, stan magazynowy odpowiednio wzrasta.
Ręczne korekty: Kasjerzy lub administratorzy mogą ręcznie korygować stan magazynowy w celu uwzględnienia przeterminowania, uszkodzeń, rozbieżności w liczeniu lub innych niezgodności.

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:

Przejdź do strony Produkty z paska bocznego.
Kliknij przycisk Dodaj produkt na pasku narzędzi.
Wpisz nazwę (musi być unikalna).
Wybierz lub wpisz kategorię.
Wybierz jednostkę miary.
Ustaw cenę sprzedaży (kwotę pobieraną od klientów, w mniejszych jednostkach walutowych).
Ustaw stawkę VAT (jako ułamek dziesiętny, np. 0,08 dla 8%).
Opcjonalnie wpisz kod kreskowy do obsługi skanera.
Ustaw początkowy stan magazynowy jeśli dotyczy.
Kliknij Zapisz.

Edycja produktu

Wybierz produkt z listy, aby otworzyć jego widok szczegółowy. Możesz zaktualizować dowolne pole w tym nazwę, cenę, kategorię, stawkę VAT, stan magazynowy i status aktywności. Zmiany wchodzą w życie natychmiast. Jeśli zaktualizujesz cenę, nowa cena dotyczy wszystkich przyszłych zamówień.

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.