/backlog-velocity

Console command that calculate the estimates for a sprint.

Primary LanguagePHPApache License 2.0Apache-2.0

Backlog Velocity

Master: Build Status

Project to manage and show estimate for Stories.

Using previous registered Sprint, the application will suggest next Sprint velocities for your team.

Installation

Using Vagrant

  • Install vagrant (at least 1.8.4) and
  • VirtualBox (at least 4.2.16). Then install vagrant plugins using this
    # command :
    vagrant plugin install vagrant-cachier
    vagrant plugin install vagrant-hostmanager
  • Run vagrant up to setup your environment
  • Open your favorite browser to app.dev, and enjoy.

Using Git (Recommended)

Requirements

You must have the following programs installed:

  1. Download the application in the folder <install-folder> using: git clone -b <tag-number> https://github.com/yvoyer/backlog-velocity.git <install-folder>.
  2. Download a composer.phar in your <install-folder>.
  3. Install the project dependencies using php composer.phar install in your <install-folder>.
  4. Copy the configuration file to your own setup cp app/config/parameters.yml.dist app/config/parameters.yml if the file was not created.
  5. Configure the database: ./backlog update

Configurations

By default, the application runs using SQLite. But you can also use any configuration supported by Doctrine.

# SQLite
parameters:
    # Sqlite database (recommended)
    database_path: '%kernel.project_dir%/var/backlog.sqlite' # %kernel.project_dir% is the root of the project

Features

The backlog velocity project is a simple app that will suggest Story point for your teams based on previous Sprint.

See Scrum for more information.

Basic concepts

  • Project: Placeholder for the Sprints, they are identified with a unique name.
  • Person: Any member of your organization that may be assigned to a sprint. Their name must be unique.
  • Team: Represents a group of persons. This is to help you filter your persons when assigning persons to a sprint.
  • Sprint: Represents an iteration of work that lasts a number of days.

Sprints

Sprint have the following workflow that must be respected, since errors will be generated when the rules are not respected.

  • When creating a Sprint, it must be assign to a specific Project. Upon creation, the Sprint is in a "Pending" state. While pending, the sprint may be commited sprint members (Person).
  • When commiting a Sprint member, you will be required to provide the number of days that this person is available for the sprint.
  • When all your team members are commited, you'll be able to start the sprint. Upon starting, the system will suggest you an estimated number of Story point for the sprint. This suggestion may be replace with your own estimate on start.
  • When started, a sprint may not receive new sprint member.
  • When you end the sprint, you'll be required to give the actual story points the team performed. This data will help the system to evaluate next Sprints.

Nice sprinting!!!

Managing your data

The application provides the following tool to manage your data.

CLI tool

You can find the available commands by running php backlog at the root of your folder.

Web interface

The Web application is built using the Symfony framework. The web server may be run using the vagrant tool, or using the Symfony recommendation