Пошаговая инструкция
Ингредиент - это сырье, которое используется складом, закупками, техкартами, цехами и отчетами. Чем точнее заполнена карточка, тем надежнее остатки, себестоимость, списания и будущие AI-объяснения.
Сначала пройдите walkthrough со скриншотами. Точки показывают, куда нажимать; видео показывают реальный ввод, раскрытие списков, загрузку изображения и сохранение в SABSUS.
Поля на этом экране
Список ингредиентов
Как заполнять: Сначала откройте список Ingredients и проверьте, нет ли уже такого сырья.
Зачем: Дубли ломают складские остатки, закупки, себестоимость техкарт и будущие AI-ответы.
Кнопка добавления
Как заполнять: Нажмите Add, чтобы открыть Product Creation с активной вкладкой Ingredient.
Зачем: Так создается запись products с типом ingrid в текущей компании.
Название
Как заполнять: Введите короткое название ингредиента на текущем языке интерфейса.
Зачем: Это название сотрудники ищут в складе, закупках, техкартах, списаниях и отчетах.
Переводы названия
Как заполнять: Откройте три точки рядом с названием и заполните активные языки.
Зачем: Мультиязычная компания должна видеть один и тот же ингредиент на понятном языке.
Категория ингредиента
Как заполнять: Выберите группу из Ingredient Categories, например Овощи и зелень.
Зачем: Категория отделяет сырье от клиентских товарных категорий и помогает фильтровать склад.
Единица измерения
Как заполнять: Выберите единицу, в которой бизнес реально считает остатки и расход: kg, g, l, pcs, pack и т. д.
Зачем: Склад, рецептуры и отчеты должны использовать одну понятную единицу.
Бренд и теги
Как заполнять: Заполните бренд поставщика и короткие теги только если они помогут искать или отличать сырье.
Зачем: Это помогает не путать похожие ингредиенты от разных поставщиков.
Учет остатков
Как заполнять: Включите Consider stock levels, когда SABSUS должен контролировать остатки этого ингредиента.
Зачем: Минимальные остатки, предупреждения и складские отчеты зависят от этого переключателя.
Минимальный остаток
Как заполнять: После включения складского учета укажите порог, при котором менеджеру нужно пополнить запас.
Зачем: Так бизнес узнает о нехватке заранее, а не в момент приготовления.
Номер в списке
Как заполнять: Используйте плюс и минус для порядка отображения.
Зачем: Часто используемые ингредиенты можно держать выше в списке.
Размеры
Как заполнять: Заполняйте ширину, длину и высоту только для упаковок или товаров, где размеры важны для хранения.
Зачем: Для сыпучего или весового сырья эти поля часто остаются нулевыми.
Штрихкод
Как заполнять: Введите barcode, если ингредиент сканируется при приемке, инвентаризации или поиске.
Зачем: Сканирование быстрее и надежнее ручного поиска.
Пищевая ценность
Как заполнять: Заполните белки, жиры, углеводы и kcal, если меню, этикетки или AI-ответы должны показывать питание.
Зачем: Нельзя объяснять калорийность и состав, если значения пустые или неактуальные.
Потери обработки
Как заполнять: Укажите проценты потерь при очистке, варке, жарке, тушении и выпекании.
Зачем: Так техкарты и отчеты точнее объясняют выход готового продукта и себестоимость.
Фото
Как заполнять: Загрузите квадратное фото ингредиента, где сырье легко узнать.
Зачем: Картинка уменьшает ошибки при выборе позиции в складе и закупках.
Save
Как заполнять: Сохраняйте только после проверки названия, переводов, категории, единицы, штрихкода, складских настроек, потерь и фото.
Зачем: После Save ингредиент становится источником данных для склада, закупок, техкарт, отчетов и агентов.
Проверка
Как заполнять: Вернитесь в список Ingredients и найдите сохраненную строку.
Зачем: Так видно, что запись реально сохранилась и загрузилась обратно из Supabase.
Частые ошибки
- Создавать ингредиент до создания Ingredient Categories.
- Выбирать товарную категорию вместо категории ингредиентов.
- Оставлять unit = pcs, когда сырье считается в kg, g, liter или pack.
- Создавать дубли с разными вариантами названия.
- Заполнять потери обработки без проверки реального выхода.
- Включать складской учет и оставлять нереальный minimum stock.
- Загружать декоративную картинку вместо узнаваемого фото сырья.
- Сохранять без проверки строки в Ingredients.
- Менять данные напрямую в Supabase и не обновлять company.loadproduct.
Техническая таблица для AI-агентов
Этот блок расположен ниже пользовательской инструкции. Он нужен поддержке, автоматизациям и будущим AI-агентам, которые будут объяснять поведение ингредиентов из Supabase products.
| Поле | Хранится как | Назначение | Почему важно |
|---|---|---|---|
| ID ингредиента | products.id | Уникальный ID строки ингредиента. | Нужен складу, техкартам, списаниям, закупкам, импорту, поддержке и AI-агентам. |
| Компания | products.company | Рабочая область, которой принадлежит ингредиент. | Не дает сырью смешиваться между компаниями. |
| Тип | products.type = ingrid | Помечает строку products как ингредиент. | Отделяет сырье от продаваемых продуктов, упаковки, модификаторов и полуфабрикатов. |
| Названия | products.name[] | Мультиязычные названия ингредиента. | Поиск, склад, закупки, техкарты, отчеты и AI-ответы используют понятное название текущего языка. |
| Фото | products.photos[] | Список изображений ингредиента. | Помогает сотрудникам визуально отличать похожее сырье. |
| Категория ингредиента | products.category_ingredients[] | ID категорий из Ingredient Categories. | Группирует сырье для склада, закупок, импорта, отчетов и AI-объяснений. |
| Категории товаров | products.category[] | Обычные товарные категории. | Для ингредиентов лучше использовать category_ingredients, чтобы не смешивать сырье с клиентским меню. |
| Бренд | products.brand | Поставщик, производитель или бренд сырья. | Помогает отличать похожие позиции от разных поставщиков. |
| Теги | products.tags[] | Короткие поисковые метки. | Улучшают поиск и будущий автоматический матчинг, если заполнены аккуратно. |
| YouTube | products.youtube[] | Дополнительные видео-ссылки. | Используйте только для обучения, обработки или инструкций поставщика. |
| Единица измерения | products.unit_of_measurement | Единица складского учета. | Без правильной единицы нельзя надежно считать остатки и расход в рецептурах. |
| Вес единицы | products.gross | Вес или объем одной учетной единицы, если поле видно для выбранной единицы. | Помогает переводить упаковки, штуки и весовые единицы в складские расчеты. |
| Номер в списке | products.number_list | Порядок отображения. | Влияет на удобство поиска часто используемого сырья. |
| Учитывать остатки | products.stoking | Включает складской контроль ингредиента. | От этого зависят минимальные остатки, предупреждения и складская аналитика. |
| Минимальный остаток | products.minstock | Порог предупреждения. | Менеджер видит, когда запас нужно пополнить. |
| Разрешить перерасход | products.oversell | Разрешает расходовать больше, чем есть на складе. | Включайте только если бизнес сознательно сверяет остатки позже. |
| Размеры | products.width / products.length / products.height | Физические размеры в миллиметрах. | Полезно для упаковок, хранения, доставки и импорта. |
| Процесс приготовления | products.preparation_process[] | Инструкции обработки на разных языках. | Цеха и сотрудники понимают, как подготовить ингредиент. |
| Описание | products.description[] | Полное описание. | Используется для карточек, справки, поставщиков и AI-объяснений. |
| Краткое описание | products.short_description[] | Короткое описание. | Удобно в компактных списках и карточках. |
| Штрихкод | products.qr_code | Barcode или внутренний код сканирования. | Ускоряет приемку, инвентаризацию и складской поиск. |
| Акцизный код | products.excise_tax_on_goods | Код регулируемого товара, если нужен. | Важен для фискальных или акцизных сценариев. |
| Белки | products.proteins | Значение белков. | Нужно для пищевой ценности, этикеток и объяснений клиентам. |
| Жиры | products.fat | Значение жиров. | Нужно для пищевой ценности и диетических объяснений. |
| Углеводы | products.carbohydrates | Значение углеводов. | Нужно для пищевой ценности и диетических объяснений. |
| Калории | products.calories | Калорийность. | Используется в меню, этикетках и AI-ответах. |
| Режим пищевой ценности | products.perkkal | Основа расчета пищевой ценности. | Агент должен понимать, указаны значения на 100 г или в другом режиме. |
| Очистка | products.cleaning | Процент потерь при очистке. | Переводит грязный/сырой вес в пригодный вес. |
| Варка | products.boiling | Процент потерь при варке. | Помогает рассчитывать выход и себестоимость. |
| Жарка | products.frying | Процент потерь при жарке. | Уточняет расход сырья для готовых блюд. |
| Тушение | products.stewing | Процент потерь при тушении. | Нужен для техкарт и объяснения выхода. |
| Выпекание | products.baking | Процент потерь при выпекании. | Нужен для выхода, себестоимости и производства. |
| Создано | products.created_at | Время создания строки. | Полезно для аудита и диагностики. |
| Обновлено | products.updated_at | Время последнего изменения. | Поддержка и AI-агенты видят актуальность данных. |
| Маркер обновления | company.loadproduct | Timestamp перезагрузки продуктов и ингредиентов. | После нативных изменений приложение должно обновить данные. |