# Feature SPAR-120 - Update and Primerise Datepicker in the scope of automatic scheduling

Project: Stream Planning and Reporting
Status: closed
URL: https://community.openproject.org/work_packages/SPAR-120

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 15.4.0 |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Use cases

_No work packages_

## Features and Chunks

| ID | Subject | Type | Status | Assignee | Target versions | Spent time |
| --- | --- | --- | --- | --- | --- | --- |
| OP-16718 | Focus on the banner while opening the date picker | Feature | closed |  | 15.4.0 |  |
| SPAR-140 | Advanced accessibility for the datepicker | Feature | closed |  | 15.5.0 |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| SPAR-171 | Bug | Non-working days are not selectable from the calendar after "Working days only" is unchecked | closed |  | 15.4.0 |  |  |
| SPAR-170 | Bug | When finish date is cleared, cursor stays on finish date but focus is on start date | closed |  | 15.4.0 |  |  |
| SPAR-199 | Bug | Predecessor/Successor tab are visually cramped | closed | Parimal Satyal | 15.4.0 |  |  |
| SPAR-187 | Bug | Mobile/Firefox: Picker gets zoomed in when opened and is difficult to use | closed |  | 15.4.0 |  |  |
| SPAR-185 | Bug | Milestones show the wrong label in the date form | closed |  | 15.4.0 |  |  |
| SPAR-183 | Bug | Duration is kept when start and finish dates are removed | closed |  | 15.4.0 |  |  |
| SPAR-169 | Bug | Missing scrollbar in Predecessor, Children and Successor tabs | closed |  | 15.4.0 |  |  |
| SPAR-160 | Bug | A work package with indirect predecessors should be able to switch to automatic | closed |  | 15.4.0 |  |  |
| SPAR-181 | Bug | Old dates still show on the calendar when we switch from Automatic to Manual and start selecting new dates | rejected |  | 15.4.0 |  |  |
| SPAR-167 | Bug | Missing space at the bottom of the date picker modal | rejected |  | 15.4.0 |  |  |
| SPAR-168 | Bug | Due to low contrast, date is barely visible on the calendar | closed |  | 15.4.0 |  |  |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups | https://www.figma.com/design/HrWVktq0SsGI2dqqIKQ11M/Scheduling---Lag-and-Modes?node-id=175-3641&node-type=canvas&t=K4NXxBykmZ0HQV3P-0 |
| Build Number |  |
| Found in mobile app version |  |
| Follow-up feedback e-mail |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Henriette Darge |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer | Parimal Satyal |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**Acceptance criteria**

