You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

80 lines
5.0 KiB

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