solidus_core 4.5.1 → 4.6.0

data/app/subscribers/spree/order_mailer_subscriber.rb

@@ -1,35 +1,17 @@
 # frozen_string_literal: true
 
 module Spree
-  # Mailing after events on a {Spree::Order}
   class OrderMailerSubscriber
     include Omnes::Subscriber
 
-    handle :order_finalized,
-           with: :send_confirmation_email,
-           id: :spree_order_mailer_send_confirmation_email
+    def send_confirmation_email(_event) = nil
+    deprecate send_confirmation_email:
+      "Use Spree::OrderConfirmationMailerSubscriber#send_confirmation_email instead",
+      deprecator: Spree.deprecator
 
-    handle :reimbursement_reimbursed,
-           with: :send_reimbursement_email,
-           id: :spree_order_mailer_send_reimbursement_email
-
-    # Sends confirmation email to the user
-    #
-    # @param event [Omnes::UnstructuredEvent]
-    def send_confirmation_email(event)
-      order = event[:order]
-      unless order.confirmation_delivered?
-        Spree::Config.order_mailer_class.confirm_email(order).deliver_later
-        order.update_column(:confirmation_delivered, true)
-      end
-    end
-
-    # Sends reimbursement email to the user
-    #
-    # @param event [Omnes::UnstructuredEvent]
-    def send_reimbursement_email(event)
-      reimbursement = event[:reimbursement]
-      Spree::Config.reimbursement_mailer_class.reimbursement_email(reimbursement.id).deliver_later
-    end
+    def send_reimbursement_email(_event) = nil
+    deprecate send_reimbursement_email:
+      "use Spree::ReimbursementMailerSubscriber#send_reimbursement_email instead",
+      deprecator: Spree.deprecator
   end
 end

data/app/subscribers/spree/reimbursement_mailer_subscriber.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Spree
+  # Mailing after a reimbursement is successful for a {Spree::Order}
+  class ReimbursementMailerSubscriber
+    include Omnes::Subscriber
+
+    handle :reimbursement_reimbursed,
+           with: :send_reimbursement_email,
+           id: :spree_order_mailer_send_reimbursement_email
+
+    # Sends reimbursement email to the user
+    #
+    # @param event [Omnes::UnstructuredEvent]
+    def send_reimbursement_email(event)
+      reimbursement = event[:reimbursement]
+      Spree::Config.reimbursement_mailer_class.reimbursement_email(reimbursement.id).deliver_later
+    end
+  end
+end

data/config/locales/en.yml

