====== TrinityTV ======


{{:logo_trnitytv.png?direct&200|}}

Модуль складається з декількох частин, і призначений для управління і тарифікації підписок користувачів на сервісі [[https://www.trinity-tv.net/|TrinityTV]]. Модуль підтримує помісячну модель нарахування АП.


====== Базова конфігурація Ubilling ======


З точки зору Ubilling усе керується такими опціями [[alteriniconf|alter.ini]]:

<file ini alter.ini>
;Чи увімкнений сервіс TrinityTV?
TRINITYTV_ENABLED=1
;ID партнеру
TRINITYTV_PARTNER_ID="bbaaababbabacbbbabbabababa"
;Salt
TRINITYTV_SALT="ccaaababbabacbbbabbabababa"
;вмикає режим налагодження модуля. Усе спілкування з віддаленим сервісом записуватиметься в exports/trinitytv.log
TRINITYTV_DEBUG=0
</file>


Тарифікація і ввімкнення/вимкнення підписок здійснюється за допомогою таких періодичних викликів [[remoteapi|RemoteAPI]]:

<code bash>
20 1 1 * *        /bin/ubapi "trinitytvcontrol&param=chargefee"
*/10 * * * *      /bin/ubapi "trinitytvcontrol&param=resurrect"
</code>

Як не складно помітити, **chargefee** спочатку здійснює зняття АП за всіма активними підписками. У разі якщо на рахунку абонента утворилася заборгованість або він був заморожений з якоїсь причини вже після нарахування АП підписка абонента буде деактивована. Наступний виклик **resurrect** пробігається по всіх неактивних підписках і перевіряє стан користувача. У разі, якщо абонент ліквідував заборгованість на своєму рахунку, або його рахунок був розморожений - він просто активує профіль користувача.


====== Конфігурація кабінету користувача ======

З точки зору [[userstats|кабінету]] - все ще простіше.

<file ini userstats.ini>
;Чи увімкнений сервіс TrintyTV у кабінеті?
TRINITYTV_ENABLED=1
;Чи захищати користувачів від їхньої власної бідності?
TRINITYTV_PROTECTION=1
;URL до вашого працюючого Ubilling для здійснення взаємодії за RemoteAPI
API_URL="http://billing.isp/"
;Серійний номер вашого працюючого Ubilling
API_KEY="UBxxxxxxxxxxxxxxxxx"
; Також ви можете продавати користувачам це все під виглядом sweet.tv. Просто будуємо все як є і вмикаємо
; опцію TRINITYTV_ENABLED у значення 0 і SWEETTV_ENABLED у значення 1.
SWEETTV_ENABLED=0
;Вимикає можливість самостійного оформлення або відмови від підписок користувачами.
TRINITYTV_NOUSERSUB=0
</file>

 Власне зрозуміло, що URL до встановленого Ubilling і його серійник мають бути валідними, для адекватного спілкування кабінету з білінгом, за допомогою RemoteAPI.

====== Заради чого все це? ======
Для того, щоб за допомогою відповідного модуля

{{:trinitytv_1.png?200|}}


Ми могли додати актуальні тарифи, і задати послуги, які ми надаємо користувачам

{{:trinitytv_2.png?500|}}

Користувачі зможуть спробувати оформити підписку у себе в кабінеті. Звісно, статися це все може, тільки якщо користувач не є замороженим, відключеним, і у нього на рахунку достатньо коштів. 

{{:trinitytv_3.png?500|}}

====== Налаштування ======
Отже. Перше що нам необхідно зробити, це отримати у менеджера TrinityTv наступні параметри:

  * PartnerID
  * Salt
  * Список тарифів c їх ServiceID відповідно
  * Логін/Пароль від адмін-панелі партнерів на стороні TrinityTV (http://partners.trinity-tv.net/) 

Отримані PartnerID, Salt прописуємо в конфігураційному файлі (описано вище в розділі **"Базова конфігурація Ubilling "**), потім в адмінці переходимо в модуль TrinityTV => меню **"Тарифи "**. У формі створення тарифу вказуємо назву тарифу, абонплату, і ID послуги (видається менеджером TrinityTV)

{{:trinitytv_4.png?500|}}

Після того як Тарифи створені переходимо в меню **"Підписки "** до створення користувача. У формі реєстрації користувачів вводимо логін абонента, обираємо тариф і натискаємо кнопку Створити.

{{:trinitytv_5.png?500|}}

Далі в картці абонента ми можемо змінити його статус, прив'язати пристрій, змінити тариф.

{{:trinitytv_6.png?500|}}

Прив'язка пристрою здійснюється двома способами:
  * вручну введенням мак-адреси 
  * прив'язкою за кодом, коли клієнт повідомляє 4-х значний код прив'язки, який він бачить на своєму пристрої.

{{:trinitytv_7.png?500|}}
{{:trinitytv_8.png?500|}}


====== Звітність ======
Звіт слугує для контролю взаєморозрахунків, у якому відображено кількість підписок за місяць, кількість абонентів, сума знятої абонплати

**Місячний звіт:**

{{:trinitytv_9.png?500|}}