spree_google_products 1.0

data/app/views/spree/admin/products/google_shopping.html.erb

@@ -0,0 +1,63 @@
+<%= render 'spree/admin/shared/product_tabs', current: :google_shopping %>
+
+<% content_for :page_title do %>
+  Google Shopping Attributes
+<% end %>
+
+<%= form_for [:admin, @product], url: admin_product_path(@product), method: :put do |f| %>
+  <div class="card mb-3">
+    <div class="card-header">
+      <h5 class="card-title mb-0">Basic Information</h5>
+    </div>
+    <div class="card-body">
+      <%= f.fields_for :google_product_attribute do |g| %>
+        
+        <div class="form-group">
+          <%= g.label :brand, "Brand Name" %>
+          <%= g.text_field :brand, class: 'form-control' %>
+        </div>
+
+        <div class="row">
+          <div class="col-6">
+            <div class="form-group">
+              <%= g.label :gtin, "GTIN / UPC / EAN" %>
+              <%= g.text_field :gtin, class: 'form-control' %>
+              <small class="form-text text-muted">Leave empty if custom product.</small>
+            </div>
+          </div>
+          <div class="col-6">
+             <div class="form-group">
+              <%= g.label :mpn, "MPN (Manufacturer Part Number)" %>
+              <%= g.text_field :mpn, class: 'form-control' %>
+            </div>
+          </div>
+        </div>
+        
+        <div class="row">
+          <div class="col-4">
+             <div class="form-group">
+              <%= g.label :condition %>
+              <%= g.select :condition, ['new', 'refurbished', 'used'], {}, class: 'select2' %>
+            </div>
+          </div>
+          <div class="col-4">
+             <div class="form-group">
+              <%= g.label :gender %>
+              <%= g.select :gender, ['', 'male', 'female', 'unisex'], {}, class: 'select2' %>
+            </div>
+          </div>
+           <div class="col-4">
+             <div class="form-group">
+              <%= g.label :age_group %>
+              <%= g.select :age_group, ['', 'adult', 'kids', 'toddler', 'infant'], {}, class: 'select2' %>
+            </div>
+          </div>
+        end %>
+      <% end %>
+    </div>
+  </div>
+  
+  <div class="form-actions" data-hook="buttons">
+    <%= render partial: 'spree/admin/shared/edit_resource_links' %>
+  </div>
+<% end %>

data/app/views/spree_google_products/_head.html.erb

@@ -0,0 +1 @@
+<%= javascript_import_module_tag 'application-spree-google-products' %>

data/config/importmap.rb

@@ -0,0 +1,6 @@
+pin 'application-spree-google-products', to: 'spree_google_products/application.js', preload: false
+
+pin_all_from SpreeGoogleProducts::Engine.root.join('app/javascript/spree_google_products/controllers'),
+             under: 'spree_google_products/controllers',
+             to:    'spree_google_products/controllers',
+             preload: 'application-spree-google-products'

data/config/initializers/assets.rb

@@ -0,0 +1,8 @@
+# Only run this if Sprockets is loaded (Spree 4.x / 5.0)
+if Rails.configuration.respond_to?(:assets) && defined?(Sprockets)
+    Rails.application.config.assets.precompile += %w[
+    app_icons/welcome_scene.svg
+    app_icons/google_logo.svg
+    app_icons/google_merchant_logo.svg
+  ]
+  end

data/config/initializers/force_encryption_keys.rb

@@ -0,0 +1,24 @@
+if Rails.env.development? || Rails.env.test?
+    env_file = Rails.root.join('.env')
+    
+    if File.exist?(env_file)
+      File.foreach(env_file) do |line|
+        next if line.strip.start_with?('#') || line.strip.empty?
+        key, value = line.strip.split('=', 2)
+        if key && value
+          ENV[key] = value
+        end
+      end
+    end
+    
+    if ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY'].present?
+      ActiveRecord::Encryption.configure(
+        primary_key: ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY'],
+        deterministic_key: ENV['ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY'],
+        key_derivation_salt: ENV['ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT']
+      )
+      puts "🔐 Active Record Encryption Keys Loaded Successfully via Initializer."
+    else
+      puts "⚠️  WARNING: Active Record Encryption Keys are MISSING in .env"
+    end
+  end

data/config/initializers/spree.rb

