Content
View differences
Updated by Parimal Satyal almost 4 years ago
# Implementation plan
This Epic will be implemented EPIC has been divided in stages parts: two for the next releases:
* **12.2**: User-definable non-working days (on the user settings page, date picker, team planner, calendar and GANTT view) are implemented but not visible. On the front-end, weekends are greyed out (cosmetically) as they are today but continue to remain selectable.
* **12.3:** Weekends are now user-configurable via settings (<mention class="mention" data-id="42316" data-type="work_package" data-text="#42316">#42316</mention>) and are properly reflected (with a grey background) in the date picker, team planner, calendar and GANTT view. Date picker has an "include non-working days" checkbox enabled by default for all existing work packages on migration. <mention class="mention" data-id="42316" data-type="work_package" data-text="#42316">#42316</mention>
# Problem
* It is currently difficult hard to create accurate project schedules as when work packages span a weekend, since weekends weekend. In these cases the weekend days are currently treated counted as normal/working normal working days.
* When projects change the start day of a work package, package the calculation of the the finish date does not take into account any non-working days between the start and the finish date.
> **Example:** A task starts on Monday and finishes finishs on Friday. If the task is delayed by one day, day the finish date is set for the Saturday. Since Saturday is generally a non-working day, day in this scenario the more accurate calculation in this case would be for the finish date to set to would be Monday.
# The Solution
An * For each each instance, an admin can define configure working days of the week, weekdays, which applies to all projects in that instance.
* There is a new entry called "Working days" in the admin settings.
* This entry is specified in <mention class="mention" data-id="42316" data-type="work_package" data-text="#42316">#42316</mention>.
* Non-working days are represented visually in the front-end (calendar days are greyed out) in the following views:
* Date picker (described in <mention class="mention" data-id="41341" data-type="work_package" data-text="#41341">#41341</mention>) (in several views)
* Gantt view
* Calendar
* Team planner
* The expected behaviour when manipulating work packages in team planner, GANTT view and calendar are described here: <mention class="mention" data-id="42869" data-type="work_package" data-text="#42869">#42869</mention> _\[open\] any other place ?_
* **NOTE:** This work package handles the configuration and display of non-working days. Actual calculation and adaption of start/end dates and duration of work packages by taking into account these non-working days will be handled by the separately (and specified in epic concerning Duration (<mention <mention class="mention" data-id="31992" data-type="work_package" data-text="#31992">#31992</mention>).
## Visuals
**Working days under administration settings** <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27750/content"></div></figure>
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36803/content"> <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27751/content"></div></figure>
# Visuals of affected views pages
**Date picker** (described * Date picker (_note: this is an illustration/work in full in progress, will almost certainly change with work on epic <mention class="mention" data-id="41341" data-id="31992" data-type="work_package" data-text="#41341">#41341</mention>) data-text="#31992">#31992</mention>)_
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36804/content"> <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27770/content"></div></figure>
**Gantt:** * Gantt:
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36805/content"> <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27771/content"></div></figure>
**Calendar:** * Calendar:
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36806/content"> <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27772/content"></div></figure>
**Team planner** * Team planner
**<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36807/content">** <figure class="image op-uc-figure" style="width:75%;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/27769/content"></div></figure>
# **Out of Scope**
* Selecting non-working days at a project level.
* Non-working-days at an individual user-level.
* Individual non-working days, e.g New Years Day (separate work package)
* Subscribing to external calendars, e.g. Google calendars (that are not included in our libraries of region-based ics calendars, or uploaded manually).
* Actual calculation of start and end dates and duration of work packages by taking in account non-working days. This will be handled in <mention class="mention" data-id="31992" data-type="work_package" data-text="#31992">#31992</mention>.
* Informing the user when they try to schedule a meeting on a non-working day.
# Figma link
https://www.figma.com/file/SMzHAQWcY9k0PkTEKd5UQn/Duration-and-Non-Working-Days?node-id=0%3A1 https://www.figma.com/file/SMzHAQWcY9k0PkTEKd5UQn/?node-id=0%3A1
This Epic will be implemented
* **12.2**: User-definable non-working days (on the user settings page, date picker, team planner, calendar and GANTT view) are implemented but not visible. On the front-end, weekends are greyed out (cosmetically) as they are today but continue to remain selectable.
* **12.3:** Weekends are now user-configurable via settings (<mention class="mention" data-id="42316" data-type="work_package" data-text="#42316">#42316</mention>) and are properly reflected (with a grey background) in the date picker, team planner, calendar and GANTT view. Date picker has an "include non-working days" checkbox enabled by default for all existing work packages on migration.
# Problem
* It is currently difficult
* When projects change the start day of a work package,
> **Example:** A task starts on Monday and finishes
# The Solution
An
* There is a new entry called "Working days" in the admin settings.
* This entry is specified in <mention class="mention" data-id="42316" data-type="work_package" data-text="#42316">#42316</mention>.
* Non-working days are represented visually in the front-end (calendar days are greyed out) in the following views:
* Date picker (described in <mention class="mention" data-id="41341" data-type="work_package" data-text="#41341">#41341</mention>)
* Gantt view
* Calendar
* Team planner
* **NOTE:** This work package handles the configuration and display of non-working days. Actual calculation and adaption of start/end dates and duration of work packages by taking into account these non-working days will be handled by the
## Visuals
**Working days under administration settings**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36803/content">
# Visuals of affected views
**Date picker** (described
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36804/content">
**Gantt:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36805/content">
**Calendar:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36806/content">
**Team planner**
**<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/36807/content">**
# **Out of Scope**
* Selecting non-working days at a project level.
* Non-working-days at an individual user-level.
* Individual non-working days, e.g New Years Day (separate work package)
* Subscribing to external calendars, e.g. Google calendars (that are not included in our libraries of region-based ics calendars, or uploaded manually).
*
*
# Figma link
https://www.figma.com/file/SMzHAQWcY9k0PkTEKd5UQn/Duration-and-Non-Working-Days?node-id=0%3A1