Skip to content
No description or website provided.
Branch: uSurvey
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config updated default head Aug 8, 2016
contrib added omitted files Sep 30, 2017
docs Update installation.md Sep 28, 2017
files/answerFiles added some missing files Dec 19, 2017
loaders more test cases and fix for reports service report generation Dec 8, 2017
media/success-stories added some missing files Dec 19, 2017
mics more test cases and fix for reports service report generation Dec 8, 2017
screenshots updated default head Aug 8, 2016
survey added some missing files Dec 19, 2017
.coveragerc changes to test cases Sep 24, 2016
.dockerignore added support for docker Sep 30, 2017
.env added possiblity of adding debug settings in docker deployment Nov 23, 2017
.gitignore adjusted the map settings .env to pick naming convection as per https… Oct 3, 2017
.travis.yml updatd yaml docs Dec 2, 2017
Dockerfile fixed issue with docker not building successfully Dec 28, 2017
LICENSE.txt updated default head Aug 8, 2016
README.md fixed issue with docker not building successfully Dec 28, 2017
administrative_divisions.csv.example updated the README.md file mostly Aug 10, 2016
administrative_divisions_india.csv.example india loc file chanes Nov 13, 2017
docker-compose.yml added ommited django-rq workers for docker Nov 20, 2017
docker_entrypoint.sh added support for docker Sep 30, 2017
docker_setup_linux.sh more test cases and fix for reports service report generation Dec 8, 2017
manage.py updated default head Aug 8, 2016
mkdocs.yml updated uSurvey docs Oct 5, 2016
pip-freeze.txt fixed issue with docker not building successfully Dec 28, 2017
pip-requires.txt fixed issue with docker not building successfully Dec 28, 2017
snap-settings.py changes to test cases Sep 24, 2016
supervisord.conf added support for docker Sep 30, 2017
usurvey-apps.yml added possiblity of adding debug settings in docker deployment Nov 23, 2017

README.md

uSurvey

Build Status Coverage Status

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/.

Quick Start

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/

What next

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

See the uSurvey documentation for further information:

http://usurvey.readthedocs.io/

Testing

  • run test as follows:

    python manage.py test

You can’t perform that action at this time.