Варианты реализации инфопотоков АСР <-> МРФ

Основные процессы – создание конвергентного абонента

Основные процессы – создание конвергентного абонента для абонента фиксированной связи

Основные процессы – создание конвергентного абонента для существующего абонента МВНО

Инфопоток создание абонента для существующего абонента МВНО

Инфопоток развал пакетного предложения по инициативе МРФ

Инфопоток блокировка/разблокировка услуг

Инфопоток развал ПП по инициативе МРФ Урал

Инфопоток передача платежа по рассрочке в МРФ

2.35M

ИР Пакетное предложение B2C

1. ИР Пакетное предложение B2C

ЕИП

2. содержание

СОДЕРЖАНИЕ
01
Обзор решения
09
Особенность МРФ Волга
02
Состав модулей ЕИП
10
Особенность МРФ Урал
03
Основные процессы
11
Выгрузка данных в MDM
04
Структура интерфейсов решения
12
Настройки, о которых стоит знать
05
Реализация в МРФ ДВ
13 Точки возможного репроцессинга
06
Реализация МРФ Юг и МРФ Центр
14 Точки возможного репроцессинга
07 Точки возможного репроцессинга
08 Точки возможного репроцессинга
15
Ссылки на документацию

3.

Обзор решения
ЕИП

4. Общая архитектура решения

01
ЕИССД
ЕИП
АСР BIS
Урал
АСР МРФ

5.

Состав модулей ЕИП
ЕИП

6. Задействованные в решении модули

ЗАДЕЙСТВОВАННЫЕ В РЕШЕНИИ МОДУЛИ
EISSDAdapter
BISProxy
UralBISMDMLoader
РЕИП МРФ УРАЛ
UralMediator
02
BillingFacade
FarEastStartMDMLoader
RegionalFacade
SibirStartMDMLoader
RegionalProcessing
VolgaStartMDMLoader
VolgaStartAdapter
РЕИП МРФ
KursAdapter
NWAdapter
Orch
RegionalFacade
CenterStartAdapter

7. Карта модулей

КАРТА МОДУЛЕЙ
02

8.

Основные процессы
ЕИП

9. Основные процессы

1
Создание конвергентного абонента
2
Добавление услуг абоненту (в т.ч. Аренда)
3
Процессы обслуживания абонентов – поток от АСР к BIS Урал: смена
паспортных данных, смена тарифа, установка и снятие
добровольной блокировки, передача ДЗ/КЗ, создание и закрытие
рассрочки
4
Процессы обслуживания абонентов – поток от BIS Урал к АСР:
блокировка, разблокировка, передачи платежа, смена номера
MVNO
5
Развал конвергентного абонента
03

10. API на стороне АСР УРалА

API НА СТОРОНЕ АСР УРАЛА
ЕИССД - методы создания абонента
GET_REF_MVNO
CREATE_SET_PACKAGE_OFFER
CREATE_MVNO
GET_CONNECTION_STATUS_MVNO
ЕИССД – метод смены паспортных данных
CHANGE_CL_INFO
АСР Урала
Создание абонента, смена тарифа и развал ПП – set_package_offer
addService – добавление услуги
removeService – снятие услуги
CreateInvoice – создание графика рассрочки
CloseInvoice – закрытие графика рассрочки
AddEquipmentRental – добавление услуги аренды оборудования
RemoveEquipmentRental – снятие услуги аренды оборудования
GetEquipment – получение статуса услуги аренды оборудования
getAccount – получение ЛС Урала по MSISDN
и т.д.
03

11. API на стороне АСР МРФ

API НА СТОРОНЕ АСР МРФ
Смена номера MVNO
Блокировка абонента
Разблокировка абонента
Передача платежа
Развал ПП по неактивности абонента
Получение callback
Получение нотификации о создании абонента MVNO (Юг)
03

12. Варианты реализации инфопотоков АСР <-> МРФ

