Товары

Страница "Товары" управляет каталогом позиций, продаваемых вашим интернет-кафе или игровым центром. Это еда, напитки, снеки, аксессуары и любые другие физические товары для клиентов. Каждый товар имеет определенную цену, категорию, ставку налога и уровень запасов. Товары интегрированы с системой заказов, позволяя кассирам создавать заказы, отслеживать продажи и управлять инвентарем.

Поля товара

Каждая запись товара содержит следующую информацию:

Поле	Описание
`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 на момент продажи как снимок.

Интеграция с заказами

Когда кассир создает заказ и добавляет товар:

Текущая цена продажи и ставка НДС товара копируются в позицию заказа как снимки.
Сумма строки рассчитывается как unit_price * qty.
При завершении заказа уровень запасов товара уменьшается на заказанное количество.
Создается запись в журнале запасов с reason = 'sale', ссылающаяся на заказ.

При последующей отмене или возврате заказа запасы могут быть восстановлены через запись возврата в журнале запасов.