# Руководство пользователя cloud.entro.pro

# Руководство пользователя cloud.entro.pro

## Содержание

1. [Введение](#введение)
2. [Начало работы](#начало-работы)
3. [Работа с проектами](#работа-с-проектами)
4. [Функции для менеджеров проектов](#функции-для-менеджеров-проектов)
5. [Административная панель](#административная-панель)
6. [Справочная информация](#справочная-информация)
7. [Часто задаваемые вопросы](#часто-задаваемые-вопросы)


---


## Введение


### О системе


**cloud.entro.pro** — это облачный сервис для геотехнического мониторинга, который позволяет централизованно управлять данными мониторинга по всем вашим объектам. Система предоставляет интерактивные карты, аналитику и инструменты для контроля технического состояния объектов.


### Основные термины


- **Проект** — объект геотехнического мониторинга (например, жилой комплекс, мост, завод)
- **Позиция** — минимальная единица для проведения мониторинга на объекте
- **Цикл** — период проведения измерений (например, ежемесячный цикл мониторинга)
- **Статус позиции** — текущее техническое состояние позиции (норма, работоспособное, ограниченно работоспособное, аварийное)


### Первый вход в систему


1. Откройте браузер и перейдите по адресу вашего сервера (например, `http://192.168.72.105:8080`)
2. На странице входа введите ваш **email** и **пароль**
3. Нажмите кнопку **"Войти"**
4. После успешного входа вы попадете на главный дашборд системы


---


## Начало работы


### Вход в систему


Для входа в систему:


1. Откройте страницу входа
2. Введите ваш **email** (логин)
3. Введите ваш **пароль**
4. Нажмите кнопку **"Войти"**


Если вы забыли пароль, используйте ссылку **"Забыли пароль?"** для его восстановления.


### Восстановление пароля


Если вы забыли пароль:


1. На странице входа нажмите **"Забыли пароль?"**
2. Введите ваш email
3. Нажмите **"Отправить"**
4. Проверьте вашу почту и следуйте инструкциям в письме
5. Создайте новый пароль


### Обзор интерфейса


Интерфейс системы разделен на два уровня работы:


#### Глобальный уровень


Когда вы только зашли в систему, вы находитесь на **глобальном уровне**. Здесь вы видите:


- **Боковое меню (сайдбар)** с разделами:
  - 📊 **Дашборд** — обзор всех ваших проектов
  - ❐ **Проекты** — список доступных проектов
  - ⚙️ **Настройки** — системные настройки
  - (Для администраторов) **Админпанель** — управление системой


- **Основное окно** — рабочая область, где отображается выбранный раздел


#### Локальный уровень (работа с проектом)


После выбора проекта из списка интерфейс переходит в **локальный уровень**:


- В боковом меню появляется секция **"АКТИВНЫЙ ПРОЕКТ"** с названием текущего проекта
- Ниже появляются разделы, относящиеся к этому проекту:
  - 🗺️ **Карта объектов** — детальная карта проекта
  - 📊 **Анализ** — графики и статистика
  - 📅 **Планировщик** — управление задачами (для менеджеров и кураторов)
  - ⚙️ **Настройки проекта** — настройки проекта (только для менеджеров)
  - 📄 **Аудит проекта** — журнал действий (только для менеджеров)


**Для переключения между проектами** используйте пункт меню **"Проекты"** в верхней части сайдбара.


---


## Работа с проектами


### Дашборд


**Дашборд** — это главная страница системы, которая показывает сводную информацию по всем вашим проектам.


На дашборде отображается:


- **Состояние проектов** — список всех доступных проектов с их статусами:
  - 🟢 **Норма** — все элементы в норме
  - 🟡 **Есть замечания** — есть элементы, требующие внимания
  - 🔴 **Требует внимания** — есть критические проблемы


- **Ближайшие задачи** — задачи из планировщиков всех проектов на ближайшее время


Для перехода к конкретному проекту кликните на его название или статус.


### Выбор проекта для работы


Для начала работы с проектом:


1. Перейдите в раздел **"Проекты"** в боковом меню
2. Вы увидите список всех доступных вам проектов
3. Кликните на нужный проект


После выбора проекта интерфейс перейдет в локальный контекст, и вы сможете работать с данными этого проекта.


### Карта объектов


**Карта объектов** — это детальная карта выбранного проекта с отображением всех позиций мониторинга.


#### Основные функции карты:


- **Отображение позиций** — на карте отображаются все позиции проекта в виде контуров (полигонов) или точек
- **Цветовая индикация** — каждая позиция окрашена в цвет, соответствующий её статусу:
  - 🟢 **Зеленый** — нормальное состояние
  - 🔵 **Синий** — работоспособное состояние
  - 🟡 **Желтый/Оранжевый** — ограниченно работоспособное
  - 🔴 **Красный** — аварийное состояние
  - ⚪ **Серый** — нет данных


- **Фильтрация по статусам** — используйте фильтры для отображения только позиций с определенными статусами
- **Выбор циклов** — выберите цикл мониторинга для отображения данных за конкретный период
- **Дерево проекта** — в боковой панели отображается иерархическая структура проекта:
  - Проект
    - Объект
      - Подобъект
        - Позиция


- **Визуализация деформаций и температур** — на карте можно включить отображение карт деформаций или температур с настройкой параметров визуализации


#### Работа с картой:


1. **Просмотр позиций** — позиции отображаются автоматически при загрузке карты
2. **Клик по позиции** — кликните на позицию на карте или в дереве проекта для просмотра детальной информации
3. **Изменение масштаба** — используйте колесико мыши или кнопки масштабирования
4. **Перемещение по карте** — зажмите левую кнопку мыши и перемещайте карту


### Анализ данных


Раздел **"Анализ"** предоставляет детальную аналитику по проекту.


#### Основные возможности:


- **Статистика по проекту** — общая статистика по всем позициям проекта
- **Графики и диаграммы** — визуализация данных по позициям и элементам мониторинга
- **Информация о позициях** — детальная информация о выбранной позиции:
  - Статус позиции
  - Количество элементов мониторинга
  - Данные измерений
  - История изменений


- **Работа с элементами ГТМ** — просмотр и анализ данных по отдельным элементам геотехнического мониторинга (марки, скважины и т.д.)


#### Использование анализа:


1. Выберите проект в разделе **"Проекты"**
2. Перейдите в раздел **"Анализ"**
3. Используйте дерево проекта для выбора позиции
4. Просматривайте графики и статистику по выбранной позиции


---


## Функции для менеджеров проектов


Менеджеры проектов имеют дополнительные возможности для управления проектом.


### Планировщик работ


**Планировщик** позволяет управлять задачами и циклами мониторинга для проекта.


#### Основные операции:


- **Просмотр задач** — все задачи отображаются в виде временной шкалы (диаграмма Ганта)
- **Создание задачи** — создание новой задачи для цикла мониторинга:
  1. Нажмите кнопку **"Создать задачу"**
  2. Выберите подобъект
  3. Выберите цикл
  4. Укажите даты начала и окончания
  5. Сохраните задачу


- **Редактирование задачи** — изменение параметров существующей задачи
- **Управление циклами** — создание и редактирование циклов мониторинга
- **Отслеживание прогресса** — просмотр прогресса выполнения задач


#### Работа с планировщиком:


1. Выберите проект
2. Перейдите в раздел **"Планировщик"**
3. Используйте фильтры для отображения нужных задач
4. Создавайте и редактируйте задачи по необходимости


**Примечание:** Планировщик доступен как менеджерам, так и кураторам проекта (кураторы могут только просматривать).


### Настройки проекта


Раздел **"Настройки проекта"** доступен только менеджерам проекта.


#### Основные функции:


- **Управление командой** — просмотр пользователей, имеющих доступ к проекту
- **Настройка метаданных** — редактирование информации о проекте
- **Управление циклами** — создание, редактирование и удаление циклов мониторинга


#### Использование настроек:


1. Выберите проект
2. Перейдите в раздел **"Настройки проекта"**
3. Внесите необходимые изменения
4. Сохраните изменения


### Аудит проекта


**Аудит проекта** показывает журнал всех действий, выполненных в рамках проекта.


#### Просмотр аудита:


1. Выберите проект
2. Перейдите в раздел **"Аудит проекта"**
3. Просматривайте список действий с фильтрацией по дате, пользователю и типу действия


**Примечание:** Аудит доступен только менеджерам проекта.


---


## Административная панель


Административная панель доступна только пользователям с ролью **Администратор системы**.


### Управление пользователями


В разделе **"Управление пользователями"** администратор может:


- **Просмотр списка пользователей** — таблица со всеми пользователями системы
- **Создание пользователя** — добавление нового пользователя:
  1. Нажмите кнопку **"Создать пользователя"**
  2. Заполните форму (email, имя, пароль)
  3. Выберите глобальную роль (admin или user)
  4. Сохраните пользователя


- **Редактирование пользователя** — изменение данных пользователя
- **Сброс пароля** — сброс пароля пользователя с отправкой нового пароля на email
- **Удаление пользователя** — удаление пользователя из системы


### Управление проектами


В разделе **"Управление проектами"** администратор может:


- **Просмотр списка проектов** — таблица со всеми проектами
- **Подключение нового проекта** — добавление нового проекта:
  1. Нажмите кнопку **"Подключить новый проект"**
  2. Заполните форму:
     - Название проекта
     - Тип подключения (Прямое/VPN)
     - Параметры подключения к базе данных (хост, порт, название БД)
     - Учетные данные для подключения (пользователь, пароль)
  3. Нажмите **"Проверить"** для проверки подключения
  4. Сохраните проект


- **Редактирование проекта** — изменение параметров проекта
- **Проверка подключения** — проверка доступности базы данных проекта
- **Удаление проекта** — удаление проекта из системы


### Управление доступом


В разделе **"Управление доступом"** администратор может:


- **Просмотр матрицы прав** — таблица, показывающая права всех пользователей на все проекты
- **Назначение ролей** — установка проектных ролей для пользователей:
  1. Найдите нужного пользователя и проект в матрице
  2. Выберите роль в выпадающем списке:
     - **Менеджер** — полный доступ к данным проекта
     - **Куратор** — только просмотр данных
     - **Нет доступа** — проект скрыт от пользователя
  3. Нажмите **"Сохранить изменения"**


- **Массовое назначение прав** — назначение прав нескольким пользователям одновременно


### Аудит системы


В разделе **"Аудит системы"** администратор может просматривать журнал всех действий в системе с фильтрацией по дате, пользователю и типу действия.


---


## Справочная информация


### Роли и права доступа


Система использует двухуровневую модель ролей:


#### Глобальные роли (системный уровень)


| Роль | Описание | Права |
|------|----------|-------|
| **Администратор** | Суперпользователь платформы | Управление пользователями, проектами, доступом. Полный контроль над системой. |
| **Пользователь** | Обычный пользователь | Просмотр доступных проектов. Доступ к проектам определяется проектными ролями. |


#### Проектные роли (уровень проекта)


| Роль | Описание | Права на проект |
|------|----------|-----------------|
| **Менеджер** | Полный доступ к управлению данными проекта | Изменение всех данных, просмотр, экспорт, работа с картами и графиками, планировщик, настройки проекта |
| **Куратор** | Только просмотр данных проекта | Просмотр всех данных (карты, графики, отчеты), скачивание готовых отчетов, просмотр планировщика. Не может изменять данные. |
| **Нет доступа** | Доступ запрещен | Проект скрыт от пользователя |


**Важно:** Администратор системы не имеет автоматического доступа к данным проектов. Для работы с данными проекта администратор должен назначить себе проектную роль через интерфейс управления доступом.


### Статусы позиций и их значения


Позиции на карте отображаются с цветовой индикацией, соответствующей их техническому состоянию:


| Цвет | Статус | Описание |
|------|--------|----------|
| 🟢 **Зеленый** | Норма | Все элементы позиции в нормальном состоянии |
| 🔵 **Синий** | Работоспособное | Позиция работоспособна, но требует внимания |
| 🟡 **Желтый/Оранжевый** | Ограниченно работоспособное | Позиция имеет ограничения в работе, требуется контроль |
| 🔴 **Красный** | Аварийное | Критическое состояние, требуется немедленное вмешательство |
| ⚪ **Серый** | Нет данных | Данные по позиции отсутствуют или не получены |


### Цветовая индикация на карте


На карте объектов позиции отображаются с цветовой индикацией:


- **Контуры позиций** (полигоны) окрашены в цвет, соответствующий статусу
- **Точки позиций** также имеют цветовую индикацию
- **Легенда карты** показывает соответствие цветов и статусов


Для фильтрации позиций по статусам используйте панель фильтров на карте.


---


## Часто задаваемые вопросы


### Общие вопросы


**В: Как войти в систему?**  
О: Откройте адрес сервера в браузере, введите ваш email и пароль, нажмите "Войти".


**В: Я забыл пароль. Что делать?**  
О: На странице входа нажмите "Забыли пароль?", введите ваш email и следуйте инструкциям в письме.


**В: Как переключиться между проектами?**  
О: Используйте пункт меню "Проекты" в боковом меню, затем выберите нужный проект из списка.


### Работа с картой


**В: Что означают цвета на карте?**  
О: Цвета показывают статус позиций: зеленый — норма, синий — работоспособное, желтый — ограниченно работоспособное, красный — аварийное, серый — нет данных.


**В: Как посмотреть информацию о конкретной позиции?**  
О: Кликните на позицию на карте или выберите её в дереве проекта в боковой панели.


**В: Как изменить цикл мониторинга на карте?**  
О: Используйте селектор циклов в панели управления картой.


### Права доступа


**В: Почему я не вижу некоторые проекты?**  
О: Вам не назначен доступ к этим проектам. Обратитесь к администратору системы для получения доступа.


**В: Почему я не могу редактировать данные проекта?**  
О: У вас роль "Куратор", которая позволяет только просматривать данные. Для редактирования нужна роль "Менеджер проекта".


**В: Как получить права менеджера проекта?**  
О: Обратитесь к администратору системы, который может назначить вам роль "Менеджер" для нужного проекта.


### Административные вопросы


**В: Как подключить новый проект?**  
О: Перейдите в "Админпанель → Управление проектами", нажмите "Подключить новый проект" и заполните форму с параметрами подключения к базе данных.


**В: Как назначить права пользователю на проект?**  
О: Перейдите в "Админпанель → Управление доступом", найдите нужного пользователя и проект в матрице, выберите роль и сохраните изменения.


**В: Как сбросить пароль пользователя?**  
О: Перейдите в "Админпанель → Управление пользователями", найдите пользователя, нажмите "Сбросить пароль". Новый пароль будет отправлен на email пользователя.


### Технические вопросы


**В: Проект показывает статус "Офлайн". Что это значит?**  
О: Система не может подключиться к базе данных проекта. Проверьте параметры подключения в настройках проекта или обратитесь к администратору.


**В: На карте не отображаются позиции. Что делать?**  
О: Проверьте, что выбран правильный цикл мониторинга, и что для позиций есть данные. Также проверьте фильтры по статусам.


---


## Заключение


Это руководство описывает основные функции системы cloud.entro.pro. Для получения дополнительной помощи обращайтесь к администратору системы.


**Удачной работы!**


---


*Версия документа: 1.0*  
*Дата обновления: 2025*