# Feature COMMS-698 - Adapt routes for project-based semantic work package identifiers

Project: Stream Communicator
Status: closed
URL: https://community.openproject.org/work_packages/COMMS-698

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.5.0 |
| Sprint |  |
| Backlog bucket |  |
| 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 |
| --- | --- | --- | --- | --- | --- | --- |
| COMMS-701 | Use displayId in work package URLs | Implementation | closed |  | 17.5.0 |  |
| COMMS-704 | Stateful navigation changes | Implementation | closed |  | 17.4.0 |  |
| COMMS-709 | Copy link to clipboard should honour semantic ids | Implementation | closed |  | 17.5.0 |  |
| COMMS-710 | Make find/exists? resolve semantic work package identifiers | Implementation | closed |  | 17.4.0 |  |
| COMMS-718 | use displayId in work package breadcrumbs | Implementation | closed |  | 17.5.0 |  |
| COMMS-721 | Use displayId in work package context menus | Implementation | closed |  | 17.5.0 |  |
| COMMS-722 | Use displayId when opening split view via list toolbar info icon | Implementation | closed |  | 17.5.0 |  |
| COMMS-723 | Use displayId on list row click while split view open | Implementation | closed |  | 17.5.0 |  |
| COMMS-724 | Use displayId on primerized split-screen full-screen link | Implementation | closed |  | 17.5.0 |  |
| COMMS-725 | Use displayId on work package card ID link | Implementation | closed |  | 17.5.0 |  |
| COMMS-726 | Use displayId on notification center work package click | Implementation | closed |  | 17.5.0 |  |
| COMMS-727 | Use displayId on backlogs view work package click | Implementation | closed |  | 17.5.0 |  |
| COMMS-735 | Override WorkPackage#to_param so URL helpers produce semantic IDs | Implementation | closed |  | 17.5.0 |  |
| COMMS-736 | Drop redundant wp.display_id arguments from WorkPackage URL helpers | Implementation | rejected | Kabiru Mwenja |  |  |
| COMMS-738 | Resolve semantic work package id when moving a work package | Implementation | closed |  | 17.5.0 |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| COMMS-753 | Bug | Numeric ID copied instead of semantic ID in "Copy work package ID" on Backlogs page | closed |  | 17.5.0 |  | Modules and project features / Backlogs, Modules and project features / Work packages |

## Technical Details

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

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers | Kabiru Mwenja |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

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

## Description

**As** a user of an OpenProject instance configured to use project-based work package identifiers  
**I want to** use URLs containing those identifiers  
**so that** I can share them with teammates or paste them into other tools, and anyone seeing the URL can tell which project the work package belongs to.

## Acceptance criteria

  - URLs like `/work_packages/PROJ-42` open the correct work package in:
    
      - Full view
    
      - Split view
    
      - BIM views

  - The same work package can be opened by its numeric ID (e.g. `/work_packages/12345`) — nothing breaks for instances that don't use semantic identifiers

  - If a project is renamed, older identifiers (e.g. `OLDNAME-42`) still resolve to the same work package

  - Opening a URL with an identifier that doesn't exist shows a standard "work package not found" page (not a generic 404)

  - Users only see work packages they have permission to view — typing a guessed identifier into the URL does not bypass permissions

  - Links generated inside the product use the semantic identifier when the feature is enabled. Places to verify:
    
      - Work package breadcrumb — clicking any parent/ancestor link (<mention class="mention" data-id="74200" data-type="work_package" data-text="#74200">#74200</mention>)
    
      - Context menus — all entries, both on the list (triggered via right-click) and on the full view (<mention class="mention" data-id="74308" data-type="work_package" data-text="#74308">#74308</mention>)
    
      - Opening a work package in split view via the info icon button in the list toolbar (<mention class="mention" data-id="74309" data-type="work_package" data-text="#74309">#74309</mention>)
    
      - Clicking another row while a split view is already open on the list (<mention class="mention" data-id="74310" data-type="work_package" data-text="#74310">#74310</mention>)
    
      - The "full screen" link on primerized split-screen pages — e.g. Boards, Notifications (<mention class="mention" data-id="74311" data-type="work_package" data-text="#74311">#74311</mention>)
    
      - The ID link shown on each work package card — e.g. on Boards (<mention class="mention" data-id="74312" data-type="work_package" data-text="#74312">#74312</mention>)
    
      - Clicking a notification in the notification center to open the referenced work package (<mention class="mention" data-id="74313" data-type="work_package" data-text="#74313">#74313</mention>)
    
      - Clicking a work package in the Backlogs view (<mention class="mention" data-id="74314" data-type="work_package" data-text="#74314">#74314</mention>)
    
      - ~~Text macro references (~~`~~#123~~` ~~in descriptions, comments, wiki content) — both the visible label and the target URL render with the semantic identifier (<mention class="mention" data-id="74315" data-type="work_package" data-text="#74315">#74315</mention>)~~
    
      - Copy-to-clipboard and "share" actions on the work package

  - The public API accepts semantic identifiers wherever it accepts numeric work package IDs, including when referencing a parent work package

## Permissions and visibility

  - **Who sees this:** all users with permission to view work packages. Using a semantic identifier in a URL does not change who can access what.

  - **When it applies:** only on instances where the semantic work package identifiers feature is enabled. On other instances, URLs continue to use numeric IDs as before.

## Translations

  - No new user-facing strings. Existing "work package not found" messages are reused.

## Out of scope

  - Displaying semantic identifiers in the UI (covered by <mention class="mention" data-id="73716" data-type="work_package" data-text="#73716">#73716</mention> and <mention class="mention" data-id="73717" data-type="work_package" data-text="#73717">#73717</mention>)

  - Assigning semantic identifiers to work packages (covered by the sequence allocation feature)

  - Admin settings for enabling or configuring the identifier format

  - Redirecting numeric URLs to semantic URLs — both forms remain valid
