Add CLI command for mapping return reasons to categories

- Add add_return_reasons_to_categories_command.rb
- Maps specified return reasons to specified categories
- Validates return reason references
- Auto-sorts alphabetically with Unknown/Other last
- Supports --include-descendants flag for cascade
- Register command in cli.rb

Author: ricardotejedorsanz

dev/lib/product_taxonomy/cli.rb

@@ -105,5 +105,12 @@ def add_return_reason(name, description)
     def dump_return_reasons
       DumpReturnReasonsCommand.new(options).run
     end
+
+    desc "add_return_reasons_to_categories RETURN_REASON_FRIENDLY_IDS CATEGORY_IDS",
+      "Add one or more return reasons to one or more categories. RETURN_REASON_FRIENDLY_IDS is a comma-separated list of return reason friendly IDs."
+    option :include_descendants, type: :boolean, desc: "When set, the return reasons will be added to all descendants of the specified categories"
+    def add_return_reasons_to_categories(return_reason_friendly_ids, category_ids)
+      AddReturnReasonsToCategoriesCommand.new(options.merge(return_reason_friendly_ids:, category_ids:)).run
+    end
   end
 end

dev/lib/product_taxonomy/commands/add_return_reasons_to_categories_command.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module ProductTaxonomy
+  class AddReturnReasonsToCategoriesCommand < Command
+    def initialize(options)
+      super
+      load_taxonomy
+      @return_reason_friendly_ids = options[:return_reason_friendly_ids]
+      @category_ids = options[:category_ids]
+      @include_descendants = options[:include_descendants]
+    end
+
+    def execute
+      add_return_reasons_to_categories!
+      update_data_files!
+    end
+
+    private
+
+    def add_return_reasons_to_categories!
+      @return_reasons = return_reason_friendly_ids.map { |friendly_id| ReturnReason.find_by!(friendly_id:) }
+      @categories = category_ids.map { |id| Category.find_by!(id:) }
+      @categories = @categories.flat_map(&:descendants_and_self) if @include_descendants
+
+      @categories.each do |category|
+        @return_reasons.each do |return_reason|
+          if category.return_reasons.include?(return_reason)
+            logger.info("Category `#{category.name}` already has return reason `#{return_reason.friendly_id}` - skipping")
+          else
+            category.return_reasons << return_reason
+          end
+        end
+        
+        sort_return_reasons!(category)
+      end
+
+      logger.info("Added #{@return_reasons.size} return reason(s) to #{@categories.size} categories")
+    end
+    
+    def sort_return_reasons!(category)
+      special_reasons = category.return_reasons.select { |r| ['unknown', 'other'].include?(r.friendly_id) }
+      regular_reasons = category.return_reasons.reject { |r| ['unknown', 'other'].include?(r.friendly_id) }
+      
+      regular_reasons.sort_by!(&:name)
+      
+      sorted_reasons = regular_reasons.dup
+      sorted_reasons << special_reasons.find { |r| r.friendly_id == 'unknown' } if special_reasons.any? { |r| r.friendly_id == 'unknown' }
+      sorted_reasons << special_reasons.find { |r| r.friendly_id == 'other' } if special_reasons.any? { |r| r.friendly_id == 'other' }
+      
+      category.instance_variable_set(:@return_reasons, sorted_reasons)
+    end
+
+    def update_data_files!
+      roots = @categories.map(&:root).uniq.map(&:id)
+      DumpCategoriesCommand.new(verticals: roots).execute
+      SyncEnLocalizationsCommand.new(targets: "categories").execute
+      GenerateDocsCommand.new({}).execute
+    end
+
+    def return_reason_friendly_ids
+      @return_reason_friendly_ids.split(",").map(&:strip)
+    end
+
+    def category_ids
+      @category_ids.split(",").map(&:strip)
+    end
+  end
+end
+
+
+