ВАРИАНТЫ РЕАЛИЗАЦИИ ИНФОПОТОКОВ АСР <->
МРФ
Инфопотоки в проекте Конвергент построены по следующим схемам:
АСР МРФ -> ЕИП -> ЕИССД -> АСР BIS Урал
АСР МРФ -> ЕИП -> АСР BIS Урал
АСР BIS Урал -> ЕИП -> АСР МРФ
Интеграция АСР BIS УРАЛ -> ЕИП реализована по протоколу SOAP
Интеграция ЕИП -> ЕИССД реализована по протоколу SOAP
Интеграция ЕИП -> АСР BIS УРАЛ реализована по
протоколу SOAP
вызовами хранимых процедур АСР BIS Урал
Со стороны ЕИП все вызовы в сторону ЕИССД, BIS Урала, а также со стороны BIS Урала в
сторону АСР МРФ реализованы через SOAP интерфейс на региональном фасаде МРФ
Урал
Интеграция между АСР МРФ и ЕИП реализована
Через интеграцию с БД АСР – МРФ Сибирь, МРФ Волга, МРФ ДВ, МРФ Центр
Через SOAP API – МРФ Волга, МРФ СЗ, МРФ Юг, МРФ Центр
Также могут присутствовать прямые интеграции АСР и МРФ Урал
03

13. Основные процессы – создание конвергентного абонента

Создание абонента. Может быть по следующим сценариям
03
Создание конвергентного абонента для абонента фиксированной связи (телефония, ШПД, и т.п.) –
реализовано последовательными вызовами методов бронирования сим-карты
(Create_set_package_offer) и создание абонента в ЕИССД (create_mvno)
Создание конвергентного абонента для существующего абонента МВНО – реализовано вызовом
метода АСР BIS Урала

14. Основные процессы – создание конвергентного абонента для абонента фиксированной связи

03
• При создании конвергентного абонента для абонента фиксированной связи должны
последовательно пройти следующие шаги:
1. Бронирование сим-карты (CREATE_SET_PACKAGE_OFFER)
2. Сохранение связки ТЛС, msisdn, appkid
3. Поиск SIM (GET_REF_MVNO)
4. Создание конвергентного абонента (CREATE_MVNO)
5. Ожидание ответа о создании сим-карты (GET_CONNECTION_STATUS_MVNO)
6. Ответ в систему-инициатор о результатах. В случае успешного создания содержит ЛС
созданного абонента в АСР BIS Урала
Важно!
После успешного прохождения первого шага в ЕИП создается связка для ТЛС, msisdn и appkid в
таблице convergentmappings БД UralMediator, которая в дальнейшем используется для
обогащения данных и маршрутизации.

15. Основные процессы – создание конвергентного абонента для абонента фиксированной связи

При интеграции на уровне БД реализовано:
• Событие 310I – при обработке данного события последовательно происходят все шаги
процесса
• Событие 310R – при обработке данного события последовательно происходят шаги 1 и 2
• Событие 310N – при обработке данного события последовательно происходят шаг 3-6
Событие Тип
Шаги
310
I
1-6
310
R
1-2
310
N
3-6
03

16. Основные процессы – создание конвергентного абонента для абонента фиксированной связи

03
При интеграции на уровне API реализовано:
• Вызов метода createConvergent с параметром needsReservation = true – выполняет всех 6
шагов
• Вызов метода ReserveSIMCardRequest с параметром isSubscriberExists=false – выполняет шаги 1
и2
• Вызов метода createConvergent с параметром needsReservation = false – выполняет шагов 3-6

17. Основные процессы – создание конвергентного абонента для существующего абонента МВНО

• При создании конвергентного абонента для существующего абонента МВНО выполняются
следующие действия:
• Смена тарифа абонента МВНО на конвергентный тариф вызовом метода BIS
set_package_offer
• Сохранение связки ТЛС, msisdn, appkid
• Ответ в систему-инициатор о результатах. В случае успешного создания содержит ЛС
созданного абонента в АСР BIS Урала
03

