# Problem

* It is currently hard to create project schedules as when work packages span a weekend. In these cases the weekend days are counted as normal working days.
* When projects change the start day of a work package the calculation of 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 finishs on Friday. If the task is delayed by one day the finish date is set for the Saturday. Since Saturday is a non-working day in this scenario the more accurate calculation for the finish date would be Monday.

# Solution

* For each each Begin of the insertioninstance,End of the insertion Begin of the deletion installationEnd of the deletion an Begin of the insertionadminEnd of the insertion Begin of the deletion AdminEnd of the deletion can Begin of the insertionconfigureEnd of the insertion Begin of the deletion set a defaultEnd of the deletion working Begin of the insertionweekdays,End of the insertion Begin of the deletion week daysEnd of the deletion which Begin of the insertionapplies toEnd of the insertion Begin of the deletion is preset forEnd of the deletion all Begin of the insertionprojects in that instance.End of the insertion Begin of the deletion projects.End of the deletion
* Begin of the insertionIn addition,End of the insertion Begin of the deletion Also a monthly or yearly calendar view will allowEnd of the deletion the Begin of the insertionadmin can also configureEnd of the insertion Begin of the deletion Admin to addEnd of the deletion non-working days Begin of the insertion(suchEnd of the insertion Begin of the deletion suchEnd of the deletion as public holidays or company Begin of the insertionevents) manually, with a weekly or a yearly calendar.End of the insertion Begin of the deletion events manually.End of the deletion This behaviour is specified Begin of the insertioninEnd of the insertion Begin of the deletion on the work package:End of the deletion <mention class="mention" data-id="41226" data-type="work_package" data-text="#41226">#41226</mention>
* Begin of the insertionWithinEnd of the insertion Begin of the deletion FromEnd of the deletion the same Begin of the insertionmodule to configure non-working days (with a weeklyEnd of the insertion Begin of the deletion monthlyEnd of the deletion or Begin of the insertionaEnd of the insertion yearly Begin of the insertioncalendar), adminsEnd of the insertion Begin of the deletion calendar AdminsEnd of the deletion will be able to import local calendar files (ics.) or choose from a list of public holiday calendars Begin of the insertionrelevant toEnd of the insertion Begin of the deletion fromEnd of the deletion the Begin of the insertionselectedEnd of the insertion region/country Begin of the insertionfor that instance.End of the insertion Begin of the deletion where the instance is located.End of the deletion This Begin of the insertionfeatureEnd of the insertion Begin of the deletion behaviourEnd of the deletion is specified Begin of the insertioninEnd of the insertion Begin of the deletion on the work package:End of the deletion <mention class="mention" data-id="41227" data-type="work_package" Begin of the insertiondata-text="#41227">#41227</mention>.End of the insertion Begin of the deletion data-text="#41227">#41227</mention>End of the deletion
* Begin of the insertionNon-working daysEnd of the insertion Begin of the deletion The non-workingEnd of the deletion are Begin of the insertionrepresented visuallyEnd of the insertion Begin of the deletion visualisedEnd of the deletion in the front-end in the following views:
* Date picker Begin of the insertion(in several views)End of the insertion
* Gantt
* Calendar
* Team planner Begin of the insertion
* _\[open\] any other place ?_End of the insertion
* **NOTE:** Begin of the insertionThis work package handlesEnd of the insertion Begin of the deletion AllEnd of the deletion the Begin of the insertionconfiguration and displayEnd of the insertion Begin of the deletion reschedulingEnd of the deletion of Begin of the insertionnon-working days. Actual calculationEnd of the insertion Begin of the deletion work packages datesEnd of the deletion and Begin of the insertionadaption ofEnd of the insertion Begin of the deletion durations for example excluding weekends from the date selection or changing theEnd of the deletion start/end Begin of the insertiondates andEnd of the insertion Begin of the deletion date depending on theEnd of the deletion duration of Begin of the deletion theEnd of the deletion work Begin of the insertionpackages by taking into account theseEnd of the insertion Begin of the deletion package and theEnd of the deletion non-working days will be Begin of the insertionhandled separately (and specifiedEnd of the insertion Begin of the deletion tackledEnd of the deletion in Begin of the insertionepicEnd of the insertion Begin of the deletion a separate EPIC related to the durationEnd of the deletion <mention class="mention" data-id="31992" data-type="work_package" Begin of the insertiondata-text="#31992">#31992</mention>, which willEnd of the insertion Begin of the deletion data-text="#31992">#31992</mention> that isEnd of the deletion also Begin of the insertionbe implemented in version 12.2.0).End of the insertion Begin of the deletion included into the release 12.2.0.End of the deletion

## Visuals

<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>

<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 pages

* Date Begin of the insertionpicker (_note: this is an illustration/work in progress, will almost certainly change with work on epic <mention class="mention" data-id="31992" data-type="work_package" data-text="#31992">#31992</mention>)_End of the insertion Begin of the deletion picker:End of the deletion

<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:

<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:

<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 Begin of the insertionplanner End of the insertion Begin of the deletion planner:End of the deletion

<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 Begin of the insertionatEnd of the insertion Begin of the deletion onEnd of the deletion a project level.
* Non-working-days Begin of the insertionat anEnd of the insertion Begin of the deletion ofEnd of the deletion individual Begin of the insertionuser-level.End of the insertion Begin of the deletion team members.End of the deletion
* Begin of the insertionSubscribingEnd of the insertion Begin of the deletion SubscribeEnd of the deletion to external calendars, e.g. Google calendars (that are not included in our libraries of Begin of the insertionregion-basedEnd of the insertion ics Begin of the insertioncalendars,End of the insertion or uploaded manually).
* Begin of the insertionActual calculationEnd of the insertion Begin of the deletion All the reschedulingEnd of the deletion of Begin of the insertionstart and endEnd of the insertion Begin of the deletion work packagesEnd of the deletion dates and Begin of the insertiondurationEnd of the insertion Begin of the deletion durations based on non-working days as its partEnd of the deletion of Begin of the insertionwork packages by taking in account non-working days. This will be handled inEnd of the insertion <mention class="mention" data-id="31992" data-type="work_package" data-text="#31992">#31992</mention>.
* Informing Begin of the insertionthe userEnd of the insertion Begin of the deletion about non working daysEnd of the deletion when Begin of the insertionthey try to scheduleEnd of the insertion Begin of the deletion schedulingEnd of the deletion a Begin of the insertionmeeting on a non-working day.End of the insertion Begin of the deletion meeting.End of the deletion

# Implementation notes

* Frontend:
* Fetch non working days when date picker, gantt chart, calendar or planning board is opened
* Block&amp;visualize in working days settings
* Block&amp;visualize in date picker
* Block&amp;visualize in gantt
* Block&amp;visualize in calendar
* Block&amp;visualize in team planner
* Angular based administration of non working days relying on the API
* Backend:
* model layer for non working days
* Contract and Services for non working days
* API: Introduce an index action that will fetch all non working days. There are two types of those. One type represents the recurring days (e.g. Saturday and Sunday) and one the exemptions (e.g. Christmas)
* Background job upon changes to the non working days
* Exclude non working days on schedule
* Default/Seed data

# Figma link

https://www.figma.com/file/SMzHAQWcY9k0PkTEKd5UQn/?node-id=0%3A1