Implementation/72461 administration setting for semantic work package identifiers UI

app/components/work_packages/admin/settings/change_identifiers_dialog_component.html.erb

@@ -0,0 +1,64 @@
+<%#
+  -- copyright
+  OpenProject is an open source project management software.
+  Copyright (C) the OpenProject GmbH
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License version 3.
+
+  OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+  Copyright (C) 2006-2013 Jean-Philippe Lang
+  Copyright (C) 2010-2013 the ChiliProject Team
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License
+  as published by the Free Software Foundation; either version 2
+  of the License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+  See COPYRIGHT and LICENSE files for more details.
+
+  ++#
+%>
+
+<%=
+  render(
+    Primer::OpenProject::DangerDialog.new(
+      id: "change-identifiers-dialog",
+      title: I18n.t("admin.settings.work_packages_identifier.dialog.title"),
+      confirm_button_text: I18n.t("admin.settings.work_packages_identifier.dialog.confirm_button"),
+      cancel_button_text: I18n.t("button_close"),
+      size: :large,
+      form_arguments: {
+        action: admin_settings_work_packages_identifier_path,
+        method: :patch
+      }
+    )
+  ) do |dialog|
+    dialog.with_confirmation_message do |message|
+      message.with_heading(tag: :h2) do
+        I18n.t("admin.settings.work_packages_identifier.dialog.heading")
+      end
+
+      message.with_description_content(
+        I18n.t("admin.settings.work_packages_identifier.dialog.description")
+      )
+    end
+
+    dialog.with_confirmation_check_box_content(
+      I18n.t("admin.settings.work_packages_identifier.dialog.checkbox_label")
+    )
+
+    dialog.with_additional_details(display: :none) do
+      hidden_field_tag("settings[work_packages_identifier]", Setting::WorkPackageIdentifier::ALPHANUMERIC)
+    end
+  end
+%>

app/components/work_packages/admin/settings/change_identifiers_dialog_component.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module WorkPackages
+  module Admin
+    module Settings
+      class ChangeIdentifiersDialogComponent < ApplicationComponent
+        include OpPrimer::ComponentHelpers
+        include OpTurbo::Streamable
+      end
+    end
+  end
+end

app/components/work_packages/admin/settings/identifier_autofix_section_component.html.erb

@@ -0,0 +1,109 @@
+<%#
+  -- copyright
+  OpenProject is an open source project management software.
+  Copyright (C) the OpenProject GmbH
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License version 3.
+
+  OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+  Copyright (C) 2006-2013 Jean-Philippe Lang
+  Copyright (C) 2010-2013 the ChiliProject Team
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License
+  as published by the Free Software Foundation; either version 2
+  of the License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+  See COPYRIGHT and LICENSE files for more details.
+
+  ++#
+%>
+
+<%=
+  render(Primer::Alpha::Banner.new(scheme: :warning, my: 3)) do
+    I18n.t(
+      "admin.settings.work_packages_identifier.banner.existing_identifiers_notice",
+      project_count: total_count
+    )
+  end
+%>
+
+<%=
+  render(border_box_container(mb: 3)) do |component|
+    component.with_header(font_weight: :bold) do
+      flex_layout do |header|
+        header.with_column(flex: 1) do
+          render(Primer::Beta::Text.new(font_weight: :semibold)) do
+            I18n.t("admin.settings.work_packages_identifier.box_header.label_project")
+          end
+        end
+        header.with_column(flex: 1) do
+          render(Primer::Beta::Text.new(font_weight: :semibold)) do
+            I18n.t("admin.settings.work_packages_identifier.box_header.label_previous_identifier")
+          end
+        end
+        header.with_column(flex: 1) do
+          render(Primer::Beta::Text.new(font_weight: :semibold)) do
+            I18n.t("admin.settings.work_packages_identifier.box_header.label_autofixed_suggestion")
+          end
+        end
+        header.with_column(flex: 1) do
+          render(Primer::Beta::Text.new(font_weight: :semibold)) do
+            I18n.t("admin.settings.work_packages_identifier.box_header.label_example_work_package_id")
+          end
+        end
+      end
+    end
+
+    displayed.each do |entry|
+      component.with_row do
+        flex_layout(align_items: :center) do |row|
+          row.with_column(flex: 1) do
+            render(Primer::Beta::Link.new(href: project_path(entry[:project]))) do
+              entry[:project].name
+            end
+          end
+          row.with_column(flex: 1) do
+            flex_layout(direction: :column) do |col|
+              col.with_row do
+                render(Primer::Beta::Text.new) { entry[:current_identifier] }
+              end
+              col.with_row do
+                render(Primer::Beta::Text.new(color: :danger, font_size: :small)) do
+                  error_label(entry[:error_reason])
+                end
+              end
+            end
+          end
+          row.with_column(flex: 1) do
+            render(Primer::Beta::Text.new) { entry[:suggested_identifier] }
+          end
+          row.with_column(flex: 1) do
+            render(Primer::Beta::Text.new) { sample_wp_id(entry[:suggested_identifier]) }
+          end
+        end
+      end
+    end
+
+    if remaining_count.positive?
+      component.with_row do
+        render(Primer::Beta::Text.new(color: :muted)) do
+          I18n.t(
+            "admin.settings.work_packages_identifier.autofix_preview.remaining_projects",
+            count: remaining_count
+          )
+        end
+      end
+    end
+  end
+%>