@@ -0,0 +1,32 @@
+# Uncomment lines below to add your own custom business logic
+# such as promotions, shipping methods, etc.
+Rails.application.config.after_initialize do
+  # Spree.shipping_methods << Spree::ShippingMethods::SuperExpensiveNotVeryFastShipping
+  # Spree.payment_methods << Spree::PaymentMethods::VerySafeAndReliablePaymentMethod
+
+  # Spree.calculators.tax_rates << Spree::TaxRates::FinanceTeamForcedMeToCodeThis
+
+  # Spree.stock_splitters << Spree::Stock::Splitters::SecretLogicSplitter
+
+  # Spree.adjusters << Spree::Adjustable::Adjuster::TaxTheRich
+
+  # Custom promotions
+  # Spree.calculators.promotion_actions_create_adjustments << Spree::Calculators::PromotionActions::CreateAdjustments::AddDiscountForFriends
+  # Spree.calculators.promotion_actions_create_item_adjustments << Spree::Calculators::PromotionActions::CreateItemAdjustments::FinanceTeamForcedMeToCodeThis
+  # Spree.promotions.rules << Spree::Promotions::Rules::OnlyForVIPCustomers
+  # Spree.promotions.actions << Spree::Promotions::Actions::GiftWithPurchase
+
+  # Spree.taxon_rules << Spree::TaxonRules::ProductsWithColor
+
+  # Spree.exports << Spree::Exports::Payments
+  # Spree.reports << Spree::Reports::MassivelyOvercomplexReportForCfo
+
+  # Themes and page builder
+  # Spree.page_builder.themes << Spree::Themes::NewShinyTheme
+  # Spree.page_builder.theme_layout_sections << Spree::PageSections::SuperImportantCeoBio
+  # Spree.page_builder.page_sections << Spree::PageSections::ContactFormToGetInTouch
+  # Spree.page_builder.page_blocks << Spree::PageBlocks::BigRedButtonToCallSales
+
+  # Storefront partials
+  Spree.storefront.partials.head << 'spree_google_products/head'
+end

data/config/initializers/spree_google_products.rb

@@ -0,0 +1,29 @@
+Rails.application.config.after_initialize do
+    if Spree.respond_to?(:admin) && Spree.admin.respond_to?(:navigation)
+      sidebar = Spree.admin.navigation.sidebar
+      sidebar.add :google_shopping, 
+        label: 'Google Shopping', 
+        icon: 'brand-google', 
+        url: :admin_google_shopping_dashboard_path, 
+        position: 85
+      sidebar.add :google_dashboard, 
+        parent: :google_shopping, 
+        label: 'Dashboard', 
+        url: :admin_google_shopping_dashboard_path, 
+        active: -> { params[:controller].include?('google_shopping/dashboard') }
+      sidebar.add :google_products, 
+        parent: :google_shopping, 
+        label: 'Products', 
+        url: :admin_google_shopping_products_path, 
+        active: -> { params[:controller].include?('google_shopping/products') }
+      sidebar.add :google_settings, 
+        parent: :google_shopping, 
+        label: :settings, 
+        url: :edit_admin_google_merchant_settings_path, 
+        active: -> { controller_name == 'google_merchant_settings' }
+    end
+    
+    if defined?(Spree::Ability) && defined?(SpreeGoogleProducts::Ability)
+      Spree::Ability.register_ability(SpreeGoogleProducts::Ability)
+    end
+  end

data/config/locales/en.yml

@@ -0,0 +1,35 @@
+en:
+  spree:
+    # --- Page Titles & Headers ---
+    google_merchant_settings: "Google Merchant Settings"
+    google_shopping_settings: "Google Shopping Settings"
+    google_merchant: "Merchant Center"
+    google_merchant_products: "Google Products"
+    google_data_quality_issues: "Data Quality Issues"
+    google_shopping: "Google Shopping"
+
+    # --- Navigation & Tabs ---
+    admin:
+      tab:
+        google_shopping: "Google Shopping"
+      
+    # --- Sidebar Menu ---
+    google_dashboard: "Dashboard"
+    google_products: "Products"
+    # 'settings' is already provided by Spree core
+
+    # --- Actions & Flash Messages ---
+    connect_merchant_center: "Connect Merchant Center"
+    sync_now: "Sync Now"
+    sync_all_products: "Sync All Products"
+    view_issues: "View Issues"
+    view_fixes: "View Fixes"
+    
+    # --- Status Labels ---
+    # Used in Dashboard and Product Lists
+    google_status:
+      active: "Active"
+      pending: "Pending"
+      disapproved: "Disapproved"
+      limited: "Limited"
+      not_synced: "Not Synced"

