/rootio_telephony

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

rootio_telephony

ABOUT

The rootio_telephony system (RTS) is a mostly internal (not outward facing) application that takes care of interactions between cloud representations of stations and a) the web interface b) telephony and sms.

At the core of RTS is the StationDaemon, one of each of which is spawned upon startup. Each daemon reacts to messages through ZeroMQ sent from a variety of other sources, such as the telephony server or the scheduler. It loads program representations (news, music, talk) upon command, spawns listeners and workers as necessary, coordinates recordings and votes and other program-specific activities.

In addition to the daemons, there is a Plivo & Flask app which handles connections to Freeswitch (telephony, some SMS) and Kannel (SMS). This is relatively "dumb" in that it tries to defer to the Daemon to the degree possible, mostly handling the calls from Plivo, whereas the Daemon makes the xml requests to Plivo.

Finally, the programs themselves are state machines that initiate necessary connections and resources, run segments of programs, and "clean up" after themselves.

This code expects a copy of rootio_web/rootio symbolically linked parallel to telephony.py.

TODO:

Still working out separation of interests between the different components. Should the Daemons be completely isolated from telephony code? Where does a Daemon stop and a program begin? Freeswitch configuration and initiation should be handled automatically. Gateway or SIP system code should be abstracted; for Uganda we are using dedicated DID/DOD lines but in other cases a gsm/sip device like the GOIP would make more sense. SMS utils is specific to the GOIP gsm-sip device, and is a hack.

MAJOR REQUIREMENTS

  • Flask
  • SQLAlchemy
  • Alembic
  • ZeroMQ
  • Plivo (the free/open version)
  • FreeSwitch

Complete list of packages in requirements.txt

DOCUMENTATION

Technical documentation is in the docs folder; see for example:

More general information, design philosophy, and usage information is in the wiki:

LICENSE

Copyright (c) 2013 RootIO.org

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

ACKNOWLEDGEMENTS

  • The Freeswitch project is a large and dangerous beast.
  • Plivo developed a smart and free open engine that could use a little more love.
  • Flask is a great web framework for agile and non-standard web interactions.