Kashana is an open source logframe management tool for planning and evaluating projects, used and written by Aptivate.
- POSIX-compliant system (tested on Linux)
- Python 2.7
- Apache + WSGI (for production)
- Recommended at least 1GB of RAM
sudo apt-get install python-virtualenv nodejs npm python-git python-pip mysql-client libmysqlclient-dev
git clone https://github.com/aptivate/kashana.git
deploy directory, run:
./bootstrap.py ./tasks.py deploy:<environment name>
<environment name> refers to one of the
local_settings.py.* files under
These contain, amongst other things the details for the MySQL database. So to deploy the
you would enter:
This script wants to create a MySql database. DYE's MySql database
manager assumes your MySQL root password is in
/root/mysql_root_password; this task will ask for a sudo password in order
to access this file.
Run local development server with
You'll need to create a superuser to access the Django admin interface at eg http://127.0.0.1:8000/admin/
cd django/website ./manage.py createsuperuser
You'll need to create a Log frame (eg http://127.0.0.1:8000/admin/logframe/logframe/add/).
You'll need to add some entries to the (RAG) Ratings table. A bug prevents these being created in the admin interface but you can update the table with MySQL:
cd django/website ./manage.py dbshell mysql> INSERT INTO logframe_rating (name, color, log_frame_id) VALUES('On track','green',1);
1is the ID of your logframe
You can rate results and indicators
You can add Risk ratings through the admin interface (eg http://127.0.0.1:8000/admin/logframe/riskrating/add/). These have a name like
For setting the reporting intervals, add Milestones for your LogFrame (eg http://127.0.0.1:8000/admin/logframe/milestone/add/).
These have a name eg
Baseline, Y1, Y2, Y3or
2019and a date.
You are not tied to years - you can specify any kind of time period. Now you can add targets for Indicators.
Now you can add Results via the dashboard. (e.g. http://127.0.0.1:8000/dashboard/) The first couple of levels of the results hierarchy have only one entry. These are usually:
The next two levels can have many items:
- Sub-output level
If you expand the tree beyond this level, you're adding Activities.
You can add TA (Technical Assistance) Types (e.g. http://127.0.0.1:8000/admin/logframe/tatype/add/) and Activity Status codes (e.g. http://127.0.0.1:8000/admin/logframe/statuscode/add/)
We have created deployment scripts using fabric to make it possible to deploy to a remote server with ssh access.
You will need to add a named entry to
production for an example)
You will need a settings file with the same name, for example
and a config file under the apache directory (see
Then under the deploy directory you would do:
./fab.py production deploy
production with the name you specified previously
All URLS except creation are
URLS for creation are
Actions determined by request type:
PUT = update DELETE = delete POST = create
The code to get the logframe exists in
logframe.views.OverviewMixin. It's a method called
The code for the backend that does the work on the logframe lives under
If you are using recent Ubuntu, then install npm which will also install nodejs. Because of a name conflict with another package it will be named nodejs instead of node, so you will have to create a symlink yourself (assuming you don't have amateur radio node package installed):
sudo ln -s /usr/bin/nodejs /usr/local/bin/node
We'll need phantomjs to run tests:
sudo npm install -g phantomjs sudo npm install -g grunt
This will install all the necessary packages including Gulp which we use for defining and running tasks. Currently following tasks are defined (and at least somewhat useful):
grunt test (runs tests) grunt jshint (checks code with JSHint) grunt templates (compiles templates to src/lib/templates.js) grunt watch (runs JSHint and compiles templates when either change)
- A multi-stakeholder and multi-organisation team operates in dozens or hundreds of villages and urban areas across Zambia. They need Android-based support to coordinate their work. They are assessing well-being, using ODK or similar on their tablets / phones. They may also be coordinating the delivery of some services -- perhaps health education, for example. They may be helping people to fill out forms to apply for various types of aid, or to register for different relations with the government bureaucracies. They need to have a well-being assessment tool that tracks the impact of their work and the work of the other development agencies in the area. How do they coordinate their activities? How do they collaborate? How are their documents hosted? Could Kashana be all or part of the solution?
- Let us imagine that an organisation gets a grant to work with us and their Ghanaian chapter. They would like to provide an inexpensive tool for coordinating the work of their Ghanian chapter via mobile phone or very inexpensive tablet. They also need to show their donors / funders that their work in promoting local participation in Ghana is improving local life outcomes. If Kashana is to help, it needs to provide a way of assessing life impacts (or tracking life impact assessments) as well as coordinating local activities (tasks, calendar, etc. for local teams and a coordinating group).
- We have a financial tracking system called CASH. The people using CASH want to know how money will be divided up between the different elements of the logframe, and also between the different people who are responsible for spending the money. They are only slightly concerned about tracking impacts within CASH -- as long as the money gets spent and they know what they have to do in order to effectively use their whole budget, they are happy.
- Various triple-bottom-line companies want to keep track of key performance indicators (outputs) as well as the social and environmental impacts of their work (outcomes), in a way that integrates with their daily work. Kashana might give those small and medium-size ethical businesses a way to manage their workflows and their policies at the same time as tracking impact, in a way that makes it easy to learn and steer. Having a simple way to connect the outputs (what the business is selling) to impacts (of various kinds) within a shared collaboration-support environment (Kashana, the intranet) can let those businesses see what's going on with a minimum of switching back and forth between a dozen different applications or interfaces. Also, it can reduce the need to enter data multiple times.