Введение
Модуль «Данные по урожайности» предназначен для централизованного учёта и анализа фактических, плановых и прогнозных данных об урожае на уровне полей, культур и вариантов выращивания.
Он служит источником данных для сверки плановых показателей с фактическими результатами, расчёта агрономических метрик (например, урожайности с гектара) и формирования аналитической отчётности.
Назначение документа
Данное руководство описывает интерфейс и функциональность модуля «Данные по урожайности».
Цель документа — предоставить пользователям чёткую инструкцию по добавлению, редактированию и анализу записей об урожае, а также объяснить бизнес-логику и связи модуля с другими разделами системы SmartAgro.
Обзор возможностей / ключевые элементы
Ведение реестра урожайности: Просмотр всех записей в табличном формате с группировкой по годам.
Типы записей: Поддержка записей трёх типов: «Факт», «План» и «Прогноз».
Ручной ввод данных: Добавление записей об урожае через форму ввода с валидацией обязательных полей.
Импорт из выгрузок: Автоматическое создание записей на основе данных, загруженных из внешних систем или уборочной техники.
Расчётные показатели: Автоматический расчёт урожайности на гектар (ц/га) на основе введённых объёма урожая и площади.
Аналитика и отчётность: Формирование сводных отчётов, возможность экспорта данных.
Связь с объектами системы: Каждая запись привязывается к полю, культуре, варианту выращивания, материалу уборки (продукции), подразделению и складу.
Структура интерфейса / описание элементов
Рис. 1. Общий вид интерфейса
Верхняя панель управления
Поле поиска — фильтрация записей по всем текстовым столбцам таблицы.
Кнопка «Выполнить» — применение поискового запроса
Селектор отчёта — переключение между предустановленными представлениями таблицы (например, «Основной отчёт»).
Кнопка «Действия» — выпадающее меню с дополнительными операциями (экспорт, очистка фильтров).
Кнопка «Добавить» — открывает форму для создания новой записи об урожае.
Кнопка «Пересчет рейтинга полей» — запускает процесс обновления показателя «Рейтинг поля» на основе актуальных данных по урожайности.
Кнопка «Выгрузки» — переход к функционалу записей из выгрузок.
Структура таблицы данных
Данные представлены в виде таблицы со следующими ключевыми колонками:
- Редактировать — кнопка открытия редактирования
Год урожая — период, за который учтены данные.
- Урожай — общий объём полученной продукции.
Площадь — убранная площадь в гектарах.
Урожайность на Га — расчётный показатель урожайности (объём урожая с гектара).
Тип — тип записи: «Факт», «План» или «Прогноз».
Дата — дата фиксации данных (формат DD.MM.YYYY).
- Примечание — дополнительные сведения или пометка об источнике данных (например, «Из выгрузок»).
- ЕИ урожайности — единица измерения урожайности (ц/га, т/га).
Поле — наименование поля из «Реестра полей».
Культура — культура, выращиваемая на поле.
Вариант — привязанный «Вариант выращивания» (технологическая карта).
Продукция (Материал уборки) — конечный продукт.
ЕИ урожая — единица измерения урожая (т, кг, ц).
Рейтинг поля — расчётный рейтинг эффективности поля.
- Группа урожайности — классификационный показатель.
Подразделение — хозяйство или отделение.
Склад — склад назначения для продукции.
Форма создания/редактирования записи
Рис. 2. Форма «Запись урожайности» для ввода данных вручную.
Форма содержит следующие поля:
Культура — выбор культуры. Обязательное поле.
Период — выбор года (периода) урожая. Обязательное поле.
Поле — выбор поля из «Реестра полей». Обязательное поле.
Материал уборки — выбор продукции из справочника «Перечень материалов». Доступны только материалы из группы «Продукция», у которых указана культура. Обязательное поле.
Рис. 3. Всплывающая подсказка для поля «Материал уборки».
Склад — выбор склада для оприходования продукции.
ЕИ Урожая — единица измерения урожая (подтягивается из карточки материала).
Факт\план — выбор типа записи: Факт или План.
Убрано — дата уборки (формат DD.MM.YYYY). Обязательное поле.
Урожай — числовое значение объёма урожая. Обязательное поле.
С площади — числовое значение убранной площади в гектарах. Обязательное поле.
Примечание — текстовое поле для комментариев.
Кнопки «Отмена» и «Создать» (или «Сохранить» при редактировании).
Пошаговая инструкция
Добавление новой записи об урожае вручную
На главной странице модуля нажмите кнопку «Добавить». Откроется форма «Запись урожайности».
Заполните обязательные поля, отмеченные в интерфейсе:
Выберите Культуру и Поле.
Выберите Период (год урожая).
Выберите Материал уборки. Помните, что список фильтруется по выбранной культуре.
Укажите Тип записи (Факт/План), дату уборки и склад при необходимости.
Введите значение Урожая и площади С площади. Система автоматически рассчитает урожайность на гектар.
При необходимости добавьте пояснение в поле Примечание.
Нажмите кнопку «Создать». Новая запись появится в общей таблице.
Добавление записей из выгрузок
На главной странице модуля нажмите кнопку «Добавить из выгрузок» (старый интерфейс).
В открывшемся интерфейсе выберите тип документа, период и другие параметры для фильтрации загруженных данных.
Отметьте необходимые строки в списке выгрузок.
Нажмите кнопку подтверждения импорта. Система автоматически создаст записи в реестре урожайности с пометкой в примечании.
Редактирование или удаление записей
Для редактирования существующей записи найдите её в таблице и нажмите на значок карандаша (✏️) в соответствующей строке. Внесите изменения в открывшейся форме и нажмите «Сохранить».
Для удаления существующей записи найдите её в таблице и нажмите на значок карандаша (✏️) в соответствующей строке, нажмите «Удалить». Подтвердите операцию.
Пересчёт рейтинга полей
Убедитесь, что в таблице присутствуют актуальные фактические данные по урожайности.
Нажмите кнопку «Пересчет рейтинга полей» на верхней панели.
Дождитесь завершения процесса. Значения в колонке «Рейтинг поля» будут обновлены согласно заложенному в системе алгоритму.
Результат выполнения
После успешного ввода данных пользователь получает актуальный и полный реестр урожайности, который:
Служит основой для аналитических отчётов и оценки эффективности полей и технологий.
Автоматически передаётся в модуль «Потребность в материалах» для расчёта планов на следующий сезон.
Используется в модуле «Мастер расхода материала» для анализа соответствия фактических расходов материалов запланированным в «Варианте выращивания».
Влияет на показатель «Рейтинг поля», который учитывается при планировании севооборота и распределении ресурсов.
Важные предупреждения и примечания
Обязательность полей: Для создания записи необходимо заполнить все поля, отмеченные в интерфейсе как обязательные (Культура, Период, Поле, Материал уборки, Убрано, Урожай, С площади). Без этого запись не будет сохранена.
Связь культуры и материала: В поле «Материал уборки» отображаются только те материалы из группы «Продукция», для которых в карточке указана культура. Культура материала должна совпадать с выбранной в форме.
Расчёт урожайности: Поле «Урожайность на Га» рассчитывается системой автоматически по формуле:
Урожайность = Урожай / С площади. Ручной ввод этого поля заблокирован.Данные из выгрузок: Записи, созданные автоматически из выгрузок, могут иметь ограниченную возможность редактирования. Для их корректировки может потребоваться обновить исходные данные выгрузки.
Актуальность справочников: Корректность работы модуля зависит от актуальности связанных справочников: «Реестр полей», «Варианты выращивания», «Перечень материалов».
Связанные разделы
Реестр полей — источник информации о полях и их характеристиках.
Варианты выращивания — технологические карты, с которыми сверяется фактический урожай.
Перечень материалов — справочник, из которого выбирается «Материал уборки».
Потребность в материалах — модуль, использующий данные урожайности для планирования.
Мастер расхода материала — инструмент для анализа расходов на основе фактических урожаев.