app/components/work_packages/admin/settings/identifier_autofix_section_component.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module WorkPackages
+  module Admin
+    module Settings
+      class IdentifierAutofixSectionComponent < ApplicationComponent
+        include OpPrimer::ComponentHelpers
+
+        DISPLAY_COUNT = WorkPackages::IdentifierAutofix::PreviewQuery::DISPLAY_COUNT
+
+        def initialize(projects_data:, total_count: projects_data.size)
+          super()
+          @total_count = total_count
+          @displayed = projects_data.first(DISPLAY_COUNT)
+          @remaining_count = [total_count - @displayed.size, 0].max
+        end
+
+        private
+
+        attr_reader :total_count, :displayed, :remaining_count
+
+        def error_label(error_reason)
+          I18n.t("admin.settings.work_packages_identifier.autofix_preview.error_#{error_reason}",
+                 default: "")
+        end
+
+        # Produces a realistic-looking example work package ID for the preview table.
+        # The sequence number is derived deterministically from the identifier so it looks
+        # varied across projects but is stable across renders. Range: 1–500.
+        def sample_wp_id(identifier)
+          n = (identifier.bytes.sum % 500) + 1
+          "#{identifier}-#{n}"
+        end
+      end
+    end
+  end
+end

app/components/work_packages/admin/settings/identifier_settings_form_component.html.erb

@@ -0,0 +1,99 @@
+<%#
+  -- copyright
+  OpenProject is an open source project management software.
+  Copyright (C) the OpenProject GmbH
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License version 3.
+
+  OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+  Copyright (C) 2006-2013 Jean-Philippe Lang
+  Copyright (C) 2010-2013 the ChiliProject Team
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License
+  as published by the Free Software Foundation; either version 2
+  of the License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+  See COPYRIGHT and LICENSE files for more details.
+
+  ++#
+%>
+
+<%= component_wrapper(**wrapper_data_attrs) do %>
+  <%=
+    settings_primer_form_with(
+      scope: :settings, action: :update, method: :patch,
+      html: change_in_progress? ? {} : { id: form_id }
+    ) do |f|
+      render_inline_settings_form(f) do |form|
+        form.radio_button_group(
+          name: :work_packages_identifier,
+          label: I18n.t("settings.work_packages.work_package_identifier"),
+          required: true,
+          **radio_button_options
+        )
+
+        form.html_content do
+          if change_in_progress?
+            render(Primer::Beta::Text.new(my: 3)) do
+              render(Primer::Beta::Spinner.new(size: :small, mr: 2)).to_s +
+                I18n.t("admin.settings.work_packages_identifier.in_progress.banner_message")
+            end
+          elsif completed?
+            render(Primer::Alpha::Banner.new(scheme: :success, dismiss_scheme: :remove, mb: 3)) do
+              I18n.t("admin.settings.work_packages_identifier.success_banner")
+            end
+          end
+        end
+      end
+    end
+  %>
+
+  <% unless change_in_progress? %>
+    <%= tag.div(
+          hidden: !show_autofix_section?,
+          data: { admin__work_packages_identifier_target: "autofixSection" }
+        ) do %>
+      <%= render(
+            WorkPackages::Admin::Settings::IdentifierAutofixSectionComponent.new(
+              projects_data:,
+              total_count:
+            )
+          ) %>
+    <% end %>
+    <div class="op-admin-settings-form-wrapper">
+      <%= render(
+            Primer::Beta::Button.new(
+              scheme: :primary,
+              type: :submit,
+              form: form_id,
+              hidden: show_autofix_section?,
+              data: { admin__work_packages_identifier_target: "saveButton" }
+            )
+          ) { t("button_save") } %>
+
+      <%= render(
+            Primer::Beta::Button.new(
+              tag: :a,
+              href: confirm_dialog_admin_settings_work_packages_identifier_path,
+              scheme: :primary,
+              hidden: !show_autofix_section?,
+              data: {
+                turbo_stream: true,
+                admin__work_packages_identifier_target: "autofixButton"
+              }
+            )
+          ) { t("admin.settings.work_packages_identifier.button_autofix") } %>
+    </div>
+  <% end %>
+<% end %>