Begin of the insertion**Jira-likeEnd of the insertion Begin of the deletion We want to provide work package identifiers in the schema `<project identifier>-<sequence number>`. As a work package identifier contains theEnd of the deletion project Begin of the insertionidentifiers**End of the insertion Begin of the deletion identifier — which provides some additional context — we call it a **semantic identifier**.End of the deletion

Begin of the deletion An admin will be able to choose if regular numeric identifiers will be used for all work packages or semantic identifiers.

The auto-incrementing sequence number which is part of every work package identifier is dependent on the project. For every project and type combination it starts with 1.

End of the deletion * Begin of the deletion Projects have a short name, e.g. `oD` for openDesk (1 to 10\* chars).

* Types have a short name, e.g. `CR` for Change Request (1 to 8 chars).


**Implementation steps**

1. Step 1: {projectkey}-{sequence} (Jira case)

1. `oD-2212`

2. `HR-123`

2. Step 2: custom pattern

1. `oD_CR-1`

2. `oD_D-4`

3. `oD_EPIC-35`

4. `oD_BUG-223`


**More requirements:**

* End of the deletion When creating a new project, I can specify a custom project key (e.g., "MKTG" for Marketing, "DEVOPS" for DevOps).

* Begin of the insertionAllow handling ofEnd of the insertion Begin of the deletion The system validates that theEnd of the deletion project key Begin of the insertionsize of \*2-255 characters.End of the insertion Begin of the deletion is unique across all projects.End of the deletion

* Begin of the insertionOur algorithm should calculate acronyms of maximal 10 by default. ThatEnd of the insertion Begin of the deletion If no custom keyEnd of the deletion is Begin of the insertionalsoEnd of the insertion Begin of the deletion provided,End of the deletion the Begin of the insertiondefault in Jira.

End of the insertion Begin of the deletion system auto-generates one from the project name, based on the rules below.

End of the deletion * Begin of the insertionAllow usage of anyEnd of the insertion Begin of the deletion 3 firstEnd of the deletion characters from Begin of the insertionA to Z, digits from 0 to 9 and the underscore character. (Jira requirement)

End of the insertion Begin of the deletion project name (e.g., "Marketing Team" → "MAR").

End of the deletion * Begin of the insertionMust start with a letter (Jira requirement)

End of the insertion Begin of the deletion In case this key is already taken, use 4 or more characters.

End of the deletion * Begin of the insertionMust be in uppercase.

* The system validates thatEnd of the insertion Begin of the deletion Changing type or movingEnd of the deletion the Begin of the deletion work package to anotherEnd of the deletion project Begin of the insertionidentifier is unique across all projects.

End of the insertion Begin of the deletion updates the key.

End of the deletion * Begin of the deletion Historical references and links remain functional after key changes.

* End of the deletion Administrators can edit an existing project's key through project settings.

* When changing a project key, the system displays a warning about the impact on existing work packages.

* All existing work package identifiers automatically update to use the new key (e.g., OLD-123 becomes NEW-123).

* Begin of the deletion The system performs a background re-index after key changes.

* End of the deletion Historical references and links remain functional after key changes.

* The numeric sequence continues incrementally regardless of key changes.

* A Begin of the insertionproject identifierEnd of the insertion Begin of the deletion keyEnd of the deletion can not be used twice. It is blocked also after deleting the Begin of the deletion work package, movingEnd of the deletion project or Begin of the insertionrenaming the project identifier.End of the insertion Begin of the deletion changing type.End of the deletion


Begin of the insertion**Jira-like project-based work package identifiers**

* We wantEnd of the insertion Begin of the deletion **RequirementsEnd of the deletion to Begin of the insertionprovide work package identifiers in the schema `<project identifier>-<sequence number>`. As a work package identifier contains the project identifier — which provides some additional context — we also call it a **semantic identifier**.

* An admin can choose the whole OpenProject instance to use for work packages

* regular numeric identifiers (the old way)

* project-based alphanumeric semantic identifiers. (theEnd of the insertion Begin of the deletion allowEnd of the deletion Jira Begin of the insertionway)

End of the insertion Begin of the deletion migrations (Step 1):**

End of the deletion * Begin of the insertionWhen project-based alphanumeric semantic work package identifiers are used, all important views, but also imports and exports, API routes, resource routes, searches, filters and other features support them.

* Moving the work package to anotherEnd of the insertion Begin of the deletion Allow handling ofEnd of the deletion project Begin of the insertionupdates the key.

* Historical references and links remain functional afterEnd of the insertion key Begin of the insertionchanges.

* The old numeric identifiers will remain usable at all times, e.g. in work package searches and API requests.

* The auto-incrementing sequence number which is partEnd of the insertion Begin of the deletion sizeEnd of the deletion of Begin of the insertionevery work package identifier is dependent on the project.

* `<project identifier>-<sequence number>`, e.g.

* `OD-2212`

* `HR-123`

* For every project the sequence starts with 1.End of the insertion Begin of the deletion \*2-255 characters.End of the deletion

* Begin of the deletion Allow usage of any characters fromEnd of the deletion A Begin of the insertionwork package identifier can not be used twice. It is blocked also after deletingEnd of the insertion Begin of the deletion to Z, digits from 0 to 9 andEnd of the deletion the Begin of the insertionwork package, renaming the project identifier or moving the work package to another project.End of the insertion Begin of the deletion underscore character.End of the deletion