Spotter-VM/doc/applications/taarifa.rst

47 lines
1.6 KiB
ReStructuredText

Taarifa Waterpoints
===================
Overview
--------
Taarifa Waterpoints is a mapping application for waterpoint management system for Tanzania. It has frontend written in JavaScript and backed in python. Uses TaarifaAPI as a framefork and MongoDB as a document storage.
Upstream URL: https://github.com/taarifa/TaarifaWaterpoints
API URL: https://github.com/taarifa/TaarifaAPI
Fork URL: https://github.com/trendspotter/TaarifaWaterpoints - the fork contains fixes for python3 compatibility and ready-to-use release package with frontent build using the method below.
Frontend build
--------------
Frontend requires ancient verions of packages to work correctly. Followin sequence produces usable dist directory on Debian 10.
.. code-block:: bash
# Install build packages
apt-get update
apt-get -y install build-essential git libpng-dev xz-utils wget
# Install Node.js 4
wget https://nodejs.org/dist/latest-v4.x/node-v4.9.1-linux-x64.tar.xz
mkdir -p /usr/local/lib/nodejs
tar -xJvf node-v4.9.1-linux-x64.tar.xz -C /usr/local/lib/nodejs
export PATH=/usr/local/lib/nodejs/node-v4.9.1-linux-x64/bin:${PATH}
# Clone Taarifa Waterpoints
git clone https://github.com/taarifa/TaarifaWaterpoints.git /tmp/taarifa
cd /tmp/taarifa
git checkout 7d0c784eb01b811e65c829796c88d9367f8fa5f7
git cherry-pick -n 984a6353f8b50e9f7f643d22e5c77ad0eb352bcb
# Install NPM packages
export HOME=/root
npm install
npm install -g grunt-cli bower
bower install --allow-root
# Hackfix grunt task and build dist
sed -i "s/'bower',//" Gruntfile.js
grunt build