Skip to main content

Руководство администратора

##

1. Введение


Это руководство предназначено для администраторов и супер-администраторов системы "Термостатика". Оно описывает расширенные возможности по управлению пользователями, устройствами и системой в целом.


Администраторы имеют доступ к специальной панели управления, которая позволяет выполнять действия, недоступные обычным пользователям.


**Роли администраторов:**

-
    **
  •   Администратор (Admin)**: Может управлять пользователями, просматривать системную статистику и логи аудита.
-
  •  ** Супер-администратор (Super Admin)**: Обладает полными правами, включая возможность создавать, удалять и переназначать логгеры, а также управлять всеми измерениями в системе.

  • ##

    2. Панель администратора


    Доступ к панели администратора осуществляется через основное меню навигации после входа в систему с учетной записью администратора.


    Панель администратора включает следующие разделы:

    -
      **Статистика**
    •   Статистика: Общая статистика по системе.
    -
  •  **Пользователи** Пользователи: Управление учетными записями пользователей.
  • -
  •  **Логгеры** Логгеры: Управление всеми логгерами в системе.
  • -
  •  ** Логи аудита**аудита: Просмотр журнала действий пользователей.

  • ##

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


    В этом разделе вы можете управлять всеми учетными записями пользователей системы.


    ###

    3.1. Просмотр списка пользователей

    На странице "Пользователи" отображается таблица со всеми зарегистрированными пользователями. Вы можете использовать поиск и фильтры для быстрого нахождения нужной учетной записи по email, роли или статусу.


    ###

    3.2. Создание нового пользователя

    1.
    1.  Нажмите кнопку "Создать пользователя".
    2.
  •  Заполните форму:
  •       *   **Email**Email: Электронная почта пользователя.
          *   **Пароль**Пароль: Временный пароль для первого входа.
          *   **Организация, Телефон, Контактное лицо**лицо: Дополнительная информация.
          *   **Роль**Роль: Выберите роль (`user`user, `admin`admin).
          *   **Отправить приглашение**приглашение: Если опция включена, пользователю будет отправлено письмо с инструкциями для входа.
    3.
  •  Нажмите "Создать".

  • ###

    3.3. Редактирование пользователя

    Вы можете изменить данные существующего пользователя:

    -
    •   Отредактировать контактную информацию.
    -
  •   Изменить роль (например, повысить пользователя до администратора).
  • -
  •   Активировать или деактивировать учетную запись (`is_active`is_active).
  • -
  •   Подтвердить email вручную (`email_verified`email_verified).

  • ###

    3.4. Блокировка и удаление пользователя

    -
      **Блокировка**
    •   Блокировка: Вы можете временно заблокировать пользователя, переключив его статус в неактивное состояние. Заблокированный пользователь не сможет войти в систему.
    -
  •  **Удаление** Удаление: Вы можете навсегда удалить учетную запись пользователя. Это действие необратимо. Будьте осторожны, так как удаление пользователя может повлиять на связанные с ним данные (например, логгеры).

  • ##

    4. Управление логгерами (Admin / Super Admin)


    Администраторы могут просматривать все логгеры в системе, независимо от того, какому пользователю они принадлежат. Супер-администраторы имеют расширенные права на управление ими.


    ###

    4.1. Просмотр всех логгеров

    В разделе "Логгеры" представлен полный список всех устройств в системе с информацией о их владельцах.


    ###

    4.2. Создание нового логгера (только Super Admin)

    Супер-администратор может добавлять в систему новые, еще не активированные логгеры.

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

  • ###

    4.3. Переназначение логгера (только Super Admin)

    Если логгер нужно передать другому пользователю:

    1.
    1.  Найдите логгер в списке.
    2.
  •  Нажмите "Переназначить".
  • 3.
  •  Выберите нового владельца из списка пользователей.
  • 4.
  •  Логгер будет отвязан от старого владельца и привязан к новому.

  • ###

    4.4. Удаление логгера (только Super Admin)

    Супер-администратор может полностью удалить логгер из системы. Это действие приведет к удалению всей связанной с ним истории измерений и является необратимым.


    ##

    5. Системная статистика


    На странице "Статистика" отображаются ключевые показатели работы системы:

    -
    •   Общее количество пользователей.
    -
  •   Количество зарегистрированных логгеров и сенсоров.
  • -
  •   Общее количество измерений в базе данных.
  • -
  •   Количество активных алертов.

  • Эта информация помогает оценить общую нагрузку и активность в системе.


    ##

    6. Логи аудита


    Раздел "Логи аудита" предоставляет детальный журнал всех значимых действий, выполненных пользователями в системе. Это важный инструмент для обеспечения безопасности и анализа инцидентов.


    Для каждого действия записывается:

    -
      **Кто**
    •   Кто: Пользователь, выполнивший действие.
    -
  •  **Что** Что: Тип действия (например, `login`login, `update_logger`update_logger, `delete_user`delete_user).
  • -
  •  **Когда** Когда: Дата и время события.
  • -
  •  **Детали** Детали: Дополнительная информация, включая IP-адрес и затронутые ресурсы.

  • Вы можете использовать фильтры для поиска событий по пользователю, типу действия или периоду времени.


    ##

    7. Управление измерениями (только Super Admin)


    Супер-администраторы имеют прямой доступ ко всем измерениям в системе через API. Это позволяет выполнять глобальные операции с данными, такие как:

    -
    •   Просмотр и экспорт измерений для любой пары "сенсор-логгер".
    -
  •   Массовое удаление данных за определенный период.
  • -
  •   Получение системной статистики по измерениям.

  • Эти операции обычно выполняются для технического обслуживания или исправления данных и не имеют прямого пользовательского интерфейса.


    ##

    8. Управление MQTT (через API)


    Администраторы могут управлять MQTT-брокером через специальные API-эндпоинты. Это позволяет:

    -
    •   Просматривать список подключенных клиентов (логгеров).
    -
  •   Создавать и удалять MQTT-учетные данные для устройств.
  • -
  •   Отправлять управляющие команды напрямую на логгеры.

  • Эти функции предназначены для продвинутой диагностики и настройки и, как правило, не требуют ежедневного использования.