data/config/routes.rb

@@ -0,0 +1,33 @@
+Spree::Core::Engine.add_routes do
+  namespace :admin do
+    # Dashboard
+    namespace :google_shopping do
+      get 'dashboard', to: 'dashboard#index', as: :dashboard
+      resources :issues, only: [:index]
+      post 'sync', to: 'dashboard#sync', as: :sync
+      
+      # Dedicated Product Manager
+      resources :products, only: [:index, :edit, :update] do
+        member do
+          post :sync_one
+          get :issues
+        end
+      end
+
+      # Taxonomy Search
+      resources :taxons, only: [] do
+        collection do
+          get :drill_down
+        end
+      end
+    end
+
+    # Settings Routes
+    resource :google_merchant_settings, only: [:edit, :update] do
+      get :connect
+      get :callback
+      delete :disconnect
+      post :sync_now
+    end
+  end
+end

data/db/migrate/20260112000000_add_spree_google_shopping_tables.rb

@@ -0,0 +1,89 @@
+class AddSpreeGoogleShoppingTables < ActiveRecord::Migration[7.0]
+    def change
+      create_table :spree_google_credentials do |t|
+        t.references :store, null: false, index: true
+        
+        # Auth & Security
+        t.string :merchant_center_id
+        t.string :ad_account_id
+        t.text   :access_token
+        t.text   :refresh_token
+        t.string :scope
+        t.string :email
+        t.datetime :token_expires_at
+        t.datetime :last_sync_at
+        
+        # Targeting Configuration
+        t.string :target_country, default: 'US'
+        t.string :target_currency, default: 'USD'
+        
+        # Global Defaults
+        t.string  :default_google_product_category
+        t.string  :default_product_type
+        t.integer :default_min_handling_time
+        t.integer :default_max_handling_time
+        
+        t.timestamps
+      end
+
+      create_table :spree_google_product_attributes do |t|
+        t.references :product, null: false, index: true
+        
+        # Core Attributes
+        t.string :brand
+        t.string :gtin
+        t.string :mpn
+        t.boolean :identifier_exists, default: true
+        
+        # Categorization
+        t.string :google_product_category
+        t.string :product_type
+        
+        # Demographics
+        t.string :condition, default: 'new'
+        t.string :gender
+        t.string :age_group
+        t.string :color
+        t.string :size
+        t.string :material
+        
+        # Status & Feedback
+        t.string :google_status
+        t.text   :google_issues
+        
+        # Extra Data
+        t.string :custom_label_0
+        
+        # Sale Logic
+        t.datetime :sale_start_at
+        t.datetime :sale_end_at
+        
+        # Shipping Overrides
+        t.integer :min_handling_time
+        t.integer :max_handling_time
+  
+        t.timestamps
+      end
+  
+      create_table :spree_google_variant_attributes do |t|
+        t.references :variant, null: false, index: true
+        
+        # Identification Overrides
+        t.string :gtin
+        t.string :mpn
+        
+        # Status Syncing
+        t.string :google_status, index: true
+        t.text   :google_issues
+        t.datetime :last_synced_at
+        
+        t.timestamps
+      end
+  
+      create_table :spree_google_taxons do |t|
+        t.string :name, index: true
+        t.string :google_id, index: true
+      end
+  
+    end
+  end

data/lib/generators/spree_google_products/install/install_generator.rb