@@ -24,8 +24,10 @@ en:
         address2: Street Address (cont'd)
         city: City
         company: Company
+        email: Email
         name: Name
         phone: Phone
+        vat_id: VAT-ID
         zipcode: Zip Code
       spree/adjustment:
         adjustable: Adjustable
@@ -433,8 +435,10 @@ en:
         weight: Weight
         width: Width
       spree/zone:
+        country_ids: Countries
         description: Description
         name: Name
+        state_ids: States
     errors:
       models:
         spree/address:
@@ -2092,6 +2096,10 @@ en:
     return_quantity: Return Quantity
     return_reasons: Return Reasons
     returned: Returned
+    reverse_charge_statuses:
+      disabled: Disabled
+      enabled: Enabled
+      not_validated: Not Validated
     review: Review
     risk: Risk
     risk_analysis: Risk Analysis
@@ -2355,6 +2363,7 @@ en:
     variant_to_add: Variant to add
     variant_to_be_received: Variant to be received
     variants: Variants
+    vat_id: VAT-ID
     version: Version
     view_product: View Product On Store
     void: Void

data/db/migrate/20160101010000_solidus_one_four.rb

@@ -972,4 +972,96 @@ class SolidusOneFour < ActiveRecord::Migration[5.0]
       t.datetime "updated_at", precision: 6
     end
   end
+
+  def down
+    drop_table "friendly_id_slugs"
+    drop_table "spree_addresses"
+    drop_table "spree_adjustment_reasons"
+    drop_table "spree_adjustments"
+    drop_table "spree_assets"
+    drop_table "spree_calculators"
+    drop_table "spree_cartons"
+    drop_table "spree_countries"
+    drop_table "spree_credit_cards"
+    drop_table "spree_customer_returns"
+    drop_table "spree_inventory_units"
+    drop_table "spree_line_item_actions"
+    drop_table "spree_line_items"
+    drop_table "spree_log_entries"
+    drop_table "spree_option_type_prototypes"
+    drop_table "spree_option_types"
+    drop_table "spree_option_values"
+    drop_table "spree_option_values_variants"
+    drop_table "spree_order_mutexes"
+    drop_table "spree_orders"
+    drop_table "spree_orders_promotions"
+    drop_table "spree_payment_capture_events"
+    drop_table "spree_payment_methods"
+    drop_table "spree_payments"
+    drop_table "spree_preferences"
+    drop_table "spree_prices"
+    drop_table "spree_product_option_types"
+    drop_table "spree_product_promotion_rules"
+    drop_table "spree_product_properties"
+    drop_table "spree_products"
+    drop_table "spree_products_taxons"
+    drop_table "spree_promotion_actions"
+    drop_table "spree_promotion_categories"
+    drop_table "spree_promotion_codes"
+    drop_table "spree_promotion_code_batches"
+    drop_table "spree_promotion_rule_taxons"
+    drop_table "spree_promotion_rules"
+    drop_table "spree_promotion_rules_stores"
+    drop_table "spree_promotion_rules_users"
+    drop_table "spree_promotions"
+    drop_table "spree_properties"
+    drop_table "spree_property_prototypes"
+    drop_table "spree_prototype_taxons"
+    drop_table "spree_prototypes"
+    drop_table "spree_refund_reasons"
+    drop_table "spree_refunds"
+    drop_table "spree_reimbursement_credits"
+    drop_table "spree_reimbursement_types"
+    drop_table "spree_reimbursements"
+    drop_table "spree_return_authorizations"
+    drop_table "spree_return_items"
+    drop_table "spree_return_reasons"
+    drop_table "spree_roles"
+    drop_table "spree_roles_users"
+    drop_table "spree_shipments"
+    drop_table "spree_shipping_categories"
+    drop_table "spree_shipping_method_categories"
+    drop_table "spree_shipping_method_stock_locations"
+    drop_table "spree_shipping_method_zones"
+    drop_table "spree_shipping_methods"
+    drop_table "spree_shipping_rate_taxes"
+    drop_table "spree_shipping_rates"
+    drop_table "spree_state_changes"
+    drop_table "spree_states"
+    drop_table "spree_stock_items"
+    drop_table "spree_stock_locations"
+    drop_table "spree_stock_movements"
+    drop_table "spree_store_credit_categories"
+    drop_table "spree_store_credit_events"
+    drop_table "spree_store_credit_types"
+    drop_table "spree_store_credit_update_reasons"
+    drop_table "spree_store_credits"
+    drop_table "spree_store_payment_methods"
+    drop_table "spree_stores"
+    drop_table "spree_tax_rates"
+    drop_table "spree_tax_categories"
+    drop_table "spree_taxonomies"
+    drop_table "spree_taxons"
+    drop_table "spree_unit_cancels"
+    drop_table "spree_user_addresses"
+    drop_table "spree_user_stock_locations"
+    drop_table "spree_variant_property_rule_conditions"
+    drop_table "spree_variant_property_rule_values"
+    drop_table "spree_variant_property_rules"
+    drop_table "spree_variants"
+    drop_table "spree_wallet_payment_sources"
+    drop_table "spree_users"
+    drop_table "spree_zone_members"
+    drop_table "spree_zones"
+  end
 end

data/db/migrate/20180416083007_add_apply_to_all_to_variant_property_rule.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 class AddApplyToAllToVariantPropertyRule < ActiveRecord::Migration[5.1]
-  def change
+  def up
     add_column :spree_variant_property_rules, :apply_to_all, :boolean, default: false, null: false
     change_column :spree_variant_property_rules, :apply_to_all, :boolean, default: true
   end

data/db/migrate/20250129061658_add_metadata_to_spree_resources.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-class AddMetadataToSpreeResources < ActiveRecord::Migration[7.2]
+class AddMetadataToSpreeResources < ActiveRecord::Migration[7.0]
   def change
     # List of Resources to add metadata columns to
     %i[

data/db/migrate/20250214094207_add_reverse_charge_status_to_store.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddReverseChargeStatusToStore < ActiveRecord::Migration[7.0]
+  def change
+    add_column :spree_stores, :reverse_charge_status, :integer, default: 0, null: false,
+                comment: "Enum values: 0 = disabled, 1 = enabled, 2 = not_validated"
+  end
+end

data/db/migrate/20250225051308_add_vat_id_email_and_reverse_charge_status_to_addresses.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+class AddVatIdEmailAndReverseChargeStatusToAddresses < ActiveRecord::Migration[7.0]
+  def change
+    add_column :spree_addresses, :vat_id, :string
+    add_column :spree_addresses, :email, :string
+    add_column :spree_addresses, :reverse_charge_status, :integer, default: 0, null: false,
+                comment: "Enum values: 0 = disabled, 1 = enabled, 2 = not_validated"
+  end
+end

data/db/migrate/20250508145917_add_email_to_stock_locations.rb

@@ -0,0 +1,5 @@
+class AddEmailToStockLocations < ActiveRecord::Migration[7.0]
+  def change
+    add_column :spree_stock_locations, :email, :string
+  end
+end

data/db/migrate/20250530102541_add_addressbook_foreign_key.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class AddAddressbookForeignKey < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned address book entries (no corresponding address)" do
+    #   Spree::UserAddress.left_joins(:address).where(spree_addresses: { id: nil }).delete_all
+    # end
+    add_foreign_key :spree_user_addresses, :spree_addresses, column: :address_id, null: false
+  rescue ActiveRecord::StatementInvalid => e
+    if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+      say <<~MSG
+        ⚠️ Foreign key constraint failed when adding :spree_user_addresses => :spree_addresses.
+        To fix this:
+          1. Uncomment the code that removes orphaned records.
+          2. Rerun the migration.
+        Offending error: #{e.cause.class} - #{e.cause.message}
+      MSG
+    end
+    raise
+  end
+
+  def down
+    remove_foreign_key :spree_user_addresses, :spree_addresses, column: :address_id, null: false
+  end
+end

data/db/migrate/20250604072105_add_fk_products_variant_property_rules.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class AddFkProductsVariantPropertyRules < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned variant property rules (no corresponding product)" do
+    #   Spree::VariantPropertyRule.left_joins(:product).where(spree_products: { id: nil }).delete_all
+    # end
+
+    add_foreign_key :spree_variant_property_rules, :spree_products, column: :product_id, null: false
+  rescue ActiveRecord::StatementInvalid => e
+    if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+      say <<~MSG
+        ⚠️ Foreign key constraint failed when adding :spree_variant_property_rules => :spree_products.
+        To fix this:
+          1. Uncomment the code that removes orphaned records.
+          2. Rerun the migration.
+        Offending error: #{e.cause.class} - #{e.cause.message}
+      MSG
+    end
+    raise
+  end
+
+  def down
+    remove_foreign_key :spree_variant_property_rules, :spree_products, column: :product_id, null: false
+  end
+end

data/db/migrate/20250604072555_add_fk_to_product_properties.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+class AddFkToProductProperties < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned product properties (no corresponding product)" do
+    #   Spree::ProductProperty.left_joins(:product).where(spree_products: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_product_properties, :spree_products, column: :product_id, null: false
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_product_properties => :spree_products.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned product properties (no corresponding property)" do
+    #   Spree::ProductProperty.left_joins(:property).where(spree_properties: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_product_properties, :spree_properties, column: :property_id, null: false
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_product_properties => :spree_properties.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+  end
+
+  def down
+    remove_foreign_key :spree_product_properties, :spree_products, column: :product_id, null: false
+    remove_foreign_key :spree_product_properties, :spree_properties, column: :property_id, null: false
+  end
+end

data/db/migrate/20250604072948_add_fk_to_product_option_types.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+class AddFkToProductOptionTypes < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned product option types (no corresponding product)" do
+    #   Spree::ProductOptionType.left_joins(:product).where(spree_products: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_product_option_types, :spree_products, column: :product_id
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_product_option_types => :spree_products.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned product option types (no corresponding option type)" do
+    #   Spree::ProductOptionType.left_joins(:option_type).where(spree_option_types: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_product_option_types, :spree_option_types, column: :option_type_id
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_product_option_types => :spree_option_types.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+  end
+
+  def down
+    remove_foreign_key :spree_product_option_types, :spree_products, column: :product_id
+    remove_foreign_key :spree_product_option_types, :spree_option_types, column: :option_type_id
+  end
+end

data/db/migrate/20250604073219_add_fk_to_classifications.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+class AddFkToClassifications < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned classifications (no corresponding product)" do
+    #   Spree::Classification.left_joins(:product).where(spree_products: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_products_taxons, :spree_products, column: :product_id
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_products_taxons => :spree_products.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned classifications (no corresponding taxon)" do
+    #   Spree::Classification.left_joins(:taxon).where(spree_taxons: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_products_taxons, :spree_taxons, column: :taxon_id
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_products_taxons => :spree_taxons.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+  end
+
+  def down
+    remove_foreign_key :spree_products_taxons, :spree_products, column: :product_id
+    remove_foreign_key :spree_products_taxons, :spree_taxons, column: :taxon_id
+  end
+end

data/db/migrate/20250605105424_add_shipping_category_foreign_keys.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+class AddShippingCategoryForeignKeys < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def change
+    # Uncomment the following code to remove orphaned records if the following code fails
+    #
+    # say_with_time "Removing orphaned products (no corresponding shipping category)" do
+    #   Spree::Product.left_joins(:shipping_category).where(spree_shipping_category: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_products, :spree_shipping_categories, column: :shipping_category_id, null: false
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_products => :spree_shipping_categories.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+
+    # Uncomment the following code to remove orphaned records if the following code fails
+    #
+    # say_with_time "Removing orphaned shipping method categories (no corresponding shipping category)" do
+    #   Spree::ShippingMethodCategory.left_joins(:shipping_category).where(spree_shipping_category: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_shipping_method_categories, :spree_shipping_methods, column: :shipping_method_id, null: false
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_shipping_method_categories => :spree_shipping_methods.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+
+    # Uncomment the following code to remove orphaned records if the following code fails
+    #
+    # say_with_time "Removing orphaned shipping method categories (no corresponding shipping method)" do
+    #   Spree::ShippingMethodCategory.left_joins(:shipping_method).where(spree_shipping_method: { id: nil }).delete_all
+    # end
+    begin
+      add_foreign_key :spree_shipping_method_categories, :spree_shipping_categories, column: :shipping_category_id, null: false
+    rescue ActiveRecord::StatementInvalid => e
+      if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+        say <<~MSG
+          ⚠️ Foreign key constraint failed when adding :spree_shipping_method_categories => :spree_shipping_categories.
+          To fix this:
+            1. Uncomment the code that removes orphaned records.
+            2. Rerun the migration.
+          Offending error: #{e.cause.class} - #{e.cause.message}
+        MSG
+      end
+      raise
+    end
+  end
+
+  def down
+    remove_foreign_key :spree_products, :spree_shipping_categories, column: :shipping_category_id, null: false
+    remove_foreign_key :spree_shipping_method_categories, :spree_shipping_methods, column: :shipping_method_id, null: false
+    remove_foreign_key :spree_shipping_method_categories, :spree_shipping_categories, column: :shipping_category_id, null: false
+  end
+end

data/db/migrate/20250626112117_add_foreign_key_to_spree_role_users.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class AddForeignKeyToSpreeRoleUsers < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing orphaned roles/user join records (no corresponding role)" do
+    #   Spree::RoleUser.left_joins(:role).where(spree_roles: { id: nil }).delete_all
+    # end
+
+    add_foreign_key :spree_roles_users, :spree_roles, column: :role_id, null: false
+  rescue ActiveRecord::StatementInvalid => e
+    if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+      say <<~MSG
+        ⚠️ Foreign key constraint failed when adding :spree_roles_users => :spree_roles.
+        To fix this:
+          1. Uncomment the code that removes orphaned records.
+          2. Rerun the migration.
+        Offending error: #{e.cause.class} - #{e.cause.message}
+      MSG
+    end
+    raise
+  end
+
+  def down
+    remove_foreign_key :spree_roles_users, :spree_roles, column: :role_id, null: false
+  end
+end

data/db/migrate/20250628094037_change_countries_iso_to_unique.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class ChangeCountriesIsoToUnique < ActiveRecord::Migration[7.0]
+  def change
+    remove_index :spree_countries, :iso
+
+    add_index :spree_countries, :iso, unique: true
+  end
+end

data/db/migrate/20250708120317_add_adjustment_reason_foreign_keys.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class AddAdjustmentReasonForeignKeys < ActiveRecord::Migration[7.0]
+  FOREIGN_KEY_VIOLATION_ERRORS = %w[PG::ForeignKeyViolation Mysql2::Error SQLite3::ConstraintException]
+
+  def up
+    # Uncomment the following code to remove orphaned records if this migration fails
+    #
+    # say_with_time "Removing invalid adjustment reason IDs from adjustments table" do
+    #   Spree::Adjustment.where.not(adjustment_reason_id: nil).left_joins(:adjustment_reason).where(spree_adjustment_reasons: { id: nil }).update_all(adjustment_reason_id: nil)
+    # end
+
+    add_foreign_key :spree_adjustments, :spree_adjustment_reasons, column: :adjustment_reason_id, null: true, on_delete: :restrict
+  rescue ActiveRecord::StatementInvalid => e
+    if e.cause.class.name.in?(FOREIGN_KEY_VIOLATION_ERRORS)
+      say <<~MSG
+        ⚠️ Foreign key constraint failed when adding :spree_adjustments => :spree_adjustment_reasons.
+        To fix this:
+          1. Uncomment the code that removes invalid adjustment reason IDs from the spree_adjustments table.
+          2. Rerun the migration.
+        Offending error: #{e.cause.class} - #{e.cause.message}
+      MSG
+    end
+    raise
+  end
+
+  def down
+    remove_foreign_key :spree_adjustments, :spree_adjustment_reasons, column: :adjustment_reason_id, null: true, on_delete: :restrict
+  end
+end