Ureports

Модуль является коммерческим

Система оповещения пользователей о состоянии счёта и другим событиям (новостям) системы посредством e-mail (для отправки должен быть настроен локальный MTA), sms (установлен модуль Sms) или факс (через внешние программы) сообщений. 

Для отправки SMS используется модуль Sms.

Возможности

• Подписка на отчёты с аккаунта пользователя

• Лимиты срабатывания сенсоров отчётов, устанавливаются пользователями самостоятельно

• Группирование отчётов в тарифные планы

• Возможность взыскания средств за активизацию тарифного плана

• Тарификация предоставления услуги (месячная абон. плата, плата за отчёт)

• Ведение журнала предоставленных отчётов

• Поддержка модулей расширения отчётов

• Возможность запретить абонентам управлять отчётами

Предоставление отчётов о:

Дополнительные отчеты

Работа

Система рассылает сообщения через программу ureports_sender.pl, кроме сообщения о пополнении, оно отправляется моментально после поступления средств. После отправки сообщения система отмечает отчёт как выполненный и больше не отправляет сообщения по нему. 1 числа месячные отчеты(№ 3, 9, 10, 11, 13, 14) обнуляются и становятся готовыми опять для отправки сообщений. Обнуление происходит дневным переодическим процессом (periodic daily).

Для того, чтоб настроить тарифный план для Ureports необходимо зайти Настройки>Оповещение>Тарифные планы

Нажимаем +

Отправленные отчеты отмечены датой, дата - это дата отправки отчета.

Поиск абонента

Есть возможность найти абонента по следующим полям:

• Адрес получателя – поле для ввода адреса получателя сообщения (например, номер телефона или идентификатор пользователя).
• Статус – выпадающий список, позволяющий выбрать статус абонента (например, "Активно").
• Тарифный план (ID) – поле для ввода или выбора тарифного плана абонента.
• Группа – выпадающий список для выбора группы, к которой принадлежит абонент (например, "Без группы").
• Код ошибки – поле для ввода кода ошибки, если сообщение не было доставлено.
• Ошибка – текстовое поле для ввода информации об ошибке (при наличии).
• Последнее сообщение – текстовое поле для поиска по содержимому последнего отправленного сообщения.

Если данные для поиска были верно заполненны и система нашла абонента, тогда искомые данные будут выведены на экране.

Если данные были введены некорректно или искомых данных нет в базе - на экране будет выведено сообщение

Поиск по последнему сообщению:

Можно вводить текст последнего отправленного сообщения. Если нужно искать только по части сообщения, можно использовать * в начале или конце текста.

Массовое удаление записей и очистка ошибок

В таблице есть возможность выбора нескольких записей с помощью чекбоксов слева. После выбора записей, пользователь может выполнить следующие действия:

1. Удалить записи – кнопка с иконкой "мусорной корзины" позволяет удалить выбранные записи пользователей.
2. Очистить ошибки – кнопка с иконкой "стрелки для сброса" позволяет очистить ошибки для выбранных записей.

Эти функции обеспечивают удобство в массовом управлении записями и ошибками, что упрощает процесс администрирования пользователей и их уведомлений.

Установка

Создать таблицы в базе, скопировать модуль

cd /usr/abills/
mysql -D abills < db/Ureports.sql
cp Ureports.pm  /usr/abills/Abills/mysql/

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

@MODULES = (
          'Ureports'
          );

Настройка

abills/libexec/config.pl

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

• Настройка периодических отчётов
• Заведение сервиса
• Отчёты Ureports

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

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

Данные программы следует поместить в /etc/crontab с параметрами времени рассылки.

Пример: рассылать сообщения каждый день в 10 утра

1   10  *  *  *  root /usr/abills/libexec/ureports_sender.pl

Отправка тестового сообщения

/usr/abills/libexec/ureports_sender.pl LOGIN=xxx DATE='2025-01-29'

Шаблоны сообщений

Общие шаблоны

• ureports_email_message.tpl - шаблон E-mail сообщения

• ureports_sms_message.tpl - шаблон SMS сообщения

Индивидуальные шаблоны отчётов (для изменения стандартного представления)

• ureports_report_1.tpl - шаблон для отчёта 1

• ureports_report_%NUM%.tpl - шаблон для отчёта %NUM%

Кастомные отчеты должны быть в папке templates/ в формате Ureports_ureports_report_%NUM%.tpl

Правка и список шаблонов отчётов находится в Настройка>Другое>Шаблоны (Работа с шаблонами системы) 

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

Также предусмотрены отдельные шаблоны для каждого типа сообщений

Например:

ureports_report_sms_10.tpl
ureports_report_email_10.tpl
ureports_report_push_10.tpl
ureports_report_telegram_10.tpl

если система не может найти отдельный шаблон она использует общий шаблон для отчета

ureports_report_10.tpl

Система плагинов

Добавлена возможность создавать собственный плагины для отчетов. Плагины размещаются в папке modules/Ureports с расширением *.pm

Пример: плагин Report1.pm поздравляет абонентов с днем рождения.