Простой биллинг с веб интерфейсом – Easyhotspot

Биллинг в системе хотспота, как и было сказано в заметке «Хотспот и с чем его едят…«, это и есть та самая программа, с которой непосредственно осуществляется управление всей системой. Его задачей является создание учетных записей для клиентов, а также получение от сервера учета данных об их использовании. Фактически, Easyhotspot является одним из наиболее простых и понятных программных продуктов, предназначенных для управления не только хотспотом, но также и ЛЮБОЙ системой доступа в интернет, использующей FreeRADIUS в качестве сервера Авторизации/Аутентификации/Аккаунтинга (ААА).

Управление услугой предоставления доступа в интернет в программе Easyhotspot осуществляется путем формирования учетных записей клиентов в базе сервера FreeRADIUS. При этом клиенту могут быть назначены самые различные лимиты – время (ограничивается максимальная длительность всех его сеаснов), объем траффика (клиент отключается после того, как получил определенное количество мегабайт), скорости (ограничивается скорость, с которой клиент получает и передает информацию в интернет), срок действия аккаунта (даже при неиспрасходованных лимитах времени или объема через указанный срок клиенту будет отказано в доступе в интернет).

Easyhotspot является веб приложением, написанным на языке PHP. Благодаря этому, управление программой выглядит как просмотр обычных вебстраниц, и возможно из любого браузера, запущенного на компьютере под управлением любой ОС. В зависимости от настроек, возможно либо предоставить, либо запретить доступ к программе для компьютеров как локальной, так и глобальной сети (иными словами, при желании вашим хотспотом, находящимся на работе, вы сможете управлять, находясь дома или даже «на море»!)…

Функциональные обязанности в программе разделены для двух должностей – Кассира и Администратора. Кассир выполняет обычную рутину, реализуя клиентам ваучеры или выписывая счета. А Администратор назначает тарифы, контроллирует реализацию ваучеров и инкассирует кассира.

Программа Easyhotspot является биллингом, или же, говоря иными словами, средством учета потребления услуг, которые возможно стоят денег (ведь хотспот не обязательно дожен быть бесплатным). Данная программа позволяет ОДНОВРЕМЕННО использовать два различных метода предоставления услуги доступа в интернет. Если использовать терминологию, применяемую операторами мобильной связи, то варианты эти назывались бы Postpaid и Prepaid.

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

• Администратор назначает тарифы для оплаты по счетам (сколько стоит каждая минута подключения, и сколько стоит каждый Мегабайт переденной информации). Обращаю внимание на то, что эти тарифы не имеют абсолютно никакого отношения к  ценообразованию для второго метода (ваучеров).

• Кассир создает учетную запись пользователя, самостоятельно назначает ему логин, пароль и тип учета. При необходимости устанавливает лимиты скорости и меняет число одновременных логинов. После этого кассир распечатывает клиенту талон, на котором указаны параметры для доступа в интернет (логин и пароль).
• Клиент начинает пользоваться услугой. На протяжении установленного учетного периода программа хотспота подсчитывает объем потребленной клиентом услуги. В зависимости от выбранного типа учета суммируется либо время, проведенное клиентом в интернете, либо объем полученной им информации.
• По истечении учетного периода кассир формирует счет клиенту. Сумма счета определяется простым умножением тарифа, указанного Администратором на объем услуги, потребленный клиентом. Кассир во избежание финансовых злоупотреблений не может просто удалить учетню запись клиента. Кроме того, по тем же причинам Кассир не может удалить сформированный счет.
• В момент формирования счета учетная запись клиента (логин и пароль) автоматически удалается, и клиент белее не сможет получить доступ в интернет.
• После того, как клиент оплатит счет, Администратор может удалить его из базы программы.

Второй метод учета (Prepaid) предназначен для предоставления разовых предоплаченных услуг. Иными словами, клиент сначала приобретает у кассира ваучер (талон) определенного номинала (в котором указаны логин и пароль), и лишь потом получает доступ в интернет. Номинал ваучера (талона) гарантирует клиенту предоставление определенного объема услуги доступа в интернет. Учет потребленной услуги возможен как по времени подключения, так и по объему израсходованного трафика. Иными словами,  клиент автоматически будет отключен от хотспота после того, как либо время, которое он был подключен к интернету (в минутах), либо объем переденой и полученной им информации (в Мегабайтах) превысили указанный лимит (номинал ваучера). Ваучер также может иметь ограничения скорости. Кроме того, у ваучера фиксирован лимит одновременных логинов – только один клиент сможет подключиться в интернет с указанными логином и паролем. Второму клиенту, использовавшему эти же учетные данные в доступе будет отказано. И напоследок, у ваучера есть срок годности (указывается Администратором). По его истечени клиент не сможет подключиться к хотспоту даже если он не израсходовал лимиты времени или мегабайт. Отсчет срока годности ведется от момента первого подключения клиента к хотспоту. Типичным примером использования данного варианта учета может служить хотспот в кафе.

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

При таком методе предоставлении услуги доступа в интернет роли пользователей программы распределены следующим образом:

• Администратор создает Тарифные пакеты. Их число ничем не ограничено, и определяется лишь потребностями хотспота. Например, можно создавать тарифные пакеты на разную длительность работы в интернете. Или, допустим, на одно и то же время доступа, но с различной скоростью. Также, Администратор абслютно свободен в вопросах ценообразования.

• На основании имеющихся (созданных Администратором) Тарифных пакетов Кассир генерирует и распечатывает ваучеры, и затем продает их (или же раздает даром, если указана нулевая цена) Клиентам.
• Клиент начинает пользоваться услугой. В момент первого подключения к хотспоту система начинает отсчет срока годности ваучера. Программа хотспота подсчитывает объем потребленной клиентом услуги. По истечению лимита, указанного как номинал ваучера, клиент будет отключен от интернета автоматически.
• Все ваучеры, использование которых клиентами было начато, попадают в отчет для инкассации.  То есть, если ваучеры были просто распечатаны и лежат у кассира, они не попадают в отчет. Но как только логин и пароль ваучера были хоть раз были введены в систему для получения доступа в интернет, программа считает такой ваучер как проданный. Как следствие, такой ваучер попадает в отчет для инкассации. Отчет подсчитывает общее число проданных ваучеров для каждого из Тарифных пакетов и, с учетом их цены, выводит итоговую сумму, подлежащую инкассации (иными словами, выручку Кассира от продажи ваучеров).
• После того, как Кассир оплачивает Администратору сумму, подлежащую инкассации за проданные ваучеры, Администратор помечает попавшие в отчет ваучеры, как инкассированные. В дальнейшем, при формировании нового отчета для инкассации, ваучеры, инкассированные ранее, уже не попадут в него.
• После инкассации Администратор может также запустить команду, которая удалит из базы хотспота все инкассированные ваучеры, лимит которых был израсходован.

Более подробно работа в программе Easyhotspot рассмотрена на этой странице, или же в данном руководстве.

Ввиду своей простоты программа является идеальны решением для организации услуги предоставления доступа в Интернет в публичных местах (Гостиницы, Библиотеки, Аэропорты, Вокзалы и т.д.) – т. н. «Hot Spot».

На сайте автора программы (Rafeequl Rahman Awan) доступны к бесплатному скачиванию два варианта – образ LiveCD со всеми компонентами, необходимыми для организации хотспота, либо само веб-приложение Easyhotspot. Это нерусифицированная исходная версия программы, не имеющая целого ряда доработок, перечисленных ниже.

Во первых, мной был выполнен перевод интерфейса программы на русский язык.

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

• Исправлена ошибка в установке скорости 64 кбит (возможно, что у автора там  коде была банальная опечатка).

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

• Для данных о времени и трафике в обоих отчетах (и по счетам, и по ваучерам) включено округление значений как времени, так и трафика до целых чисел, чтобы не выводились дроби.

• У кассира убрана кнопка для удаления выписанных ваучеров – с целью исключить возможные злоупотребления (т.е. – продать ваучер, после его использования запись о нем из базы удалить, а деньги положить себе в карман). ПРИМЕЧАНИЕ: см. обновление от 25.06.2010 ниже – наличие или отсутствие кнопки удаления теперь определяется параметром «доверие кассиру», задаваемым при установке.

• Чтобы база не хранила все израсходованные ваучеры, их все таки нужно удалять. Но, так как касир их удалять теперь не может, то удаление израсходованных ваучеров перенесено в меню администратора. При этом, удаление сразу всех израсходованных ваучеров выполняется автоматически, нажатием одной кнопки.

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

• Изменена процедура генерации новых ваучеров. Теперь сразу же после их создания автоматически выполняется вывод ваучеров на печать. При этом, в отличие от авторской версии программы, ваучеры группируются по 9 штук на листе.

• У кассира убрана кнопка для удаления записей о клиентах с оплатой по счету. Также с целью исключить возможные злоупотребления (т.е. – создать учетную запись, продать клиенту данные для доступа в интернет, после использования данную запись из базы удалить, а деньги положить себе в карман). ПРИМЕЧАНИЕ: см. обновление от 25.06.2010 ниже – наличие или отсутствие кнопки удаления теперь определяется параметром «доверие кассиру», задаваемым при установке.

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

• Исправлена ошибка формирования счета для клиента, который не пользовался услугой. Вместо «белого экрана» выводится сообщение о невозможности выписать счет.

• Добавлен вывод сообщения при создании клиента с оплатой по счету с логином, у которого уже есть неоплаченый счет.
• Добавлен вывод сообщения о попытке создании клиента с логином, уже имеющимся в базе.

• Клиентам с оплатой по счету введен лимит одновременных логинов.

• Добавлен логотип в печатаемые ваучеры, счета и пр.

• Добавлен лимит «срока годности» ваучера (сутки, двое, трое – настраивается). Доступ в интернет по «просроченному» ваучеру не предоставляется, даже если его лимит не был израсходован полностью.
• В форме смены пароля для кассира теперь автоматически подставляется его логин, и ввод какого-либо иного значения для данного поля запрещен. До этого кассир имел возможность сменить пароль любього администратора, если в своей форме вводил его учетные данные.

