spree_google_products 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f5d3d6b3ccd94d66bee77b1760f4b1a6943b942a329c85dbc8b9f0750540e53a
+  data.tar.gz: eb9538793bd6233441a77c8892de2a43c5da94960697e7fd9ad6fe426953976e
+SHA512:
+  metadata.gz: a7656f0f6f6ce4f5645a8a315cf2fcc035be97a912c576c4b973a7d504723853665c4aae3d62c1968461654af36472ba911a23b6afe037b29572edcd16d42a12
+  data.tar.gz: 11ad2e4b1590638d8c14fcdec637fa2b6bafdd8fb3907d58c45c653162fa8dd38bfd9229075e521da91120ba3dc28aa5b5b399468bedac35181a5c27fc733dde

data/README.md

@@ -0,0 +1,177 @@
+# Spree Google Shopping (Merchant Center)<br>
+
+![logo_light_mc2](https://github.com/user-attachments/assets/8eecad8c-107d-46a5-8e62-4e061286f251)
+
+<br>
+A production-grade Spree Commerce extension that integrates directly with Google Merchant Center. Automatically sync products, variants, inventory, and pricing in real-time using the Content API v2.1
+
+<br>
+Includes a full Admin Dashboard for tracking approval status, fixing data quality issues, and managing OAuth connections securely.
+
+<br>
+
+## 🚀 Key Features
+1. Real-Time Sync: Products are pushed to Google immediately upon update/create via background jobs.<br>
+2. OAuth 2.0 Integration: Secure, token-based authentication (No static JSON key files required).<br>
+3. Admin Dashboard: Live visualization of Approved, Pending, and Disapproved products.<br>
+4. Data Quality Issues: View specific error messages from Google (e.g., "Missing GTIN", "Image too small") directly in Spree.<br>
+5. Granular Control:<br>
+  • Set Global Defaults (Target Country, Currency, Shipping Rules).<br>
+  • Override attributes per Product (Brand, MPN, GTIN, Gender, Age Group).
+6. Drill-Down Taxonomy: Built-in selector for Google's official Product Taxonomy (6,000+ categories).
+7. Secure: Uses Rails 7 Active Record Encryption to store OAuth tokens safely.
+
+<br>
+
+## 📦 Installation
+1. Add this line to your application's Gemfile:
+```ruby
+gem 'spree_google_products', github: 'your-username/spree_google_products'
+```
+
+2. Install the gem:
+```ruby
+bundle install
+```
+
+3. Run the Installer:
+This command will copy migrations, generate encryption keys, and seed the Google Taxonomy database.
+```bash
+bundle exec rails g spree_google_products:install
+```
+
+Follow the on-screen prompts to run migrations and seed data.
+
+<br>
+
+## ⚙️ Configuration
+### Google Cloud Console Setup<br>
+Before using the extension, you must create credentials in Google Cloud.<br>
+1. Go to [Google Cloud Console.](https://console.cloud.google.com/)<br>
+2. Create a new project (or select existing).<br>
+3. Enable API: Go to "APIs & Services" > "Library" -> Search for "Content API for Shopping" -> Enable it.<br>
+4. Create Credentials:<br>
+
+   • Go to "APIs & Services" > "Credentials".<br>
+
+   • Click Create Credentials -> OAuth Client ID.<br>
+
+   • Application Type: Web Application.<br>
+
+   • Authorized Redirect URI: https://your-store.com/admin/google_merchant_settings/callback<br>
+(Note: Use http://localhost:3000/... for local development).<br>
+5. Copy the Client ID and Client Secret.<br>
+<br>
+<img width="900" height="auto" alt="Screenshot 2026-01-11 at 11 58 54 PM" src="https://github.com/user-attachments/assets/bff8a7cc-050d-4fa1-9bfe-190719ae984a" />
+<br>
+
+### Environment Variables<br>
+The installer automatically adds these to your .env file. Fill in your Google credentials:<br>
+
+```bash
+GOOGLE_CLIENT_ID=your_client_id_here
+GOOGLE_CLIENT_SECRET=your_client_secret_here
+```
+
+<br>
+
+### Connect in Spree Admin
+1. Login to your Spree Admin Panel.
+2. Navigate to Google Shopping > Settings (Sidebar).
+3. Click Connect Account and log in with the Google Account that manages your Merchant Center.
+4. Once connected, enter your Merchant Center ID and Target Country/Currency.
+5. Click Save Settings.
+<br>
+<img width="900" height="auto" alt="Screenshot 2026-01-11 at 11 59 17 PM" src="https://github.com/user-attachments/assets/fea6f8c2-dd1e-443c-8906-dd61869b8226" />
+<br>
+
+## 🛠️ Usage
+
+### Dashboard
+Visit Google Shopping > Dashboard to see a live overview of your product feed health.
+• Approved: Live on Google Shopping.
+
+• Limited: Live but restricted (e.g., adult content, partial regions).
+
+• Disapproved: Critical issues preventing display.
+
+• Sync Now: Force a full catalog sync manually.
+
+<img width="900" height="auto" alt="Screenshot 2026-01-12 at 12 43 34 AM" src="https://github.com/user-attachments/assets/b53174b2-37ee-42ea-9526-00630b46c60e" />
+
+<br>
+
+
+### Managing Products
+You can manage Google-specific attributes in the Product Edit tab under "Google Shopping Attributes".
+• GTIN / MPN: Crucial for approval. If your products have barcodes, enter them here.
+
+• Google Category: Use the drill-down selector to pick the exact Google Taxonomy ID.
+
+• Demographics: Set Gender, Age Group, and Condition (New/Used).
+
+<br>
+<img width="900" height="auto" alt="Screenshot 2026-01-12 at 12 51 02 AM" src="https://github.com/user-attachments/assets/37c064cf-d794-42bb-90eb-3ade6ec2bbab" />
+<img width="900" height="auto" alt="Screenshot 2026-01-12 at 12 32 11 AM" src="https://github.com/user-attachments/assets/aee1955d-481f-47d3-a15f-c7a4670f9e78" />
+<img width="871" height="456" alt="Screenshot 2026-01-12 at 12 39 32 AM" src="https://github.com/user-attachments/assets/2a509733-2151-48c0-8b63-2d3db654b797" />
+
+<br>
+
+### Background Jobs
+This extension uses ActiveJob. Ensure you have a queue adapter configured (Sidekiq, Solid Queue, or Delayed Job) for production.<br>
+• Spree::GoogleShopping::SyncProductJob: Syncs individual product updates.<br>
+• Spree::GoogleShopping::SyncAllJob: Bulk syncs entire catalog.<br>
+• Spree::GoogleShopping::FetchStatusJob: Pulls approval status from Google.<br>
+
+<br>
+
+## 🔒 Security & Encryption
+This plugin strictly adheres to security best practices. OAuth Refresh Tokens are encrypted at rest in the database using Rails Active Record Encryption.<br>
+
+The installer generates these keys in your .env file automatically:
+
+ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY<br>
+ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY<br>
+ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT<br>
+
+<br>
+
+### ⚠️ IMPORTANT: Keep these keys safe. If you lose them, you will need to disconnect and reconnect your Google Account.
+
+<br>
+
+## 🗑️ Uninstallation
+To cleanly remove the extension, drop tables, and cleanup migrations, run:
+
+```bash
+bundle exec rails g spree_google_products:uninstall
+```
+
+This command will ask for confirmation before dropping the Google-related tables.
+
+<br>
+
+## 🗺️ Roadmap
+• [x] Google Merchant Center (Content API) Sync<br>
+• [x] Product Approval Status Dashboard<br>
+• [x] Issue Reporting<br>
+• [ ] Google Ads Integration: Create Performance Max campaigns directly from Spree.<br>
+• [ ] Conversion Tracking: Auto-inject Google Ads conversion pixels.<br>
+• [ ] Free Listings: specialized support for "Free Listings" enhanced attributes.<br>
+
+<br>
+
+## ❓ FAQ
+Q: I get "Missing Active Record encryption credential" error.
+A: Restart your server. The encryption keys are loaded from .env on boot. If using a custom deployment, ensure the ACTIVE_RECORD_ENCRYPTION_* variables are set in your environment.
+
+Q: Why are my products still "Pending" after syncing?
+A: Google takes 3-5 business days to review new products. Check the Dashboard for real-time status updates.
+
+Q: Can I sync to multiple countries?
+A: Currently, the extension supports one primary Target Country per store. Multi-country feeds via the "Shipping" attribute are planned for v2.0.
+
+<br>
+
+### License
+Copyright (c) 2026. Released under the BSD-3-Clause [License](https://github.com/umeshravani/spree_google_products/blob/main/LICENSE.md).

data/Rakefile

@@ -0,0 +1,21 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+require 'spree/testing_support/extension_rake'
+
+RSpec::Core::RakeTask.new
+
+task :default do
+  if Dir['spec/dummy'].empty?
+    Rake::Task[:test_app].invoke
+    Dir.chdir('../../')
+  end
+  Rake::Task[:spec].invoke
+end
+
+desc 'Generates a dummy app for testing'
+task :test_app do
+  ENV['LIB_NAME'] = 'spree_google_products'
+  Rake::Task['extension:test_app'].invoke
+end

data/app/assets/config/spree_google_products_manifest.js

@@ -0,0 +1,5 @@
+//= link_tree ../images
+//= link spree_google_products/application.js
+//= link_tree ../../javascript/spree_google_products/controllers .js
+//= link_tree ../../../vendor/javascript .js
+//= link_tree ../../../vendor/stylesheets .css

data/app/assets/images/app_icons/google_logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24" width="24"><path d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z" fill="#4285F4"/><path d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z" fill="#34A853"/><path d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z" fill="#FBBC05"/><path d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z" fill="#EA4335"/><path d="M1 1h22v22H1z" fill="none"/></svg>

data/app/assets/images/app_icons/google_merchant_logo.svg

@@ -0,0 +1,52 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <mask id="mask0_2_319" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="3" y="3" width="30" height="30">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.25H6C4.7625 32.25 3.75 31.2375 3.75 30V6C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.25Z" fill="white"/>
+  </mask>
+  <g mask="url(#mask0_2_319)">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M3.75 32.25V3.75H32.25V32.25H3.75ZM22.1869 9V8.99625C22.7794 8.96438 23.25 8.48063 23.25 7.8825C23.25 7.28437 22.7794 6.79875 22.1869 6.76688V6.76312H19.4981C19.4981 6.75938 19.4986 6.75563 19.4991 6.75188C19.4995 6.74813 19.5 6.74437 19.5 6.74062C19.5 5.9175 18.8287 5.25 18 5.25C17.1713 5.25 16.5 5.9175 16.5 6.74062C16.5 6.74437 16.5005 6.74813 16.5009 6.75188C16.5014 6.75563 16.5019 6.75938 16.5019 6.76312H13.8131V6.76688C13.2206 6.80063 12.75 7.28625 12.75 7.8825C12.75 8.47875 13.2206 8.96438 13.8131 8.99625V9H22.1869Z" fill="#4285F4"/>
+  </g>
+  <mask id="mask1_2_319" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="3" y="3" width="30" height="30">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.25H6C4.7625 32.25 3.75 31.2375 3.75 30V6C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.25Z" fill="white"/>
+  </mask>
+  <g mask="url(#mask1_2_319)">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 3.75H6C4.7625 3.75 3.75 4.7625 3.75 6V6.1875C3.75 4.95 4.7625 3.9375 6 3.9375H30C31.2375 3.9375 32.25 4.95 32.25 6.1875V6C32.25 4.7625 31.2375 3.75 30 3.75Z" fill="white" fill-opacity="0.2"/>
+  </g>
+  <mask id="mask2_2_319" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="3" y="3" width="30" height="30">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.25H6C4.7625 32.25 3.75 31.2375 3.75 30V6C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.25Z" fill="white"/>
+  </mask>
+  <g mask="url(#mask2_2_319)">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M3.75 10.5V3.75H32.25V10.5H3.75ZM22.1869 9V8.99625C22.7794 8.96438 23.25 8.48063 23.25 7.8825C23.25 7.28437 22.7794 6.79875 22.1869 6.76688V6.76312H19.4981C19.4981 6.75938 19.4986 6.75563 19.4991 6.75188C19.4995 6.74813 19.5 6.74437 19.5 6.74062C19.5 5.9175 18.8287 5.25 18 5.25C17.1713 5.25 16.5 5.9175 16.5 6.74062C16.5 6.74437 16.5005 6.74813 16.5009 6.75188C16.5014 6.75563 16.5019 6.75938 16.5019 6.76312H13.8131V6.76688C13.2206 6.80063 12.75 7.28625 12.75 7.8825C12.75 8.47875 13.2206 8.96438 13.8131 8.99625V9H22.1869Z" fill="#3F51B5"/>
+  </g>
+  <mask id="mask3_2_319" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="3" y="3" width="30" height="30">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.25H6C4.7625 32.25 3.75 31.2375 3.75 30V6C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.25Z" fill="white"/>
+  </mask>
+  <g mask="url(#mask3_2_319)">
+    <path opacity="0.2" fill-rule="evenodd" clip-rule="evenodd" d="M22.1868 9.00937V9.01312H13.8131V9.00937C13.2525 8.97937 12.8006 8.53875 12.7556 7.98187C12.7537 8.01375 12.7518 8.04375 12.7518 8.07562C12.7518 8.67562 13.2225 9.165 13.815 9.19687V9.20062H22.1906V9.19687C22.7831 9.165 23.2537 8.67562 23.2537 8.07562C23.2537 8.04375 23.2518 8.01375 23.25 7.98187C23.1993 8.53687 22.7475 8.9775 22.1868 9.00937Z" fill="white"/>
+  </g>
+  <mask id="mask4_2_319" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="3" y="3" width="30" height="30">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.25H6C4.7625 32.25 3.75 31.2375 3.75 30V6C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.25Z" fill="white"/>
+  </mask>
+  <g mask="url(#mask4_2_319)">
+    <path opacity="0.2" fill-rule="evenodd" clip-rule="evenodd" d="M22.1869 6.5775V6.57375H19.4981C19.4981 6.56625 19.5 6.55875 19.5 6.55125C19.5 5.7225 18.8288 5.05125 18 5.05125C17.1713 5.05125 16.5 5.7225 16.5 6.55125C16.5 6.55875 16.5019 6.56625 16.5019 6.57375H13.8131V6.5775C13.2206 6.60937 12.75 7.09875 12.75 7.69875C12.75 7.73062 12.7519 7.76062 12.7538 7.7925C12.8006 7.23562 13.2506 6.795 13.8113 6.765V6.76125H16.5C16.5 6.75375 16.4981 6.74625 16.4981 6.73875C16.4981 5.91 17.1694 5.23875 17.9981 5.23875C18.8269 5.23875 19.4981 5.91 19.4981 6.73875C19.4981 6.74625 19.4963 6.75375 19.4963 6.76125H22.185V6.765C22.7456 6.795 23.1975 7.23562 23.2425 7.7925C23.2444 7.76062 23.2463 7.73062 23.2463 7.69875C23.25 7.09875 22.7794 6.60937 22.1869 6.5775Z" fill="#1A237E"/>
+  </g>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M30 32.0625H6C4.7625 32.0625 3.75 31.05 3.75 29.8125V30C3.75 31.2375 4.7625 32.25 6 32.25H30C31.2375 32.25 32.25 31.2375 32.25 30V29.8125C32.25 31.05 31.2375 32.0625 30 32.0625Z" fill="#1A237E" fill-opacity="0.2"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M6 3.9375H30C31.2375 3.9375 32.25 4.95 32.25 6.1875V6C32.25 4.7625 31.2375 3.75 30 3.75H6C4.7625 3.75 3.75 4.7625 3.75 6V6.1875C3.75 4.95 4.7625 3.9375 6 3.9375Z" fill="white" fill-opacity="0.2"/>
+  <rect opacity="0.2" x="9" y="12.375" width="18.765" height="18.765" fill="url(#pattern0)"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M17.67 14.58L24.795 21.705C24.9994 21.9075 25.125 22.1887 25.125 22.5C25.125 22.8094 24.9994 23.0906 24.795 23.295L19.92 28.17C19.7175 28.3744 19.4344 28.5 19.125 28.5C18.8156 28.5 18.5344 28.3744 18.33 28.17L11.205 21.045C11.0006 20.8425 10.875 20.5613 10.875 20.25V15.375C10.875 14.7544 11.3794 14.25 12 14.25H16.875C17.1863 14.25 17.4675 14.3756 17.67 14.58ZM12 16.125C12 16.5394 12.3356 16.875 12.75 16.875C13.1644 16.875 13.5 16.5394 13.5 16.125C13.5 15.7106 13.1644 15.375 12.75 15.375C12.3356 15.375 12 15.7106 12 16.125Z" fill="#F5F5F5"/>
+  <path opacity="0.2" fill-rule="evenodd" clip-rule="evenodd" d="M17.67 14.58L24.795 21.705C24.9994 21.9075 25.125 22.1887 25.125 22.5C25.125 22.521 25.1234 22.5411 25.1217 22.5616C25.1209 22.5722 25.12 22.5829 25.1194 22.5938C25.0969 22.3219 24.9787 22.0762 24.795 21.8925L17.67 14.7675C17.4675 14.5631 17.1863 14.4375 16.875 14.4375H12C11.3794 14.4375 10.875 14.9419 10.875 15.5625V15.375C10.875 14.7544 11.3794 14.25 12 14.25H16.875C17.1863 14.25 17.4675 14.3756 17.67 14.58ZM13.5 16.125C13.5 16.5394 13.1644 16.875 12.75 16.875C12.3356 16.875 12 16.5394 12 16.125C12 16.1016 12.003 16.0792 12.0061 16.0563C12.0072 16.0481 12.0084 16.0397 12.0094 16.0312C12.0562 16.4006 12.3675 16.6875 12.75 16.6875C13.1325 16.6875 13.4437 16.4006 13.4906 16.0312C13.4916 16.0397 13.4928 16.0481 13.4939 16.0563C13.497 16.0792 13.5 16.1016 13.5 16.125Z" fill="white"/>
+  <path opacity="0.2" fill-rule="evenodd" clip-rule="evenodd" d="M13.4906 16.2188C13.4437 15.8494 13.1325 15.5625 12.75 15.5625C12.3675 15.5625 12.0562 15.8494 12.0094 16.2188C12.0084 16.2103 12.0072 16.2019 12.0061 16.1937C12.003 16.1708 12 16.1484 12 16.125C12 15.7106 12.3356 15.375 12.75 15.375C13.1644 15.375 13.5 15.7106 13.5 16.125C13.5 16.1484 13.497 16.1708 13.4939 16.1937C13.4928 16.2019 13.4916 16.2103 13.4906 16.2188ZM19.92 28.17L24.795 23.295C24.9787 23.1131 25.0969 22.8675 25.1194 22.5938C25.1231 22.6256 25.125 22.6556 25.125 22.6875C25.125 22.9969 24.9994 23.2781 24.795 23.4825L19.92 28.3575C19.7175 28.5619 19.4344 28.6875 19.125 28.6875C18.8156 28.6875 18.5344 28.5619 18.33 28.3575L11.205 21.2325C11.0006 21.03 10.875 20.7488 10.875 20.4375V20.25C10.875 20.5613 11.0006 20.8425 11.205 21.045L18.33 28.17C18.5325 28.3744 18.8156 28.5 19.125 28.5C19.4344 28.5 19.7156 28.3744 19.92 28.17Z" fill="#1A237E"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M32.25 29.1713L24.885 21.8063C25.035 21.9975 25.125 22.2375 25.125 22.5C25.125 22.8113 24.9994 23.0925 24.795 23.295L19.92 28.17C19.7156 28.3744 19.4344 28.5 19.125 28.5C18.8625 28.5 18.6225 28.41 18.4313 28.26L22.4213 32.25H32.25V29.1713Z" fill="url(#paint0_linear_2_319)"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M32.25 6V30C32.25 31.2375 31.2375 32.25 30 32.2481H6C4.7625 32.2481 3.75 31.2375 3.75 30V5.99813C3.75 4.7625 4.7625 3.75 6 3.75H30C31.2375 3.75 32.25 4.7625 32.25 6ZM22.1869 9V8.99625C22.7794 8.96438 23.25 8.48063 23.25 7.8825C23.25 7.28437 22.7794 6.79875 22.1869 6.76688V6.76312H19.4981C19.4981 6.75938 19.4986 6.75563 19.4991 6.75188C19.4995 6.74813 19.5 6.74437 19.5 6.74062C19.5 5.9175 18.8287 5.25 18 5.25C17.1713 5.25 16.5 5.9175 16.5 6.74062C16.5 6.74437 16.5005 6.74813 16.5009 6.75188C16.5014 6.75563 16.5019 6.75938 16.5019 6.76312H13.8131V6.76688C13.2206 6.80063 12.75 7.28625 12.75 7.8825C12.75 8.47875 13.2206 8.96438 13.8131 8.99625V9H22.1869Z" fill="url(#paint1_radial_2_319)"/>
+  <defs>
+    <pattern id="pattern0" patternContentUnits="objectBoundingBox" width="1" height="1">
+    </pattern>
+    <linearGradient id="paint0_linear_2_319" x1="17.0167" y1="28.6632" x2="22.4013" y2="38.0903" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#1A237E" stop-opacity="0.2"/>
+      <stop offset="1" stop-color="#1A237E" stop-opacity="0.02"/>
+    </linearGradient>
+    <radialGradient id="paint1_radial_2_319" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(4.6875 4.125) scale(38.1249 38.1224)">
+      <stop stop-color="white" stop-opacity="0.1"/>
+      <stop offset="1" stop-color="white" stop-opacity="0.01"/>
+    </radialGradient>
+  </defs>
+</svg>

data/app/assets/images/app_icons/welcome_scene.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="316" height="112"><defs><linearGradient id="a" x1="66" y1="90" x2="102" y2="90" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#bdc1c6" stop-opacity="0"/><stop offset=".137" stop-color="#bdc1c6" stop-opacity=".021"/><stop offset=".279" stop-color="#bdc1c6" stop-opacity=".084"/><stop offset=".424" stop-color="#bdc1c6" stop-opacity=".189"/><stop offset=".57" stop-color="#bdc1c6" stop-opacity=".336"/><stop offset=".718" stop-color="#bdc1c6" stop-opacity=".525"/><stop offset=".864" stop-color="#bdc1c6" stop-opacity=".753"/><stop offset="1" stop-color="#bdc1c6"/></linearGradient><linearGradient id="b" data-name="Linear ground shadow - light-B" x1="224" y1="110" x2="246" y2="110" xlink:href="#a"/><linearGradient id="c" data-name="Linear ground shadow - light-B" x1="26" y1="110" x2="58" y2="110" xlink:href="#a"/><linearGradient id="d" x1="65.992" y1="70" x2="65.992" y2="112" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#669df6"/><stop offset=".094" stop-color="#669df6" stop-opacity=".826"/><stop offset=".225" stop-color="#669df6" stop-opacity=".61"/><stop offset=".358" stop-color="#669df6" stop-opacity=".423"/><stop offset=".49" stop-color="#669df6" stop-opacity=".27"/><stop offset=".621" stop-color="#669df6" stop-opacity=".152"/><stop offset=".75" stop-color="#669df6" stop-opacity=".068"/><stop offset=".877" stop-color="#669df6" stop-opacity=".017"/><stop offset="1" stop-color="#669df6" stop-opacity="0"/></linearGradient><linearGradient id="e" x1="260" y1="112" x2="260" y2="80" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#f29900"/><stop offset="1" stop-color="#f29900" stop-opacity="0"/></linearGradient><linearGradient id="f" x1="269" y1="80" x2="269" y2="112" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#fdd663"/><stop offset=".107" stop-color="#fdd663" stop-opacity=".803"/><stop offset=".236" stop-color="#fdd663" stop-opacity=".593"/><stop offset=".367" stop-color="#fdd663" stop-opacity=".411"/><stop offset=".497" stop-color="#fdd663" stop-opacity=".263"/><stop offset=".626" stop-color="#fdd663" stop-opacity=".148"/><stop offset=".754" stop-color="#fdd663" stop-opacity=".066"/><stop offset=".879" stop-color="#fdd663" stop-opacity=".017"/><stop offset="1" stop-color="#fdd663" stop-opacity="0"/></linearGradient></defs><g style="isolation:isolate"><path fill="url(#a)" style="mix-blend-mode:multiply" d="M66 88h36v4H66z"/><rect x="99" y="21" width="118" height="70" rx="3" fill="#fff"/><path d="M214 22a2.002 2.002 0 0 1 2 2v64a2.002 2.002 0 0 1-2 2H102a2.002 2.002 0 0 1-2-2V24a2.002 2.002 0 0 1 2-2h112m0-2H102a4 4 0 0 0-4 4v64a4 4 0 0 0 4 4h112a4 4 0 0 0 4-4V24a4 4 0 0 0-4-4z" fill="#e8eaed"/><path fill="url(#b)" style="mix-blend-mode:multiply" d="M224 108h22v4h-22z"/><path fill="url(#c)" style="mix-blend-mode:multiply" d="M26 108h32v4H26z"/><rect x="82" y="32" width="108" height="32" rx="4" fill="#4285f4"/><rect x="126" y="48" width="108" height="32" rx="5.367" fill="#f1f3f4"/><rect x="216" y="54" width="2" height="20" rx="1" fill="#ea4335"/><path fill="none" d="M138 56h16v16h-16z"/><path fill="#1a73e8" d="M138 62.75h16v2.5h-16z"/><path fill="#1a73e8" d="m143.083 56.447 8 13.856-2.166 1.25-8-13.856z"/><path fill="#1a73e8" d="m151.083 57.697-8 13.856-2.166-1.25 8-13.856z"/><path fill="none" d="M164 56h16v16h-16z"/><path fill="#1a73e8" d="M164 62.75h16v2.5h-16z"/><path fill="#1a73e8" d="m169.083 56.447 8 13.856-2.166 1.25-8-13.856z"/><path fill="#1a73e8" d="m177.083 57.697-8 13.856-2.166-1.25 8-13.856z"/><path fill="none" d="M190 56h16v16h-16z"/><path fill="#1a73e8" d="M190 62.75h16v2.5h-16z"/><path fill="#1a73e8" d="m195.083 56.447 8 13.856-2.166 1.25-8-13.856z"/><path fill="#1a73e8" d="m203.083 57.697-8 13.856-2.166-1.25 8-13.856z"/><rect x="98" y="38" width="2" height="20" rx="1" fill="#fff"/><path d="M180 22V10m-52.343 25.657L118 26m114.343 9.657L242 26" fill="none" stroke="#fbbc04" stroke-linecap="round" stroke-miterlimit="10" stroke-width="3"/><path d="M57.984 112a27.497 27.497 0 0 0 15.67-21.27A41.143 41.143 0 0 0 74 86.147V75l-16-5-16 5v11.147a41.143 41.143 0 0 0 .346 4.583A27.43 27.43 0 0 0 57.985 112z" fill="#4285f4"/><path d="M57.984 112a27.497 27.497 0 0 0 15.67-21.27A41.143 41.143 0 0 0 74 86.147V75l-16-5z" fill="url(#d)" style="mix-blend-mode:lighten" data-name="Shape"/><rect x="242" y="80" width="36" height="32" rx="4" fill="#fbbc04"/><path d="M250 80v-7a10 10 0 0 1 10-10 10 10 0 0 1 10 10v7" fill="none" stroke="#9aa0a6" stroke-miterlimit="10" stroke-width="3"/><rect x="242" y="80" width="36" height="32" rx="4" opacity=".5" fill="url(#e)" style="mix-blend-mode:multiply"/><path d="M274 112a4 4 0 0 0 4-4V84a4 4 0 0 0-4-4h-14v32z" fill="url(#f)" style="mix-blend-mode:lighten"/><path fill="none" d="M0 0h316v112H0z"/><path d="M260 25.971a3.637 3.637 0 0 1 4.265-3.602 10.972 10.972 0 0 1 19.47-2.519A6.4 6.4 0 0 1 292 25.971m-6.4-6.4a6.38 6.38 0 0 0-4.526 1.875m-14.831 1.939a3.646 3.646 0 0 0-2.586-1.07M20 38a9.29 9.29 0 0 1 17-5.184A5.419 5.419 0 0 1 44 38m-5.42-5.42a5.402 5.402 0 0 0-3.831 1.588M76 16a9.29 9.29 0 0 0-17-5.184A5.419 5.419 0 0 0 52 16m5.42-5.42a5.402 5.402 0 0 1 3.831 1.588" fill="none" stroke="#e8eaed" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2"/></g></svg>

data/app/controllers/spree/admin/google_merchant_settings_controller.rb

@@ -0,0 +1,182 @@
+require 'signet/oauth_2/client'
+require 'net/http'
+require 'json'
+require 'openssl'
+
+module Spree
+  module Admin
+    class GoogleMerchantSettingsController < ResourceController
+      helper Spree::Admin::GoogleShoppingHelper 
+      
+      def model_class
+        Spree::GoogleCredential
+      end
+
+      def edit
+        @credential = current_store.google_credential || current_store.build_google_credential
+      end
+
+      def update
+        @credential = current_store.google_credential || current_store.build_google_credential
+        
+        if @credential.update(permitted_params)
+          Spree::GoogleShopping::SyncAllJob.perform_later
+          
+          flash[:success] = Spree.t(:successfully_updated, resource: 'Google Settings')
+          redirect_to spree.edit_admin_google_merchant_settings_path
+        else
+          flash[:error] = "Failed to save settings. Please check the errors below."
+          render :edit
+        end
+      end
+
+      def connect
+        redirect_uri = spree.callback_admin_google_merchant_settings_url
+        Rails.logger.info "GOOGLE CONNECT: Generated Redirect URI: #{redirect_uri}"
+
+        client = Signet::OAuth2::Client.new(
+          authorization_uri: 'https://accounts.google.com/o/oauth2/auth',
+          token_credential_uri: 'https://oauth2.googleapis.com/token',
+          client_id: ENV['GOOGLE_CLIENT_ID'],
+          client_secret: ENV['GOOGLE_CLIENT_SECRET'],
+          scope: [
+            'https://www.googleapis.com/auth/content',
+            'https://www.googleapis.com/auth/adwords',
+            'https://www.googleapis.com/auth/userinfo.email'
+          ],
+          redirect_uri: redirect_uri,
+          additional_parameters: { 
+            access_type: 'offline',
+            prompt: 'consent'
+          }
+        )
+        redirect_to client.authorization_uri.to_s, allow_other_host: true
+      end
+
+      def callback
+        Rails.logger.info "GOOGLE CALLBACK: Received parameters: #{params.inspect}"
+
+        if params[:error].present?
+          flash[:error] = "Google Access Denied: #{params[:error]}"
+          return redirect_to spree.edit_admin_google_merchant_settings_path
+        end
+
+        if params[:code].blank?
+          flash[:error] = "No code received from Google."
+          return redirect_to spree.edit_admin_google_merchant_settings_path
+        end
+
+        redirect_uri = spree.callback_admin_google_merchant_settings_url
+
+        client = Signet::OAuth2::Client.new(
+          token_credential_uri: 'https://oauth2.googleapis.com/token',
+          client_id: ENV['GOOGLE_CLIENT_ID'],
+          client_secret: ENV['GOOGLE_CLIENT_SECRET'],
+          redirect_uri: redirect_uri,
+          code: params[:code]
+        )
+        begin
+          response = client.fetch_access_token!
+          
+          Rails.logger.info "GOOGLE TOKEN: Success! Expires in: #{response['expires_in']}"
+
+          access_token = response['access_token']
+          expires_in = response['expires_in'].to_i
+          expires_in = 3600 if expires_in <= 0
+
+          email = fetch_google_email(access_token)
+
+          cred = current_store.google_credential || current_store.build_google_credential
+          
+          new_refresh_token = response['refresh_token'].presence || cred.refresh_token
+
+          cred.assign_attributes(
+            access_token: access_token,
+            refresh_token: new_refresh_token,
+            token_expires_at: Time.current + expires_in.seconds,
+            scope: response['scope'],
+            email: email,
+            store: current_store
+          )
+          
+          if cred.save(validate: false)
+            flash[:success] = "Google Account (#{email}) Connected Successfully!"
+          else
+            Rails.logger.error "DB ERROR: #{cred.errors.full_messages}"
+            flash[:error] = "Database Error: #{cred.errors.full_messages.join(', ')}"
+          end
+          
+          redirect_to spree.edit_admin_google_merchant_settings_path
+
+        rescue Signet::AuthorizationError => e
+
+          current_cred = current_store.google_credential
+          if current_cred&.active? && current_cred.updated_at > 2.minutes.ago
+            Rails.logger.warn "GOOGLE: Race condition detected (invalid_grant ignored). Login was successful."
+            
+            connected_email = current_cred.email || "Google Account"
+            flash[:success] = "Google Account (#{connected_email}) Connected Successfully!"
+            
+            redirect_to spree.edit_admin_google_merchant_settings_path
+            return
+          end
+          
+          Rails.logger.error "GOOGLE AUTH ERROR: #{e.message}"
+          flash[:error] = "Google Authorization Failed: #{e.message}"
+          redirect_to spree.edit_admin_google_merchant_settings_path
+          
+        rescue => e
+          Rails.logger.error "GOOGLE GENERIC ERROR: #{e.message}"
+          flash[:error] = "Error: #{e.message}"
+          redirect_to spree.edit_admin_google_merchant_settings_path
+        end
+      end
+
+      def disconnect
+        cred = current_store.google_credential
+        if cred&.destroy
+          flash[:success] = "Google Account Disconnected."
+        else
+          flash[:error] = "Could not disconnect account."
+        end
+        redirect_to spree.edit_admin_google_merchant_settings_path
+      end
+
+      private
+
+      def fetch_google_email(access_token)
+        uri = URI('https://www.googleapis.com/oauth2/v2/userinfo')
+        request = Net::HTTP::Get.new(uri)
+        request['Authorization'] = "Bearer #{access_token}"
+        request['User-Agent'] = "SpreeGoogleShopping/1.0"
+        response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, verify_mode: OpenSSL::SSL::VERIFY_NONE) do |http|
+          http.request(request)
+        end
+
+        if response.is_a?(Net::HTTPSuccess)
+          data = JSON.parse(response.body)
+          data['email']
+        else
+          Rails.logger.warn "GOOGLE EMAIL FETCH FAILED: #{response.code} - #{response.body}"
+          "Connected Account"
+        end
+      rescue => e
+        Rails.logger.error "GOOGLE EMAIL FETCH ERROR: #{e.message}"
+        "Connected Account"
+      end
+
+      def permitted_params
+        params.require(:google_credential).permit(
+          :merchant_center_id, 
+          :ad_account_id,
+          :target_country,
+          :target_currency,
+          :default_product_type,
+          :default_google_product_category,
+          :default_min_handling_time, 
+          :default_max_handling_time
+        )
+      end
+    end
+  end
+end

data/app/controllers/spree/admin/google_shopping/dashboard_controller.rb

@@ -0,0 +1,64 @@
+module Spree
+  module Admin
+    module GoogleShopping
+      class DashboardController < Spree::Admin::BaseController
+        helper Spree::Admin::BaseHelper
+        
+        before_action :check_connection, only: [:index]
+
+        def index
+          @store = Spree::Store.default
+          @credential = @store.google_credential
+
+          if @credential&.active? && @credential.merchant_center_id.present?
+            service = Spree::GoogleShopping::StatusService.new(@credential)
+            @stats = service.fetch_counts
+            @last_sync = @credential.last_sync_at
+            
+            if @stats[:error]
+              flash.now[:error] = "Could not fetch live stats from Google. Showing cached or empty data."
+            end
+          else
+
+            @stats = { approved: 0, limited: 0, pending: 0, disapproved: 0 }
+            @last_sync = nil
+          end
+        end
+
+        def sync
+          products = Spree::Product.all
+          @store = Spree::Store.default
+          
+          if products.empty?
+            flash[:error] = "No products found to sync."
+          elsif @store.google_credential.merchant_center_id.blank?
+            flash[:error] = "Please enter your Google Merchant Center ID in Settings before syncing."
+          else
+            products.each do |product|
+              Spree::GoogleShopping::SyncProductJob.perform_later(product.id)
+            end
+            
+            if @store.google_credential&.merchant_center_id
+              Rails.cache.delete("google_shopping_stats_#{@store.google_credential.merchant_center_id}")
+            end
+            
+            flash[:success] = "Sync started for #{products.count} products! Statuses will update shortly."
+          end
+
+          redirect_to admin_google_shopping_dashboard_path
+        end
+
+        private
+
+        def check_connection
+          credential = Spree::Store.default.google_credential
+          
+          unless credential&.active?
+            flash[:warning] = "Please connect your Google Merchant Center account to access the dashboard."
+            redirect_to edit_admin_google_merchant_settings_path
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/admin/google_shopping/issues_controller.rb

@@ -0,0 +1,42 @@
+module Spree
+  module Admin
+    module GoogleShopping
+      class IssuesController < Spree::Admin::BaseController
+        
+        def index
+          @total_variants = Spree::Variant.count
+          @issues_summary = []
+
+          attributes_with_issues = Spree::GoogleVariantAttribute
+                                     .where.not(google_issues: nil)
+                                     .where.not(google_issues: "[]")
+          grouped_issues = {}
+
+          attributes_with_issues.each do |attr|
+            next if attr.google_issues.blank?
+
+            attr.google_issues.each do |issue|
+              key = issue['description']
+              if grouped_issues[key].nil?
+                variant = Spree::Variant.find_by(id: attr.variant_id)
+                product_id = variant&.product_id
+                grouped_issues[key] = {
+                  short_title: issue['description'],
+                  long_title: issue['detail'], 
+                  code: issue['code'],
+                  affected_count: 0,
+                  severity: issue['servability'],
+                  example_product_id: product_id
+                }
+              end
+              
+              grouped_issues[key][:affected_count] += 1
+            end
+          end
+
+          @issues_summary = grouped_issues.values.sort_by { |i| -i[:affected_count] }
+        end
+      end
+    end
+  end
+end