Руководство пользователя

Краткий гайд по работе с приложением учёта парфюмерного сырья, партий, формул и закупок.

1. Обзор

Экран «Обзор» показывает краткую сводку по системе: количество ингредиентов, партий, позиций ниже минимального остатка и формул. Отсюда удобно оценить текущее состояние склада и перейти в нужный раздел.

2. Ингредиенты

Во вкладке «Ингредиенты» хранится полный справочник веществ: название, CAS-номер, тип материала, ольфакторная группа, позиция в пирамиде и суммарный остаток по всем партиям. Здесь можно добавлять новые ингредиенты, редактировать существующие, фильтровать по алфавиту и задавать минимальный остаток.

При клике по строке открывается карточка вещества. В ней видно детальную информацию об ингредиенте и доступны действия: редактировать данные, скорректировать остаток, отправить в архив или удалить ингредиент.

Кнопка «Редактировать» открывает форму с полями названия, CAS-номера, типа материала, ольфакторной группы, позиции в пирамиде и минимального остатка (по умолчанию 1 г).

Кнопка «Скорректировать остаток» позволяет вручную задать новый остаток по конкретной партии, указав причину коррекции. Каждая коррекция фиксируется в журнале движений.

Импорт стартового списка из Excel

Для быстрого запуска можно импортировать стартовый список ингредиентов через кнопку «Стартовый список (Excel)». Для каждого вещества автоматически создаётся стартовая партия с общим кодом партии. Формат файла описан непосредственно в интерфейсе импорта.

3. Партии

Раздел «Партии» отвечает за учёт конкретных закупок и партий сырья. Каждая партия привязана к ингредиенту и содержит код партии, дату закупки, закуплённое количество, текущий остаток, цену за грамм и статус.

Кнопка «Добавить партию» открывает форму, где указывается вещество, код партии, дата, количество, текущий остаток, цена за грамм, поставщик и статус.

4. Движения

Журнал «Движения» фиксирует все приходы, списания и корректировки остатков. Любое движение автоматически пересчитывает остаток партии и суммарный остаток ингредиента.

Кнопка «Добавить движение» позволяет вручную зафиксировать приход, списание или корректировку с указанием вещества, партии, даты, количества и комментария.

5. Формулы

В разделе «Формулы» хранятся рецептуры: список формул с названием, количеством компонентов, весом рецепта и максимально возможным выходом из текущих остатков. Формулы можно создавать вручную или импортировать из Excel.

При клике по формуле открывается редактор: ингредиенты, дозировки в граммах, роль компонента и примечания. Здесь же видно максимально возможный выход — сколько граммов концентрата можно произвести из текущих складских остатков. Компоненты можно добавлять, изменять и удалять.

6. Закупки

Раздел «Закупки» используется для планирования и фиксации закупок сырья. Кнопка «Авто-план по остаткам» автоматически формирует список позиций, у которых остаток опустился ниже минимального порога.

Каждая строка закупки содержит ингредиент, планируемое количество, поставщика, цену за грамм, сумму и статус (запланировано / заказано / в пути / получено / отменено). Добавление и редактирование выполняется через модальное окно.

При переводе позиции в статус «Получено» вводится фактическое количество, цена и код партии — на основе этих данных автоматически создаётся новая партия и обновляется остаток по ингредиенту.

7. Импорт данных из Excel

Общие требования

• Формат файла: .xlsx или .xls
• Заголовки колонок — обязательно в первой строке листа
• Названия обязательных колонок — точно как указано, регистр и пробелы важны
• Лишние колонки игнорируются
• Десятичный разделитель в числах — точка или запятая (оба варианта работают)
• Даты: любой формат, который Excel понимает как дату

7.1. Стартовый список ингредиентов

Кнопка «Стартовый список (Excel)». Для каждой строки автоматически создаётся стартовая партия 5 г с единым кодом вида START-YYYYMMDD-HHMMSS.

Колонка	Обязат.	Описание	Пример
Name	✅	Название вещества	Hedione
CAS	—	CAS-номер	24851-98-7
Type	—	Тип материала	molecule / essential oil / absolute / resinoid / base
Group	—	Ольфакторная группа	Floral
Pyramid	—	Позиция в пирамиде	Top / Heart / Base
Supplier	—	Поставщик	PerfumeryLab

Стартовое количество партии всегда 5 г, цена 0. Если ингредиент с таким же Name+CAS уже есть в базе — он не дублируется, новая партия всё равно создаётся.

7.2. Импорт закупок (партий)

Кнопка «Импорт закупок (Excel)». Каждая строка — отдельная партия со своим количеством. Ингредиент ищется сначала по CAS, затем по названию — если не найден, создаётся новый.

Колонка	Обязат.	Описание	Пример
Name	✅	Название вещества	Iso E Super
QtyG	✅	Количество в граммах	25
CAS	—	CAS-номер	54464-57-2
Type	—	Тип материала	molecule
Group	—	Ольфакторная группа	Woody
Pyramid	—	Позиция в пирамиде	Base
BatchCode	—	Код партии (если пусто — генерируется авто)	ISO-2026-01
PurchaseDate	—	Дата закупки	2026-04-01
Supplier	—	Поставщик	PerfumeryLab

7.3. Импорт формул

Кнопка «Импорт из Excel» в разделе «Формулы». Каждый файл — одна формула. Название предлагается автоматически из названия файла или из ячейки FormulaName.

Колонка	Обязат.	Описание	Пример
FormulaName	—	Название формулы (отдельная ячейка до таблицы)	CITRUS_EMBER
IngredientName	✅	Название ингредиента	Hedione
QtyG	✅	Количество в граммах	1.5
Role	—	Роль компонента	Heart / Top / Base
Comment	—	Примечание	Зелёное, свежее

Строка с ячейкой FormulaName — служебная, в ней пишется название формулы. Дальше — строка заголовков (IngredientName, QtyG и др.) и строки данных.

Типичные ошибки

• Файл не импортируется, если отсутствует хотя бы одна обязательная колонка или она названа с ошибкой (например name вместо Name).
• Строка пропускается, если поле Name пустое или QtyG = 0.
• Если в QtyG записан текст — строка будет пропущена.
• Excel-файл читается с первого листа — другие листы игнорируются.

8. Бэкап и восстановление

Для защиты данных используйте кнопку «Экспорт бэкапа» в верхней панели любого раздела. Она скачивает JSON-файл, содержащий все данные (ингредиенты, партии, движения, формулы, закупки). Для восстановления воспользуйтесь кнопкой «Импорт бэкапа (JSON)».

9. Поставщики

Раздел «Поставщики» — справочник контрагентов для закупок сырья. Здесь хранятся название, страна, город, сайт, email, телефон и примечания. Поставщиков можно выбирать при создании закупок.

Если при работе с системой что-то непонятно или возникает ошибка — сначала загляните в это руководство. Если ответа нет, обратитесь в поддержку: info@eklectos.ru