Интерсвязь | Бизнес
Руководство по эксплуатации
«Цифровая мультисервисная платформа - суперприложение для жителей »
Экземпляр ПО доступен по ссылке
Функциональные характеристики
Продукт позволяет решать следующие задачи:

  • Управлением доступом к видеопотоку для пользоваелей.
  • Перенаправление запросов пользователей к биллинговой/crm/медиа системе их компании и наоборот.
  • Обмен приватного токена биллинговой системы/crm на частообновляемый публичный для обеспечения безопасности.
  • Логирование запросов.
1. Установка системы
1.1. Системные требования
1.1.1. Системные требования для работы серверного ПО:

• Современная операционная система Linux, имеющая интерпретатор командной строки, рекомендуется «Debian 10».
• Docker 20.10.12+
• Docker-compose 2.2.2+
• Golang 1.17.5
• Аппаратные требования:
• Оперативная память: 8 ГБ
• Свободное дисковое пространство: не менее 100 ГБ (зависит от
• объема данных)
• Количество логических ядер процессора: 4
• Частота процессора: 2.10 GHz

1.1.2. Системные требования для компиляции мобильного приложения:

• 64-разрядное распределение, позволяющее запускать 32-разрядные приложения;
• Библиотека GNU C (glibc) версии 2.11 или новее;
• 2 ГБ оперативной памяти, рекомендуется 8 ГБ оперативной памяти;
• 2 ГБ свободного места на диске, рекомендуется 4 ГБ (500 МБ для IDE + 1,5 ГБ для Android SDK и образа эмулятора);
• Минимальное разрешение экрана 1280 на 800 пикселей;
• JDK 8;
• Для ускоренного эмулятора: процессор Intel с поддержкой функций Intel VT-x, Intel EM64T (Intel 64) и Execute Disable (XD) или процессор AMD с поддержкой технологии виртуализации AMD (AMD-V).

Когда вы убедитесь, что операционная система совместима и подходит для установки и настройки Android Studio, загрузите соответствующий дистрибутив.

1.2. Используемые компоненты и языки

1.3. Установка
1.3.1. Установка серверного ПО

Для установки программного обеспечения на собственные сервера требуется произвести следующие действия:

• Загрузить Архивы с ПО на сервер (в желаемую папку на усмотрение пользователя/администратора, осуществляющего установку экземпляра ПО), на котором предполагается установить развернуть платформу. В моём случае это будет /tmp.
• Перейти в директорию с загруженными архивами и выполнить следующие команды:
• tar -xvf cde.tar.gz
• docker load -i redis-alpine.tar
• docker load -i postgres12.tar
• docker load -i core-adapter-auth.tar
• docker load -i core-adapter-intercom.tar
• docker load -i core-adapter-video.tar
• docker load -i core-web.tar
• docker load -i core-main.tar
• cd cde/core-developer-environment
• docker-compose up -d

1.3.2. Создание мобильного приложения
1.3.2.1. Подготовка android studio:

Для запуска проекта можно использовать персональный компьютер с установленными ОС Linux, Mac OS или Windows. Далее по инструкции будем рассматривать запуск и сборку приложения из под системы Linux, также будет рассмотрена установка англо-язычной версии ПО.

Подготовка Android Studio для работы:

