Портал жителя iRidium Mobile

Инструкция для интегратора.

Поддержка Портала жителя будет прекращена 31.12.29 г.

Задача интегратора

Сервис "Портал жителя" подразумевает присвоение проекта каждой квартире в соответствии с требованиями заказчика. Проект внедряется интегратором, и в дальнейшем загружается для каждой квартиры в мобильном приложении "Портал жителя". Можно использовать один проект для всех квартир, либо разработать несколько проектов и применять для квартир индивидуально.

Если Вам потребуется помощь в разработке проекта, свяжитесь с нами по почте contact@iridiummobile.ru

Демо

В режиме "Демо" функционал решения ограничен. Для полноценного тестирования, ознакомьтесь с инструкцией.

Функция "Заполнить профиль демо-данными" находится в разделе "Центр мониторинга" веб-портала УК. Она служит для знакомства с системой PMS. При нажатии система запрашивает номер телефона, который будет являться тестовым. После его ввода, система заполнится следующими данными:

• Демо-дом с подъездами, этажами и квартирами (Раздел "Дома");
• Житель, заселенный в случайную квартиру демо-дома (Раздел "Квартира", вкладка "Жители").
• Привязанный лицевой счет к квартире и квитанция по оплате (Раздел "Квартира", вкладка "Счета");
• Номер SIP, привязанный к квартире (Раздел "Квартира", вкладка "SIP");
• Система оплаты "Сбербанк ДЕМО" (Раздел "Профиль"; вкладка "Эквайринг");
• Новая организация ( Раздел "Профиль", вкладка "Мои поставщики");

Так же во вкладке "Мобильное приложение" раздела "Квартира" вы увидите заполненный ключ интегратора:"5h2hf2v6j75pb39br79k" - это ключ тестового проекта, который можно открыть с помощью приложения "Портал жителя".

1. Откройте приложение и введите номер демо жителя.

2. Подтвердите согласие на обработку персональных данных.

3. Появится форма для ввода кода и уведомление, что он был отправлен СМС-сообщением на указанный номер. СМС не придет, так как номер - тестовый. Введите "12456" в поле для кода.

После загрузки откроется базовый проект. Он включает в себя разделы:

• Умный дом
• Шлагбаум и калитка
• Камеры
• Ресепшн
• Заявки
• Уведомления
• Показания
• Собрания
• Счета
• Опросы

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

Создание проекта для портала жителя

На данном этапе вы должны знать:

• Что такое iRidium Pro,
• Как работать в iRidium Studio.

Создание проекта для портала жильца не отличается от создания проекта для i3 Pro. Вам необходимо создать проект в iRidium Studio.

Мы предоставляем вам пример проекта для мобильного приложения mkd_panel_23_05_22.irpz.

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

Описание примера

Для начала работы необходимо скачать образец mkd_panel_23_05_22.irpz и открыть его для редактирования в iRidium Studio.

Проект состоит из следующих компонентов:

• Структура графического интерфейса;
• JS файлы;
• Драйверы.

Многие компоненты проекта связаны между собой и необходимы для правильной работы. 
Удаление или переименование некоторых из них, может повлечь за собой неисправность проекта. 

Структура графического интерфейса

Структура графического интерфейса - список попапов, которые содержат в себе все необходимые элементы управления (заголовки, страницы разделов, виджеты, всплывающие окна с уведомлениями и т.д.), отрисованные в одном стиле и сгруппированные по функционалу

JS файлы

JS файлы - это набор скриптов, выполняющих разные команды и обеспечивающих взаимодействие между компонентами. Каждый скрипт несет свою значимость:

• ir_lib - скрипт, отвечающий за реализацию стандартных функций JavaScript: console, JSON, setTimeout, setInterval, Object, Date.
• Misc - выполняет полезные дополнительные функции: работа с временем, проверка соединения, получение IP-адреса, работа с сигналами.
• TenantHandler - важный скрипт API функций запросов к порталу mkd.iridi.com. Обрабатывает данные между порталом и клиентом.
• GlobalHandler - скрипт реализации глобального слушателя.
• TimeHandler - скрипт реализации слушателя изменения времени.
• Loading - скрипт, обрабатывающий всплывающее окно ожидания.
• Chat - скрипт, обеспечивающий работу чата внутри заявки: получение и отправку текстовых сообщений, обработку и отправку изображений через чат (внутри заявки).
• ProposalsList - скрипт, формирующий списки заявок и сообщений.
• NotificationList - скрипт, формирующий списки оповещений .
• QuestionList - скрипт, реализующий функционал участия в опросах.
• MeetingList - скрипт, реализующий функционал участия в голосованиях и формирующий списков собраний.
• CashesList - скрипт, реализующий функционал с платежными системами и формирующий списки квитанций.
• PopupTree - базовый скрипт, формирующий структуру попапов в проекте.
• Photo&Image - скрипт, реализующий выбор и создание изображения для прикрепления к заявке.
• Metrics - скрипт, формирующий списки показаний счетчиков и реализующий передачу показаний.
• MessageBox - скрипт, реализующий функционал информационных всплывающих окон.
• MaskedEditBox - скрипт, отвечающий за поддержку валидации полей ввода EditBox: Дата, Время, Число.
• RateHandler - скрипт, реализующий функционал рейтинга заявки.
• LabelHandler - служебный скрипт, отвечающий за корректировку отображения текста в полях.