• Из авторской версии 02 вставлена страница про «онлайн» пользователей.
• Добавлены всплывающие подсказки.

Обновление от 28 мая 2010 г.

• Создан инсталлятор, значительно упрощающий процедуру установки. Причем, его задача не просто поставить саму программу Easyhotspot, а установить и настроить все службы, требующиеся для работы сервера хотспота. В данном руководстве (PDF, 2,9 Мб) полностью описан весь процесс установки с помощью указанного инсталлятора. Как видно из приведенного документа, чтобы установить и настроить хотспот не нужны большие опыт и познания в работе с линуксом.

Обновление от 15 июня 2010 г.

• «Срок годности» ваучеров из фиксированного значения, единого для всей системы, преобразован в индивидуальный параметр для каждого Тарифного пакета. Иными словами, создавая новый Тарифный пакет, вы сами указываете, каков будет срок годности ваучеров, созданных на основе данного тарифа.
• Клиентам, оплачивающим услугу по счетам, добавлена возможность ограничения скорости обмена информацией с интернетом.

Обновление от 25 июня 2010 г.

• В инсталятор добавлен вопрос о «доверии кассиру». Ответ не него управляет соответствующим параметром программы, который определяет – останутся ли в программе кнопки для удаления ваучеров, аккаунтов и счетов, доступные именно кассиру (администратору они доступны всегда). Если ваш хотспот предполагает «двухуровневое» управление – то есть кассир и администратор – это разные люди, и администратор не доверяет кассиру, то указанные кнопки лучше скрыть. Благодаря этому кассир не сможет удалить выписанные ваучеры, аккаунты и счета, а полученные за них деньги присвоить. Их (ваучеры, аккаунты и счета) сможет удалить только администратор. Если же хотспотом управляет один и тот же человек (как в качестве кассира, так и в качестве администратора), то каждый раз ему переключаться с кассира на администратора и наоборот будет не удобно. В таком случае указанные кнопки лучше не скрывать, и ваучеры, аккаунты и счета можно будет удалять непосредственно в меню кассира.

Обновление от 29.06.2010 г.

• Изменен дизайн страницы авторизации. Во первых, она теперь многоязычная – по ответу браузера клиента определяется язык, используемый им в системе, и страница авторизациии выводится на соответствующем языке. Поддерживаются следующие языки – английский, французский, немецкий, испанский, русский. Для компьютеров с украинским языком выводится страница авторизации на русском. Во вторых,  На страницу добавлена графика – есть «основная» картинка фиксированного размера, и картинка фонового рисунка, заполняющего остальное поле. Внешний вид нового окна авторизации можно посмотреть по этой ссылке.

Обновления от 14.07.2010 г.

• Исправлена ошибка подсчета выручки каcсира.
• Исправлена ошибка, возникавшая в случае формирования счета клиенту, который в этот момент продолжал пользоваться интернетом. Теперь сеанс доступа клиента в интернет сначала принудительно прекращается, а потом уже ему выписывается счет.
• Косметические изменения во всплывающих сообщениях.

Обновление от 16.08.2010 г.

• На странице авторизации переведены сообщения о причинах отказа в авторизации (превышении лимитов времени, трафика, одновременных логинов). Ранее они выводились только на английском языке, теперь – на языке, используемом в системе клиента (английском, французском, немецком, испанском, русском – в соответствии с ответом браузера клиента).

Увидеть результат (попробовать поработать в программе Easyhotspot) можно на моем сайте, если перейти по этой ссылке. Чтобы войти в программу как Администратор, Вам потребуется ввести логин admin и пароль admin123. Чтобы поработать в роли Кассира, нужно ввести логин vcool, и пароль vcool123. Полную подробную инструкцию по работе с программой можно прочесть и скачать по данной ссылке.

Мной составлено подробное руководство по установке и настройке хотспота с использованием программ и служб Easyhotspot, FreeRADIUS, MySQL, Apache, установленных на компьютере, работающем под управлением ОС Linux Ubuntu 9.04. Содержание руководства можно просмотреть по ссылке. Данное руководство плюс модифицированная и русифицированная версия программы предлагаются к продаже по цене 300 Грн. Программа поставляется в виде скрипта-инсталлятора, который полностью устанавливает и настраивает весь хотспот – контроллер доступа Chillispot, сервер авторизации RADIUS, необходимые для работы программы сервер баз данных MySQL и веб сервер Apache, ну и собственно сам программу Easyhotspot. Работа скрипта исталлятора описана в руководстве по быстрой установке, которое можно скачать по этой ссылке.  Дополнительные детали – по почте.

Дополнительно, предостваляется услуга дистанционной установки программ хотспота на ваш подготовленный компьютер. Детали о том, что нужно подготовить – в этом руководстве. Стоимость услуги – 100 грн.

Отзывы можно почитать тут.

У вас остались вопросы, на которые вы не нашли ответа? Загляните на страницу FAQ. И этого недостаточно? Напишите мне письмо с вашими вопросами…

Дополнительные ссылки:

Все мои заметки о хотспотах