##### **Date picker**

  - The date picker will be Primerised.

  - Each date now has a clear button.
    
      - *Primer will show this all the time (even if the value is empty; we will suggest to Primer to implement behaviour to allow showing a trailing action only when there is a value input, for use as a clear action).*

  - There is now an UnderlineNav bar at the top:
    
      - With four options:
        
          - Dates
        
          - Predecessors
        
          - Successors
        
          - Children

  - Tab: **Dates**
    
      - There is a new segmented control with label "Scheduling mode"
        
          - ~~There is a help icon next to the label. On hover, it displays a tooltip with this text: "‘Manual’ lets you pick fixed dates freely but ignores all predecessors. ‘Automatic’ selects the earliest possible start date for this work package, which cannot be modified."~~
            
              - Edit: Primer strongly discourages to  use tooltips on non-interactive elements, so we decided to drop that.
        
          - Options: "Manual" and "Automatic"
    
      - The "Working days only" toggle becomes a checkbox aligned to the far right edge of the same line as the segmented control.
    
      - In **Manual** mode:
        
          - The dates are freely selectable, without restrictions.
        
          - Relations don't affect the start and finish dates.
        
          - A manually scheduled work package can push and pull successors that are automatically scheduled
        
          - A manual work package can start before any of their predecessors
        
          - A manually scheduled work package will not push a predecessor to the past when it's moved to the past
    
      - In **Automatic** mode:
        
          - The *Start date* is read-only
        
          - The "Today" links under the date fields are disabled (but not removed so that elements in the date picker don't move when changing modes)
        
          - The *Duration* field remains editable
            
              - Changing duration can change the *Finish date*
            
              - Unless it's a parent; in this case, all three fields (Start date, Finish date, Duration) are inactive.
        
          - The mini-calendar (all dates) go into inactive/disabled mode; it is not possible to click on the dates to change them.
        
          - If a work package does not have a predecessor, a blankslate will be displayed that informs the user that a predecessor is needed to enter this mode. The Save button is disabled until the user switches back to manual mode.

  - Tabs: **Predecessor, Successor and Children**
    
      - Each of the tabs displays the number of relations of that type with a badge
        
          - If there are no relations of that type, the badge will read 0
    
      - In each tab, all relations of that type are displayed in a box list
    
      - The content is the same as in the "Relations" tab of the work package, but in read only mode and:
        
          - without the section header
        
          - without the "more" icon (⋯), which means it is not possible to edit or remove relations from here in the current scope
    
      - When there are no relations, each section will display a blankslate (see [Figma mockups](https://www.figma.com/design/HrWVktq0SsGI2dqqIKQ11M/Scheduling---Lag-and-Modes?node-id=395-22009&t=HKs33N4NjcnQFpgU-4))
        
          - The blankslate will not offer any actions (eg. add a relation of that type) in this version

**Single date mode (Milestone)**

In single date mode:

  - There is only one date field with label "Date"
    
      - Finish date and Duration are not displayed
    
      - On desktop, two mini-calendars are displayed (due to the Underline Nav taking more horizontal space)
    
      - A single click changes the date on the calendar (current behaviour)

##### **Date picker banners:**

**Manual scheduling:**

  - Colour: Warning orange

  - Action: Show relations

  - Case 1: Relations exist but no predecessors.
    
      - **Manually scheduled. Dates not affected by relations.**
        
        Click on “Show relations” for Gantt overview

  - Case 2: There are predecessors but a gap of over two days with the finish date of the latest predecessor.
    
      - **Manually scheduled. Dates not affected by relations.**
        
        There is a gap between this and all predecessors.

  - Case 3: There are predecessors and the current work package overlaps with at least one of them.
    
      - **Manually scheduled. Dates not affected by relations.**
        
        Overlaps with at least one predecessor.

  - Case 4: Work package has children.
    
      - **Manually scheduled. Dates not affected by relations.**
        
        This has child work packages but their start dates are ignored.

  - Case 5: There are no relations.
    
      - No banner displayed.

**Automatic:**

  - Colour: Info blue

  - Action: Show relations

  - Case 1: There is a predecessor.
    
      - **The start date is set by a predecessor.**
        
        Click on “Show relations” for Gantt overview.

  - Case 2: The work package is a parent.
    
      - **The dates are determined by child work packages.**
        
        Click on “Show relations” for Gantt overview.
    
      - If a work package is both a parent and has predecessors, this "parent" message will be displayed.

#### Mobile behaviour 

##### Banners

There are only two variants of banners in mobile: one for manual, one for automatic.

**Manual scheduling**

  - Only visible if a manually scheduled work package has relations.

  - Colour: Warning orange

  - ~~Action: Relations~~  TBD

  - Text: "Manually scheduled. Relations ignored."

**Automatic scheduling:**

  - Always displayed in automatic mode.

  - Colour: Blue orange

  - ~~Action: Relations~~  TBD

  - Text: Automatically scheduled. Start date derived.

##### Date picker structure

The mobile date picker has these specificities (see mockup for visual reference):

  - The input fields are stacked vertically.

  - The UnderlineNav component is not visible.

  - The banner (when displayed) and rhe footer are fixed; any content that overflows is scrolled between the two.

#### Accessibility

<mention class="mention" data-id="60904" data-type="work_package" data-text="###60904">###60904</mention>

#### Visuals

***Note:** Please check* [*Figma*](https://www.figma.com/design/HrWVktq0SsGI2dqqIKQ11M/Scheduling---Lag-and-Modes?node-id=175-3641) *for the most recent mockups.*

**Manual scheduling (but predecessors overlap):**

<img class="image_resized op-uc-image op-uc-image_inline" style="width:460px;" src="/api/v3/attachments/260443/content">

**Automatic scheduling (start date set by predecessors):**

<img class="image_resized op-uc-image op-uc-image_inline" style="width:444px;" src="/api/v3/attachments/265063/content">

<br>

**Single date picker (Milstone) - Manual scheduling**

<img class="image_resized op-uc-image op-uc-image_inline" style="width:460px;" src="/api/v3/attachments/260446/content">

<br>

**Blankslate (No successors)**

**<img class="image_resized op-uc-image op-uc-image_inline" style="width:460px;" src="/api/v3/attachments/260445/content">**

**Mobile view, automatically scheduled:**

**<img class="image_resized op-uc-image op-uc-image_inline" style="width:253px;" src="/api/v3/attachments/262749/content">**

<br>
