[#73373] Background job for migrating pre-existing data to semantic identifiers

[thykel]

Ticket

https://community.openproject.org/projects/communicator-stream/work_packages/71645/activity

What are you trying to accomplish?

Add a background procedure to convert project & work package identifiers from classic (project cool_project, WP 1) to semantic (project CP, WP CP-1).

The procedure is invoked by switching to the semantic ("alphanumeric") identifier format via the admin settings.

Screenshots

What approach did you choose and why?

The original noop background job is now replaced by ProjectIdentifiers::ConvertInstanceToSemanticIdsJob. This is the flow:

0. Click the admin button to switch identifier mode to semantic.
1. Invoke ProjectIdentifiers::ConvertInstanceToSemanticIdsJob
2. If the database does not require any identifier transformation (e.g. proj => PROJ), simply set the the identifier mode to semantic and exit with success. Otherwise, continue further.
3. Spawn a batch of per-project jobs that fix the project identifier & populate work package identifiers (ProjectIdentifiers::BackfillProjectJob)
4. Once the batch has finished processing, GOTO 1. If this has already happened 10 times, abort the job as we're likely in an infinite loop.

Additionally, tweak the interface of the admin setting controller to have some proper shape -- previously it required presence of settings hash + a separate confirm_dangerous_action param, now it only needs a properly set settings hash.

Merge checklist

• Added/updated tests
• Added/updated documentation in Lookbook (patterns, previews, etc)
• Tested major browsers (Chrome, Firefox, Edge, ...)

[judithroth]

This is coming along nicely! I'm sorry I found another edge case that keeps me from approving 😅

[Copilot]

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 6 comments.

Comments suppressed due to low confidence (1)

app/models/work_package/semantic_identifier.rb:103

• The removal of private makes alias_rows_for_sequence_number a public instance method on WorkPackage, which looks like an internal helper used only by allocate_and_register_semantic_id. Consider restoring private (or marking just this method private) to avoid accidentally expanding the public API surface.

  # Builds alias rows for every identifier this project has ever used at the given sequence (including the current one).
  # This also includes "ghost identifiers" -- i.e. those that weren't ever actually generated, but should work
  # as a historical alias (e.g. OLDPROJ-42 should work even if WP #42 was created after rename to NEWPROJ)
  def alias_rows_for_sequence_number(seq)
    project.slugs
           .pluck(:slug)
           .map { |prefix| { identifier: "#{prefix}-#{seq}", work_package_id: id } }
  end

[thykel]

Split into:

• [#71645] Improve interface of WP identifier setting controller #22764
• [#71645] Convert instance to semantic identifiers #22765
• [#71645] Revert instance to classic identifiers #22770