18. Основные процессы – создание конвергентного абонента для существующего абонента МВНО

При интеграции на уровне БД реализовано:
• Событие 310T – при обработке данного события последовательно происходят все шаги
процесса
03

19. Основные процессы – создание конвергентного абонента для существующего абонента МВНО

03
При интеграции на уровне API реализовано:
• Вызов метода ReserveSIMCardRequest с параметром isSubscriberExists = true – влечет за собой
последовательное выполнение всех 3 шагов

20. Основные процессы - обслуживание

Изменение паспортных данных для абонента
Добавление/удаление услуг абоненту
Блокировки и разблокировки абонента
Смена номера MVNO абонента
Смена ТП абонента – может пойти по следующим принципиальным сценариям
Смена тарифа на конвергентный тариф
Смена тарифа на неконвергентный тариф – влечет за собой развал пакетного
предложения
Подключение и отключение аренды оборудования
Создание и закрытие рассрочки за пользование оборудованием
Передача ДЗ и КЗ
Закрытие абонента (развал ПП)
03

21. Основные процессы – создание конвергентного абонента для абонента фиксированной связи

03
Событие
Метод API
Описание
310I
CreateMVNO с параметром
needsReservation = true
Резервирование сим-карты (вызов метода
create_set_package_offer), создание
конвергентного абонента (Create_MVNO),
возврат ЛС Урала
310R
Вызов метода ReserveSIMCard с
параметром isSubscriberExists=false
Резервирование сим-карты (вызов метода
create_set_package_offer), возврат ЛС
Урала
310N
Вызов метода CreateMVNO с
параметром needsReservation = false
Создание конвергентного абонента
(Create_MVNO)
310T
Вызов метода ReserveSIMCard с
параметром isSubscriberExists = true
Создание конвергентного абонента (вызов
метода АСР BIS set_package_offer),
возврат ЛС Урала

22. Основные процессы – создание конвергентного абонента для абонента фиксированной связи

03
Событие
Метод API
Описание
311I
ChangeTariffPlan
Смена тарифа (конвергент -> конвергент)
(вызов метода АСР BIS set_package_offer)
312I
СloseConvergent
Развал пакетного предложения по
инициативе МРФ (вызов метода АСР BIS
set_package_offer)
313I
ChangeRegData
Смена паспортных данных абонента
314A/314D AddService/RemoveService
Добавление/снятие услуги
314C
Смена промо услуги на коммерческую
315A/315D AddServiceEqipment/RemoveServiceE
qipment
Добавление/снятие аренды
316A
Подключение разовой услуги
getDebitAccount
317A/317D CreateInvoice/CloseInvoice
Создание/удаление графика рассрочки
318I
Передача дебиторской/кредиторской
задолженности
SetAdjDebts

23.

Структура интерфейсов решения
ЕИП

24. Структура интерфейсов решения

• Общие интерфейсы – реализованы в модуле RegionalFacade
• ConvergentManagementService
• ConvergentService
• Интерфейсы для МРФ – реализованы в соответствующих адаптерах
• NWAdapter – для МРФ СЗ
• KursAdapter – для МРФ Юг
• CenterStartAdapter – для МРФ Центр
• VolgaStartAdapter – для МРФ Волга
• Специфичные для этих адаптеров методы описаны в следующих разделах
04

25.

Реализация в МРФ Сибирь
ЕИП

26. Особенность МРФ Сибирь

• В МРФ Сибирь функционал реализован на интеграции с АСР на уровне БД. Для
интеграции формируются управляющие события:
• 310 – создание абонента
• 311 – смена тарифа
• 312 – смена паспортных данных
• 313 – развал пакета
• 314 – добавление услуг
• 315 – аренда оборудования
• 317 – рассрочка
• Передача разовых услуг реализована напрямую в BIS Урал, без ЕИП.
• Передача ДЗ/КЗ реализована вызовом API
05

27. Схема модулей МРФ Сибирь

