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
.envfile found in the project directory -
Run the following commands in the project directory:
chmod +x docker_setup_linux.sh ./docker_setup_linux.shThis 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:
http://usurvey.readthedocs.io/
-
run test as follows:
python manage.py test