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