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
Update the database entries in
.envfile 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:
You'll need to load the administrative divisions data for your country setup.
See the uSurvey documentation for further information:
run test as follows:
python manage.py test