Драйверы

HTTP - базовый драйвер для выполнения API запросов к порталу mkd.iridi.com

SIP - дополнительный драйвер SIP телефонии, для поддержки работы требуется JSON-конфигурация

MQTT - базовый драйвер для работы с MQTT уведомлениями (например новый статус заявки, или новое сообщение и пр.)

iRidium Server - драйвер работы с iRidium Server для поддержки функций умного дома

Загрузка проекта

При авторизации жители каждой квартиры должны получить индивидуальный проект. Выполните следующие шаги:

1. В личном кабинете интегратора создайте объект для дома (в качестве примера назовите его "МКД").

Готовый объект необходимо настроить для работы . На данном этапе это делают сотрудники iRidium. Напишите письмо support@iridi.com с просьбой настроить проект для МКД (сообщите имя объекта и логин вашей учетной записи). После того, как проект будет готов, вы увидите видоизмененный интерфейс при работе с проектами в личном кабинете.

2. Приобретите лицензию МКД в магазине лицензий.

3. Загрузите ваши проекты.

4. Укажите теги для проектов. Например, "Panel" для панельных проектов и "Phone" для телефонных. Так же теги можно использовать для отдельных групп квартир. Например, "VIP" или "Standart". Разделяйте проекты по тегам так, как удобно (он пишется произвольно).

5. Нажмите '"Сохранить изменения в системе Портал жильца". Если у вас нет этой кнопки, значит объект не настроен для работы с МКД.

6. Скопируйте “Код для связи объекта с апартаментами”.

7. Откройте нужную квартиру на сайте mkd.iridi.com и перейдите в раздел "Мобильное приложение”.

8. Вставьте скопированный “Код для связи объекта с апартаментами” в поле “Ключ интегратора”.

На данном этапе у квартиры может быть доступ только к одному проекту.

9. Выберите конфигурацию: тег, который вы приписывали проектам. Например, Panel или Phone.

Если конфигураций не видно - повторите пункт 5.

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

Портал жителя

Для работы с проектами МКД iRidium реализовал специальное приложение “Портал жителя”. Приложение может быть загружено с App Store или Google Play на панель в квартире жителя и на мобильное устройство.

C 25.04.2023 в App Stоre приложение “Портал жителя” будет доступно только с версии iOS 11 и выше.

Если настройка произведена верно, то при авторизации в приложении “портал жильца” вы увидите номер нужной квартиры.

Настройка системы оплаты услуг

Систему оплаты услуг нужно настроить для того, чтоб жители получили квитанции от организации, предоставлявшей эти услуги и чтоб оплата производилась на банковские счета этой организации. Система МКД берет данные из .json файла, выгруженного из 1С. Если следующие данные в системе МКД будут будут отсутствовать или будут некорректными, то выгрузка данных о квитанциях, оплате и задолженностях произойдет некорректно.

1. Для начала необходимо из 1С/Биллинга экспортировать файл .json, чтоб провести тестовую выгрузку и проверить правильность заполнения. Файл должен генерироваться системой расчетов в формате, который представлен ниже:

• Описание строк шаблона
• Пример шаблона

2. Заполните банковские реквизиты Управляющей Компании для Эквайринга. Перейдите в раздел “Профиль”, выберите вкладку “Профиль и юр. инф” и укажите данные банка.

3. Добавьте организации, предоставляющие услуги и ресурсы, в список поставщиков. Для этого в разделе “Профиль” есть вкладка “Мои поставщики”. В форме для заполнения необходимо ввести ИНН нужной организации. Если поставщиком услуг, например, коммунальных, является сама УК, то укажите ее ИНН в качестве поставщика. Если номер введен верно, то название нужной организации появится в таблице ниже. После добавления необходимо указать банк, обслуживающий организацию.

На данном этапе система МКД работает исключительно со Сбербанком.

4. В каждой квартире создайте персональный лицевой счет каждого поставщика. Перейдите в раздел “Дома”, выберите нужный дом и квартиру. Откройте вкладку "Счета" в квартире, добавьте лицевой счет и прикрепите к нему необходимого поставщика.

5. Проверьте все данные, убедитесь, что они заполнены корректно, что все квартиры имеют лицевые счета и привязанную организацию-поставщика. Проведите тестовую выгрузку .json файла с данными об оплате. Если данные в системе МКД и в файле .json введены верно, то в разделе “Счета” квартиры появится список квитанций.