Page Index

Commit 24b209

2026-03-20 13:42:29 GitLab Deploy: sync: deploy from GitLab commit 7e56f245
/dev/null .. руководство пользователя/агро-модуль/как начать работу в агро-модуле.md
@@ 0,0 1,149 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как начать работу в Агро-модуле
+
+ ## Когда это нужно
+
+ AGRO-модуль требует первоначальной настройки перед тем, как система начнёт автоматически обнаруживать и регистрировать сельскохозяйственные обработки. Эта инструкция описывает базовые шаги для запуска модуля с нуля.
+
+ ## Что потребуется
+
+ - Техника добавлена в систему **SKIF.PRO** и на ней установлены GPS-трекеры.
+ - Данные о перемещении техники поступают в систему.
+ - При необходимости настроены водители, прицепы и навесное оборудование (агрегаты).
+
+ ## Пошаговая инструкция
+
+ ### Шаг 1. Проверить наличие техники и телематических данных
+
+ AGRO-модуль работает на основе данных телематики, поступающих из системы **SKIF.PRO**.
+
+ Перед использованием убедитесь, что:
+ - техника добавлена в систему;
+ - на технике установлены GPS-трекеры;
+ - данные о перемещении техники поступают в систему.
+
+ Также при необходимости должны быть настроены:
+ - водители;
+ - прицепы и навесное оборудование (агрегаты).
+
+ Без телематических данных система не сможет обнаруживать обработки.
+
+ ### Шаг 2. Настроить справочники
+
+ Следующий шаг — настройка базовых справочников AGRO-модуля.
+
+ Откройте раздел **AGRO → Справочники**.
+
+ В этом разделе необходимо заполнить следующие справочники:
+
+ **Культуры**
+
+ Добавьте перечень сельскохозяйственных культур, выращиваемых на полях компании. Культуры используются при создании полей, в регистрациях обработок и для визуализации полей на карте.
+
+ **Операции**
+
+ Создайте список сельскохозяйственных операций, например: посев, культивация, боронование, опрыскивание, уборка. Для каждой операции можно указать допустимый диапазон скоростей выполнения.
+
+ **Агрегаты**
+
+ Проверьте список агрегатов (прицепного и навесного оборудования). Агрегаты автоматически синхронизируются из системы **SKIF.PRO**.
+
+ Для каждого агрегата необходимо настроить:
+ - операцию;
+ - ширину захвата;
+ - смещение агрегата (при необходимости).
+
+ Эти параметры используются системой при расчёте обработок.
+
+ ### Шаг 3. Создать поля
+
+ После настройки справочников необходимо добавить поля.
+
+ Откройте раздел **AGRO → Поля**.
+
+ Для каждого поля необходимо указать:
+ - название поля;
+ - границы поля на карте;
+ - культуру;
+ - площадь (рассчитывается автоматически).
+
+ Поля используются системой для определения мест выполнения сельскохозяйственных работ. Когда техника движется внутри геозоны поля, система может обнаружить потенциальную обработку.
+
+ ### Шаг 4. Настроить параметры AGRO-модуля
+
+ Перед началом анализа обработок рекомендуется настроить параметры работы AGRO-модуля. Эти настройки определяют, как система будет анализировать телематические данные техники и формировать обработки.
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Настройки**.
+ 3. Укажите необходимые параметры.
+ 4. Нажмите **Сохранить**.
+
+ Подробнее о параметрах см. в статье [Настройки Агро-модуля](../Настройки-Агро-модуля).
+
+ ### Шаг 5. Проверить регистрации обработок
+
+ После выполнения всех настроек система начнёт автоматически обнаруживать обработки.
+
+ Откройте раздел **AGRO → Регистрации обработок**.
+
+ Здесь отображаются потенциальные обработки, найденные системой на основе телематических данных.
+
+ Для каждой обработки пользователь может:
+ - открыть карту обработки;
+ - проверить трек движения техники;
+ - скорректировать параметры обработки;
+ - подтвердить регистрацию;
+ - отклонить регистрацию.
+
+ Только подтверждённые обработки используются системой в аналитике и отчётах.
+
+ ### Шаг 6. Анализировать отчёты
+
+ После подтверждения обработок можно анализировать результаты выполненных работ.
+
+ Откройте раздел **AGRO → Отчёты**.
+
+ Система позволяет формировать отчёты:
+ - по объектам (технике);
+ - по полям;
+ - по операциям;
+ - по водителям;
+ - по культурам.
+
+ Отчёты помогают оценить объём выполненных работ, загрузку техники, эффективность выполнения операций и качество обработки полей.
+
+ ### Результат
+
+ После выполнения этих шагов AGRO-модуль полностью готов к работе.
+
+ Система будет автоматически:
+ - анализировать телематические данные техники;
+ - обнаруживать сельскохозяйственные обработки;
+ - рассчитывать производственные показатели;
+ - формировать аналитические отчёты по выполненным работам.
+
+ ## Частые вопросы и ошибки
+
+ **Нет данных телематики** — система не обнаруживает обработки. Проверьте, что техника добавлена в SKIF.PRO, установлены GPS-трекеры и данные поступают в систему.
+
+ **Агрегаты не отображаются** — убедитесь, что оборудование создано в SKIF.PRO и синхронизировано с AGRO-модулем.
+
+ **Поля не видны или не доступны** — проверьте, что границы поля корректно нарисованы или импортированы, а культура назначена.
+
+ **Регистрации обработок не появляются** — убедитесь, что техника перемещалась внутри границ поля и что все справочники (культуры, операции, агрегаты) настроены.
+
+ **Ошибки при создании или редактировании справочников** — убедитесь в уникальности названий и корректности диапазонов скоростей для операций, а также в корректном смещении агрегатов (не превышает половину ширины захвата).
+
+ **Неверные показатели в отчётах** — убедитесь, что обработки подтверждены; только подтверждённые обработки учитываются в аналитике и отчётах.
+
+ **Недостаточные права доступа** — пользователи без ролей Редактор, Администратор, Супервизор или Редактор тарифа не могут создавать/редактировать справочники, поля, агрегаты или обработки.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/отчёты.md
@@ 0,0 1,72 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Отчёты"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Как устроен раздел Отчёт
+
+ ## Для чего это нужно
+
+ **Отчёты** — это аналитический инструмент AGRO-модуля, предназначенный для анализа фактически выполненных сельскохозяйственных работ на основе данных о подтверждённых обработках.
+
+ Модуль используется для:
+ - анализа эффективности сельскохозяйственных операций;
+ - контроля выполнения полевых работ;
+ - анализа загрузки техники и персонала;
+ - подготовки аналитических данных для управленческих решений.
+
+ ## Как это работает
+
+ Модуль формирует отчёты на основе агрегированных данных, полученных из:
+ - регистраций обработок;
+ - справочников системы (объекты, поля, операции, водители, культуры);
+ - геометрии полей;
+ - параметров смен.
+
+ Отчёты позволяют пользователю анализировать выполненные работы за выбранный период времени и оценивать эффективность использования техники и персонала.
+
+ **Важно:** в отчётах используются **только подтверждённые регистрации обработок**. Потенциальные и отклонённые регистрации в отчёты не включаются.
+
+ ### Основные возможности
+
+ Модуль отчётов позволяет:
+ - формировать отчёты за любой период времени;
+ - фильтровать данные по ключевым сущностям;
+ - группировать результаты по выбранным параметрам;
+ - анализировать показатели эффективности выполненных работ;
+ - просматривать результаты в табличной форме;
+ - экспортировать данные во внешние системы.
+
+ ### Показатели в отчётах
+
+ Отчёты позволяют анализировать следующие показатели:
+ - количество выполненных обработок;
+ - длительность работ;
+ - пробег техники по полю;
+ - обработанную площадь;
+ - перекрытия и пропуски;
+ - расход топлива;
+ - среднюю и максимальную скорость.
+
+ ## Сценарии применения
+
+ **Контроль выполнения плана работ** — проверка, выполнены ли запланированные операции на всех полях за сезон или заданный период.
+
+ **Анализ загрузки техники и водителей** — оценка работы машин и персонала, выявление перегрузок или простоя техники.
+
+ **Сравнение обработанных площадей по полям и культурам** — выявление отклонений в обработанной площади, анализ эффективности распределения ресурсов.
+
+ **Оценка эффективности операций** — анализ перекрытий, пропусков, расхода топлива и времени для оптимизации процессов.
+
+ **Подготовка управленческих решений** — предоставление руководству точных данных для планирования бюджета, закупки ресурсов и корректировки агротехнологий.
+
+ ## Ограничения и важные условия
+
+ - Отчёты строятся только на основе **подтверждённых** регистраций.
+ - Данные в отчётах зависят от корректности настроек системы мер в разделе Настройки Агро-модуля.
/dev/null .. руководство пользователя/агро-модуль/отчёты/виды отчётов в агро.md
@@ 0,0 1,90 @@
+ ---
+ type: C
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Отчёты"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Виды отчётов в Агро
+
+ ## Назначение
+
+ Модуль отчётов поддерживает несколько типов аналитических отчётов, позволяющих анализировать данные по различным сущностям сельскохозяйственного производства. Каждый тип отчёта предназначен для анализа данных в разрезе конкретной сущности: техники, полей, операций, водителей или культур.
+
+ ## Как открыть
+
+ 1. Откройте **AGRO**.
+ 2. Перейдите в подраздел **Отчёты**.
+ 3. Выберите нужный тип отчёта из списка.
+
+ ## Описание полей
+
+ ### Все обработки
+
+ Отчёт отображает полный список обработок за выбранный период.
+
+ Используется для:
+ - общего анализа выполненных работ;
+ - просмотра всех обработок без дополнительной агрегации;
+ - детального анализа отдельных операций.
+
+ ### Отчёт по объекту
+
+ Данные группируются по технике, выполнявшей работы.
+
+ Позволяет анализировать:
+ - загрузку техники;
+ - пробег по полям;
+ - обработанную площадь;
+ - расход топлива.
+
+ Используется для оценки эффективности использования техники.
+
+ ### Отчёт по полю
+
+ Отчёт показывает результаты работ по каждому полю.
+
+ Позволяет анализировать:
+ - площадь выполненных обработок;
+ - длительность работ;
+ - эффективность обработки поля;
+ - перекрытия и пропуски.
+
+ Используется для контроля выполнения сельскохозяйственных операций на конкретных полях.
+
+ ### Отчёт по операции
+
+ Данные группируются по видам сельскохозяйственных операций.
+
+ Позволяет анализировать:
+ - объём выполненных работ по каждому типу операции;
+ - длительность операций;
+ - расход ресурсов.
+
+ Используется для анализа структуры выполненных агротехнических работ.
+
+ ### Отчёт по водителю
+
+ Отчёт показывает результаты работ по каждому водителю.
+
+ Позволяет анализировать:
+ - загрузку водителей;
+ - длительность выполненных работ;
+ - эффективность выполнения операций.
+
+ Используется для контроля работы персонала.
+
+ ### Отчёт по культуре
+
+ Отчёт агрегирует данные по культурам, выращиваемым на полях.
+
+ Позволяет анализировать:
+ - объём выполненных работ по культурам;
+ - распределение обработанных площадей;
+ - эффективность обработки различных культур.
+
+ Используется для анализа агротехнических мероприятий в разрезе культур.
/dev/null .. руководство пользователя/агро-модуль/отчёты/как сформировать отчёт.md
@@ 0,0 1,70 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Отчёты"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как сформировать отчёт
+
+ ## Когда это нужно
+
+ Формирование отчёта используется для анализа выполненных сельскохозяйственных работ за выбранный период.
+
+ ## Что потребуется
+
+ - В системе должны быть подтверждённые регистрации обработок за нужный период.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в подраздел **Отчёты**.
+
+ Откроется форма параметров отчёта.
+
+ 3. Укажите **период отчёта**:
+ - дату начала;
+ - дату окончания.
+ 4. Выберите **тип отчёта**.
+ 5. При необходимости укажите дополнительные параметры:
+ - конкретный элемент (например, поле или объект);
+ - группировку данных;
+ - фильтрацию по сменам.
+ 6. Нажмите **Выполнить отчёт**.
+
+ Система сформирует отчёт и отобразит результаты в таблице.
+
+ ### Результат
+
+ После формирования отчёта пользователю доступны:
+ - таблица с результатами;
+ - сводная статистика по отчёту;
+ - сортировка данных по колонкам;
+ - экспорт отчёта.
+
+ ### Экспорт отчёта
+
+ Сформированный отчёт можно экспортировать в один из форматов:
+ - **CSV**
+ - **XLSX**
+
+ Экспортируемый файл содержит:
+ - все строки таблицы;
+ - все выбранные колонки;
+ - параметры отчёта (период и применённые фильтры).
+
+ ## Частые вопросы и ошибки
+
+ - **Отчёт пустой** — возможно, за выбранный период нет подтверждённых регистраций обработок.
+
+ - **Неверно выбран период** — дата начала позже даты окончания или период не охватывает нужные обработки.
+
+ - **Нет данных по выбранному объекту** — выбран объект, по которому ещё не было зарегистрированных обработок.
+
+ - **Смена не учитывается** — если включена фильтрация по сменам, убедитесь, что для выбранного периода заданы рабочие смены в настройках.
+
+ - **Ошибки при экспорте** — проверьте, что таблица содержит выбранные колонки и данные не превышают ограничения формата (особенно для XLSX).
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/поля.md
@@ 0,0 1,1 @@
+ # Поля
/dev/null .. руководство пользователя/агро-модуль/поля/как редактировать поле.md
@@ 0,0 1,61 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Поля"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как редактировать поле
+
+ ## Когда это нужно
+
+ Редактирование поля позволяет изменить его параметры, например название, границы или описание. Изменения применяются ко всем будущим операциям, связанным с этим полем.
+
+ ## Что потребуется
+
+ Редактировать поля могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут редактирвать поле.
+
+ ## Пошаговая инструкция
+
+ 1. Зайдите на платформу SKIF.PRO.
+ 2. Откройте модуль **Геозоны**.
+ 3. Найдите нужное поле в списке.
+ 4. Нажмите кнопку **Редактировать**.
+ 5. Измените необходимые параметры:
+ - название поля;
+ - описание;
+ - границы поля на карте;
+ - тип;
+ - связанные данные (если доступно).
+ 6. Нажмите **Сохранить**.
+
+ ### Результат
+
+ Изменения будут сохранены, и поле будет отображаться в системе с обновлёнными параметрами.
+
+ **(!)** Если изменить геометрию поля, площадь будет пересчитана автоматически.
+
+ ## Частые вопросы и ошибки
+
+ ## Частые вопросы и ошибки
+
+ **Неверное отображение границ поля** — после редактирования границ убедитесь, что геометрия корректно отображается на карте; при ошибках попробуйте перезагрузить карту.
+
+ **Пересчёт площади** — изменение геометрии поля автоматически пересчитывает площадь; убедитесь, что новые данные соответствуют фактическому размеру участка.
+
+ **Блокировка редактирования** — если поле связано с активными регистрациями или операциями, некоторые параметры (например, тип или связанные данные) могут быть недоступны для изменения.
+
+ **Ошибка синхронизации с SKIF.PRO** — изменения могут не отобразиться сразу, пока не завершится синхронизация с платформой.
+
+ **Недостаточные права доступа** — пользователи без ролей Редактор, Администратор, Супервизор или Редактор тарифа не могут редактировать поле и не видят кнопку «Редактировать».
/dev/null .. руководство пользователя/агро-модуль/поля/как создать поле.md
@@ 0,0 1,55 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Поля"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как создать поле
+
+ ## Когда это нужно
+
+ Создание поля необходимо для описания сельскохозяйственного участка в системе. После создания поле становится доступным для планирования операций, регистрации выполненных работ и построения отчётов.
+
+ ## Что потребуется
+
+ - Права на создание полей в системе.
+ - Границы поля (их можно нарисовать на карте или импортировать из другой системы).
+
+ ## Пошаговая инструкция
+
+ 1. Зайдите на платформу SKIF.PRO.
+ 2. Откройте модуль **Геозоны**.
+ 3. Нажмите кнопку **Создать**.
+ 4. В форме создания заполните основные параметры поля:
+ - **Название поля**
+ - **Тип** (необязательно)
+ - **Группа** (необязательно)
+ 5. Задайте границы поля:
+ - нарисуйте полигон на карте
+ или
+ - выберите существующую геозону.
+ 6. Нажмите **Сохранить**.
+
+ ### Результат
+
+ Новое поле появится в **справочнике полей** Агро-модуля и станет доступно для:
+ - планирования сельскохозяйственных операций;
+ - регистрации выполненных работ;
+ - построения отчётов.
+
+ ## Частые вопросы и ошибки
+
+ **Незамкнутый полигон** — границы поля должны быть замкнутыми; если полигон не замкнут, поле не будет сохранено.
+
+ **Дубли названий** — убедитесь, что название поля уникально в пределах компании, иначе сохранение может быть заблокировано.
+
+ **Ошибка при импорте границ** — при загрузке геозоны из внешней системы проверьте корректность формата файла и проекции координат.
+
+ **Недостаточные права доступа** — пользователи без ролей Редактор, Администратор, Супервизор или Редактор тарифа не видят кнопку «Создать» и не могут создавать поля.
+
+ **Проблемы с отображением на карте** — после создания поле может временно не отображаться; попробуйте обновить карту или страницу.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/поля/как удалить поле.md
@@ 0,0 1,55 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Поля"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как удалить поле
+
+ ## Когда это нужно
+
+ Удаление поля используется, когда участок больше не должен использоваться в системе.
+
+ **(!)** Если поле связано с операциями или регистрациями, его удаление может быть ограничено.
+
+ ## Что потребуется
+
+ Удалить поле могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут выполнять удаление поля.
+
+ ## Пошаговая инструкция
+
+ 1. Зайдите на платформу SKIF.PRO.
+ 2. Откройте модуль **Геозоны**.
+ 3. Найдите поле в списке.
+ 4. Выберите нужное поле через чек-бокс.
+ 5. Нажмите на появившуюся кнопку **Удалить**.
+ 6. Подтвердите удаление.
+
+ ### Результат
+
+ Поле будет удалено из справочника и больше не будет доступно для:
+ - планирования операций;
+ - регистрации работ;
+ - построения отчётов.
+
+ ## Частые вопросы и ошибки
+
+ Поле связано с регистрациями обработок — если на поле есть подтверждённые обработки, система не позволит удалить поле. В этом случае сначала удалите или отклоните соответствующие обработки.
+
+ Поле используется в активных операциях — удаление блокируется, пока поле назначено на текущие операции или кампании.
+
+ Ошибка синхронизации с SKIF.PRO — если платформа не завершила обновление данных, поле может не удалиться; попробуйте повторить действие после синхронизации.
+
+ Неверные права доступа — пользователи без ролей Редактор, Администратор, Супервизор или Редактор тарифа не видят кнопку удаления и не могут выполнить действие.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/регистрации обработок.md
@@ 0,0 1,79 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Регистрации обработок"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Как устроен раздел Регистрации обработок
+
+ ## Для чего это нужно
+
+ **Регистрации обработок** — это механизм автоматического выявления и фиксации фактически выполненных сельскохозяйственных работ на полях на основе телематических данных движения техники.
+
+ Модуль позволяет:
+ - автоматически обнаруживать выполненные обработки по треку движения техники;
+ - проверять и подтверждать найденные обработки;
+ - накапливать достоверную историю выполненных сельскохозяйственных работ;
+ - использовать данные о подтверждённых обработках в отчётах и аналитике.
+
+ ## Как это работает
+
+ Модуль анализирует треки сельскохозяйственной техники и определяет потенциальные обработки, когда техника выполняет работу внутри геозоны поля. Найденные события формируются в виде **регистраций**, которые пользователь может проверить, подтвердить или отклонить.
+
+ Каждая регистрация содержит данные о выполненной работе:
+ - поле, на котором выполнялась операция;
+ - культура;
+ - объект (техника);
+ - водитель;
+ - агрегат;
+ - операция;
+ - время начала и окончания обработки.
+
+ Также автоматически рассчитываются производственные показатели:
+ - обработанная площадь;
+ - перекрытия;
+ - пропуски;
+ - оставшаяся необработанная площадь;
+ - пробег по полю;
+ - средняя и максимальная скорость;
+ - расход топлива.
+
+ ### Статусы регистраций
+
+ Регистрация может находиться в одном из трёх состояний:
+
+ **Потенциальная** — создана системой автоматически, требует проверки пользователем.
+
+ **Подтверждённая** — подтверждена пользователем, участвует в отчётах и аналитике.
+
+ **Отклонённая** — признана некорректной, сохраняется в системе, но не используется в расчётах.
+
+ ### Визуализация обработки
+
+ Для каждой регистрации доступна карта обработки, где отображаются:
+ - контур поля;
+ - трек движения техники;
+ - обработанная область;
+ - перекрытия;
+ - пропуски.
+
+ Это позволяет визуально проверить качество выполненных работ.
+
+ ## Сценарии применения
+
+ Подтверждённые регистрации используются в различных разделах AGRO:
+ - отчёты по обработкам;
+ - аналитика по культурам и полям;
+ - история обработки полей;
+ - агротехническое планирование.
+
+ ## Ограничения и важные условия
+
+ - В отчётах используются **только подтверждённые регистрации**. Потенциальные и отклонённые регистрации в отчёты не включаются.
+ - Точность обнаружения обработок зависит от корректной настройки параметров в разделе Настройки Агро-модуля.
+ - Перед удалением обработки рекомендуется использовать статус **Отклонённая**, чтобы сохранить историю анализа.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/регистрации обработок/как найти обработки.md
@@ 0,0 1,64 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Регистрации обработок"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как найти обработки
+
+ ## Когда это нужно
+
+ Регистрации обработок создаются системой **автоматически** на основе анализа телематических данных движения техники. Пользователь запускает поиск, чтобы получить список потенциальных обработок за нужный период и затем проверить их.
+
+ Система формирует потенциальную регистрацию при выполнении следующих условий:
+ - техника движется внутри геозоны поля;
+ - поле принадлежит компании пользователя;
+ - объект имеет признак агротехники;
+ - время нахождения на поле превышает минимальный порог (по умолчанию — 5 минут);
+ - соблюдаются настройки смен и рабочего времени.
+
+ ## Что потребуется
+
+ - Поля созданы в системе.
+ - Техника выполнила работы на полях и данные телематики поступили в систему.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в подраздел **Регистрации обработок**.
+ 3. Укажите дату предполагаемой обработки.
+ 4. При необходимости задайте фильтры:
+ - поля;
+ - объекты;
+ - водители;
+ - операции;
+ - культуры.
+ 5. Нажмите **Поиск**.
+
+ Система выполнит анализ телематических данных и отобразит найденные регистрации.
+
+ ### Результат
+
+ В таблице появится список потенциальных обработок, для которых пользователь может:
+ - открыть подробную информацию;
+ - подтвердить регистрацию;
+ - отклонить регистрацию;
+ - отредактировать параметры обработки.
+
+ ## Частые вопросы и ошибки
+
+ - **Обработки не найдены** — возможные причины:
+ - техника не имеет признака агротехники;
+ - техника не заходила на поле;
+ - время нахождения на поле меньше минимального порога;
+ - данные телематики ещё не поступили в систему.
+ - **Фильтры не показывают результаты** — проверьте:
+ - выбран правильный период поиска;
+ - корректно указаны поля, объекты, водители, операции или культуры;
+ - выбранные фильтры соответствуют фактически выполненным обработкам.
+ - **Повторное выполнение поиска** — если обработка не появилась после первого поиска, убедитесь, что данные телематики обновлены, и повторите поиск.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/регистрации обработок/как редактировать обработку.md
@@ 0,0 1,71 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Регистрации обработок"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как редактировать обработку
+
+ ## Когда это нужно
+
+ Редактирование применяется, если система определила обработку автоматически, но некоторые параметры требуют уточнения:
+ - агрегат определён неверно;
+ - требуется изменить ширину захвата;
+ - необходимо указать культуру;
+ - нужно скорректировать операцию.
+
+ ## Что потребуется
+
+ Редактировать информацию об обработке могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут редактировать информацию об обработке.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Регистрации обработок**.
+ 3. Найдите нужную регистрацию в таблице.
+ 4. Нажмите на строку регистрации или кнопку **Редактировать**.
+
+ Откроется страница **Сводной информации об обработке**.
+
+ 5. Измените необходимые параметры, например:
+ - поле;
+ - водитель;
+ - агрегат;
+ - операция;
+ - культура;
+ - ширина захвата;
+ - смещение агрегата;
+ - время начала и окончания обработки.
+ 6. Проверьте визуализацию обработки на карте.
+ 7. Провалидируете все необходимые поля.
+ 8. Нажмите **Подтвердить**, чтобы сохранить изменения.
+
+ ### Результат
+
+ После сохранения система автоматически пересчитает связанные показатели:
+ - обработанную площадь;
+ - перекрытия;
+ - пропуски;
+ - статистику движения техники.
+
+ Регистрация получит статус **Подтверждённая** и будет участвовать в отчётах.
+
+ ## Частые вопросы и ошибки
+
+ Агрегат выбран неверно — проверьте, что выбран актуальный агрегат из справочника;
+
+ Область на карте не отображается полностью — участки трека с превышением или понижением скорости за пределами допустимого диапазона операции не обрисовываются как обработка;
+
+ Ошибка при подтверждении — убедитесь, что все обязательные поля заполнены и значения валидны.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/регистрации обработок/как удалить обработку.md
@@ 0,0 1,57 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Регистрации обработок"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как удалить обработку
+
+ ## Когда это нужно
+
+ Удаление обработки используется, если регистрация была создана ошибочно и не должна сохраняться в системе.
+
+ ## Что потребуется
+
+ Удалить обработку могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут выполнять удаление обработку.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Отчеты**.
+ 3. Найдите нужную регистрацию.
+ 4. Откройте **Сводную информацию об обработке**.
+ 5. Нажмите **Удалить**.
+ 6. Подтвердите действие.
+
+ **Важно!** Если удалить обработку по ошибке, она может быть восстановлена только как потенциальная, при условии наличия исходных телеметрических данных и повторного поиска на странице регистраций.
+
+ ### Результат
+
+ После удаления обработки:
+
+ - запись удаляется из списка подтверждённых обработок;
+ - обработка больше не отображается:
+ - в регистрациях (как "Подтвержденная");
+ - в отчётах AGRO;
+ - данные обработки исключаются из всех расчётов (площадь, пробег, перекрытия и пропуски);
+ - факт удаления фиксируется в системе: пользователь, дата/время, идентификатор обработки.
+
+ ## Частые вопросы и ошибки
+
+ Обработка не удаляется — проверьте права доступа;
+
+ Удаление приводит к потере данных — используйте статус Отклонённая для сохранения истории;
+
+ Обработка не появляется снова после удаления — необходимо выполнить повторный поиск, чтобы она снова стала потенциальной, при наличии исходных данных.
\ No newline at end of file
руководство пользователя/агро-модуль/справочники.md ..
@@ 1,1 1,67 @@
- # Справочники
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Как устроены Справочники
+
+ ## Для чего это нужно
+
+ **Справочники AGRO** — это набор данных, используемых для планирования и учёта сельскохозяйственных работ в AGRO-модуле платформы **SKIF.PRO**.
+
+ Использование справочников позволяет:
+ - избежать ручного ввода одних и тех же данных;
+ - обеспечить единообразие терминологии;
+ - уменьшить количество ошибок при вводе информации;
+ - упростить анализ и формирование отчётов.
+
+ Например, вместо ручного ввода названия культуры пользователь выбирает её из справочника культур.
+
+ ## Как это работает
+
+ Справочники содержат перечни сущностей, которые используются при создании операций, регистраций выполненных работ и отчётов.
+
+ Основная задача справочников — хранение **нормативных и повторно используемых данных**, которые применяются в различных процессах AGRO-модуля.
+
+ ### Культуры
+
+ Справочник культур используется для хранения перечня сельскохозяйственных культур, выращиваемых в хозяйстве. Культуры используются при ведении культур поля и формировании отчётов.
+
+ Примеры культур: пшеница, кукуруза, подсолнечник, соя, рапс.
+
+ ### Типы операций
+
+ Справочник типов операций определяет виды сельскохозяйственных работ. Тип операции используется при создании плановых операций и регистраций выполненных работ.
+
+ Примеры операций: посев, внесение удобрений, культивация, уборка урожая.
+
+ ### Агрегаты
+
+ Справочник орудий используется для описания сельскохозяйственного оборудования, которое применяется вместе с техникой. Эти данные используются при планировании и регистрации операций.
+
+ Примеры: сеялка, опрыскиватель, плуг, культиватор.
+
+ ### Использование в AGRO
+
+ **Регистрация выполненных работ** — при формировании обработки система учитывает тип операции и оборудование. Это позволяет хранить структурированные данные о выполненных работах.
+
+ **Формирование отчётов** — справочники позволяют формировать аналитические отчёты по культурам, типам операций и оборудованию. Единый набор справочных данных обеспечивает корректную группировку и анализ информации.
+
+ ## Сценарии применения
+
+ Справочники используются, когда необходимо:
+ - определить перечень культур хозяйства;
+ - настроить типы сельскохозяйственных операций;
+ - вести учёт используемых материалов;
+ - стандартизировать данные AGRO-модуля.
+
+ ## Ограничения и важные условия
+
+ - Справочники агрегатов синхронизируются с системой **SKIF.PRO** автоматически.
+ - Изменения в справочниках применяются ко всем связанным данным.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как редактировать агрегат.md
@@ 0,0 1,78 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как редактировать агрегат
+
+ ## Когда это нужно
+
+ Редактирование агрегата позволяет изменить параметры оборудования, используемые при расчёте обработок.
+
+ ## Что потребуется
+
+ Редактирвать агрегат могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут выполнять редактирование агрегата.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Справочники → Агрегаты**.
+ 3. Найдите нужный агрегат в таблице.
+ 4. Нажмите **Редактировать**.
+
+ Откроется модальное окно **Редактировать агрегат**.
+
+ 5. Измените параметры агрегата:
+
+ |Поле|Описание|
+ |---|---|
+ |**Название**|Название агрегата|
+ |**Операция**|Тип выполняемой операции|
+ |**Ширина захвата**|Рабочая ширина агрегата|
+ |**Смещение**|Смещение агрегата относительно центра техники|
+
+ 6. Нажмите **Сохранить**.
+
+ ### Ограничения при редактировании
+
+ - значение смещения не может превышать половину ширины захвата;
+ - смещение может быть положительным или отрицательным;
+ - для разделения дробной части используется точка.
+
+ ### Результат
+
+ После сохранения:
+ - параметры агрегата обновляются;
+ - изменения применяются при расчёте обработок;
+ - обновлённые данные синхронизируются с системой **SKIF.PRO**.
+
+ ## Частые вопросы и ошибки
+
+ **Смещение превышает допустимое значение**
+ Если значение смещения больше половины ширины захвата, система не позволит сохранить изменения. Необходимо уменьшить значение смещения или увеличить ширину захвата.
+
+ **Неверный формат числа**
+ Для дробных значений необходимо использовать точку (например, `1.5`). Использование запятой приведёт к ошибке сохранения.
+
+ **Недостаточно прав доступа**
+ Редактирование доступно только пользователям с ролями:
+ Редактор, Администратор, Супервизор, Редактор тарифа, Контролер.
+
+ **Синхронизация с SKIF.PRO**
+ Изменения параметров агрегата автоматически передаются в **SKIF.PRO**. При проблемах с синхронизацией изменения могут не сохраниться — в этом случае рекомендуется повторить попытку позже.
+
+ **Влияние на расчёты**
+ После изменения параметров агрегата (ширины, смещения или операции) пересчитываются связанные обработки. Это может привести к изменению показателей (площадь, перекрытия, пропуски) в уже существующих данных.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как редактировать культуру.md
@@ 0,0 1,74 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как редактировать культуру
+
+ ## Когда это нужно
+
+ Редактирование культуры используется для изменения её названия или цвета.
+
+ ## Что потребуется
+
+ Редактировать культуру могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут редактирровать культуры.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Справочники → Культуры**.
+ 3. Найдите нужную культуру в таблице.
+ 4. Нажмите кнопку **Редактировать** напротив нужной записи.
+
+ Откроется модальное окно **Редактировать культуру**.
+
+ 5. Измените необходимые параметры:
+
+ |Поле|Описание|
+ |---|---|
+ |**Название**|Название культуры|
+ |**Цвет**|Цвет отображения культуры|
+
+ 6. Нажмите **Сохранить**.
+
+ ### Результат
+
+ После сохранения изменения автоматически применяются:
+ - ко всем полям, где используется данная культура;
+ - ко всем связанным обработкам;
+ - обновлённый цвет будет отображаться на карте для всех соответствующих полей.
+
+ ## Частые вопросы и ошибки
+
+ **Почему кнопка “Сохранить” неактивна?**
+ Не заполнено обязательное поле **Название**.
+
+ **Почему цвет не изменился на карте?**
+ Возможные причины:
+ - изменения не были сохранены;
+ - требуется обновить страницу или перезагрузить карту;
+ - пользователь просматривает устаревшие данные (кэш браузера).
+
+ **Влияет ли изменение культуры на уже выполненные обработки?**
+ Да. Название и цвет обновляются во всех связанных сущностях, включая уже подтверждённые обработки.
+
+ **Почему я не могу редактировать культуру?**
+ Возможные причины:
+ - у пользователя недостаточно прав доступа;
+ - культура недоступна для редактирования из-за ограничений интерфейса.
+
+ **Можно ли отменить изменения?**
+ Нет. После сохранения изменения применяются сразу ко всем связанным данным. Для возврата необходимо вручную изменить параметры обратно.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как создать агрегат.md
@@ 0,0 1,75 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как создать агрегат
+
+ ## Когда это нужно
+
+ Создание агрегатов выполняется через систему **SKIF.PRO**, после чего агрегаты автоматически появляются в AGRO-модуле. Агрегат необходимо создать, чтобы система могла использовать его параметры при расчёте обработок.
+
+ ## Что потребуется
+
+ Создать агрегат могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут создавать агрегаты.
+
+ ## Пошаговая инструкция
+
+ Вариант 1. Через SKIF.PRO
+
+ 1. Откройте систему **SKIF.PRO**.
+ 2. Перейдите в модуль **Объекты → Прицепы**.
+ 3. Нажмите **Добавить прицеп**.
+ 4. Укажите параметры агрегата:
+ - название агрегата;
+ - дополнительные параметры ширины захвата;
+ - параметры смещения (при необходимости).
+ 5. Нажмите **Сохранить**.
+
+ Вариант 2. В SKIF.PRO Agro
+
+ 1. Откройте систему **SKIF.PRO Agro**.
+ 2. Перейдите в **Справочники → Арегаты**.
+ 3. Нажмите **Добавить агрегат**.
+ 4. Укажите параметры агрегата:
+ - название агрегата;
+ - проводимую операцию;
+ - дополнительные параметры ширины захвата;
+ - параметры смещения (при необходимости).
+ 5. Нажмите **Сохранить**.
+
+ ### Результат
+
+ После сохранения:
+ - агрегат автоматически создастся в SKIF.PRO Agro;
+ - агрегат появляется в разделе **Справочники → Агрегаты**;
+ - агрегат становится доступным для использования при регистрации обработок.
+
+ ## Частые вопросы и ошибки
+
+ **Агрегат не появляется в AGRO**
+ После создания в **SKIF.PRO** агрегат должен автоматически синхронизироваться. Если он не появился:
+
+ - проверьте, что синхронизация настроена корректно;
+ - обновите страницу в AGRO;
+ - подождите некоторое время и повторите проверку.
+
+ **Некорректный формат значений**
+ Для дробных значений необходимо использовать точку (например, `2.5`). Использование запятой может привести к ошибкам при обработке данных.
+
+ **Недостаточно прав доступа**
+ Создание агрегатов доступно только пользователям с ролями:
+ Редактор, Администратор, Супервизор, Редактор тарифа.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как создать культуру.md
@@ 0,0 1,60 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как создать культуру
+
+ ## Когда это нужно
+
+ Создание культуры выполняется в разделе справочников AGRO-модуля. Культуру необходимо добавить, чтобы она стала доступной при создании полей и регистрациях обработок.
+
+ ## Что потребуется
+
+ Создать культуру могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут создать культуру.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Справочники → Культуры**.
+
+ Откроется таблица со списком существующих культур.
+
+ 3. Нажмите кнопку **Создать**.
+
+ Система откроет модальное окно **Создать культуру**.
+
+ 4. Заполните параметры культуры:
+
+ |Поле|Описание|
+ |---|---|
+ |**Название**|Название культуры|
+ |**Цвет**|Цвет культуры, выбираемый из палитры|
+
+ 5. Нажмите **Сохранить**.
+
+ ### Результат
+
+ После сохранения:
+ - культура добавляется в справочник;
+ - она становится доступной для выбора при создании или редактировании поля и в регистрациях обработок;
+ - выбранный цвет используется для отображения полей на карте.
+
+ ## Частые вопросы и ошибки
+
+ Если обязательные поля не заполнены:
+ - система отобразит сообщение об ошибке;
+ - сохранение будет недоступно до заполнения всех обязательных параметров.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как удалить агрегат.md
@@ 0,0 1,62 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как удалить агрегат
+
+ ## Когда это нужно
+
+ Удаление агрегата используется, когда оборудование больше не применяется в работе. Удаление выполняется с учётом синхронизации с системой **SKIF.PRO**.
+
+ **(!)** Удаление агрегата влияет на дальнейшие расчёты обработок. Перед удалением убедитесь, что агрегат больше не используется в рабочих процессах.
+
+ ## Что потребуется
+
+ Удалить агрегат могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут выполнять удаление арегата.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Справочники → Агрегаты**.
+ 3. Найдите агрегат в таблице.
+ 4. Нажмите **Удалить**.
+ 5. Подтвердите действие.
+
+ ### Результат
+
+ После удаления:
+ - агрегат удаляется из AGRO-модуля;
+ - агрегат удаляется из системы **SKIF.PRO**;
+ - агрегат становится недоступным для использования в регистрациях обработок.
+
+ ## Частые вопросы и ошибки
+
+ **Агрегат используется в обработках**
+ Если агрегат ранее использовался в регистрациях обработок, его удаление может повлиять на корректность отображения исторических данных и расчётов. Рекомендуется убедиться, что агрегат не используется в активных или планируемых работах.
+
+ **Синхронизация с SKIF.PRO**
+ Удаление агрегата выполняется синхронно с системой **SKIF.PRO**. Если в момент удаления возникают проблемы со связью или синхронизацией, операция может завершиться с ошибкой или потребовать повторного выполнения.
+
+ **Недостаточно прав доступа**
+ Если кнопка удаления недоступна, проверьте роль пользователя. Удаление доступно только пользователям с ролями:
+ Редактор, Администратор, Супервизор, Редактор тарифа, Контролер.
+
+ **Ошибки при попытке удаления**
+ Возможны ограничения со стороны системы, если агрегат:
+ - используется в текущих расчётах;
+ - участвует в незавершённых или потенциальных обработках;
+ - имеет несинхронизированные изменения с **SKIF.PRO**.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/как удалить культуру.md
@@ 0,0 1,66 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как удалить культуру
+
+ ## Когда это нужно
+
+ Удаление культуры используется, если она больше не применяется в системе.
+
+ ## Что потребуется
+
+ Удалить культуру могут пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут выполнять удаление культуры.
+
+ ## Пошаговая инструкция
+
+ 1. Откройте раздел **AGRO**.
+ 2. Перейдите в **Справочники → Культуры**.
+ 3. Найдите культуру в списке.
+ 4. Нажмите кнопку **Удалить**.
+
+ Система отобразит подтверждение удаления.
+
+ 5. В диалоговом окне нажмите **Да**, чтобы подтвердить удаление.
+
+ ### Результат
+
+ После удаления культуры система применяет следующие правила:
+ - в **неподтверждённых регистрациях обработок** культура удаляется;
+ - в **подтверждённых и отклонённых регистрациях** культура сохраняется;
+ - культура исчезает из списка доступных значений при создании новых объектов.
+
+ Удалённая культура больше не доступна для выбора в системе.
+
+ ## Частые вопросы и ошибки
+
+ **Что произойдёт с полями, у которых была указана удалённая культура?**
+ Культура будет удалена из свойств полей, где она была указана. Поля сохраняются, но остаются без назначенной культуры до тех пор, пока пользователь не укажет новую.
+
+ **Повлияет ли удаление культуры на уже выполненные обработки?**
+ Нет. В подтверждённых и отклонённых регистрациях культура сохраняется без изменений, чтобы не нарушать исторические данные.
+
+ **Почему культура пропала из некоторых обработок?**
+ Культура удаляется из всех неподтверждённых регистраций, так как они считаются черновыми и подлежат актуализации.
+
+ **Можно ли восстановить удалённую культуру?**
+ Нет. После удаления культуру можно только создать заново.
+
+ **Почему я не могу удалить культуру?**
+ Возможные причины:
+ - у пользователя недостаточно прав доступа;
+ - действие не подтверждено пользователем.
\ No newline at end of file
/dev/null .. руководство пользователя/агро-модуль/справочники/что такое агрегаты.md
@@ 0,0 1,63 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Что такое агрегаты
+
+ ## Для чего это нужно
+
+ **Агрегаты** — это справочник сельскохозяйственного прицепного и навесного оборудования, используемого при выполнении полевых работ.
+
+ Агрегаты применяются для корректного расчёта параметров обработок на основе телематических данных движения техники.
+
+ Справочник агрегатов формируется автоматически на основании прицепов, созданных в системе **SKIF.PRO**, и синхронизируется с ней.
+
+ ## Как это работает
+
+ Агрегаты используются системой для:
+ - определения типа выполняемой сельскохозяйственной операции;
+ - расчёта ширины обрабатываемой полосы;
+ - корректного построения трека обработки;
+ - расчёта обработанной площади;
+ - определения перекрытий и пропусков.
+
+ ### Параметры агрегата
+
+ Каждый агрегат содержит следующие параметры:
+
+ |Поле|Описание|
+ |---|---|
+ |**Название**|Название агрегата|
+ |**Операция**|Тип сельскохозяйственной операции|
+ |**Ширина захвата**|Рабочая ширина агрегата|
+ |**Смещение**|Смещение агрегата относительно центра техники|
+
+ ### Где используются агрегаты
+
+ **Регистрации обработок** — при регистрации обработки система использует параметры агрегата для расчёта ширины обработки, площади обработанной территории, перекрытий и пропусков.
+
+ **Анализ треков обработки** — параметры агрегата используются при построении треков обработки и вычислении показателей эффективности работ.
+
+ ## Сценарии применения
+
+ - **Настройка агрегатов перед началом сезона** — добавление и проверка всех используемых прицепов и навесного оборудования для корректного расчёта обработок.
+
+ - **Добавление нового оборудования** — создание нового агрегата в SKIF.PRO с автоматической синхронизацией в AGRO-модуль для использования в регистрациях обработок.
+
+ - **Обновление параметров агрегата** — изменение ширины захвата или смещения агрегата при смене типа выполняемых работ, что позволяет корректно учитывать площадь обработки и предотвращать ошибки в расчётах перекрытий и пропусков.
+
+ - **Проверка корректности треков и обработанной площади** — использование агрегатов для анализа эффективности работы техники и выявления областей с недоработкой или перекрытием.
+
+ ## Ограничения и важные условия
+
+ - Агрегаты синхронизируются с системой **SKIF.PRO** автоматически.
+ - Изменения параметров агрегата применяются при расчёте последующих обработок.
+ - Параметры агрегата могут влиять на расчёт площади, перекрытий и пропусков.
+ - Значение смещения не может превышать половину ширины захвата.
/dev/null .. руководство пользователя/агро-модуль/справочники/что такое культуры.md
@@ 0,0 1,69 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Что такое культуры
+
+ ## Для чего это нужно
+
+ **Культуры** — это справочник сельскохозяйственных культур, используемый в AGRO-модуле для описания полей, регистрации обработок и визуализации данных на карте.
+
+ Каждая культура представляет собой элемент справочника с названием и цветом, который используется системой для отображения информации в различных модулях.
+
+ ## Как это работает
+
+ Культуры являются сквозной справочной сущностью и применяются в нескольких функциональных разделах системы.
+
+ **Поля** — при создании или редактировании поля пользователю необходимо указать культуру, которая выращивается на данном участке.
+
+ **Регистрации обработок** — культура используется для привязки сельскохозяйственных операций к конкретному полю и позволяет анализировать обработку в разрезе выращиваемых культур.
+
+ **Визуализация карты** — каждая культура имеет собственный цвет, который используется при отображении полей на карте. Это позволяет быстро визуально различать поля с различными культурами.
+
+ ### Параметры культуры
+
+ Каждая запись в справочнике содержит следующие параметры:
+
+ |Поле|Описание|
+ |---|---|
+ |**Название**|Название сельскохозяйственной культуры|
+ |**Цвет**|Цвет, которым поле отображается на карте|
+
+ Оба параметра являются обязательными.
+
+ ## Сценарии применения
+
+ **Подготовка к сезону**
+
+ Перед началом сельскохозяйственного сезона пользователь создаёт перечень культур, которые будут использоваться в хозяйстве. Это позволяет заранее подготовить систему для корректного ведения учёта работ и анализа.
+
+ **Назначение культур полям**
+
+ При создании или обновлении полей пользователь указывает культуру для каждого участка. Это обеспечивает корректную группировку и анализ данных в отчётах.
+
+ **Анализ выполненных работ по культурам**
+
+ В регистрациях обработок и отчётах пользователь может анализировать:
+ - объём выполненных работ по каждой культуре;
+ - обработанную площадь;
+ - эффективность выполнения операций.
+
+ **Визуальное различение полей**
+
+ Использование разных цветов для культур позволяет:
+ - быстро ориентироваться на карте;
+ - различать поля с разными культурами;
+ - визуально оценивать структуру посевов.
+
+ ## Ограничения и важные условия
+
+ - Изменения культуры автоматически применяются ко всем связанным полям и обработкам.
+ - Культура может использоваться одновременно в нескольких полях.
+ - Цвет культуры используется только для визуализации и не влияет на расчёты.
/dev/null .. руководство пользователя/агро-модуль/справочники/что такое операции.md
@@ 0,0 1,100 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль/Справочники"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Что такое операции
+
+ ## Для чего это нужно
+
+ **Операции** — это справочник сельскохозяйственных работ, выполняемых на полях.
+
+ Каждая операция описывает тип выполняемой работы и содержит параметры допустимых скоростей, которые используются системой при анализе треков обработки.
+
+ Операции являются нормативно-справочной сущностью и применяются в нескольких ключевых модулях AGRO.
+
+ ## Как это работает
+
+ Справочник операций используется системой для:
+ - определения типа выполняемой сельскохозяйственной работы;
+ - настройки параметров работы агрегатов;
+ - анализа треков движения техники во время обработки;
+ - выявления нарушений скорости при выполнении работ.
+
+ ### Параметры операции
+
+ Каждая операция может содержать допустимый диапазон скоростей:
+
+ |Параметр|Описание|
+ |---|---|
+ |**Название**|Название операции|
+ |**Минимальная скорость**|Нижняя граница допустимой скорости|
+ |**Максимальная скорость**|Верхняя граница допустимой скорости|
+
+ Название является обязательным параметром. Диапазон скоростей используется при анализе треков обработки.
+
+ ### Где используются операции
+
+ **Агрегаты** — каждому агрегату назначается операция, которую он выполняет. Это позволяет системе корректно интерпретировать данные телематики.
+
+ **Регистрации обработок** — операция указывается для каждой обработки и используется для анализа выполненных работ.
+
+ **Анализ треков обработки** — диапазон скоростей операции применяется для оценки корректности выполнения работы.
+
+ ### Нарушения скорости
+
+ Если скорость техники выходит за пределы установленного диапазона, система фиксирует нарушение.
+
+ **Ключевая особенность:**
+ участки трека, на которых скорость выходит за пределы допустимого диапазона, **не учитываются как обработанная**.
+
+ Это означает:
+ - такие участки **не включаются в обработанную площадь**;
+ - обработанная область на карте в этих местах **не отображается**;
+ - в расчётах учитываются только участки, где скорость соответствует заданному диапазону.
+
+ Нарушения отображаются:
+ - на карте трека обработки;
+ - в свойствах обработки;
+ - в отчётах.
+
+ ## Сценарии применения
+
+ **Настройка операций под разные типы работ**
+
+ Для разных видов сельскохозяйственных операций задаются собственные диапазоны скоростей:
+
+ - для посева - один диапазон;
+ - для опрыскивания - другой;
+ - для культивации - третий.
+
+ Это позволяет системе корректно определять, где работа выполнялась с соблюдением технологии.
+
+ **Контроль качества выполнения работ**
+
+ Агроном может анализировать обработку и видеть:
+ - где техника двигалась слишком быстро (риск некачественной обработки);
+ - где скорость была слишком низкой (возможные остановки или ошибки).
+
+ Такие участки не включаются в обработку, что позволяет объективно оценивать качество выполнения работ.
+
+ **Анализ эффективности**
+
+ На основе корректно отфильтрованных данных:
+ - рассчитывается реальная обработанная площадь;
+ - исключаются искажения из-за некорректной скорости;
+ - повышается точность отчётов и аналитики.
+
+ ## Ограничения и важные условия
+
+ ## Ограничения и важные условия
+
+ - Изменения диапазона скоростей применяются ко всем агрегатам, использующим данную операцию.
+ - Изменения влияют на расчёт обработанной площади, перекрытий и других показателей.
+ - После удаления операция удаляется из всех агрегатов, где она была назначена.
/dev/null .. руководство пользователя/агро-модуль/что такое агро-модуль.md
@@ 0,0 1,95 @@
+ ---
+ type: B
+ audience: R1
+ source: S2
+ section: "Агро-модуль"
+ owner: ""
+ last_verified: ""
+ tested_by: ""
+ version: ""
+ ---
+
+ # Что такое Агро-модуль
+
+ ## Для чего это нужно
+
+ **AGRO-модуль** — это функциональность платформы **SKIF.PRO**, предназначенная для управления сельскохозяйственными работами и анализа производственной деятельности хозяйства на основе данных телематики, геозон и операций.
+
+ Модуль применяется, когда необходимо:
+ - вести учёт сельскохозяйственных работ;
+ - контролировать обработку полей;
+ - хранить историю культур;
+ - анализировать эффективность агропроизводства;
+ - интегрировать телематические данные техники с агрономическими операциями.
+
+ AGRO-модуль связывает **географические данные**, **работу техники** и **агрономические операции** в единую систему учёта.
+
+ ## Как это работает
+
+ ### Основные сущности
+
+ Работа AGRO-модуля строится вокруг нескольких ключевых сущностей.
+
+ **Поля**
+
+ Поля — это сельскохозяйственные участки с географическими границами. Поле хранит геометрию участка, площадь и историю выполненных операций. Поля обычно создаются на основе геозон платформы.
+
+ **Кампании**
+
+ Кампания — это сельскохозяйственный сезон или производственный цикл. Кампания объединяет поля, запланированные операции и фактические регистрации работ.
+
+ **Операции**
+
+ Операция — это **план сельскохозяйственной работы**: посев культуры, внесение удобрений, обработка гербицидами, уборка урожая. Операции могут быть привязаны к одному или нескольким полям.
+
+ **Регистрации**
+
+ Регистрация — это **факт выполнения операции**. Фиксирует когда, какой техникой, с какими материалами и на какой площади была выполнена работа.
+
+ **Справочники**
+
+ Справочники хранят нормативные данные: культуры, типы операций, материалы, орудия и агрегаты. Используются при планировании операций и создании регистраций.
+
+ ### Ключевые задачи модуля
+
+ **Учёт структуры сельхозугодий**
+
+ Поля хозяйства описываются в системе как географические объекты с границами, площадью и историей использования. Это позволяет создать цифровую карту сельхозугодий.
+
+ **Фиксация факта выполнения работ**
+
+ После выполнения операции система создаёт **регистрацию**, которая фиксирует фактические данные: дата и время, техника и агрегаты, обработанные поля, использованные материалы, площадь обработки.
+
+ **Контроль севооборота**
+
+ AGRO-модуль хранит историю культур по каждому полю, позволяет отслеживать последовательность культур и анализировать соблюдение схем севооборота.
+
+ **Аналитика и отчётность**
+
+ На основе операций и регистраций система формирует отчёты по обработке полей, выполненным операциям, использованию материалов и истории культур.
+
+ ### Связь с другими модулями платформы
+
+ AGRO-модуль работает совместно с другими компонентами платформы **SKIF.PRO**.
+
+ **Геозоны** — границы полей обычно создаются на основе геозон. Это позволяет использовать существующие полигоны, отображать поля на карте и анализировать работу техники внутри поля.
+
+ **Объекты** — техника может участвовать в выполнении операций. Это позволяет учитывать технику, выполнявшую работы, анализировать её загрузку и сопоставлять телематические данные с агрооперациями.
+
+ **Отчёты** — данные AGRO-модуля используются при построении аналитических отчётов по выполнению агроопераций и обработанным площадям.
+
+ ## Сценарии применения
+
+ AGRO-модуль используется несколькими ролями.
+
+ **Руководители хозяйства** — контроль выполнения работ, анализ эффективности, планирование кампаний.
+
+ **Агрономы** — планирование операций, контроль севооборота, ведение истории обработки полей.
+
+ **Диспетчеры техники** — фиксация выполненных работ, контроль использования техники.
+
+ ## Ограничения и важные условия
+
+ - Без телематических данных от объектов система не сможет автоматически обнаруживать обработки.
+ - Для корректной работы модуля необходимо предварительно настроить справочники (культуры, операции, агрегаты) и создать поля.
+ - В отчётах используются **только подтверждённые регистрации обработок**.
\ No newline at end of file
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9