Руководство пользователя

Intro

SMS Notification System ( далее просто SNS) - Платформа для организации SMS рассылки.

Как это работает

Есть компьютер под управлением Linux, к нему подключен телефон по дата-кабелю (irda, BT & etc). На телефон приходит SMS, программа считывает это SMS, считаывается номер отправителя, он ищется в базе, если находится - SMS рассылается всем остальным пользователям из базы.

Настройка (version 0.1)

Настройка сводится к конфигурированию gammu, утановке путей к базе с пользователями.

Настрофка Gammu

Перво наперво прочитайте документацию к этому пакету. Суть то что ниже будет, это краткие выдержки для того что бы понять, будет ли работать ваш телефон или нет.

Для начала создайте конфигурационный файл для программы, открыв в любом текстовом редакторе файл ~/.gammurc:

[gammu]
port = /dev/ttyACM0
connection = at

Эти настройки подходят для того телефона Motorola что был у меня как тестовый, подробности смотрите в документации к Gammu

Настройка путей

Откройте в любом текстовом редакторе файл ~/.sns.conf и пропишите туда примерно следующее:

temp_dir="/tmp"                                                                                                               
data_dir="/home/hatred/Projects/SNS/sns-current/OUT/etc/sns"                                                                  
check_inbox_delay="5"

где:

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

Файл пользотельской базы

Сей файл имеет имя abon.db и лежит в data_dir либо в каталоге с программой, представляет собой обыкновенный текстовый файл, стуктура которого такая:

<телефонный номер>:<ник>:<флаг>:<группа>

где:

  • <телефонный номер> - федеральный телефонный номер, примерно такой: +79242000000, пробелов и других раздилителей быть не должно!
  • <ник> - ник пользователя, пробелы не допускаются
  • <флаг> - тут может быть записано: on - пользователь принимает рассылку, off - пользователь не принимает рассылку, эти поля посредством смс пользователь сам может устанавливать
  • <группа> - группа для пользователя, может быть пустым. для админов должна стоять группа admin

Пример файла:

503:megafon_sms:off:
+79242000000:vasya:on:admin

Как работать с системой

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

Команды

Команды деляться на пользовательский и админские:

  1. Пользовательские:
    • on / off - включает/выключает рассылку смс на номер отправителя
  2. Админские:
    • del <номер> - удаляет пользователя из базы
    • flon / floff - включает/выключает режим защиты от спама/флуда (обработка не реализована)
    • syson / sysoff - запуск/останов системы, пока не реализовано, будучи запушена, система работает всегда

все команды чувствительны к регистру, все команды только маленькими латинскими буквами.


Личные инструменты