linuxdv-static/projects/sns/readme/index.markdown

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

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

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

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

Команды

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

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

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