1. Прежде всего, вам необходимо загрузить установщик с официального сайта разработчиков. Перейдите на сайт и нажмите Download Android Studio.
2. Ознакомьтесь с лицензионным соглашением, активируйте чекбокс и нажмите кнопку Download Android Studio for Linux.
3. Дождитесь завершения скачивания.
4. Когда файл будет загружен, перейдите в папку с загрузками и распакуйте содержимое архива в /opt. Для этого используйте команду вида (укажите скачанную вами версию приложения вместо 202.7486908): sudo tar xf ~/Загрузки/android-studio-ide-202.7486908-linux.tar.gz -C /opt
5. Чтобы добавить ярлык в меню приложений, создайте файл androidstudio.desktop командой: vi ~/.local/share/applications/androidstudio.desktop
6. Добавьте в файл следующий текст и сохраните его:
[Desktop Entry] Version=1.0 Type=Application Name=Android Studio Exec="/opt/android-studio/bin/studio.sh" %f Icon=/opt/android-studio/bin/studio.png Categories=Development;IDE; Terminal=false StartupNotify=true StartupWMClass=android-studio
7. После этого установка будет завершена, и вы можете запустить среду разработки из главного меню, однако окончательная установка Android Studio ещё не завершена — программа должна скачать все необходимые компоненты и настройки. Если вы работали с Android Studio ранее, в следующем окне вы можете скопировать свои настройки. Если нет, — выберите Do not import settings и нажмите ОК.
8. Потребуется некоторое время, чтобы программа могла загрузить нужные компоненты и настроить систему.
9. На следующем экране нажмите кнопку Next.
10. После этого вы сможете выбрать между стандартной автоматической инсталляцией и ручной. Второй способ позволяет выбрать для установки отдельные компоненты.
11. Выберите предпочитаемую тему оформления.
12. Ознакомьтесь со списком компонентов и их расположением.
13. Приложение отобразит уведомление о том, можете ли вы использовать эмуляторы на своём компьютере (зависит от аппаратной составляющей).
14. Далее начнётся загрузка, которая может занять довольно много времени, скорость зависит от вашего интернет соединения.
15. Когда загрузка завершится, вы можете нажать Finish и перейти к открытию проекта.

1.3.2.2. Открытие проекта
Для открытия проекта требуется:

1. В появившемся окне нажать на Open an Existing Project или просто Open.
2. Найти папку с нужным проектом, нажать ОК.
3. Через какое-то время проект загрузится и можно будет приступить к созданию собственной версии приложения.
Далее по тексту подобным убразом будет обозначаться относительный путь до требуемой папки или файла:
./app/src/maintest или так ./res/values/app_configurations.xml

1.3.2.3. Создание собственного варианта приложения:
Для создания собственного варианта приложения требуется:

1. Скопировать папку ./yard-android/app/src/maintest и поместить его по этомуже адресу, но уже с вашим названием. (Например так ./yard-android/app/src/maintest)
2. Папка долна иметь обязательные ресурсы:
• ./res/values/app_configurations.xml
• ./res/values/strings.xlm
• ./res/google-services.json (создается автоматически при создании проекта в личном кабинете FireBase необходимо заменить этот фаил на свой)
3. Не обязательные файлы:
• ./res/values/drawable - иконки приложения;
• ./res/values/mipmap* - иконки приложения.
4. Изменить в файле ./res/values/strings.xlm - "app_name" - название приложения на свое.
5. Изменить в файле /res/values/app_configurations.xml:
• "scheme_app" - указать свое значение (сейчас служит идентификатором для уникальной сборки приложения (Например maintest));
• "auth_client" - CLIENT_ID организации на мультисервисной платформы.
6. Добавить в фаил ./app/flavors.gradle: Добавить к applicationDefinitions новый элемент массива ['name': 'maintest', applicationId: 'com.maintest.yard'] где, maintest должен соответствовать значению scheme_app из файла ./res/values/strings.xlm.

1.3.2.4. Сборка проекта

1. Открыть через пункт меню Build -> Generate Signed bundle/apk
2. В диалоговом окне выбрать APK. Указать путь к ключу подписи для приложения если такого нет, нужно создать.
3. В форме требуется указать путь к ключу подписи, который был создан или уже имеющийся.
Создается ключ подписи с кнопки `Create new...`:
Поля заполняются следующим образом:
- `Key store path - Путь до хранилища ключей;`
- `Password - Пароль от хранилища;`
- `Confirm - Повторить пароль;`
- `Alias - Название ключа (Указать свое значение `scheme_app`);`
- `Password - Пароль от ключа;`
- `Confirm - Повторить пароль;`
- `First and Last Name - Ваше Имя/фамилия;`
- `Organizational Unit - Название отдела;`
- `Organization - Название организации;`
- `City or Locality - Название города;`
- `State or Province - Название области;`
- `Country Code(XX) - Код города;`
- После указания данных нажимаем `OK`.
4. Далее в списке нужно выбрать наш вариант с названием нашей сборки+ надпись Release (пример - maintestRelease).
5. После нажатия на кнопку Finish будет собираться приложение. Готовое приложение будет находится в папке app/maintest/release/maintest-release.apk

