Commit 3f558a

2026-03-23 07:04:52 GitLab Deploy: sync: deploy from GitLab commit 3f6b117e
/dev/null .. руководство пользователя/агро-модуль/настройки агро-модуля.md
@@ 0,0 1,182 @@
+ ---
+ type: A
+ audience: R1
+ source: S2
+ section: "Агро-модуль"
+ owner: ""
+ last_verified: ""
+ tested_by: "Kirill Analyze"
+ version: ""
+ ---
+
+ # Как настроить параметры AGRO модуля
+
+ ## Когда это нужно
+
+ Раздел **Настройки** предназначен для конфигурирования параметров работы AGRO-модуля на уровне компании. Настройки определяют, как система анализирует телематические данные техники и формирует обработки.
+
+ Настройки применяются ко всем связанным модулям системы:
+ - **Поля**
+ - **Регистрации обработок**
+ - **Отчёты**
+
+ ## Что потребуется
+
+ Досуп к настрройкам имеют пользователи с ролями:
+
+ - Редактор
+ - Администратор
+ - Супервизор
+ - Редактор тарифа
+
+ Пользователи с более низкими правами доступа не могут менять настройки.
+
+ ## Пошаговая инструкция
+
+ ### Открытие раздела Настройки
+
+ Чтобы открыть настройки AGRO-модуля:
+ 1. Перейдите в **AGRO**.
+ 2. Выберите пункт **Настройки**.
+
+ Откроется страница конфигурации параметров системы.
+
+ Если пользователь имеет доступ к нескольким компаниям, необходимо выбрать нужную компанию для настройки.
+
+ ### Настройка параметров формирования обработок
+
+ Основные параметры определяют, как система анализирует телематические данные и формирует потенциальные обработки.
+
+ 1. Откройте раздел **Настройки**.
+ 2. Укажите необходимые значения параметров.
+ 3. Нажмите **Сохранить**.
+
+ **Параметры:**
+
+ |Параметр|Описание|
+ |---|---|
+ |**Время начала работы**|Определяет начало операционного дня для анализа обработок|
+ |**Минимальное время движения для регистрации**|Минимальное время движения техники по полю для регистрации обработки|
+ |**Время на разворот**|Допустимое время нахождения техники за пределами поля, которое учитывается как часть обработки|
+ |**Разделять обработки по сменам**|Включает или отключает разделение обработок по рабочим сменам|
+
+ **Особенности параметров:**
+
+ **Время начала работы** определяет начало агрономического дня. Например: если установлено **07:00**, система будет учитывать обработки до **06:59 следующих суток**.
+
+ **Минимальное время движения** позволяет исключить короткие заезды техники на поле, которые не являются полноценной обработкой. По умолчанию используется значение **5 минут**.
+
+ **Время на разворот** — если техника временно покидает поле для разворота, этот интервал может быть включён в обработку. Если время за пределами поля превышает установленный лимит — интервал исключается из обработки.
+
+ ### Настройка рабочих смен
+
+ Рабочие смены используются для разделения обработок по временным интервалам.
+
+ 1. Откройте раздел **Настройки**.
+ 2. Включите параметр **Разделять обработки по сменам**.
+ 3. Нажмите **Добавить смену**.
+ 4. Укажите время начала и окончания смены.
+ 5. При необходимости добавьте дополнительные смены.
+ 6. Нажмите **Сохранить**.
+
+ **Правила настройки смен:**
+ - суммарная продолжительность смен не может превышать **24 часа**;
+ - смена не может начинаться в один день и заканчиваться на следующий;
+ - время начала смены должно быть меньше времени окончания.
+
+ **Принцип работы смен:**
+
+ Если включено разделение по сменам, одна фактическая обработка может быть автоматически разделена на несколько регистраций. Граница смены является точкой разрыва обработки.
+
+ Если обработка выполняется вне настроенных смен — она не будет зарегистрирована системой.
+
+ **Как работают смены вместе с временем начала работы**
+
+ Смены и время начала работы работают **совместно и последовательно**.
+
+ 1. Сначала задаётся агро-сутки
+ Параметр **Время начала работы** определяет границы суток.
+ Пример:
+
+ - установлено **07:00**
+ - сутки: **07:00 → 06:59 следующего дня**
+
+ **2. Затем применяются смены**
+ Смены ограничивают допустимые интервалы работы **по календаррному дню**.
+
+ **Пример работы**
+
+ Настройки:
+ - время начала работы: **07:00**
+ - смена: **08:00 – 20:00**
+ - включено разделение по сменам
+
+ Поведение системы:
+ - события с **07:00 до 08:00** → не учитываются (вне смены);
+ - события с **08:00 до 20:00** → формируют обработку;
+ - события после **20:00** → не учитываются;
+ - в **06:59 следующего дня** сутки завершаются.
+
+ **Важные особенности**
+
+ - смены привязаны к календарным дням, а не к агро-суткам
+ - обработка:
+ - обрезается по границе суток;
+ - делится по границам смен;
+ - если обработка полностью вне смен:
+ - она **не создаётся**;
+ - не отображается в системе;
+ - не участвует в отчётах.
+
+ ## Частые вопросы и ошибки
+
+ **Обработки не создаются** - слишком большое значение параметра **Минимальное время движения**.
+ Система игнорирует короткие заезды техники на поле.
+
+ **Решение:**
+ Уменьшите значение параметра или проверьте фактическую длительность работы техники по телематике.
+
+ **Обработки обрываются или делятся на части**
+
+ Возможные причины:
+ - пересечение границы **агро-суток** (время начала работы);
+ - включено разделение по сменам, и обработка пересекает границы смен.
+
+ Решение:
+ - проверьте параметр **Время начала работы**;
+ - проверьте настройки смен и их интервалы;
+ - убедитесь, что разбиение соответствует бизнес-логике работы техники.
+
+ **Обработки не попадают в отчёты**
+
+ Возможные причины:
+ - обработки не были подтверждены;
+ - обработка была сформирована вне текущих агро-суток или смен.
+
+ Решение:
+ - проверьте статус обработок;
+ - проверьте период отчёта с учётом агро-суток;
+ - убедитесь, что обработка попадает в активные смены.
+
+ **Обработки не создаются при включённых сменах**
+
+ Возможная причина:
+ - обработка выполняется вне заданных смен.
+
+ Решение:
+ - проверьте интервалы смен;
+ - убедитесь, что фактическое время работы техники попадает в них;
+ - при необходимости отключите разделение по сменам.
+
+ **Обработка есть в телематике, но отсутствует в системе**
+
+ Возможная причина:
+ - движение было меньше минимального порога;
+ - данные отфильтрованы настройками (смены, агро-сутки).
+
+ Решение:
+ Пошагово проверьте:
+
+ 1. параметры техники;
+ 2. длительность движения;
+ 3. настройки смен и времени начала работы.
\ 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