taarifa/TaarifaWaterpoints

Waterpoint management system for Tanzania Taarifa Waterpoints =================== .. contents:: Table of Contents Background Waterpoints Prequisites Linux Windows Installation Installation using a virtual machine Usage Deployment to Heroku Contribute Background ========== Taarifa_ is an open source platform for the crowd sourced reporting and triaging of infrastructure related issues. Think of it as a bug tracker for the real world which helps to engage citizens with their local government. The Taarifa platform is built around the `Taarifa API`_, a RESTful service offering that clients can interact with to create and triage 'bugreports' relating to public infrastructure (e.g., the public toilet is broken). For information on how to get inovoled, scroll to the Contributing section at the bottom of the page. Waterpoints =========== This repository contains an example application around Waterpoint Management built on top of the core API. It contains scripts to import Waterpoint data (resources) which then become available through the API to file requests against (e.g., waterpoint 2345 is broken and needs fixing). There is also an angularjs_ web application that illustrates how a user can interact with the API and data through a browser. Prerequisites ============= .. note:: You may choose to install into a virtual machine as described further down. Taarifa requires Python_, pip_, nodejs_, npm_ and MongoDB_ to be available on the system. .. note:: pip_ >= 1.5 is required. if you have an older version you can upgrade (may require ``sudo``) with :: pip install -U pip Linux ----- If you are running Ubuntu you can simply execute the `install.sh` script :: ./install.sh Some of the commands are executed with sudo and require sudo permission for the currently logged in user. On other distributions, use the package manager to install the packages corresponding to those listed in `install.sh`. Windows ------- Windows can be used as the platform to run Taarifa - the main caveat here however is t …