**As** an OpenProject user
**I want** to calculate the work package start and end dates based on the duration
**so** that I only have to set the duration.

# **Acceptance criteria:**

Begin of the insertionThe duration feature affects a range of views and modules:

### Work package attributes and date picker

End of the insertion * In the date picker modal there is a Begin of the insertiontextEnd of the insertion Begin of the deletion formEnd of the deletion field `duration`.
* When Begin of the insertionthe user entersEnd of the insertion Begin of the deletion enteringEnd of the deletion a Begin of the insertionduration,End of the insertion Begin of the deletion durationEnd of the deletion the dates are Begin of the insertionderived.
* The contrary is also true: when a user enters dates, the duration is derived.
* More precise scenarios for what is derived/calculated as a result of what input (in which order), are [presented below](https://community.openproject.org/#scenarios).End of the insertion Begin of the deletion derivedEnd of the deletion
* Begin of the deletion **\[open\]**End of the deletion The duration represents the amount of days between the start and the finish date Begin of the insertion(inclusive):End of the insertion Begin of the deletion with the day of the finish date included, e.g:End of the deletion
* Monday to Tuesday: 2 Begin of the insertiondaysEnd of the insertion
* Monday to Monday (same day): 1 Begin of the insertiondayEnd of the insertion
* Begin of the deletion **\[open\]**End of the deletion Once Begin of the insertionconfiguring non-workingEnd of the insertion Begin of the deletion non workingEnd of the deletion days Begin of the insertionisEnd of the insertion Begin of the deletion areEnd of the deletion implemented Begin of the insertion(<mention class="mention" data-id="18416" data-type="work_package" data-text="#18416">#18416</mention>), these non-workingEnd of the insertion Begin of the deletion (#18416),End of the deletion days Begin of the insertionare _skipped_ _over_ andEnd of the insertion Begin of the deletion defined to be non working daysEnd of the deletion do not count Begin of the insertiontowardsEnd of the insertion Begin of the deletion when calculatingEnd of the deletion the Begin of the insertiontotal duration:End of the insertion Begin of the deletion duration or dates based on the duration, e.g:End of the deletion
* Friday to Monday: 2 Begin of the insertiondays _(Saturday and Sunday are skipped over)_
End of the insertion Begin of the deletion
End of the deletion * Begin of the insertion**\[open\]** The userEnd of the insertion Begin of the deletion In the work packages list thereEnd of the deletion is Begin of the insertionable to override configured non-working days per work package;End of the insertion Begin of the deletion a column &quot;duration&quot;. When clicking onEnd of the deletion this Begin of the insertionmeans non-working can be optionally included, in which case they are _not_ skipped and count towardsEnd of the insertion the date Begin of the insertionand duration count.
* **\[open\]** This requires manual scheduling to be checked (to be explored)End of the insertion Begin of the deletion modal with the date picker is opened.End of the deletion
* In all Begin of the insertioncases,End of the insertion Begin of the deletion casesEnd of the deletion the duration is consistent with the start and the finish date. Begin of the insertionUpdating dates will update duration, and updating duration will update dates.
* End of the insertion It Begin of the insertionwillEnd of the insertion Begin of the deletion isEnd of the deletion not Begin of the insertionpossible, for example,End of the insertion Begin of the deletion possibleEnd of the deletion to Begin of the insertionspecifyEnd of the insertion Begin of the deletion createEnd of the deletion a duration of 8 days for a task that starts and finishes Begin of the deletion inEnd of the deletion the same week.
* The Begin of the insertionduration as well as start and due dates can not be configured via the form configuration. They are always present at the same place within theEnd of the insertion Begin of the deletion bar representing aEnd of the deletion work package Begin of the insertionshow page and form.
* Work packages have an empty (not set) default duration.
* Setting start _and_ end dates automatically sets duration.
* Setting only one of the dates does not automatically set duration (unable to derive)
* Setting only of the dates and duration derives the other date.
* **\[open\]** Duration, once set, cannot be removed unless at least one of the dates (start/finish) is also removed; else, duration is derived (as described above)
* Milestone-typed work packages don&#39;t have a duration field. 
* **\[open\]** On the GANNT and Team planner, they represent 1 day.
* The userEnd of the insertion has Begin of the insertionto to be informed when:
* Dates are automatically derived from relations (notably from parents or children),
* **\[open\]** The user must be givenEnd of the insertion a Begin of the insertionwayEnd of the insertion Begin of the deletion width accordingEnd of the deletion to Begin of the insertionview relations (a link to a GANTT view?)
* these automatically derived dates can not be modified, _unless:_
* Manual scheduling is enabled, and thus relations are ignored and
* Configured non-working days maybe optionally included inEnd of the insertion the Begin of the insertioncalculation of totalEnd of the insertion Begin of the deletion work package&#39;sEnd of the deletion duration Begin of the insertionand start/end dates.

### Work package table view

* In the work packages list there isEnd of the insertion Begin of the deletion (if defined) while draggingEnd of the deletion a Begin of the insertioncolumn &quot;duration&quot;. When clicking on this the date modal with the date picker is opened.
* **\[open\]** With the focus on the duration field.
* Filtering by duration is possible
* Sorting by duration is possible

### GANTT chart

* ForEnd of the insertion work Begin of the insertionpackagesEnd of the insertion Begin of the deletion packageEnd of the deletion without Begin of the insertionstart/finishEnd of the insertion Begin of the deletion start and endEnd of the deletion dates Begin of the insertionbut _with_ duration, the width of a &quot;strip&quot; representing such a work package has a width that is relative to its total duration when dragging to the the GANTT chart.
* &quot;Relative&quot; because width dependsEnd of the insertion Begin of the deletion for placementEnd of the deletion on the Begin of the insertionzoom level of the GANTT chart.End of the insertion Begin of the deletion gantt chart and planning boardEnd of the deletion
* Begin of the deletion **\[open\]**End of the deletion If the user modifies Begin of the insertionaEnd of the insertion Begin of the deletion theEnd of the deletion work package via the drag handles on the left/right Begin of the insertionedgesEnd of the insertion Begin of the deletion borderEnd of the deletion of the Begin of the insertionstripsEnd of the insertion Begin of the deletion cards/strips representingEnd of the deletion the Begin of the deletion work packageEnd of the deletion in Gantt Begin of the insertionchart,End of the insertion Begin of the deletion chart/Team planner,End of the deletion both the start/finish date as well as the duration Begin of the insertionareEnd of the insertion Begin of the deletion isEnd of the deletion altered in Begin of the insertionlockstep.

### Team planner

End of the insertion Begin of the deletion lockstep
End of the deletion * Begin of the insertionFor work packages without start/finish dates but _with_ duration, the width of a card thatEnd of the insertion Begin of the deletion Filtering by durationEnd of the deletion is Begin of the insertiondragged onto the team planner (from the left-hand &quot;Add Existing&quot; panel, for example) is relative to the total duration of that work package.
End of the insertion Begin of the deletion possible
End of the deletion * Begin of the insertion&quot;Relative&quot; because width depends on the zoom level/view of the team planner calendar.End of the insertion Begin of the deletion Sorting by duration is possibleEnd of the deletion
* Begin of the insertionIf the user modifies a work package via the drag handles on the left/right edges of the cards on the Team planner, both the start/finish dateEnd of the insertion Begin of the deletion The durationEnd of the deletion as well as Begin of the deletion start and due dates can not be configured viaEnd of the deletion the Begin of the insertiondurationEnd of the insertion Begin of the deletion form configuration. TheyEnd of the deletion are Begin of the insertionaltered in lockstep.End of the insertion Begin of the deletion always present at the same place within the work package show page and form.End of the deletion
* Begin of the insertion**\[open\]** The user is able to modify the view such that non-workin days are not displayed on the team planner.
End of the insertion Begin of the deletion Work packages have an empty (not set) default duration
End of the deletion * Begin of the insertionEven when non-working days are not displayed, they are nevertheless represented (although with much narrower column widths and withoutEnd of the insertion Begin of the deletion Milestone typed work packages don&#39;t haveEnd of the deletion a Begin of the insertionheader). 
* This is especially important because manual scheduling nevertheless allows users to include non-working days into the date andEnd of the insertion duration Begin of the insertioncount.End of the insertion Begin of the deletion fieldEnd of the deletion

# Open

* Visuals for the rework of the dates &amp; duration to be a fixed (not configurable) part of the work package show page and form Begin of the insertion(<mention class="mention" data-id="40539" data-type="work_package" data-text="#40539">#40539</mention>)End of the insertion Begin of the deletion (##40539)End of the deletion
* Inheritance of the duration between a work package and its children
* e.g. can a work package have a duration that is less than the duration of its child

# Begin of the insertionVisuals neededEnd of the insertion Begin of the deletion ExamplesEnd of the deletion

Begin of the insertion* Date picker with duration field
* Warning/Information when dates are derived from relations
* Warning/information about manual scheduling
* Option to include configured non-working days
* Work package table view with duration column
* GANTT view
* Team planner
* with option to switch on and off the display of non-working days in week/2-week view

# Scenarios

End of the insertion ## Scenario 1:

* Setup
* Start date: Monday, February 8 2021
* Finish date: empty
* Duration: empty
* Change
* User enters a duration of 10 days
* Expected result:
* The finish date is changed to Friday, February 19 2021

## Scenario 2

* Setup
* Start date: empty
* Finish date: empty
* Duration: empty
* Change
* User enters a duration of 10 days
* Expected result:
* No date is added

## Scenario 3

* Setup
* Start date: empty
* Finish date: Friday, February 19, 2021
* Duration: empty
* Change
* User enters a duration of 10 days
* Expected result:
* The start date is changed to Monday, February 8, 2021

## Scenario 4

* Setup
* Start date: Monday, February 8, 2021
* Finish date: Friday, February 19, 2021
* Duration: 10
* Change
* User enters a duration of 11 days
* Expected result:
* The finish date is changed to Monday, February, 22 2021

## Scenario 5

* Setup
* Start date: Monday, February 8, 2021
* Finish date: Monday, February 22, 2021
* Duration: 11
* Change
* User enters a duration of 10 days
* Expected result:
* The finish date is changed to Friday, February, 19, 2021

## Scenario 6

* Setup
* Two work packages
* Task 1: Monday - Tuesday
* Task 2: no dates, no duration
* Change
* Task 2 follows Task 1
* Expected result
* Task 2: Starts Wednesday, Finish Date Wednesday, Duration = 1

## Scenario 7

* Setup
* Start date: Monday, February 9, 2021
* Finish date: Wednesday, February 11, 2021
* Duration: 3
* Change
* User alters the start date to Tuesday 10, 2021
* Expected result
* Finish date is changed to Thursday, Feb 12, 2021

## Scenario 8

* Setup
* Start date: Tuesday, February 10, 2021
* Finish date: Thursday, February 12, 2021
* Duration: 3
* Change
* User alters the finish date to Feb 11, 2021
* Expected result
* Start date is changed to Monday, Feb 9, 2021

## Scenario 9

* Setup
* Start date: Monday, February 9, 2021
* Finish date: Wednesday, February 11, 2021
* Duration: 3
* Change
* User moves the drag handle on the left border (start date) of the box representing the work package in Gantt chart and Team planner one day to the right (to Feb 10, 2021)
* Expected result
* The duration is reduced to 2. The start date is set to Feb 10, 2021. The Finish date is left unchanged.

## Scenario 10

* Setup
* Start date: empty
* Finish date: Wednesday, February 11, 2021
* Duration: empty
* Change
* User enters the start date of Monday, February 09, 2021
* Expected result
* **\[open\]** Duration is set to 3

# Visuals

<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27172/content"></div></figure>

# Seed Data

**Static queries in section &quot;Default data&quot;:**

* Gantt chart: Add duration column after column finish date:

**Queries in section favorite views**

* Project plan (Query ID 1): Add duration column after column finish date
* Project plan (Query ID 14): Add duration column after column finish date

# Full screen view

* Currently the status selection is below the subject at the same position for all work package types.
* We also move the dates and the curation to this area (visuals tbd).
* For milestones there is no duration by definition.

# Out-of-Scope

* Consider weekends and holidays Begin of the insertion(for this ticket, will normally already have been dealth by <mention class="mention" data-id="18416" data-type="work_package" data-text="#18416">#18416</mention>)End of the insertion Begin of the deletion (##18416)End of the deletion
* Summing Begin of the insertionduration _(need clarification)_End of the insertion Begin of the deletion durationsEnd of the deletion
* Grouping by durations Begin of the insertion_(need clarification)_End of the insertion

# Implementation notes

* Frontend:
* include duration in date picker
* There is no duration form field for milestones.
* Restyling dates section (start &amp; due date &amp; duration) so that dates are always visible (no longer configurable via form configuration) similar to status
* Adapt specs that break by doing this
* Display longer bar in gantt chart and planning board while dragging a work package without start &amp; end dates
* Backend:
* Introduce into data layer &amp; contracts
* Disallow setting duration for milestone typed work packages
* Services
* **Open** inheritance within hierarchy
* Include in API
* Exclude for milestone typed work packages (should be covered by non writable property in contract)
* Calculates start/end dates on scheduling and on setting duration/start/end-dates
* Filter for duration (&quot;Everything longer than&quot;)
* Sort
* Seeding and default configurations
* Migration for removing the dates from existing form configurations as they can no longer be configured.
* Migration for setting a duration for all work packages having start and end date set.