Документация NetAMS - [28]

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

Необходимо поставить 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

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

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

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

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

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

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

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

Вам бедет необходимо исправить шаблонный файл cgi–bin/activate.tmpl, поместим в него макет страницы, которую должен видеть пользватель. Шаблон состоит из двух половинок (код HTML), разделенных строкой ########. Верхняя часть содержит форму активации, нижняя — информацию об операции.

Пользователью необходимо предоставить ссылку на скрипт cgi–bin/activate.cgi

В шаблоне по умолчанию присутствует следующая таблица:

После выполнения операции абонент получает одно из следующих сообщений:

Управление базой данных

Можно настроить автоматическую или ручную очистку быстрорастущих таблиц raw и monitor при помощи этих нехитрых SQL–команд:

delete from raw \

where t_to < unix_timestamp(date_add(now(), interval–6 MONTH));

delete from monitor \

where time < unix_timestamp(date_add(now(), interval–6 MONTH));

При этом удаляются записи, которым более полугода.

Надо отметить, что таблица summary растет достаточно медленно, и при нынешних ценах на дисковую память можно не особо беспокоиться.

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

• Поставить в сервер два жестких диска, и организовать аппаратный или программный RAID. Это не спасет, если упадет ОС (придется тратить время на переустановку), разрушится или случайно сотрется содержимое файловой системы или кто–то грохнет базу, или сервер украдут;

• Организовать автоматическое резервное копирование базы через mysqldump/mysqlhotcopy, на соседний сервер или удаленный компьютер;

• Средствами NeTAMS писать одновременно в два хранилища: