---
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** - запуск/останов системы, пока не реализовано, будучи запушена, система работает всегда

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