Документация NetAMS

В наборе скриптов управление системой NeTAMS появилось два новых скрипта — управления карточками, и активации карточек пользователем. Владелец (администратор) сети, в которой установлен и работает NeTAMS+модуль биллинга, генерирует базу карточкек эксперсс–оплаты, печатает и реализует их, и использует активацию карточек как средство пополнения баланса абонента в системе биллинга. Активация карточек возможна как оператором системы, так и непосредственно самим абонентом через отдельный скрипт. Возможно также блокировать–разблокировать как отдельные карточки, так и серии карточек, экспортировать номера карточек во внешний файл, проверять годноть и статус карточки, и так далее. Курс преобразования номинала карточки в условные единицы биллинга также управляется из администраторского скрипта.

Каждая карточка имеет десятизначный номер (первые три цифры — номер серии, остальные семь — случайное число), ПИН–код (двадцать случайных чисел в четырех группах по пять чисел, разделенных дефисом), номинал (число от 10 до 10000, задается при создании), время создания, статус (неактивирована, уже активирована, блокирована), время изменения статуса.

Случайные числа, испольованные при генерации номеров — действительно случайные, построенные с использованием системного устройства энтропии вроде /dev/urandom.

Как поставить

Необходимо поставить Netams 3.3.1–release, хотя сам скрипт будет работать и с предыдущими версиями. Необходимо правильно настроить скрипты admintool.cgi, config.cgi из каталога admin/cgi–bin дистрибутива. Фактически, модуль работы с карточками вызывается оттуда и использует чаcть общих функций Admintool и NeTAMS Perl API.

Система управления карточками привязана к MySQL, но легко может быть перенесена на PostgreSQL или Oracle. Она состоит из следующих файлов:

• addon/cardtool_schema.sql — схема базы данных (описание таблицы cards). Вы должны создать эту новую таблицу в вашей базе данных посредством следующей команды:

mysql netams < addon/cardtool_schema.sql

(предполагается, что имя вашей база данных «netams»)

• admin/cardtool.cgi — основной скрипт работы с карточками. В его первых строках указан относительный путь до файла с курсом перерасчета у.е. По умолчанию это «ratefile.txt» в такущем каталоге.

• admin/ratefile.txt — файл содержит одну строку с курсом перерасчета у.е. при пополнении баланса биллинга. Вы ДОЛЖНЫ сами создать этот файл вручную, и присвоить ему права доступа, гарантирующие запись в него из скрипта. Дальнейшие модификации этого файла будут проводиться самим скриптом cardtool.cgi.

• activate.cgi — скрипт активации карточки пользователем. Начало файла содержит ссылку на файл с курсом у.е., а также имя шаблона страницы, которая будет показана пользователью перед активацией (форма с запросом) и после (результат активации).

• activate.tmpl — форма (шаблон) страницы пользователя, проводящего активацию самостоятельно.

В файле config.cgi проверяем наличие:

#enable or disable prepaid card processing services

$have_cards=«yes»;

Все, можно работать. Заходим в Admintool и видим появившийся пункт меню:

Как использовать

Создать новую серию карточек

Необходимо указать номинал карточки, количество карточек, и нажать кнопку «Применить». Номер серии присвоится автоматически (следующий незанятый начиная с 1), и вы увидите что–то вроде:

Просмотреть всю серию

В таблице серий карточек кликнуть на номер серии, появится таблица со сведениями о серии, плюс информация о каждой карточке:

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

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

Получить список карточек

Нажать на кнопку «Экспортировать», во всплывшем окне (оключить блокиратор!) появистся список карточек вместе с номером, кодом и номиналом. Его можно потом скопировать и сохранить в отдельном файле.

Курс перерасчета

В основном окне «Prepaid cards» можно выбрать режим изменения курса перерасчета. Карточки выпускаются с номиналом в рублях, а на баланс абонента средства заносятся путем деления номинала карты на этот курс. Величина курса хранится в текстовом файле admin/ratefile.txt

Активация карты

Администратор/оператор системы может сам активировать карту (по звонку абонента), путем ввода всей информации в верхней части основного окна. Необходимо указать номер, ПИН, имя аккаунта абонента, и нажать кнопку «Применить». Будет произведена проверка, и в открывшемся окне можно или подтвердить операцию, или посмотреть сообщение об ошибке:

Кнопка «Применить» (пополнить счет абонента) появится только в случае, если все нормально.

Операции с картой

По номеру карты можно посмотреть ее статус, а также произвести блокировку и разблокировку:

Операция блокировки обратима, операция активации карты — нет.

Активация карты абонентом