Content
View differences
Updated by Jens Ulferts 5 months ago
**As** a user following agile methodologies
**I want to** have sprint objects connected to work packages
**so that** I can group work packages by sprints in which they are worked on
**Acceptance criteria**
* The feature is hidden behind a feature flag
* Unless it is used by the existing Backlogs module
* Sprints exist in OpenProject. They have
* a name (plain text)
* a start and a finish date (dates)
* a goal (plain text)
* a status
* \[Open\] will this status have fixed values or can the user administrate (add/remove/order)?
* a capacity
* story points or days
* \[open\] will we support both from the start?
* a number of projects they are shared with
* \[Open\] Should the same options be used as for versions?
* Work packages can be connected to multiple sprints.
* The sprint property can be administrated in the form configuration.
* The property can be used to filter, sort and group in the work package list.
* The property is journaled.
* \[Open\] it might be sufficient to connect a work package to a single sprint. My \[Jens\] understanding is, that a user should be able to see which sprints a work package has been assigned to in its history. We can get that information from the journals. It will already be displayed in the activity but we could also show it differently, e.g. in a hover card over the current sprint value.
* If a work package can be connected to multiple sprints, the position within each need to be kept independently. There is currently a "position" field added to work packages by backlogs.
* Sprints are exposed via an API.
* Sprints are part of the work package API (resource, form, schema including available values)
* \[open\] is there a list of sprints (filterable by project)?
* This would be necessary for the mobile app
* \[open\] Can sprints be created, updated and deleted via the API?
* Versions are no longer used by the existing Backlogs module. Sprints are used instead.
* Only This will only be necessary if the left hand part of the backlogs main view will use sprints. Backlogs (currently displayed to the right) will continue to use versions (subject to change later). module is continued and not replaced by a new agile module
* Existing versions used as sprints are migrated.
* The goal is to have an uninterrupted user experience when switching from the pre-sprint state to the post-sprint state.
* A version is migrated if
* the version is configured to \[open\] Can sprints be displayed "left" (for "Column in backlog") in at least one project
* the version has at least one work package associated to it in a project in which the version is configured to be displayed "left"
* The existing connection from a work package to a version is kept
* Work packages associated to a migrated version are associated to the created sprint.
* The button reading "+ Version" is changed to "+ Sprint" and opens the sprint creation form.
* The "Properties" menu entry in the sprint menu will lead to the sprint edit form.
* The "Wiki" menu entry from the sprint menu is removed
* The "Stories/Tasks" menu will lead to the work package list filtered by the sprint.
* The version form no longer has the "Column in backlogs" select field. Instead a "Used shared same as backlog" checkbox is displayed.
versions currently can (e.g. hierarchy or whole instance).
* The limitation on the work package type (which type qualifies as a user story, which one is a task) remains unchanged.
* The task board will \[open\] How can sprints be using the sprint
* The burndown chart (if it still exists) will be using the sprint
administrated?
**Technical notes**
* <br>
**Permissions and visibility considerations**
* _To whom is this feature visible?_
* _When is it not visible?_
**Translation considerations**
* _Key terms and phrases in the key languages_
**Out of scope**
* Having a sprint board (for now)
**I want to** have sprint objects connected to work packages
**so that** I can group work packages by sprints in which they are worked on
**Acceptance criteria**
*
* Unless it is used by the existing Backlogs module
*
* a name (plain text)
* a start and a finish date (dates)
* a goal (plain text)
* a status
* \[Open\] will this status have fixed values or can the user administrate (add/remove/order)?
* a capacity
* story points or days
* \[open\] will we support both from the start?
* \[Open\] Should the same options be used as for versions?
* Work packages can be connected to multiple sprints.
* The sprint property can be administrated in the form configuration.
* The property can be used to filter, sort and group in the work package list.
* \[Open\] it might be sufficient to connect a work package to a single sprint. My \[Jens\] understanding is, that a user should be able to see which sprints a work package has been assigned to in its history. We can get that information from the journals. It will already be displayed in the activity but we could also show it differently, e.g. in a hover card over the current sprint value.
* If a work package can be connected to multiple sprints, the position within each need to be kept independently. There is currently a "position" field added to work packages by backlogs.
* Sprints are exposed via an API.
* \[open\] is there a list of sprints (filterable by project)?
* This would be necessary for the mobile app
* \[open\] Can sprints be created, updated and deleted via the API?
* Versions are no longer used by the existing Backlogs module. Sprints are used instead.
* Only
* Existing versions used as sprints are migrated.
* A version is migrated if
* the version is configured to
* the version has at least one work package associated to it in a project in which the version is configured to be displayed "left"
* The existing connection from a work package to a version is kept
* Work packages associated to a migrated version are associated to the created sprint.
* The button reading "+ Version" is changed to "+ Sprint" and opens the sprint creation form.
* The "Properties" menu entry in the sprint menu will lead to the sprint edit form.
* The "Wiki" menu entry from the sprint menu is removed
* The "Stories/Tasks" menu will lead to the work package list filtered by the sprint.
* The version form no longer has the "Column in backlogs" select field. Instead a "Used
* The task board will
* The burndown chart (if it still exists) will be using the sprint
* <br>
**Permissions and visibility considerations**
* _To whom is this feature visible?_
* _When is it not visible?_
**Translation considerations**
* _Key terms and phrases in the key languages_
**Out of scope**
* Having a sprint board (for now)