Planning Poker is a web platform allowing users to perform scrum task time estimation votings, organized in virtual rooms. Its back-end is powered by Django framework. After registration, the user gets access to a customized django admin panel where they can manage their rooms and participants, who gain access by personalized URLs.
The voting data is transferred between clients using websockets (socket.io). Application's front-end is based on Twitter Bootstrap and a custom Angular.js engine.
Planning Poker offers JIRA integration simplifying the process of fetching lists of tasks from current JIRA sprint.
You can create a fully-featured demo room without registration here: http://planningpoker.prktk.pl/demo/
In case you want to check out the full expirience, you might register an admin account by visiting: http://planningpoker.prktk.pl/register/ - credentials achieved by signing up may be used to login into the administration interface available at the url: http://planningpoker.prktk.pl/admin/.
Note: all user created data on our test instance is wiped out once a day, at 12am GMT+2.
In order to run your own instance of planning poker:
- Clone the repo:
git clone https://github.com/praktikdev/planning-poker.git
- Create virtualenv:
virtualenv env
- Activate it:
. env/bin/activate
- cd the app directory:
cd planning-poker
- Install requirements:
pip install -r requirements.txt
- Create your copy of
local_settings.py
and fill it:
cp poker/local_settings.py.dist poker/local_settings.py && vim poker/local_settings.py
- Create your copy of
constants.js
:
cp app/static/scripts/constants.js.dist app/static/scripts/constants.js
- Migrate the database:
python manage.py migrate
- Create your user account:
python manage.py createsuperuser
- Run http and websocket servers:
python manage.py runserver &
python runserver.py &
- Navigate over to http://localhost:8000/admin to create your first planning poker room!
This project is licensed under the terms of the MIT license.
Fork the project, create a feature branch, and send us a pull request.