1.3.2.5. Установка приложения

Для установки также понадобится выполнить несколько шагов:
1. Переместите полученный файл «apk» на Ваш смартфон
Зайдите в диспетчер файлов и перейдите в каталог с файлом
2. Нажмите на APK, после чего выберите установщик
3. Нажмите «Установить».
Подготовка приложения к использования закончена.
2. Доступные методы API
Документация по API находится по адресу:
https://<Адрес_вашего_сервера>:8080/docs/swagger/index.html
Логин для доступа «user_doc», а пароль «RGGbn6nL».
В документации приведено описание к каждому запросу.
3. Руководство пользователя веб-части
3.1 Начальная страница
Для перехода на страницу с WEB интерфейсом платформы необходимо перейти на http://<IP_Сервера>:8085/Для входа в систему необходимо ввести логин и пароль и нажать на кнопку «Sign in»

3.2 Раздел «Организации»
3.2.1 Создания организации

Для создания организации необходимо выбрать раздел «Организации» в меню находящимся в левой части интерфейса
В появившимся окне необходимо нажать на
В появившимся окне необходимо заполнить поля:
• « Наименование »
• « Идентификатор клиента »
• « Пароль клиента »
После чего выбрать вид отображения приложения в выпадающем списке « Entrypoint »

3.2.3 Удаление организации
Удалить организацию можно нажав на кнопку «Actions» находящуюся напротив нужной организации и выбрав в меню «Удалить»

3.2.4 Редактирование организации
Изменить организацию можно нажав на кнопку «Actions» находящуюся напротив нужной организации и выбрав в меню «Редактировать», после внесения изменений необходимо применить изменение нажав на кнопку «Submit»

3.2.5 Добавление пользователя
Добавление пользователя в организацию осуществляется путем нажатия на кнопку «Actions» на против нужной организации и выбором из писка пункта «Пользователи»
В открывшемся окне отображается список пользователей у данной организации
Снизу данного списка нажимаем на кнопку «Добавить пользователя».

В появившемся окне заполняем поля: Логин, Пароль, Общее имя, Группа, Fias id, Квартира.
• «Логин» - указываем логин нового пользователя
• «Пароль» - указываем пароль нового пользователя
• «Общее имя» - указываем общее имя
• «Группа» - из попадающегося списка выбираем группу к которой будет относиться данный пользователь
• «Fias id» - указываем адрес
• «Квартира» - указываем квартиру
После заполнения необходимых полей, подтверждаем действие нажатием на кнопку «Добавить»

3.2.6 Удаление пользователя
Удаление пользователя производиться путем нажатия на кнопку «Actions» находящуюся напротив нужного пользователя и выбора пункта «Удалить»

3.2.7 Добавление входа
Добавление входа в организацию производиться нажатием на кнопку «Actions» находящуюся на против нужной организации и выбора пункта «Входы»
В появившемся списке входов в начале списка заполняем необходимые поля: Идентификатор камеры, Идентификатор входа.
И подтверждаем добавление нажатием на кнопку «+»

3.2.8 Удаление входа
Удаление входа производиться путем нажатия на кнопку находящуюся напротив нужного входа

3.2.9 Добавление персональных камер
Добавление персональных камер осуществляется путем нажатия на кнопку «Actions» находящуюся на против нужной организации и выбора пункта «Персональные камеры»
В появившимся окне заполняем необходимые поля: ID клиента, ID потока подтверждаем добавление нажатием на кнопку «+».

3.2.10 Удаление персональной камеры
Удаление персональной камеры производиться путем нажатия на кнопку находящуюся напротив нужной камеры

