**As** a user of an OpenProject instance Begin of the insertionconfiguredEnd of the insertion Begin of the deletion which is setEnd of the deletion to use project-based work package identifiers
**I want to** use URLs Begin of the insertioncontainingEnd of the insertion Begin of the deletion withEnd of the deletion those identifiers
**so that** I can Begin of the insertionshare them with teammates or paste them intoEnd of the insertion Begin of the deletion copy those toEnd of the deletion other Begin of the insertiontools,End of the insertion Begin of the deletion toolsEnd of the deletion and Begin of the insertionanyone seeing theEnd of the insertion Begin of the deletion people can from thatEnd of the deletion URL Begin of the insertioncan tellEnd of the insertion Begin of the deletion seeEnd of the deletion which project the work package belongs Begin of the insertionto.End of the insertion Begin of the deletion toEnd of the deletion

## Acceptance criteria

* URLs like `/work_packages/PROJ-42` Begin of the insertionopenEnd of the insertion Begin of the deletion resolve toEnd of the deletion the correct work package Begin of the insertionin:

* Full view

* Split view

* End of the insertion Begin of the deletion (full view, split view, andEnd of the deletion BIM Begin of the insertionviews

End of the insertion Begin of the deletion views)

End of the deletion * The Begin of the insertionsameEnd of the insertion Begin of the deletion API v3 endpoint `GET /api/v3/work_packages/PROJ-42` resolves theEnd of the deletion work package Begin of the insertioncan be openedEnd of the insertion by its Begin of the insertionnumeric IDEnd of the insertion Begin of the deletion semantic identifier

* Scoped queriesEnd of the deletion (e.g. Begin of the insertion`/work_packages/12345`) - nothing breaks for instances that don't useEnd of the insertion Begin of the deletion `WorkPackage.visible(user).find("PROJ-42")`) resolveEnd of the deletion semantic identifiers Begin of the deletion transparentlyEnd of the deletion

* Begin of the insertionIf aEnd of the insertion Begin of the deletion `WorkPackage.exists?("PROJ-42")` returns `true` when the semantic identifier exists

* Historical/aliased identifiers (fromEnd of the deletion project Begin of the insertionis renamed, older identifiers (e.g. `OLDNAME-42`)End of the insertion Begin of the deletion renames)End of the deletion still resolve Begin of the deletion via the `work_package_semantic_aliases` table

* Numeric IDs continueEnd of the deletion to Begin of the insertionthe sameEnd of the insertion work Begin of the insertionpackageEnd of the insertion Begin of the deletion in all URL positions — no regressions for classic modeEnd of the deletion

* Begin of the insertionOpeningEnd of the insertion Begin of the deletion WhenEnd of the deletion a Begin of the insertionURL with anEnd of the insertion Begin of the deletion semanticEnd of the deletion identifier Begin of the insertionthat doesn't exist showsEnd of the insertion Begin of the deletion is not found, the response isEnd of the deletion a standard Begin of the insertion"work package not found" pageEnd of the insertion Begin of the deletion 404 with a work-package-specific error messageEnd of the deletion (not a generic 404)

* Begin of the insertionUsers only seeEnd of the insertion Begin of the deletion The API v3End of the deletion work Begin of the insertionpackages they have permission to view - typing a guessed identifier into the URL does not bypass permissionsEnd of the insertion Begin of the deletion package form endpoint correctly handles semantic identifiers in parent referencesEnd of the deletion

* Begin of the insertionLinksEnd of the insertion Begin of the deletion AdaptEnd of the deletion generated Begin of the insertioninside the product (e.g. copy-to-clipboard, breadcrumbs, parent links)End of the insertion Begin of the deletion routes such as clipboard copy toEnd of the deletion use Begin of the insertiontheEnd of the insertion semantic Begin of the insertionidentifier when the featureEnd of the insertion Begin of the deletion Ids


## Technical notes

* `WorkPackage::SemanticIdentifier::FinderMethods` moduleEnd of the deletion is Begin of the insertionenabledEnd of the insertion Begin of the deletion included in `WorkPackage` and extended onto every AR relation, overriding `find` and `exists?` to dispatch via `semantic_id?`End of the deletion

