Возможности
Подписка на отчёты с аккаунта пользователя
Лимиты срабатывания сенсоров отчётов, устанавливаются пользователями самостоятельно
Группирование отчётов в тарифные планы
Возможность взыскания средств за активизацию тарифного плана
Тарификация предоставления услуги (месячная абон. плата, плата за отчёт)
Ведение журнала предоставленных отчётов
Поддержка модулей расширения отчётов
Возможность запретить абонентам управлять отчётами
Предоставление отчётов о:
1 | Оповещение абонента со статусом услуги интернет «Активно» и суммой депозита ниже значения тригера |
---|---|
2 | Депозит + Кредит ниже значения тригера |
3 | Предоплаченный трафик закончился. (Значение тригера не учитывается) %REST% - осталось трафика в байтах %REST_DIMENSION% - осталось трафика приведено в разрядность %PREPAID% - предоплачено трафика Маркеры с учетом классов трафика %REST_0% %REST_DIMENSION_0% %PREPAID_0% |
4 | Дневной трафик превысил лимит тригера |
5 | Месячный отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается) |
6 | Дневной отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается) |
7 | Оповещение о завершении кредита через указанное в тригере количество дней |
8 | Оповещение об отключенном логине (тригер не учитывается) |
9 | Оповещение о завершении тарифа через указанное количество дней. количество дней до завершения в шаблоне задается опцией %CREDIT_EXPIRE_DAYS%. Дней до завершения предоплаченного периода |
10 | Недостаточно средств для работы в следующем месяце (Депозит + Кредит) |
11 | Депозит ниже, чем абонплата следующего месяца. По данном отчету абонент может выставить период предупреждения. Например за 5 дней до начала следующего учетного периода. |
12 | Оповещение о пополнении счета |
13 | Оповещение о завершении всех сервисов (Internet, Abon, Iptv, Voip) за несколько дней (количество дней до завершения указывается в тригере) |
14 | Оповещение о начислении абонплаты через период дней указанный в тригере |
15 | В услуги интернет изменился статус (тригер не учитывается) |
16 | Предупреждение о начале следующего учётного периода. В тригере указывается количество дней |
Работа
Система рассылает сообщения через программу ureports_sender.pl, кроме сообщения о пополнении, оно отправляется моментально после поступления средств. После отправки сообщения система отмечает отчёт как выполненный и больше не отправляет сообщения по нему. 1 числа месячные отчеты обнуляются и становятся готовыми опять для отправки сообщений. Обнуление происходит дневным периодиком (periodic daily).
Установка
Создать таблицы в базе.
cd /usr/abills/ mysql -D abills < db/Ureports.sql
cd libexec ln -s ../Abills/modules/Ureports/ureports_sender.pl ureports_sender.pl
@MODULES = ( 'Ureports' );
Настройка
abills/libexec/config.pl
$conf{UREPORTS_EXT_SENDER}=«» | Внешняя программа рассылки сообщений. Система передаёт ей следующие параметры DESTINATION - адрес получения MESSAGES - сообщение |
---|---|
$conf{UREPORTS_SKIP_ACTIVATE_SMS}=1; | Не отправлять SMS при активации и изменении данных услуги. По умолчанию при активизации или изменении услуги оповещения система отправляет сообщение о действии |
$conf{UREPORTS_ROUNDING}=1; | Округление рекомендуемой суммы оплаты к целым числам, округление всегда происходит в большую сторону |
$conf{UREPORTS_ALLOWED_TYPES} = 'Sms'; | Список доступных типов оповещений для модуля. |
Работа с системой
Рассылка сообщений
Рассылкой сообщений занимается программа /usr/abills/libexec/ureports_sender.pl, доступны следующие опции.
DEBUG=0..6 | Режим отладки |
---|---|
TP_IDS= | Список тарифных планов для обработки. Номера тарифных планов разделяются запятыми без пробелов |
LOGIN= | Список логинов для отправки сообщений. Разделяются запятыми |
DATE= | Установка даты формирования отчётов. Используется если есть необходимость сформировать отчёт за определённое число |
help | Помощь |
Данные программы следует поместить в /etc/crontab с параметрами времени рассылки.
Пример: рассылать сообщения каждый день в 10 утра
1 10 * * * root /usr/abills/libexec/ureports_sender.pl
Шаблоны сообщений
Общие шаблоны
ureports_email_message.tpl - шаблон E-mail сообщения
ureports_sms_message.tpl - шаблон SMS сообщения
Индивидуальные шаблоны отчётов (для изменения стандартного представления)
ureports_reports_1.tpl - шаблон для отчёта 1
ureports_reports_%NUM%.tpl - шаблон для отчёта %NUM%
Правка и список шаблонов отчётов находится в Настройка>Другое>Шаблоны (Работа с шаблонами системы)
Переменные шаблонов
UID | UID |
---|---|
LOGIN | Логин |
FIO | Фамилия |
CONTRACT_ID | Номер контракта |
CONTRACT_DATE | Дата контракта |
MESSAGE | Сообщение отчёта |
DATE | Текущая дата |
TP_ID | Номер ТП отчёта |
CREDIT | Кредит абонента |
DEPOSIT | Депозит абонента |
EXPIRE_DAYS | Дней до завершения всех услуг |
EXPIRE_DATE | Дата завершения услуг |
RECOMMENDED_PAYMENT | Рекомендованная сумма оплат |
TOTAL_FEES_SUM | Сумма всех месячных начислений |
TP_MONTH_FEE | Месячная абонплата |
MESSAGE | Как стандартное тело отчёта, которое формирует программа отчётов, в некоторых отчётах может не заполняться |
Система плагинов
Добавлена возможность создавать собственный плагины для отчетов. Плагины размещаются в папке modules/Ureports с расширением *.pm
Пример: плагин Report1.pm поздравляет абонентов с днем рождения.