28. Инофопоток создание абонента

29. Инфопоток создание абонента для существующего абонента МВНО

30. Инфопоток смена паспортных данных

31. Инфопоток развал пакетного предложения по инициативе МРФ

32. Инфопоток смена тарифного плана

33. Инфопоток подключение/отключение услуги

34. Инфопоток смена номера МВНО

35. Инфопоток блокировка/разблокировка услуг

36. Инфопоток развал ПП по инициативе МРФ Урал

37. Инфопоток создание графика рассрочки

38. Инфопоток передача платежа по рассрочке в МРФ

39.

Реализация в МРФ ДВ
ЕИП

40. Реализация в МРФ ДВ

В МРФ ДВ функционал реализован на интеграции с АСР на уровне БД, за основу взята
реализация для МРФ Сибирь. Для интеграции формируются управляющие события:
• 310 – создание абонента
• 311 – смена тарифа
• 312 – смена паспортных данных
• 313 – развал пакета
• 314 – добавление услуг
• 315 – аренда оборудования
• 316 – разовые услуги
• 317 – рассрочка
• 318 – передача ДЗ и КЗ
Особенности:
• Передача разовых начислений через событие (316)
• Добавление событий 316, 317, 318 напрямую в таблицу ЕИП mdm_events
06

41.

Реализация МРФ Юг и МРФ Центр
ЕИП

42. Реализация в МРФ Юг и Центр

• В МРФ Центр и Юг функционал реализован вызовами API ЕИП, выставленными на
региональном фасаде или на соответствующем адаптере.
• Для процесса переноса абонента МВНО в конвергент на стороне МРФ Юг реализован
метод CreateConvergentInform, который вызывает АСР BIS Урал. Этот метод выставлен на
KursAdapter, вызывает setMvnoService АСР Курс
07

43.

Особенность МРФ СЗ
ЕИП

44. Особенность МРФ СЗ

• В МРФ СЗ функционал реализован на прямой интеграции между АСР СЗ и АСР Урала. В
дальнейшем предполагается использование им API, разработанных для использования
Центром, Волгой, Югом.
• Из специфичного функционала в МРФ СЗ используется
• создание и считывание связок между MSISDN, ТЛС и appkid.
• Получение MSISDN по ICCID
08

45.

Особенность МРФ Волга
ЕИП

46. Особенность МРФ Волга

В МРФ Волга задействованы обе схемы интеграции:
• Интеграция на уровне АСР и создание событий
• Интеграция через API
Из особенностей стоит отметить следующие
• В МРФ реализовано несколько сценариев продажи конвергентных предложений
абонентам. Как следствие – несколько реализаций этого процесса в ЕИП:
• Бронирование сим-карты может быть реализовано как через событие, так и
вызовом API
• Создание абонента происходит через событие
09

47.

Особенность МРФ Урал
ЕИП

48. Особенность МРФ Урал

В МРФ Урал функционал реализован внутри АСР, без использования ЕИП
10

49.

Выгрузка данных в MDM
ЕИП

50. Выгрузка данных в MDM

• Для корректной работы функционала WINK реализована выгрузка данных в MDM
• Выгрузка реализована как новое событие (319) в БД ЕИП в АСР BIS Урал
• В MDM данные загружаются в таблицу entity_mapping
• srcref1_localSystemId = <ЛС МВНО>
• srcref1_appPkId = appPkId из карточки клиента с NLS = <ЛС МВНО>
• srcref1_classname = ru.rt.mdm.app.ejb.entity.PhysicalClient.nls.convergent
• tagref1_localSystemId = <ТЛС>
• tagref1_appPkId = appPkId из карточки клиента с NLS = <ТЛС>
• tagref1_classname = ru.rt.mdm.app.ejb.entity.PhysicalClient.nls.convergent
• В entity_mapping существует только текущая версия связки, история связок не ведется
• При закрытии связки в АСР BIS Урал запись в MDM удаляется
• При создании и удалении связки в entity_mapping данные дублируются в очередь
(реализована на Kafka), подписчиком которой является сервис взаимодействия с WINK
11

