uSurvey is an innovative data collection tool designed to provide statistically representative real time estimates of a given indicator. It runs on USSD (Unstructured Supplementary Service Data) interactive secured channel and on ODK (Open Data Kit), for off-line data collection in locations with intermittent mobile network connections.

The system has been designed to collect a wide range of data for the structured survey; to generate and produce descriptive statistics and graphical representation of the collected information whenever desired, as well as during the process of data collection.

Official documentation is available on http://usurvey.readthedocs.io/.

The easiest way to be up and running with uSurvey is to use the docker setup.

• Clone the uSurvey Application from Github

    git clone https://github.com/unicefuganda/uSurvey.git
  

• Enter the project directory

    cd uSurvey
  

• Update the database entries in .env file found in the project directory

• Run the following commands in the project directory:

    chmod +x docker_setup_linux.sh
  
    ./docker_setup_linux.sh
  

  This step performs the following activities:

    1. Creates path where database files are stored on host machine
    2. Loads the necessary Permissions categories.
    3. Creates a super user to enable you login to uSurvey (requires you to supply login credentials)
    4. Attempts to setup up the map for your country
  

• Once done, enter the following address on your browser to be sure uSurvey is properly setup:

  http://localhost:8071/

You'll need to load the administrative divisions data for your country setup.

See the uSurvey documentation for further information:

http://usurvey.readthedocs.io/

• run test as follows:

  python manage.py test