Add CLI command for creating return reasons

- Add add_return_reason_command.rb for creating new return reasons
- Auto-generates identifiers (friendly_id, handle) from name
- Validates uniqueness of IDs, names, handles, friendly_ids
- Triggers automatic updates: localizations, dist files, docs
- Register add_return_reason command in cli.rb

Author: ricardotejedorsanz

dev/lib/product_taxonomy/cli.rb

@@ -95,5 +95,10 @@ def add_attributes_to_categories(attribute_friendly_ids, category_ids)
     def add_value(name, attribute_friendly_id)
       AddValueCommand.new(options.merge(name:, attribute_friendly_id:)).run
     end
+
+    desc "add_return_reason NAME DESCRIPTION", "Add a new return reason to the taxonomy with NAME and DESCRIPTION"
+    def add_return_reason(name, description)
+      AddReturnReasonCommand.new(options.merge(name:, description:)).run
+    end
   end
 end

dev/lib/product_taxonomy/commands/add_return_reason_command.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module ProductTaxonomy
+  class AddReturnReasonCommand < Command
+    def initialize(options)
+      super
+      load_taxonomy
+      @name = options[:name]
+      @description = options[:description]
+    end
+
+    def execute
+      create_return_reason!
+      update_data_files!
+    end
+
+    private
+
+    def create_return_reason!
+      @return_reason = ReturnReason.new(
+        id: ReturnReason.next_id,
+        name: @name,
+        description: @description,
+        friendly_id:,
+        handle:,
+      )
+      
+      begin
+        @return_reason.validate!(:create)
+      rescue ActiveModel::ValidationError => e
+        raise ActiveModel::ValidationError.new(e.model), "Failed to create return reason: #{e.message}"
+      end
+
+      ReturnReason.add(@return_reason)
+      logger.info("Created return reason `#{@return_reason.name}` with friendly_id=`#{@return_reason.friendly_id}`")
+    end
+
+    def update_data_files!
+      DumpReturnReasonsCommand.new({}).execute
+      SyncEnLocalizationsCommand.new(targets: "return_reasons").execute
+      GenerateDocsCommand.new({}).execute
+    end
+
+    def friendly_id
+      @friendly_id ||= IdentifierFormatter.format_friendly_id(@name)
+    end
+
+    def handle
+      @handle ||= IdentifierFormatter.format_handle(friendly_id)
+    end
+  end
+end
+
+
+