Товари

Сторінка Товарів керує каталогом позицій, що продаються у вашому інтернет-кафе або ігровому центрі. Це включає їжу, напої, закуски, аксесуари та будь-які інші фізичні товари для клієнтів. Кожен товар має визначену ціну, категорію, ставку ПДВ та рівень запасів. Товари інтегруються з системою замовлень, дозволяючи касирам створювати замовлення, відстежувати продажі та керувати інвентарем.

Поля товару

Кожен запис товару містить таку інформацію:

Поле	Опис
`name`	Назва товару в інтерфейсі замовлень. Має бути унікальною (нечутливо до регістру).
`category`	Текстова мітка для групування пов'язаних товарів (наприклад, "Напої", "Закуски", "Аксесуари"). Для фільтрації та звітності.
`unit`	Одиниця виміру для відстеження запасів (наприклад, "штука", "кг", "літр", "банка", "пляшка").
`barcode`	Необов'язкове значення штрихкоду для інтеграції зі сканером. Касири можуть сканувати штрихкод для швидкого додавання до замовлення.
`sale_price`	Ціна продажу в мінорних одиницях валюти (наприклад, копійки). Сума, що стягується з клієнта за одиницю.
`vat_rate`	Ставка ПДВ у відсотках (наприклад, 18 для 18% ПДВ). Для розрахунку податкового компонента кожного продажу.
`stock`	Поточний рівень запасів як десяткова кількість. Оновлюється автоматично при розміщенні замовлень та записі закупівель інвентарю.
`active`	Перемикач, що контролює, чи товар відображається в інтерфейсі замовлень. Неактивні товари приховані від касирів, але зберігаються в базі даних для історичної звітності.
`description`	Необов'язковий текстовий опис для додаткових деталей товару.

Активний / Неактивний

Товари можна перемикати між активним та неактивним станами:

Активні товари відображаються в інтерфейсі замовлень та можуть додаватися до нових замовлень.
Неактивні товари приховані від інтерфейсу замовлень, але залишаються в базі даних. Минулі замовлення зберігають посилання, тому історичні дані продажів збережені.

Це корисно для сезонних товарів, знятих з продажу позицій або товарів, тимчасово відсутніх на складі.

Відстеження запасів

HandyCafe підтримує поточний облік запасів для кожного товару. Це значення автоматично оновлюється системою у відповідь на:

Продажі: при продажу товару через замовлення запаси зменшуються на замовлену кількість.
Закупівлі інвентарю: при надходженні нового запасу та записі на сторінці Інвентарю запаси збільшуються відповідно.
Ручні коригування: касири або адміністратори можуть вручну скоригувати рівень запасів для обліку псування, бою, похибок підрахунку або інших розбіжностей.

Журнал запасів товару

Кожна зміна рівня запасів товару фіксується у журналі запасів, створюючи повний аудиторський слід:

Причина	Опис
`sale`	Запаси зменшились через замовлення клієнта. Посилання на конкретне замовлення.
`purchase`	Запаси збільшились через закупівлю інвентарю. Посилання на конкретний запис інвентарю.
`adjustment`	Запаси скориговано вручну касиром або адміністратором.
`waste`	Запаси зменшились через псування, бій або списання.
`return`	Запаси збільшились через повернення клієнтом або скасування замовлення.

Кожен запис журналу фіксує зміну кількості (позитивне для збільшення, негативне для зменшення), новий рівень запасів після зміни, хто зробив зміну та необов'язкову примітку з причиною.

Категорії товарів

Товари групуються за категорією за допомогою вільного текстового поля. Типові категорії:

Напої (газовані напої, вода, енергетики)
Гарячі напої (кава, чай, гарячий шоколад)
Закуски (чіпси, цукерки, шоколадні батончики)
Їжа (бутерброди, роли, гарячі страви)
Аксесуари (гарнітури, USB-накопичувачі, килимки для миші)

Категорії використовуються для фільтрації в інтерфейсі замовлень. Касири можуть швидко перемикатися між категоріями для пошуку потрібного товару. Категорії також служать для групування у звітах продажів.

Окремого інтерфейсу управління категоріями немає. Категорії створюються неявно при призначенні назви категорії товару. Для перейменування категорії оновіть поле категорії на всіх товарах, що використовують стару назву.

Створення товару

Для додавання нового товару до каталогу:

Перейдіть на сторінку Товари з бічної панелі.
Натисніть кнопку Додати товар на панелі інструментів.
Введіть назву (має бути унікальною).
Оберіть або введіть категорію.
Оберіть одиницю виміру.
Встановіть ціну продажу (сума для клієнтів, у мінорних одиницях валюти).
Встановіть ставку ПДВ (як десяткове число, наприклад, 0.08 для 8%).
За бажанням введіть штрихкод для підтримки сканера.
Встановіть початковий рівень запасів, якщо застосовно.
Натисніть Зберегти.

Редагування товару

Оберіть товар зі списку для відкриття деталей. Ви можете оновити будь-яке поле, включаючи назву, ціну, категорію, ставку ПДВ, рівень запасів та активний статус. Зміни набувають чинності негайно. При оновленні ціни нова ціна застосовується до всіх майбутніх замовлень.

Минулі замовлення не зачіпаються змінами цін. Кожна позиція замовлення зберігає unit_price на момент продажу як знімок.

Інтеграція з замовленнями

Коли касир створює замовлення та додає товар:

Поточна ціна продажу та ставка ПДВ товару копіюються в позицію замовлення як знімки.
Сума рядка розраховується як ціна_за_одиницю * кількість.
При завершенні замовлення рівень запасів товару зменшується на замовлену кількість.
Створюється запис журналу запасів з reason = 'sale', що посилається на замовлення.

При подальшому скасуванні або поверненні замовлення запаси можуть бути відновлені через запис повернення в журналі запасів.