Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
This is the Mwana MNCH RapidSMS project for deployment in Zambia and Malawi. It includes Results160, a tool for delivering DBS test results to health clinic workers, and RemindMi, a birth registration and appointment reminder system for community based agents (such as CHWs and HSAs).
Python JavaScript Other

This branch is 1616 commits ahead of adammck:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
mwana
.gitignore
README.rst

README.rst

mwana

This is the Mwana MNCH RapidSMS project for deployment in Zambia and Malawi. It includes Results160, a tool for delivering DBS test results to health clinic workers, and RemindMi, a birth registration and appointment reminder system for community based agents (such as CHWs and HSAs).

Development Workflow

We are using git-flow to help manage our development process.

Learn how to use git-flow at:
http://jeffkreeftmeijer.com/2010/why-arent-you-using-git-flow/
You can download and install git-flow from:
https://github.com/nvie/gitflow
Learn more about the methodology behind it at:
http://nvie.com/posts/a-successful-git-branching-model/

Developer Setup

Prerequisites:

  • A Linux-based development environment including Python 2.6. Ubuntu 10.04 or later is recommended. At present, Windows-based environments are not actively supported.

  • PostgreSQL and the appropriate Python bindings (psycopg2). In Debian-based distributions, you can install these using apt-get, e.g.:

    sudo apt-get install postgresql python-psycopg2
    
  • Install pip and virtualenv, and make sure virtualenv is up to date, e.g.:

    easy_install pip
    pip install -U virtualenv
    pip install -U virtualenvwrapper
    
  • Install git-flow (see above).

To setup a local development environment, follow these steps:

  1. Clone the code from git, checkout the develop branch, and initialize git-flow:

    git clone git@github.com:mwana/mwana.git
    cd mwana/mwana
    git checkout develop
    git flow init # just accept all the default answers
    
  2. Create a Python virtual environment for this project:

    mkvirtualenv --distribute mwana-dev
    workon mwana-dev
    
  3. Install the project dependencies into the virtual environment:

    ./bootstrap.py
    
  4. Create local settings file and initialize a development database:

    cp localsettings.py.example localsettings.py
    gedit localsettings.py # replace <country> with zambia or malawi in the first line
    createdb mwana_devel
    ./manage.py syncdb
    
  5. In one terminal, start RapidSMS router:

    mkdir logs
    ./manage.py runrouter
    
  6. In another terminal, start the Django development server:

    ./manage.py runserver
    
  7. Open http://localhost:8000 in your web browser and you should see an Installation Successful! screen.

Something went wrong with that request. Please try again.