=====Ureports=====
Система оповещения пользователей о состоянии счёта и другим событиям (новостям) по различным каналам связи  \\

Для отправки  SMS используется модуль [[abills:docs:modules:sms:ru|SMS]] \\

Благодаря модулю ''Sender'' и [[abills:docs:manual:admin:form_users:user_contacts|использованию новых контактов]], можно отсылать через
  * E-mail
  * Push
  * Telegram
  * XMPP
  * Viber

====Возможности====

  * Подписка на отчёты с аккаунта пользователя.
  * Лимиты срабатывания сенсоров отчётов устанавливаются пользователями самостоятельно.
  * Группирование отчётов в тарифные планы.
  * Возможность взыскание средств за активизацию тарифного плана.
  * Тарификация предоставления услуги (месячная абон. плата, плата за отчёт).
  * Ведение журнала предоставленных отчётов.

**Предоставление отчётов о:**
  * Оповещение о балансе за несколько дней до абон. платы
  * Достижении баланса определённой сумы.
  * Месячный отчёт по использованию трафика.
  * Сообщение о достижение лимита трафика.
  * Депозит ниже определённой суммы 
  * Депозит + Кредит меньше определённой сумы
  * Предоплаченный трафик закончился	
  * Месяц: Депозит + Кредит + Трафик. Выставляется в начале месяца за прошедший
  * Окончание кредита через Х дней
  * Логин Отключено 
  * Сообщение о пополнении счета
  * Все услуги закончатся через XX  дней

====Screenshots====





====Установка====
Создать таблицы в базе. 

  # cd /usr/abills/
  # mysql -D abills < db/Ureports.sql
  # cd libexec 
  # ln -s ../Abills/modules/Ureports/ureports_sender.pl  ureports_sender.pl


Подключение модуля.
**abills/libexec/config.pl**
  @MODULES = (
            'Ureports'
            );


Установка агента рассылки сообщений (сендера).

  # cd /usr/abills/libexec/
  # ln -s ../Abills/modules/Ureports/ureports_sender.pl ureports_sender.pl


====Настройка====
**abills/libexec/config.pl**

^$conf{UREPORTS_EXT_SENDER}="" | Внешняя программы рассылки сообщений. Система передаёт ей следующие параметры \\ DESTINATION - адрес получения \\ MESSAGES  - сообщение |
^$conf{UREPORTS_SKIP_ACTIVATE_SMS}=1; |  не отправлять SMS при активации и изменении данных услуги |

http://abills.net.ua/wiki/doku.php?id=abills:docs:ureports:ru

=====Работа с системой=====

====Тарифные планы====
**/ System configuration/ Reports/ Tarif plans/**
^#	              | Номер тарифного плана |
^Name:	              | Название |
^Message price:	      | Цена сообщения |
^Periodic payments    | Переодические платежи за использование сервиса |
^Month fee:	      | Месячный платёж |
^Postpaid:	      | Послеоплата |
^Discount:	      | Учитывать скидку при взымании денег со счёта за использование услуги  |
^Extra Money account: |	Использовать для оплаты сервиса дополнительный аккаунт |
^Other              | Другие настройки |
^Activation:	    | Цена за подключение сервиса |
^Change:	    | Цена, которая взымается при изменении тарифного плана |
^Credit:	    | Кредит для данного сервиса. Имеет более низкий приоритет перед кредитом аккаунта |

===Reports===
Выбор предоставляемых  сенсоров оповещения. 
^#      | Выбор предоставляемого сенсора в данном тарифном плане |
^Name   | Название сенсора |
^Value  | Значение при котором будет срабатывать сенсор. У пользователя есть возможность изменить это значение. |

====Заведение сервиса====
** /Customers/ Logins/ Information/ Services/ Reports/ ** \\

^Tarif plan:	 | Тарифный план |
^Type:	| Тип отправки |
^Destination (PHONE/E-MAIL): | Телефон |	
^Status:	 | Статус сервиса |
^Registration:	2009-02-24  | Дата регистрации |

После включения сервиса появляется список доступных данному тарифному плану сенсоров.
У пользователя есть возможность самостоятельно менять порог срабатывания сенсора.
**сенсоры**\\

^#     |включить сенсор |
^Name  |Название сенсора|
^Value |Значение срабатывания сенсора |
^Default | Значен сенсора по умолчанию |
^Date  | Дата последнего срабатывания сенсора |

====Отчёты====



=====Рассылка сообщений=====

Рассылкой сообщений занимается программа /usr/abills/libexec/ureports_sender.pl.
доступны следующие опции.

^ DEBUG=0..6  | режим отладки |
^ TP_IDS=     | Список тарифных планов для обработки. Номера тарифных планов разделяются запятыми без пробелов.  |
^ LOGIN=      | Список логинов для отправки сообщений. Разделяются запятыми |
^ DATE=       | Установка даты формирования отчётов. Используется если есть необходимость сформировать отчёт за определённое число. |
^ help        | Помощь |

Данные программу следует  поместить в /etc/crontab с параметрами времени рассылки
\\
**Пример**
\\
Рассылать сообщения каждый день в 10 утра 

<code>
1   10  *  *  *  root /usr/abills/libexec/ureports_sender.pl
</code>

====Шаблоны сообщений====
 \\
общие шаблоны
  * ureports_email_message.tpl  шаблон E-mail сообщения
  * ureports_sms_message.tpl  шаблон SMS сообщения

индивидуальные шаблоны отчётов
  * ureports_reports_1.tpl - Шаблон для отчёта 1

\\

Правка и список шаблонов отчётов находится в ''Настройка / Другое / Шаблоны'' ([[abills:docs:manual:system_configuration:system_configuration#template|Работа с шаблонами]])

\\

Переменные шаблонов

|UID | UID |
|LOGIN | Логин |
|FIO | Фамилия |
|CONTRACT_ID | Номер контракта |
|CONTRACT_DATE | Дата котнракта |
|MESSAGE | Сообщение отчёта |  
|DATE | Текущая дата |
|TP_ID | Номер ТП отчёта |
|CREDIT | Кредит абонента |
|DEPOSIT | Депозит абонента |
|EXPIRE_DAYS |Дней до завершения всех услуг.    |
|EXPIRE_DATE |Дата завершения услуг |
|RECOMMENDED_PAYMENT | Рекомендованная сумма оплат |
|TP_MONTH_FEE| месячная абонплата |
|MESSAGE| как стандартное тело отчёта которое формирует программа отчётов в некоторых отчётах может не заполняться   |