/scrum-poker-planning

:black_joker: A team friendly and realtime Scrum poker planning web app based on WebSockets and Spring framework.

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

codecov Build Status Maintainability

scrum-poker-planning

⚠️ Sorry, this application is not available any more on Heroku.

Starting November 28, 2022, free Heroku Dynos, free Heroku Postgres, and free Heroku Data for Redis® plans will no longer be available. Only with a paid account, the URL will still work after November 28th.

Scrum Poker application

Vote your stories instantly & get the result in a blink!

Scrum Poker is a powerful tool to make faster and more accurate estimations and most important of all, no developer influences his team mates!

This app can be used in scrum poker planning sessions anywhere. It includes the numbered cards along with Pass, break and ? cards. 3 types of cards set can be selected when creating a voting session.

How to run locally

Prerequisites

Build and Run

1- Use docker compose to build a docker image and run the app in a container

docker-compose up

2- Open your preferred browser and go to localhost:28080

How to use this app

1- In login page, click on New Session button to configure a new Poker planning session

2- Configure your new Poker planning session

  • select you voting cards type
    • Time: to estimate time in hours, days ...
    • Fibonacci: to estimate your stories based on story points using Fibonacci sequence numbers
    • Modified Fibonacci: to estimate your stories based on story points Modified Fibonacci sequence numbers
  • [Optional] configure a suffix to your stories names. For example, if you set the value of this field to jira-, all the stories that will be created next well be named jira-xxx.
  • [Optional] select a card theme. It makes the voting funnier!
  • [Optional] If you already know your stories ids or names before starting the voting session, you can enter them in the text area. Don't forget to click on Convert to stories button to generate the stories.

Configuration dashboard

3- After finishing the configuration, you can click on save & start button to start the new session. You'll be asked to enter your name that will be displayed during the voting session.

4- You should be redirected to the Poker planning session dashboard where your team members can cast their votes. In order to let them join your new session, you should send them the session Id.

Share the current session id

5- If you have not already created stories in configuration step, you can add a story name or id by entering a value in the following inputText. A new task will be added into the list with the prefix defined in the configuration step.

Share the current session id

6- Every team member can cast a vote if they click on a story from the list and select a card. Votes can be changed until the voting session has been ended manually by the session admin.

Voting on a Story

7- When everyone has finished voting, the session admin (the user who have created and configured the session) can stop the voting by clicking on End vote button. Results will be revealed to everyone right after that.

Display results

War file generation for Openshift

For all WebSocket connections on OpenShift, you need to use port 8000 (for Secured sessions it would be 8443). you should generate a war file using following command.

mvn clean install -Dconfigure.ws=8000 -Dconfigure.wss=8443

Developed by

  • Hazem Ben Khalfallah
  • Khaireddine Rezgui

Credits

Special thanks to Redbooth team for their creative card set.

Chris Aguilar for his vector playing cards.