@@ -0,0 +1,84 @@
+require 'securerandom'
+
+module SpreeGoogleProducts
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      class_option :auto_run_migrations, type: :boolean, default: false
+
+      def add_migrations
+        run 'bundle exec rake railties:install:migrations FROM=spree_google_products'
+      end
+
+      def create_initializer
+        initializer_content = <<~RUBY
+          if Rails.env.development? || Rails.env.test?
+            env_file = Rails.root.join('.env')
+            
+            if File.exist?(env_file)
+              File.foreach(env_file) do |line|
+                next if line.strip.start_with?('#') || line.strip.empty?
+                key, value = line.strip.split('=', 2)
+                ENV[key] = value if key && value
+              end
+            end
+          
+            if ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY'].present?
+              ActiveRecord::Encryption.configure(
+                primary_key: ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY'],
+                deterministic_key: ENV['ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY'],
+                key_derivation_salt: ENV['ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT']
+              )
+            end
+          end
+        RUBY
+
+        create_file "config/initializers/force_encryption_keys.rb", initializer_content
+      end
+
+      def setup_encryption_keys
+        return unless Rails.env.development? || Rails.env.test?
+        env_file = File.join(Rails.root, '.env')
+        create_file '.env' unless File.exist?(env_file)
+        current_content = File.read(env_file)
+        keys_to_add = []
+        
+        {
+          "ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY" => SecureRandom.alphanumeric(32),
+          "ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY" => SecureRandom.alphanumeric(32),
+          "ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT" => SecureRandom.alphanumeric(32)
+        }.each do |key_name, value|
+          unless current_content.include?(key_name)
+            keys_to_add << "#{key_name}=#{value}"
+          end
+        end
+
+        if keys_to_add.any?
+          append_to_file '.env', "\n# --- Added by Spree Google Shopping Installer ---\n#{keys_to_add.join("\n")}\n"
+          puts "🔑 Added missing Active Record Encryption keys to .env"
+        else
+          puts "✅ Active Record Encryption keys already present."
+        end
+      end
+
+      def run_migrations
+        run_migrations = options[:auto_run_migrations] || ['', 'y', 'Y'].include?(ask('Would you like to run the migrations now? [Y/n]'))
+        if run_migrations
+          run 'bundle exec rails db:migrate'
+        else
+          puts 'Skipping rails db:migrate, don\'t forget to run it!'
+        end
+      end
+
+      def run_seeds
+        run_seeds = options[:auto_run_migrations] || ['', 'y', 'Y'].include?(ask('Would you like to download and seed Google Taxonomies now? (Recommended) [Y/n]'))
+        if run_seeds
+          run 'bundle exec rake spree_google_shopping:seed_taxons'
+        else
+          puts 'Skipping seed. You can run it later with: bundle exec rake spree_google_shopping:seed_taxons'
+        end
+      end
+    end
+  end
+end

data/lib/generators/spree_google_products/uninstall/uninstall_generator.rb

@@ -0,0 +1,55 @@
+module SpreeGoogleProducts
+  module Generators
+    class UninstallGenerator < Rails::Generators::Base
+      
+      def drop_tables
+        return unless yes?("WARNING: This will destroy all Google Shopping data (Credentials, Product Settings, Taxonomies). Are you sure? [y/N]")
+
+        tables = %w[spree_google_credentials spree_google_product_attributes spree_google_variant_attributes spree_google_taxons]
+
+        tables.each do |table|
+          if ActiveRecord::Base.connection.table_exists?(table)
+            ActiveRecord::Base.connection.drop_table(table, force: :cascade)
+            puts "🔥 Dropped table: #{table}"
+          else
+            puts "   Table #{table} does not exist, skipping."
+          end
+        end
+      end
+
+      def remove_migrations
+        migration_files = Dir.glob("db/migrate/*add_spree_google_shopping_tables.spree_google_products.rb")
+        migration_files += Dir.glob("db/migrate/*spree_google_products.rb")
+
+        if migration_files.any?
+          migration_files.uniq.each do |file|
+            version = File.basename(file).split('_').first
+            if version.match?(/^\d+$/)
+              ActiveRecord::Base.connection.execute("DELETE FROM schema_migrations WHERE version = '#{version}'")
+              puts "🧹 Removed version #{version} from schema_migrations."
+            end
+
+            remove_file file
+          end
+        else
+          puts "⚠️  No specific migration files found to remove."
+        end
+      end
+
+      def remove_initializer
+        remove_file "config/initializers/force_encryption_keys.rb"
+      end
+
+      def clean_env_reminder
+        puts "\n"
+        puts "⚠️  IMPORTANT: We did not remove the Encryption Keys from your .env file."
+        puts "   If you are not using them for other plugins, please manually remove:"
+        puts "   - ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY"
+        puts "   - ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY"
+        puts "   - ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT"
+        puts "\n"
+        puts "✅ Spree Google Products has been uninstalled."
+      end
+    end
+  end
+end

