¶ Артефакты платформы
¶ Перечень сущностей
Основные сущности АС «Андромеда» представлены в таблице ниже.
| № | Сущность | Определение |
|---|---|---|
| 1 | Пользователь | Представляют собой учетные записи, содержащие идентификационные данные и используемые для авторизации и работы в системе. |
| 2 | Роль | Закрепляются за учетными записями и определяют права доступа к функциям и данным системы. |
| 3 | Организация | Используются для централизованного управления правами доступа пользователей к объектам диспетчеризации и группирования объектов системы. |
| 4 | Должность | Представляют собой атрибуты учетных записей и используются для отображения информации в связке с организациями. |
| 5 | Расположение | Описывают структурное расположение объектов и устройств в системе и применяются для корректной привязки данных к конкретным локациям. |
| 6 | Назначения и зоны | Фиксируют типы помещений и используются для уточнения пространственной привязки устройств и параметров в системе. |
| 7 | Параметр | Определяют характеристики устройств и служат для описания их текущего состояния или режимов работы. |
| 8 | Единица измерения | Применяются для представления значений параметров в системе и обеспечивают корректное отображение данных в заданных форматах. |
| 9 | Системные параметры | Являются встроенными характеристиками, используемыми для корректного отображения информации и не подлежащими изменению пользователями. |
| 10 | Границы параметров | Фиксируют допустимые диапазоны значений и связываются с правилами и событиями для контроля работы устройств. |
| 11 | Автоконфигурирование объекта | Механизм автоматического присвоения атрибутов объектам на основе анализа данных, доступных в системе. |
| 12 | Устройство | Элементы инфраструктуры, регистрируемые в системе для мониторинга и управления. |
| 13 | Расположение устройства | Связывают устройства с определенными локациями и применяются при конфигурировании системы. |
| 14 | Параметр устройства | Определяют доступные изменяемые характеристики оборудования и фиксируют его состояние в системе. |
| 15 | Топик | Записи данных, передаваемых в систему от контроллеров, используемые для обмена информацией. |
| 16 | Конфигурация | Объединяют параметры и применяются для настройки системы и интерпретации поступающих данных. |
| 17 | Расположение устройства | Задают связи между устройствами и локациями в составе конфигурации. |
| 18 | Параметры конфигурации | Характеристики, назначаемые устройствам в рамках конфигурации. |
| 19 | Контроллер |
Общее название устройства (физического или виртуального), с которого на брокер, а затем в облако Андромеды (и обратно) попадают топики. Обеспечивает ввод данных от оборудования в систему и служат точками подключения устройств. |
| 20 | ИИ помощник | Встроенные интеллектуальные помощники на основе GigaChat, использующие загруженные инструкции. |
| 21 | Информационная панель | Набор виджетов, расположенных определенным образом. Один из элементов визуализации в Андромеде. Представляет из себя рабочее пространство, на котором можно разместить информационные блоки - от текстовых, до сложных графиков. Для отображения на них информации с контроллера, к блоку привязывается какой-либо сконфигурированный топик. |
| 22 | Дашборд объекта | Дашборд, в карточке которых указан конкретный объект диспетчеризации. Это позволяет просматривать дашборд напрямую из карточки объекта, не переходя в боковое меню "Виджеты", где хранятся все дашборды. |
| 23 | Виджет | Настраиваемые элементы интерфейса для отображения системных данных. |
| 24 | Объекты | Основная сущность системы, отражающая объект недвижимости или его часть, используемая для мониторинга и управления. |
| 25 | Поэтажные схемы объекта | Визуальные планы помещений с размещёнными устройствами и параметрами. |
| 26 | Алгоритмы объекта | Логика управления и анализа, связанная с конкретным объектом. |
| 27 | Документы объекта | Файлы и материалы, загружаемые в карточку объекта для хранения и использования. |
| 28 | Оборудование объекта | Отображает данные телеметрии в структурированном виде, удобном для восприятия пользователем. |
| 29 | Инциденты объекта | Зарегистрированные в системе случаи нарушения нормального функционирования объекта, требующие анализа, реагирования или устранения. |
| 30 | Событие | Фиксируют выход параметров за границы и отображаются в журнале системы. |
| 31 | Отчёты | Формирование и выгрузка аналитических данных по объектам и параметрам системы. |
| 32 | Инструкции | Материалы, регламентирующие порядок работы в системе. |
¶ Диаграмма взаимосвязей между сущностями
Для обеспечения целостности данных и корректного функционирования АС «Андромеда» все основные сущности находятся в логически взаимосвязанной структуре.
На диаграмме выше представлено общее представление взаимосвязей между объектами данных, бизнес-сущностями и пользовательскими ролями.
Диаграмма отражает:
- ключевые объекты предметной области (устройства, контроллеры, события, роли пользователей и др.);
- взаимосвязи между объектами (наследование, принадлежность, ассоциации и ссылки);
- направления информационных потоков между компонентами системы.
¶ Матрица доступа
¶ Описание типовых ролей и их возможностей
| Роль | Альтернативное название | Описание | Разрешённые действия | Запрещённые действия |
|---|---|---|---|---|
| LEAD_MAINTENANCE_PROM | Руководитель эксплуатации | Используется руководителями службы эксплуатации внешних и внутренних заказчиков. Контролирует сотрудников, отслеживает отклонения, работает с документами объектов, принимает и сдаёт смены. | - Просматривать контроллеры, дашборды, схемы, отчёты, обновления, журнал событий, объекты, оборудование, карты, документы объектов - Формировать и скачивать отчёты - Просматривать и создавать события и действия в журнале, переназначать задачи, выгружать журнал в Excel, скачивать файлы, управлять подписками - Работать с ассистентами - Просматривать инструкции, алгоритмы, обновления - Взять смену, сдать смену, получать отчёты по сменам |
- Редактировать/создавать/удалять контроллеры, дашборды, схемы, отчёты, инструкции, алгоритмы, оповещения, события, объекты, оборудование, документы - Управлять доступом, конфигурированием, администрированием - Администрировать ассистентов - Создавать пользователей, организации, роли |
| MAINTENANCE_PROM | Пользователь эксплуатации | Сотрудники эксплуатации заказчика. Контролируют параметры функционирования объектов и реагируют на отклонения. | - Просматривать контроллеры, дашборды, схемы, отчёты, обновления, объекты, оборудование, карты, документы - Формировать и скачивать отчёты - Создавать события и действия, переносить задачи, выгружать журнал, скачивать файлы - Работать с ассистентами - Просматривать инструкции и алгоритмы - Получать доступ к сменам - Управлять диспетчерскими наименованиями |
- Редактировать/создавать/удалять контроллеры, дашборды, схемы, отчёты, инструкции, алгоритмы, оповещения, события, объекты, документы - Переключать режимы оборудования - Управлять доступами и администрированием (кроме диспетчерских наименований) - Администрировать ассистентов - Брать/сдавать смену - Создавать пользователей, организации, роли |
| INTEGRATOR_PROM | Интегратор | Создание дашбордов, событий, алгоритмов. Создание контроллеров, конфигураций, устройств, организаций, границ параметров. | - Создавать контроллеры, добавлять их к объектам - Создавать/редактировать дашборды и добавлять к объектам - Редактировать схемы, слои, карточки - Формировать и скачивать отчёты - Работать с алгоритмами (кроме удаления) - Работать с событиями и журналом - Просматривать и редактировать объекты, задавать расписание - Управлять конфигурациями, связками, автоконфигурацией - Управлять зонами, назначениями, устройствами - Работать с ассистентами |
- Редактировать/удалять контроллеры - Управлять доступом к контроллерам/дашбордам - Удалять дашборды, схемы, отчёты, инструкции, оповещения, документы - Создавать/редактировать/удалять пользователей, организации, роли, должности - Администрировать ассистентов - Брать/сдавать смену - Редактировать/удалять параметры, границы, диспетчерские наименования |
| DEMO_USER | Демо-пользователь | Используется для демонстраций. Может просматривать всё и управлять оборудованием, но ограничен в создании/удалении. | - Просматривать контроллеры, дашборды, схемы, отчёты, обновления, объекты, карты, документы - Формировать отчёты - Создавать события - Работать с ассистентами - Просматривать/создавать/редактировать/удалять алгоритмы, запускать и останавливать |
- Редактировать/создавать/удалять контроллеры, дашборды, схемы, инструкции, оповещения, события, объекты, оборудование, документы - Управлять доступом, конфигурированием, администрированием - Администрировать ассистентов - Брать/сдавать смену - Создавать пользователей, организации, роли |
| ENGINEER_INFRA_PROM | Инженер инфраструктуры | Сотрудники внедрения. Полный доступ к конфигурациям, событиям и алгоритмам. Нет доступа к управлению пользователями. | - Полный доступ к контроллерам и дашбордам - Полный доступ к схемам - Полный доступ к отчётам - Управление алгоритмами - Управление оповещениями - Полный доступ к объектам - Управление оборудованием - Работа с документами - Полное конфигурирование и администрирование - Просмотр пользователей, организаций, должностей |
- Администрирование ассистентов - Управление подписками других пользователей |
| ENGINEER_SUPPORT_PROM | Инженер поддержки | Аналог инженера инфраструктуры, но также может администрировать ассистентов. | - Полный доступ ко всем элементам системы - Создание/редактирование/удаление ИИ-агентов - Администрирование ассистентов |
- Управление доступом к контроллерам/дашбордам - Управление подписками других пользователей |
| SUPPORT_ADMIN_PROM | Администратор системы | Администрирование пользователей, обработка запросов, проведение интеграций. | - Полный доступ к контроллерам, дашбордам, схемам, отчётам, алгоритмам, оповещениям - Полный доступ к объектам, документам - Полное конфигурирование и администрирование - Полный доступ к пользователям, организациям, ролям, должностям - Администрирование ассистентов |
- Управление подписками других пользователей |
| ADMIN_SEC_PROM | Администратор безопасности | Доступ только к созданию пользователей, организаций и выдаче доступов. | - Управлять пользователями, организациями, ролями, должностями - Выдавать доступ к контроллерам и дашбордам - Работать с ассистентами |
- Любые операции с контроллерами, дашбордами, схемами, отчётами, инструкциями, алгоритмами, объектами, оборудованием, событиями, документами, картами - Конфигурирование (кроме пользователей) - Администрирование ассистентов - Управление сменами |
¶ Требования к аппаратному обеспечению
¶ Требования к on-premise
Для локального размещения АС «Андромеда» необходимо соблюдение следующих требований к инфраструктуре:
Серверная инфраструктура:
- Postgres 14;
- Kafka 3.5.0 в кластерном режиме;
- Emqx server 5.6.0;
- Kubernetes cluster 1.28+;
- S3;
- Hashicorp vault;
- Redis cluster 7.0.14;
- Elasticsearch 8.10.3;
- Keycloak server;
- Auth-proxy server;
- Учетная запись в почтовом сервере;
- Телеграм бот и токен для доступа к нему (опционально).
¶ Минимальные системные требования
| Модуль | Технические требования |
|---|---|
| kubernetes | CPU - 16 RAM - 32 Gb |
| S3 | CPU - 2 RAM - 8 Gb Storage - 100 gb |
| Postgres | CPU - 8 RAM - 16 Gb Storage - 500 Gb |
| Kafka | Минимальное рекомендуемое количество нод - 3 CPU - 4 RAM - 8 Gb Storage - 100 Gb |
| Emqx | CPU - 2 RAM - 4 Gb Storage - 40 Gb |
| K8S compute nodes | Минимальное рекомендуемое количество нод - 15 CPU - 16 RAM - 32 Gb |
| Redis | Общий размер доступного кеша 1Gb |
| Elasticsearch | CPU - 4 RAM - 8 Gb Storage - 50 Gb |