Commit e0739a
2026-06-16 13:58:04 GitLab Sync: sync: pull wiki from cms-test| агро-модуль.md .. | |
| @@ 5,55 5,33 @@ | |
| # Агро-модуль | |
| - | **AGRO-модуль** — функциональность платформы **SKIF.PRO** для управления сельскохозяйственными работами и анализа производственной деятельности хозяйства на основе данных телематики. |
| + | **SKIF.AGRO** — модуль платформы SKIF.PRO для учёта и контроля сельскохозяйственных работ. Модуль связывает географические данные, работу техники и агрономические операции в единую систему на основе телематики. |
| - | Модуль объединяет географические данные, работу техники и агрономические операции в единую систему учёта. |
| + | Модуль доступен по адресу [agro.skif.pro](https://agro.skif.pro) после активации компании. |
| - | > 👤 — статья для конечных пользователей (диспетчеры, агрономы, руководители) |
| - | > 🔧 — статья для интеграторов (подключение и настройка на стороне платформы) |
| - | |
| - | ## Разделы |
| - | |
| - | - [Что такое Агро-модуль](Агро-модуль/Что%20такое%20Агро-модуль.md) — назначение, основные сущности и возможности модуля |
| - | - [Как подключить компанию к Агро-модулю](Агро-модуль/Как%20подключить%20компанию%20к%20Агро-модулю.md) 🔧 — активация доступа, подготовка объектов и геозон в SKIF |
| - | - [Как начать работу в Агро-модуле](Агро-модуль/Как%20начать%20работу%20в%20Агро-модуле.md) 👤 — пошаговая настройка с нуля |
| - | |
| - | ### Поля |
| + | ## Основные сущности |
| - | - [Поля](Агро-модуль/Поля.md) — что такое поля в AGRO |
| - | - [Как создать поле](Агро-модуль/Поля/Как%20создать%20поле.md) |
| - | - [Как редактировать поле](Агро-модуль/Поля/Как%20редактировать%20поле.md) |
| - | - [Как удалить поле](Агро-модуль/Поля/Как%20удалить%20поле.md) |
| + | Работа SKIF.AGRO строится вокруг нескольких ключевых сущностей: |
| - | ### Регистрации обработок |
| + | | Сущность | Описание | |
| + | |---|---| |
| + | | **Поля** | Сельскохозяйственные участки с географическими границами. Поле хранит геометрию участка, площадь и историю выполненных операций. Поля создаются на основе геозон SKIF.PRO. | |
| + | | **Регистрации обработок** | Факт выполнения сельскохозяйственной операции на поле. Фиксирует когда, какой техникой, с какими материалами и на какой площади была выполнена работа. | |
| + | | **Справочники** | Нормативные данные: культуры, операции, агрегаты. Используются при создании регистраций и формировании отчётов. | |
| + | | **Отчёты** | Аналитический инструмент для анализа фактически выполненных работ за выбранный период. | |
| - | - [Регистрации обработок](Агро-модуль/Регистрации%20обработок.md) — как работает механизм автоматического выявления обработок |
| - | - [Как найти обработки](Агро-модуль/Регистрации%20обработок/Как%20найти%20обработки.md) |
| - | - [Как редактировать обработку](Агро-модуль/Регистрации%20обработок/Как%20редактировать%20обработку.md) |
| - | - [Как удалить обработку](Агро-модуль/Регистрации%20обработок/Как%20удалить%20обработку.md) |
| + | ## Подключение и настройка |
| - | ### Отчёты |
| + | - [Подключение компании](Агро-модуль/Подключение%20компании.md) 🔧 — активация доступа, подготовка объектов и геозон в SKIF.PRO (для интеграторов) |
| + | - [Начало работы](Агро-модуль/Начало%20работы.md) 👤 — пошаговая настройка SKIF.AGRO с нуля |
| + | - [Настройки](Агро-модуль/Настройки.md) — параметры формирования обработок и рабочих смен |
| - | - [Отчёты](Агро-модуль/Отчёты.md) — аналитический инструмент модуля |
| - | - [Виды отчётов в Агро](Агро-модуль/Отчёты/Виды%20отчётов%20в%20Агро.md) |
| - | - [Как сформировать отчёт](Агро-модуль/Отчёты/Как%20сформировать%20отчёт.md) |
| - | |
| - | ### Настройки |
| - | |
| - | - [Настройки Агро-модуля](Агро-модуль/Настройки%20Агро-модуля.md) — параметры формирования обработок, рабочие смены, система мер |
| + | ## Разделы |
| - | ### Справочники |
| + | - [Поля](Агро-модуль/Поля.md) — сельскохозяйственные участки |
| + | - [Регистрации обработок](Агро-модуль/Регистрации%20обработок.md) — учёт выполненных работ |
| + | - [Справочники](Агро-модуль/Справочники.md) — Агрегаты, Культуры, Операции |
| + | - [Отчёты](Агро-модуль/Отчёты.md) — аналитика выполненных работ |
| - | - [Справочники](Агро-модуль/Справочники.md) — нормативные данные для планирования и учёта |
| - | - [Что такое агрегаты](Агро-модуль/Справочники/Что%20такое%20агрегаты.md) |
| - | - [Как создать агрегат](Агро-модуль/Справочники/Как%20создать%20агрегат.md) |
| - | - [Как редактировать агрегат](Агро-модуль/Справочники/Как%20редактировать%20агрегат.md) |
| - | - [Как удалить агрегат](Агро-модуль/Справочники/Как%20удалить%20агрегат.md) |
| - | - [Что такое культуры](Агро-модуль/Справочники/Что%20такое%20культуры.md) |
| - | - [Как создать культуру](Агро-модуль/Справочники/Как%20создать%20культуру.md) |
| - | - [Как редактировать культуру](Агро-модуль/Справочники/Как%20редактировать%20культуру.md) |
| - | - [Как удалить культуру](Агро-модуль/Справочники/Как%20удалить%20культуру.md) |
| - | - [Что такое операции](Агро-модуль/Справочники/Что%20такое%20операции.md) |
| - | - [Как создать операцию](Агро-модуль/Справочники/Как%20создать%20операцию.md) |
| - | - [Как редактировать операцию](Агро-модуль/Справочники/Как%20редактировать%20операцию.md) |
| - | - [Как удалить операцию](Агро-модуль/Справочники/Как%20удалить%20операцию.md) |
| + | > 👤 — статья для конечных пользователей (диспетчеры, агрономы, руководители) |
| + | > 🔧 — статья для интеграторов (подключение и настройка на стороне платформы) |
| агро-модуль/как начать работу в агро-модуле.md .. /dev/null | |
| @@ 1,148 0,0 @@ | |
| - | --- |
| - | 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. Создать поля |
| - | |
| - | После настройки справочников необходимо добавить поля. |
| - | |
| - | Зайдите на платформу **SKIF.PRO → Геозоны** |
| - | |
| - | Для каждого поля необходимо указать: |
| - | |
| - | - название поля; |
| - | - тип поля (полигон, территория) |
| - | - задать границы поля на карте; |
| - | - площадь (рассчитывается автоматически). |
| - | |
| - | Поля используются системой для определения мест выполнения сельскохозяйственных работ. Когда техника движется внутри геозоны поля, система может обнаружить потенциальную обработку. |
| - | |
| - | ### Шаг 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 |
| агро-модуль/как подключить компанию к агро-модулю.md .. /dev/null | |
| @@ 1,94 0,0 @@ | |
| - | --- |
| - | type: A |
| - | audience: R2 |
| - | source: S2 |
| - | section: "Агро-модуль" |
| - | owner: "" |
| - | last_verified: "" |
| - | tested_by: "Kirill Analyze" |
| - | version: "" |
| - | --- |
| - | |
| - | # Как подключить компанию к Агро-модулю |
| - | |
| - | Подключите компанию-клиента к Агро-модулю **SKIF.PRO** для учёта обработок полей и работы с агрономической аналитикой. Перед началом работы необходимо активировать доступ, убедиться в наличии объектов и подготовить геозоны нужного типа в основной платформе SKIF. |
| - | |
| - | ## Что потребуется |
| - | |
| - | - Доступ к платформе SKIF.PRO с правами управления компанией |
| - | - Роли: Рдактор тарифа, Супервизор |
| - | - Перечень компаний, для которых необходим доступ к Агро-модулю |
| - | - Объекты (транспортные средства, сельхозтехника), зарегистрированные в SKIF |
| - | - Геозоны типа «полигон», соответствующие контурам полей |
| - | |
| - | ## Пошаговая инструкция |
| - | |
| - | ### Шаг 1. Активировать доступ к Агро-модулю для компании |
| - | |
| - | Доступ к Агро-модулю для компании активируется на стороне SKIF.PRO. Направьте заявку на подключение с перечнем компаний, которым необходим доступ. |
| - | |
| - | Самостоятельная активация через административную панель на текущий момент недоступна — доступ управляется через back-office платформы. |
| - | |
| - | После активации компания и все связанные с ней данные становятся доступны в Агро-модуле по адресу [`agro.skif.pro`](https://agro.skif.pro). |
| - | |
| - | ### Шаг 2. Проверить объекты компании |
| - | |
| - | Все объекты (транспортные средства, техника) из подключённой компании автоматически становятся доступны в Агро-модуле. Дополнительная настройка объектов не требуется. |
| - | |
| - | Объекты используются в Агро-модуле для: |
| - | |
| - | - построения отчётов по технике; |
| - | - автоматического выявления обработок полей; |
| - | - привязки к агрономическим операциям. |
| - | |
| - | Убедитесь, что техника добавлена в SKIF и на ней установлены GPS-трекеры с поступающими телематическими данными. Без телематических данных Агро-модуль не сможет обнаруживать обработки. |
| - | |
| - | ### Шаг 3. Подготовить геозоны в SKIF |
| - | |
| - | Агро-модуль использует геозоны из SKIF для определения границ полей. Геозоны должны соответствовать следующим требованиям: |
| - | |
| - | - **Тип геозоны:** только поле и территория. Линейные, точечные и другие типы геозон не поддерживаются Агро-модулем. |
| - | |
| - | Геозоны-поля и территории, созданные в SKIF, будут доступны в Агро-модуле для создания полей на их основе. |
| - | |
| - | ### Шаг 4. Перейти к настройке Агро-модуля |
| - | |
| - | После активации доступа и подготовки данных в SKIF дальнейшая настройка выполняется в самом Агро-модуле: |
| - | |
| - | - **Поля** — создаются в Агро-модуле на основе геозон из SKIF. Подробнее: [Как начать работу в Агро-модуле](Как%20начать%20работу%20в%20Агро-модуле.md) |
| - | - **Справочники** (операции, агрегаты, культуры) — заполняются в Агро-модуле. Подробнее: [Справочники](Справочники.md) |
| - | - **Настройки обработок** — параметры автоматического выявления обработок задаются в Агро-модуле |
| - | |
| - | Пошаговую инструкцию по настройке модуля с нуля см. в статье [Как начать работу в Агро-модуле](Как%20начать%20работу%20в%20Агро-модуле.md). |
| - | |
| - | ### Результат |
| - | |
| - | После выполнения шагов 1–3 компания подключена к Агро-модулю: |
| - | |
| - | - доступ активирован; |
| - | - объекты компании доступны в модуле; |
| - | - геозоны-поля/территории готовы для создания полей. |
| - | |
| - | Дальнейшая настройка справочников, полей и параметров обработок выполняется в интерфейсе Агро-модуля. |
| - | |
| - | ## Частые вопросы и ошибки |
| - | |
| - | **Компания не отображается в Агро-модуле после заявки на подключение** |
| - | |
| - | Убедитесь, что заявка обработана и доступ активирован на стороне SKIF.PRO. Если доступ активирован, но компания не отображается — проверьте, что вход выполнен под учётной записью с привязкой к нужной компании. |
| - | |
| - | **Объекты компании не видны в Агро-модуле** |
| - | |
| - | Все объекты компании переносятся автоматически. Если объекты отсутствуют: |
| - | |
| - | - объекты должны быть зарегистрированы в SKIF под той же компанией, для которой активирован Агро-модуль; |
| - | - доступ к Агро-модулю для компании должен быть включён. |
| - | |
| - | **Геозоны из SKIF не отображаются при создании полей в Агро-модуле** |
| - | |
| - | Агро-модуль использует только геозоны типа «поле» и «территория». Линейные, точечные и другие типы геозон не будут доступны. Проверьте тип геозон в SKIF. |
| - | |
| - | ## Что дальше |
| - | |
| - | - [Как начать работу в Агро-модуле](Как%20начать%20работу%20в%20Агро-модуле.md) — пошаговая настройка справочников, полей и параметров модуля |
| - | - [Что такое Агро-модуль](Что%20такое%20Агро-модуль.md) — назначение, основные сущности и возможности модуля |
| агро-модуль/настройки агро-модуля.md .. /dev/null | |
| @@ 1,175 0,0 @@ | |
| - | --- |
| - | 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 |
| /dev/null .. агро-модуль/настройки.md | |
| @@ 0,0 1,68 @@ | |
| + | --- |
| + | tested_by: "Kirill Analyze" |
| + | --- |
| + | |
| + | # Настройки |
| + | |
| + | Настройки SKIF.AGRO определяют, как система анализирует телематические данные техники и формирует обработки. Параметры применяются на уровне компании и влияют на все связанные модули — Поля, Регистрации обработок и Отчёты. |
| + | |
| + | Для изменения настроек нужны роли **Редактор**, **Администратор**, **Супервизор** или **Редактор тарифа**. |
| + | |
| + | ## Открытие настроек |
| + | |
| + | 1. Откройте **SKIF.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` следующего дня сутки завершаются. |
| + | |
| + | > Если обработка выполняется полностью вне настроенных смен — она не создаётся, не отображается в системе и не участвует в отчётах. |
| + | |
| + | > Смены привязаны к календарным дням, а не к агро-суткам. Обработка обрезается по границе суток и делится по границам смен. |
| /dev/null .. агро-модуль/начало работы.md | |
| @@ 0,0 1,30 @@ | |
| + | --- |
| + | tested_by: "Kirill Analyze" |
| + | --- |
| + | |
| + | # Начало работы |
| + | |
| + | Базовая настройка SKIF.AGRO с нуля. После выполнения этих шагов система начинает автоматически обнаруживать и регистрировать сельскохозяйственные обработки. |
| + | |
| + | Перед началом убедитесь, что: |
| + | |
| + | - техника добавлена в SKIF.PRO и на ней установлены GPS-трекеры; |
| + | - данные о перемещении техники поступают в систему; |
| + | - настроены водители, прицепы и навесное оборудование (агрегаты), если они используются. |
| + | |
| + | Если компания ещё не подключена к SKIF.AGRO, начните с [Подключения компании](Подключение%20компании.md). |
| + | |
| + | ## Этапы настройки |
| + | |
| + | 1. **Проверьте наличие техники и телематических данных в SKIF.PRO.** Без телематики система не сможет обнаруживать обработки. |
| + | 2. **Заполните справочники.** В разделе **SKIF.AGRO → Справочники** добавьте [культуры](Справочники/Культуры.md), [операции](Справочники/Операции.md) и проверьте список синхронизированных [агрегатов](Справочники/Агрегаты.md). |
| + | 3. **Создайте поля.** В **SKIF.PRO → Геозоны** добавьте поля на основе геозон-полигонов. Подробнее: [Создание поля](Поля/Создание%20поля.md). |
| + | 4. **Настройте параметры формирования обработок.** В **SKIF.AGRO → Настройки** укажите время начала работы, минимальное время движения, время на разворот и при необходимости — рабочие смены. Подробнее: [Настройки](Настройки.md). |
| + | 5. **Проверьте регистрации обработок.** В **SKIF.AGRO → Регистрации обработок** отображаются потенциальные обработки, найденные системой. Подробнее: [Поиск регистраций](Регистрации%20обработок/Поиск%20регистраций.md). |
| + | 6. **Сформируйте отчёт.** В **SKIF.AGRO → Отчёты** проанализируйте выполненные работы. Подробнее: [Формирование отчёта](Отчёты/Формирование%20отчёта.md). |
| + | |
| + | После выполнения всех шагов SKIF.AGRO готов к работе. Система автоматически анализирует телематические данные техники, обнаруживает обработки, рассчитывает производственные показатели и формирует аналитические отчёты. |
| + | |
| + | > Только подтверждённые регистрации обработок используются в аналитике и отчётах. |
| + | |
| + | > Изменения в параметрах справочников (ширина захвата, диапазон скоростей операции) применяются при расчёте последующих обработок. Уже сформированные регистрации могут пересчитываться. |
| /dev/null .. агро-модуль/подключение компании.md | |
| @@ 0,0 1,29 @@ | |
| + | --- |
| + | audience: R2 |
| + | tested_by: "Kirill Analyze" |
| + | --- |
| + | |
| + | # Подключение компании |
| + | |
| + | Подключите компанию-клиента к SKIF.AGRO для учёта обработок полей и работы с агрономической аналитикой. Подключение выполняется через back-office платформы SKIF.PRO — самостоятельная активация через административную панель на текущий момент недоступна. |
| + | |
| + | Для подключения нужны роли **Редактор тарифа** или **Супервизор** на стороне SKIF.PRO. |
| + | |
| + | ## Что потребуется |
| + | |
| + | - Перечень компаний, которым необходим доступ к SKIF.AGRO. |
| + | - Объекты (транспортные средства, сельхозтехника), зарегистрированные в SKIF.PRO под этими компаниями. |
| + | - Геозоны типа **полигон** или **территория**, соответствующие контурам полей. |
| + | |
| + | ## Этапы подключения |
| + | |
| + | 1. **Активируйте доступ.** Направьте заявку на подключение с перечнем компаний. Доступ управляется через back-office. После активации компания и все связанные данные становятся доступны в SKIF.AGRO по адресу [agro.skif.pro](https://agro.skif.pro). |
| + | 2. **Проверьте объекты компании.** Все объекты подключённой компании автоматически становятся доступны в SKIF.AGRO. Дополнительная настройка не требуется. Убедитесь, что на объектах установлены GPS-трекеры и поступают телематические данные. |
| + | 3. **Подготовьте геозоны в SKIF.PRO.** SKIF.AGRO использует геозоны для определения границ полей. Поддерживаются только типы **полигон** и **территория** — линейные, точечные и другие типы геозон не будут доступны при создании полей. |
| + | 4. **Передайте настройку клиенту.** Дальнейшая работа в SKIF.AGRO выполняется силами клиента. Передайте инструкцию [Начало работы](Начало%20работы.md) для пошаговой настройки справочников, полей и параметров обработок. |
| + | |
| + | После выполнения шагов 1–3 компания подключена к SKIF.AGRO: доступ активирован, объекты компании доступны в модуле, геозоны-поля готовы для создания полей. |
| + | |
| + | > Самостоятельная активация через административную панель на текущий момент недоступна. Подключение управляется через back-office. |
| + | |
| + | > SKIF.AGRO использует только геозоны типа **полигон** и **территория**. Если в SKIF.PRO есть геозоны другого типа — они не будут видны в SKIF.AGRO. |
| агро-модуль/что такое агро-модуль.md .. /dev/null | |
| @@ 1,72 0,0 @@ | |
| - | --- |
| - | type: B |
| - | audience: R1 |
| - | source: S2 |
| - | section: "Агро-модуль" |
| - | owner: "" |
| - | last_verified: "" |
| - | tested_by: "" |
| - | version: "" |
| - | --- |
| - | |
| - | # Что такое Агро-модуль |
| - | |
| - | **AGRO-модуль** — функциональность платформы **SKIF.PRO** для учёта и контроля сельскохозяйственных работ. Модуль связывает географические данные, работу техники и агрономические операции в единую систему на основе телематики. |
| - | |
| - | ## Как это работает |
| - | |
| - | ### Основные сущности |
| - | |
| - | Работа AGRO-модуля строится вокруг нескольких ключевых сущностей. |
| - | |
| - | | Сущность | Описание | |
| - | |---|---| |
| - | | **Поля** | Сельскохозяйственные участки с географическими границами. Поле хранит геометрию участка, площадь и историю выполненных операций. Поля обычно создаются на основе геозон платформы. | |
| - | | **Кампании** | Сельскохозяйственный сезон или производственный цикл. Кампания объединяет поля, запланированные операции и фактические регистрации работ. | |
| - | | **Операции** | **План сельскохозяйственной работы**: посев культуры, внесение удобрений, обработка гербицидами, уборка урожая. Операции могут быть привязаны к одному или нескольким полям. | |
| - | | **Регистрации** | **Факт выполнения операции**. Фиксирует когда, какой техникой, с какими материалами и на какой площади была выполнена работа. | |
| - | | **Справочники** | Хранят нормативные данные: культуры, типы операций, материалы, орудия и агрегаты. Используются при планировании операций и создании регистраций. | |
| - | |
| - | ### Ключевые задачи модуля |
| - | |
| - | **Учёт структуры сельхозугодий** |
| - | |
| - | Поля хозяйства описываются в системе как географические объекты с границами, площадью и историей использования. Это позволяет создать цифровую карту сельхозугодий. |
| - | |
| - | **Фиксация факта выполнения работ** |
| - | |
| - | После выполнения операции система создаёт **регистрацию**, которая фиксирует фактические данные: дата и время, техника и агрегаты, обработанные поля, использованные материалы, площадь обработки. |
| - | |
| - | **Контроль севооборота** |
| - | |
| - | AGRO-модуль хранит историю культур по каждому полю, позволяет отслеживать последовательность культур и анализировать соблюдение схем севооборота. |
| - | |
| - | **Аналитика и отчётность** |
| - | |
| - | На основе операций и регистраций система формирует отчёты по обработке полей, выполненным операциям, использованию материалов и истории культур. |
| - | |
| - | ### Связь с другими модулями платформы |
| - | |
| - | AGRO-модуль работает совместно с другими компонентами платформы **SKIF.PRO**. |
| - | |
| - | **Геозоны** — границы полей обычно создаются на основе геозон. Это позволяет использовать существующие полигоны, отображать поля на карте и анализировать работу техники внутри поля. |
| - | |
| - | **Объекты** — техника может участвовать в выполнении операций. Это позволяет учитывать технику, выполнявшую работы, анализировать её загрузку и сопоставлять телематические данные с агрооперациями. |
| - | |
| - | **Отчёты** — данные AGRO-модуля используются при построении аналитических отчётов по выполнению агроопераций и обработанным площадям. |
| - | |
| - | ## Сценарии применения |
| - | |
| - | AGRO-модуль используется несколькими ролями. |
| - | |
| - | **Руководители хозяйства** — контроль выполнения работ, анализ эффективности, планирование кампаний. |
| - | |
| - | **Агрономы** — планирование операций, контроль севооборота, ведение истории обработки полей. |
| - | |
| - | **Диспетчеры техники** — фиксация выполненных работ, контроль использования техники. |
| - | |
| - | ## Ограничения и важные условия |
| - | |
| - | - Без телематических данных от объектов система не сможет автоматически обнаруживать обработки. |
| - | - Для корректной работы модуля необходимо предварительно настроить справочники (культуры, операции, агрегаты) и создать поля. |
| - | - В отчётах используются **только подтверждённые регистрации обработок**. |
| \ | No newline at end of file |