data/lib/spree_google_products/configuration.rb

@@ -0,0 +1,13 @@
+module SpreeGoogleProducts
+  class Configuration < Spree::Preferences::Configuration
+
+   # Some example preferences are shown below, for more information visit:
+   # https://docs.spreecommerce.org/developer/contributing/creating-an-extension
+
+   # preference :enabled, :boolean, default: true
+   # preference :dark_chocolate, :boolean, default: true
+   # preference :color, :string, default: 'Red'
+   # preference :favorite_number, :integer
+   # preference :supported_locales, :array, default: [:en]
+  end
+end

data/lib/spree_google_products/engine.rb

@@ -0,0 +1,37 @@
+module SpreeGoogleProducts
+  class Engine < Rails::Engine
+    require 'spree/core'
+    isolate_namespace Spree
+    engine_name 'spree_google_products'
+
+    # use rspec for tests
+    config.generators do |g|
+      g.test_framework :rspec
+    end
+
+    initializer 'spree_google_products.environment', before: :load_config_initializers do |_app|
+      SpreeGoogleProducts::Config = SpreeGoogleProducts::Configuration.new
+    end
+
+    initializer 'spree_google_products.assets' do |app|
+      app.config.assets.paths << root.join('app/javascript')
+      app.config.assets.paths << root.join('vendor/javascript')
+      app.config.assets.paths << root.join('vendor/stylesheets')
+      app.config.assets.precompile += %w[spree_google_products_manifest]
+    end
+
+    initializer 'spree_google_products.importmap', before: 'importmap' do |app|
+      app.config.importmap.paths << root.join('config/importmap.rb')
+      # https://github.com/rails/importmap-rails?tab=readme-ov-file#sweeping-the-cache-in-development-and-test
+      app.config.importmap.cache_sweepers << root.join('app/javascript')
+    end
+
+    def self.activate
+      Dir.glob(File.join(File.dirname(__FILE__), '../../app/**/*_decorator*.rb')) do |c|
+        Rails.configuration.cache_classes ? require(c) : load(c)
+      end
+    end
+
+    config.to_prepare(&method(:activate).to_proc)
+  end
+end

data/lib/spree_google_products/factories.rb

@@ -0,0 +1,6 @@
+FactoryBot.define do
+  # Define your Spree extensions Factories within this file to enable applications, and other extensions to use and override them.
+  #
+  # Example adding this to your spec_helper will load these Factories for use:
+  # require 'spree_google_products/factories'
+end

data/lib/spree_google_products/version.rb

@@ -0,0 +1,7 @@
+module SpreeGoogleProducts
+  VERSION = '1.0'.freeze
+
+  def gem_version
+    Gem::Version.new(VERSION)
+  end
+end

data/lib/spree_google_products.rb

@@ -0,0 +1,13 @@
+require 'spree_core'
+require 'spree_extension'
+require 'spree_google_products/engine'
+require 'spree_google_products/version'
+require 'spree_google_products/configuration'
+
+module SpreeGoogleProducts
+  mattr_accessor :queue
+
+  def self.queue
+    @@queue ||= (defined?(Spree.queues) ? Spree.queues.default : :default)
+  end
+end

data/lib/tasks/spree_google_products.rake

@@ -0,0 +1,41 @@
+namespace :spree_google_shopping do
+  desc "Download and import official Google Taxonomy"
+  task seed_taxons: :environment do
+    require 'open-uri'
+
+    url = "https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt"
+    puts "⬇️  Downloading Google Taxonomy from: #{url}..."
+
+    ActiveRecord::Base.transaction do
+      Spree::GoogleTaxon.delete_all
+      
+      count = 0
+      data = []
+      
+      URI.open(url) do |file|
+        file.each_line do |line|
+          next if line.start_with?('#') || line.strip.empty?
+          
+          parts = line.strip.split(' - ', 2)
+          
+          if parts.length == 2
+            data << { 
+              google_id: parts[0], 
+              name: parts[1]
+            }
+            count += 1
+          end
+
+          if data.size >= 1000
+            Spree::GoogleTaxon.insert_all(data)
+            print "."
+            data = []
+          end
+        end
+      end
+      
+      Spree::GoogleTaxon.insert_all(data) if data.any?
+      puts "\n✅ Successfully seeded #{count} Google Taxons!"
+    end
+  end
+end