3.3 Раздел «Модули»
3.3.1 Отключение модулей

В данном разделе отображается информация об имеющихся плагинах, например видео адаптер с указанием его ID, ID организации, типом и его URI идентификатор

3.3.2 Отключение модулей
Так же можно отключить нужный модуль нажатием на кнопку «Unregister» которая находиться напротив нужного модуля.

3.4 Раздел «Сессии»
В разделе «Сессии» отображается информация о сессиях пользователей в какой организации и с каким токеном, а так же указывается время начало регистрации и время окончания

3.5 Раздел «Устройства»
3.5.1 Описание
В разделе «Устройства» находиться информация об устройстве с которого подключался пользователь

3.5.1 Отключить устройство
Отключить устройcтво можно нажатием на кнопку «Unregister» напротив нужного устройства

3.6 Раздел «Адреса»
3.6.1 Описание
В данном разделе отображается информация об адресе, его FiasID и сам адрес

3.6.2 Добавление
Добавления адреса производится путем заполнения полей: «Fias ID» и «Адрес» и нажатием на кнопку «Добавить» в конце списка адресов

3.6.3 Удаление адреса
Удаление адреса производится путем нажатия на кнопку «Actions» и выбрав пункт «Удалить»

3.7 Раздел «Группы»
3.7.1 Описание
В разделе «Группы» отображается список групп

3.7.2 Добавить группу
Добавить новую группу можно нажатием на кнопку «Добавить группу» находящуюся в конце списка.

3.7.3 Редактирование и удаление группы
Редактирование группы а так же удаление производиться через меню «Action» находящимся напротив нужной группы

3.8 Раздел «Push сервера»
3.8.1 Описание
В разделе «Push сервера» находиться информация о имеющихся Push серверах

3.8.2 Добавление Push сервера
Добавить Push сервер можно нажатием на кнопку «Добавить PUSH сервер» находящуюся в конце списка серверов
Заполнив необходимые поля «app id» и «Адрес» необходимо нажать на «Submit»
• «app id» - id приложения
• «Адрес» - адрес push сервера

3.8.3 Изменение Push серверах
Изменить имеющийся Push сервер можно нажав на кнопку «Actions» находящуюся напротив нужного Push сервера и выбрав в меню «Изменить». В появившимся окне меняем нужный параметр после чего нажимаем на кнопку.
4. Руководство пользователя мобильной части
4.1. Авторизация
После запуска приложения в открывшемся окне выберите кнопку «ВХОД». Далее перед Вами предстанет окно, в котором потребуется ввести логин и пароль для завершения авторизации и открытия списка домофонов.

4.2. Разделы видеопотоков
Открылась страница со списком потоков, где верхний раздел принадлежит домофонам, калиткам и шлагбаумам, а нижний городским и личным камерам. Различие между этими разделами в наличии кнопки открытии у верхнего раздела.
При нажатии на определенный видеопоток перейдем на страницу видеопотока.

4.3. Раздел определенного видеопотока
В данном разделе содержится информация связанная только с определенным видеопотоком, у пользователя имеется возможность просмотреть прямой эфир с указанного потока и его архивные записи. Если это мы выбрали видеопоток из верхнего раздела, то он также имеет кнопку открытия.

Для управления архивом имеется несколько вариантов:
1. Шкала времени под видеопотоком.
2. Кнопка «Архив» с возможностью выбора даты архива.
Пусть сложные решения даются легко!
Документы «Интерсвязь. Платформа IP-домофонии»:
Руководство по развертыванию платформы
Жизненный цикл
Экземпляр ПО
Регламент оказания услуг технической поддержки Платформы для IP-домофонии
Руководство пользователя

Документы «Интерсвязь. Цифровая мультисервисная платформа - суперприложение для жителей»:
Жизненный цикл
Руководство по эксплуатации
Экземпляр ПО

ООО Фирма «Интерсвязь»,
г. Челябинск, пр. Победы, 288, офис 605
Звонок бесплатный