51.

Настройки, о которых стоит знать
ЕИП

52. Настройки, о которых стоит знать

• При создании абонента его пол всегда передается в ЕИССД как мужской из-за специфики
реализации на стороне ЕИССД
• Для АСР Сибирь, Волга, ДВ (которые интегрированы через БД и события) есть
возможность настроить абонентские данные по умолчанию в БД. Т.к. АСР BIS Урал не
может создать абонента с пустыми данными, а АСР МРФ данные ещё могут не заведены,
этот механизм позволяет создать абонента с возможностью последующего заполнения его
данных
• В случае, если в АСР МРФ прогруженные номера ICCID сим-карт не совпадают с
номерами ICCID в ЕИССД (загружены без контрольной цифры), на уровне загрузчика АСР
МРФ и/или адаптера к АСР МРФ есть возможность задать символ (%), который будет
добавлен к полученному от АСР ICCID – в этом случае ЕИССД найдет данную сим-карту
12

53.

Точки возможного
репроцессинга
ЕИП

54. Точки возможного репроцессинга

• Репроцессинг в решении имеет смысл только в случае, если была ошибка обработки
события в БД
• Репроцессинг для вызовов API на стороне ЕИП делать не требуется, т.к. вызывающие
системы получают в случае ошибок соответствующий ответ от ЕИП
• Ошибки обработки событий в БД могут быть двух видов: 1) ошибки загрузки события, 2)
ошибки обработки события
• Ошибки загрузки события могут быть, в свою очередь
• связаны с некорректными данными в АСР – тогда требуется скорректировать
данные в АСР и отправить событие в повторную обработку
• связаны с недоступностью модулей ЕИП – ситуация так же решается повторной
обработкой события
• Ошибки обработки события обычно связаны с некорректными данными на стороне
АСР или на стороне ЕИССД/BIS Урал, в этом случае требуется скорректировать
данные и перевести наряд снова в подразделение ЕИП, чтобы он ушел в повторную
обработку
13

55.

Структура таблицы
convergentmappings
ЕИП

56. Структура таблицы convergentmappings

Таблица convergentmappings содержит связки между ТЛС и номером абонента MVNO для
всех МРФ. Её структура:
• Id – идентификатор записи
• Accounttech – ТЛС
• Apppkid – идентификатор региона
• Msisdn – номер телефона MVNO
• Deleted – Boolean, содержит признак, что связка ТЛС-msisdn удалена
14

57.

Ссылки на документацию
ЕИП

58. Ссылки на докуметацию

Документ
ЕИП.РЕИП.РР. Конвергент.Центр_1этап.v.2
Ссылка в ЕСЭД
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d2672ea6
ЕИП.РЕИП.РР. Конвергент_Центр_2этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d29e2a67
РР.РЕИП.Конвергент.СЗ_v.6
http://esed.rt.ru/webtop/action/properties?objectId=0901b211cf3df030
ЕИП.РЕИП.ЧТЗ. Конвергент.Урал_1этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d266db63
ЕИП.РЕИП.ЧТЗ. Конвергент.Урал_2этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d29dba70
ЕИП.РЕИП.РР. Конвергент_Юг_1этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d26701cc
ЕИП.РЕИП.РР. Конвергент_Юг_2этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d29e04d4
ЕИП.РЕИП.ЧТЗ. Конвергент.Сибирь_1этап
ЕИП.РЕИП.ЧТЗ. Конвергент.Сибирь_2этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d29de95b
РР.РЕИП_Урал.Wink
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d2658529
ЕИП.РЕИП.ЧТЗ. Конвергент.ДВ_1этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d2668e7f
ЕИП.РЕИП.ЧТЗ. Конвергент.Волга_1этап
http://esed.rt.ru/webtop/action/properties?objectId=0901b211d266b1e2
15

English Русский Rules