* Begin of the insertionThe publicEnd of the insertion Begin of the deletion `semantic_id?` predicate: strips whitespace, rejects non-strings and numeric strings, returns true only for `PROJECTID-SEQ` patterns — replaces FriendlyId's `Object#friendly_id?` monkey-patch

* Resolution chain: check `identifier` column first, then fall back to `work_package_semantic_aliases` table for historical identifiers

* `ID_ROUTE_CONSTRAINT` constant centralised in `WorkPackage::SemanticIdentifier` — single source of truth for both `config/routes.rb` and frontend `WP_ID_URL_PATTERN`

* Rails route constraint widened from `/\d+/` to accept both numeric and `PROJECTID-SEQ` patterns

* End of the deletion API Begin of the insertionacceptsEnd of the insertion Begin of the deletion v3 route parameter changed from `type: Integer` to `type: String` to acceptEnd of the deletion semantic Begin of the insertionidentifiers wherever it accepts numeric work package IDs, including when referencing a parent work packageEnd of the insertion Begin of the deletion IDs

* Controller and ViewComponent finders updated to use `find_by_id_or_identifier` instead of `find`

* `RecordNotFound` raised with structured `model:`, `primary_key:`, and `id:` fields for error reportingEnd of the deletion


## Permissions and visibility Begin of the deletion considerationsEnd of the deletion

* Begin of the insertion**Who sees this:**End of the insertion Begin of the deletion **Visible to:**End of the deletion all users Begin of the insertionwithEnd of the insertion Begin of the deletion who haveEnd of the deletion permission to view work Begin of the insertionpackages. Using a semanticEnd of the insertion Begin of the deletion packages — theEnd of the deletion identifier Begin of the deletion formatEnd of the deletion in Begin of the insertionaEnd of the insertion Begin of the deletion theEnd of the deletion URL does not change Begin of the insertionwho can access what.End of the insertion Begin of the deletion authorization checksEnd of the deletion

* Begin of the insertion**When it applies:** only on instances whereEnd of the insertion Begin of the deletion **Not visible when:**End of the deletion the semantic work package identifiers feature Begin of the deletion flagEnd of the deletion is Begin of the insertionenabled. On other instances, URLs continueEnd of the insertion Begin of the deletion disabled at the instance level (routes still accept the pattern but no semantic identifiers will have been assigned)

* Authorization is unchanged: `WorkPackage.visible(user)` scoping applies before identifier resolution, so users cannot access work packages they lack permissionEnd of the deletion to Begin of the insertionuse numeric IDs as before.End of the insertion Begin of the deletion view by guessing semantic identifiersEnd of the deletion


## Begin of the insertionTranslationsEnd of the insertion Begin of the deletion Translation considerationsEnd of the deletion

* No new user-facing Begin of the insertionstrings. Existing "work package notEnd of the insertion Begin of the deletion strings — this is a routing/resolution layer change

* Error messages for "notEnd of the deletion found" Begin of the insertionmessages are reused.End of the insertion Begin of the deletion reuse existing `WorkPackage` record-not-found translationsEnd of the deletion


## Out of scope

* Begin of the insertionDisplayingEnd of the insertion Begin of the deletion Generating or displayingEnd of the deletion semantic identifiers in the UI (covered by Begin of the insertion<mention class="mention" data-id="73716" data-type="work_package" data-text="#73716">#73716</mention>End of the insertion Begin of the deletion PRs #22704End of the deletion and Begin of the insertion<mention class="mention" data-id="73717" data-type="work_package" data-text="#73717">#73717</mention> )End of the insertion Begin of the deletion #22710)End of the deletion

* Begin of the insertionAssigningEnd of the insertion Begin of the deletion AllocatingEnd of the deletion semantic identifiers to work packages (covered by the sequence allocation feature)

* Admin settings for Begin of the insertionenabling or configuring theEnd of the insertion Begin of the deletion enabling/configuring semanticEnd of the deletion identifier format

* Redirecting numeric URLs to semantic URLs Begin of the insertion- bothEnd of the insertion Begin of the deletion (bothEnd of the deletion forms remain Begin of the insertionvalidEnd of the insertion Begin of the deletion valid)

* Sharing/copy-to-clipboard UI for semantic URLsEnd of the deletion