spree_cm_commissioner 2.5.0.pre.pre2 → 2.5.0.pre.pre4

data/app/views/spree/admin/integrations/_stadium_x_v1_fields.html.erb

@@ -0,0 +1,29 @@
+<!-- Stadium X V1 API Credentials -->
+<div class="col-12">
+  <hr class="my-4">
+
+  <h6 class="text-muted">
+    <%= I18n.t('spree.admin.external_integrations.stadium_x_credentials', default: 'Stadium X API Credentials') %>
+  </h6>
+</div>
+
+<div class="col-6">
+  <%= f.field_container :public_key do %>
+    <%= f.label :public_key, raw(I18n.t('spree.admin.external_integrations.public_key', default: 'Public Key') + required_span_tag) %>
+    <%= text_field_tag 'spree_cm_commissioner_integration[private_metadata][public_key]', f.object.public_key, class: 'form-control', required: true %>
+  <% end %>
+</div>
+
+<div class="col-6">
+  <%= f.field_container :private_key do %>
+    <%= f.label :private_key, raw(I18n.t('spree.admin.external_integrations.private_key', default: 'Private Key') + required_span_tag) %>
+    <%= text_field_tag 'spree_cm_commissioner_integration[private_metadata][private_key]', f.object.private_key, class: 'form-control', required: true %>
+  <% end %>
+</div>
+
+<div class="col-6">
+  <%= f.field_container :base_url do %>
+    <%= f.label :base_url, raw(I18n.t('spree.admin.external_integrations.base_url', default: 'Base URL') + required_span_tag) %>
+    <%= text_field_tag 'spree_cm_commissioner_integration[private_metadata][base_url]', f.object.base_url, class: 'form-control', placeholder: 'https://api.stadiumx.com', required: true %>
+  <% end %>
+</div>

data/app/views/spree/admin/integrations/edit.html.erb

@@ -0,0 +1,45 @@
+<% content_for :page_title do %>
+  <%= link_to Spree.t('external_integrations'), spree.admin_integrations_url %> / <%= @object.name %>
+<% end %>
+
+<% content_for :page_tabs do %>
+  <li class="nav-item">
+    <%= link_to Spree.t(:edit),
+      edit_admin_integration_path(@object),
+      class: "nav-link active" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_sync_sessions),
+      admin_integration_sessions_path(@object),
+      class: "nav-link" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_mappings),
+      admin_integration_mappings_path(@object),
+      class: "nav-link" %>
+  </li>
+<% end %>
+
+<div data-hook="admin_integrations" class="card mb-3">
+  <div class="card-header">
+    <h5 class="card-title mb-0 h6"><%= Spree.t('external_integrations') %></h5>
+  </div>
+
+  <div class="card-body">
+    <div data-hook="admin_integrations_edit_form_header">
+      <%= render partial: 'spree/admin/shared/error_messages', locals: { target: @object } %>
+    </div>
+
+    <div data-hook="admin_integrations_edit_form">
+      <%= form_with model: @object, url: admin_integration_path(@object), method: :patch, scope: :spree_cm_commissioner_integration do |f| %>
+        <%= render partial: 'form', locals: { f: f } %>
+
+        <div data-hook="admin_integrations_edit_form_buttons">
+          <%= render partial: 'spree/admin/shared/edit_resource_links', locals: { collection_url: spree.admin_integrations_path } %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/spree/admin/integrations/index.html.erb

@@ -0,0 +1,75 @@
+<% content_for :page_title do %>
+  <%= Spree.t('external_integrations') %>
+<% end %>
+
+<% content_for :page_actions do %>
+  <%= button_link_to Spree.t(:new_external_integration), new_admin_integration_path, class: "btn-success", icon: 'add.svg' %>
+<% end if can? :create, SpreeCmCommissioner::Integration %>
+
+<% if @integrations.any? %>
+  <div class="table-responsive border rounded bg-white mb-3">
+    <table class="table" id="listing_integrations" data-hook>
+      <thead class="text-muted">
+        <tr data-hook="admin_integrations_index_headers">
+          <th><%= Spree.t(:name) %></th>
+          <th><%= Spree.t(:base_url) %></th>
+          <th><%= Spree.t(:conflict_strategy) %></th>
+          <th><%= Spree.t(:incremental_sync_interval_seconds) %></th>
+          <th><%= Spree.t(:full_sync_interval_hours) %></th>
+          <th><%= Spree.t(:vendor) %></th>
+          <th><%= Spree.t(:status) %></th>
+          <th><%= Spree.t(:updated_at) %></th>
+        </tr>
+      </thead>
+
+      <tbody>
+        <% @integrations.each do |integration| %>
+          <tr
+            id="<%= spree_dom_id integration %>"
+            data-hook="admin_integrations_index_rows"
+          >
+            <td><%= integration.name %></td>
+
+            <td>
+              <%= integration_base_url_link(integration.base_url) %>
+            </td>
+
+            <td>
+              <%= integration_conflict_strategy_badge(integration.conflict_strategy) %>
+            </td>
+
+            <td>
+              <%= integration_interval_badge(integration.incremental_sync_interval_seconds, 's') %>
+            </td>
+
+            <td>
+              <%= integration_interval_badge(integration.full_sync_interval_hours, 'h') %>
+            </td>
+
+            <td><%= integration.vendor.name %></td>
+
+            <td>
+              <%= integration_status_badge(integration.status) %>
+            </td>
+
+            <td><%= integration.updated_at %></td>
+
+            <td
+              data-hook="admin_integrations_index_row_actions"
+              class="actions"
+            >
+              <span class="d-flex justify-content-end">
+                <%= link_to_edit integration, url: edit_admin_integration_path(integration), no_text: true if can?(:edit, integration) %>
+                <%= link_to_delete integration, url: admin_integration_path(integration), no_text: true if can?(:delete, integration) %>
+              </span>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+<% else %>
+  <small class="form-text text-muted">
+    <%= raw I18n.t('external_integrations.empty_info') %>
+  </small>
+<% end %>

data/app/views/spree/admin/integrations/new.html.erb

@@ -0,0 +1,25 @@
+<% content_for :page_title do %>
+  <%= link_to Spree.t('external_integrations'), spree.admin_integrations_url %> / <%= Spree.t(:new) %>
+<% end %>
+
+<div data-hook="admin_integrations" class="card mb-3">
+  <div class="card-header">
+    <h5 class="card-title mb-0 h6"><%= Spree.t('external_integrations') %></h5>
+  </div>
+
+  <div class="card-body">
+    <div data-hook="admin_integrations_new_form_header">
+      <%= render partial: 'spree/admin/shared/error_messages', locals: { target: @object } %>
+    </div>
+
+    <div data-hook="admin_integrations_new_form">
+      <%= form_with model: @object, url: { action: 'create' }, scope: :spree_cm_commissioner_integration do |f| %>
+        <%= render partial: 'form', locals: { f: f } %>
+
+        <div data-hook="admin_integrations_new_form_buttons">
+          <%= render partial: 'spree/admin/shared/new_resource_links' %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/spree/admin/tenants/_form.html.erb

@@ -74,8 +74,6 @@
       <%= content_tag :div, nil, style: "background-color: #{@object.preferred_brand_primary_color}; width: 60px; height: 60px; border: 1px solid #ccc; box-sizing: border-box; display: block;" %>
     </div>
   </div>
-
-  <!-- Assetlinks Field -->
   <div class="col-12">
     <%= f.field_container :preferred_assetlinks do %>
       <%= f.label :preferred_assetlinks, raw(Spree.t(:assetlinks)) %>
@@ -184,22 +182,6 @@
   </div>
 </div>
 
-<!-- ======================== Footer ======================== -->
-<div class="card mb-4">
-  <div class="card-body">
-    <div data-hook="admin_tenant_form_fields" class="row mt-4">
-      <div class="col-12 mb-4">
-        <h4>Footer <span class="text-muted" style="font-size: 1rem; font-weight: normal;">(Footer is for customer support details and tenant address)</span></h4>
-      </div>
-      <!-- Footer Field -->
-      <div class="col-12">
-        <%= render partial: 'spree/admin/tenants/form/footer', locals: { f: f } %>
-        <%= render partial: 'spree/admin/tenants/form/social', locals: { f: f } %>
-      </div>
-    </div>
-  </div>
-</div>
-
 <!-- ======================== Redirect Settings ======================== -->
 <div class="card mb-4">
   <div class="card-body">

data/app/views/spree/order_mailer/confirm_email.html.erb

@@ -21,7 +21,7 @@
                   <%= render 'spree_cm_commissioner/order_mailer/order_total', order: @order %>
                   <%= render 'spree_cm_commissioner/order_mailer/your_booking', order: @order, show_booking_header: true %>
                   <%= render 'spree_cm_commissioner/order_mailer/tenant/customer_info', order: @order %>
-                  <%= render 'spree_cm_commissioner/order_mailer/tenant/support_contact', order: @order, name: @name%>
+                  <%= render 'spree_cm_commissioner/order_mailer/tenant/support_contact' %>
                 </div>
               </div>
             <% end %>

data/app/views/spree_cm_commissioner/layouts/order_mailer.html.erb

@@ -26,7 +26,7 @@
                 <% if @order.tenant.nil? %>
                   <%= render 'spree_cm_commissioner/order_mailer/footer', store: @order.store %>
                 <% else %>
-                  <%= render 'spree_cm_commissioner/order_mailer/tenant/footer', tenant: @order.tenant %>
+                  <%= render 'spree_cm_commissioner/order_mailer/tenant/footer', store: @order.store %>
                 <% end %>
               </td>
             </tr>

data/app/views/spree_cm_commissioner/order_mailer/tenant/_footer.html.erb

@@ -1,31 +1,24 @@
 <div class="email-footer_inner">
-  <div class="mb-24"><%= tenant&.description %></div>
-  <div class="mb-24 f-14"><%= tenant&.address %></div>
+  <div class="mb-24"><%= store.description%></div>
+  <div class="mb-24 f-14"><%= store.address%></div>
   <h2 class="mb-24">Connect with us</h2>
   <table class="mb-24 social_icons">
     <tbody>
       <tr>
-        <% if tenant&.preferred_facebook.present? %>
+        <% if store.facebook? %>
           <td class="social_icon">
-            <%= link_to tenant.preferred_facebook, target: :_blank do %>
+            <%= link_to store.facebook, target: :_blank do %>
               <%= image_tag "mailer/facebook.png", class: "mail-icon"%>
             <% end %>
           </td>
         <% end %>
-        <% if tenant&.preferred_instagram.present? %>
+        <% if store.instagram?%>
           <td class="social_icon">
-            <%= link_to tenant.preferred_instagram, target: :_blank do %>
+            <%= link_to store.instagram, target: :_blank do %>
               <%= image_tag "mailer/instagram.png", class: "mail-icon"%>
             <% end %>
           </td>
         <% end %>
-        <% if tenant&.preferred_twitter.present? %>
-          <td class="social_icon">
-            <%= link_to tenant.preferred_twitter, target: :_blank do %>
-              <%= image_tag "mailer/twitter.png", class: "mail-icon"%>
-            <% end %>
-          </td>
-        <% end %>
       </tr>
     </tbody>
   </table>

data/app/views/spree_cm_commissioner/order_mailer/tenant/_support_contact.html.erb

@@ -1,32 +1,33 @@
 <div class="content-cell">
-  <div class="container">
-    <h2><%= name %> Support</h2>
-    <div class="flex two-columns">
-      <div class="two-columns-item">
-        <div class="flex two-columns-item_detail">
-          <div class="two-columns_icon"><%= image_tag "mailer/tenant_phone.png", class: "mail-icon"%></div>
-          <div class="two-columns_text-container">
-            <p class="two-columns_title">Contact</p>
-            <% if order&.tenant&.contact_phone&.present? %>
-              <p class="two-columns_description">
-                <%= link_to order.tenant.contact_phone, "tel:#{order.tenant.contact_phone}" %>
-              </p>
-            <% end %>
-          </div>
+<div class="container">
+  <h2><%= I18n.t('mail.order_mailer.bookmeplus_support')%></h2>
+  <div class="flex two-columns">
+    <div class="two-columns-item">
+      <div class="flex two-columns-item_detail">
+        <div class="two-columns_icon"><%= image_tag "mailer/tenant_phone.png", class: "mail-icon"%></div>
+        <div class="two-columns_text-container">
+          <p class="two-columns_title">Contact</p>
+          <% if @order.store.contact_phone.present? %>
+            <p class="two-columns_description">
+              <%= link_to @order.store.contact_phone, "tel:#{@order.store.contact_phone}" %>
+            </p>
+          <% end %>
         </div>
       </div>
-      <div class="vertical-separater"></div>
-      <div class="two-columns-item">
-        <div class="flex two-columns-item_detail">
-          <div class="two-columns_icon"><%= image_tag "mailer/mail.png", class: "mail-icon"%></div>
-          <div class="two-columns_text-container">
-            <p class="two-columns_title">Email</p>
+    </div>
+    <div class="vertical-separater"></div>
+    <div class="two-columns-item">
+      <div class="flex two-columns-item_detail">
+        <div class="two-columns_icon"><%= image_tag "mailer/mail.png", class: "mail-icon"%></div>
+        <div class="two-columns_text-container">
+          <p class="two-columns_title">Email</p>
             <p class="two-columns_description">
-              <%= order&.tenant&.customer_support_email.present? ? link_to(order.tenant.customer_support_email, "mailto:#{order.tenant.customer_support_email}") : "N/A" %>
-            </p>
-          </div>
+          <%= @vendor&.support_email.present? ? link_to(@vendor.support_email, "mailto:#{@vendor.support_email}") : "N/A" %>
+          </p>
+
         </div>
       </div>
     </div>
   </div>
 </div>
+</div>

data/config/locales/en.yml

@@ -454,6 +454,14 @@ en:
     admin:
       display_on:
         frontend_for_early_adopter: "Storefront for Early Adopter"
+      external_integrations_title: "External Integrations"
+      integration_sync_enqueued: "Integration sync has been enqueued"
+      integration_inactive: "Integration is inactive"
+      external_integrations:
+        view_result: "View Result"
+        sync_result: "Sync Result"
+        external_payload: "External Payload"
+        no_results: "No results found"
     event:
       check_in:
         success: "Guest check-in in successfully"

data/config/locales/km.yml

@@ -341,6 +341,14 @@ km:
     admin:
       display_on:
         frontend_for_early_adopter: "Storefront for Early Adopter"
+      external_integrations_title: "ការភ្ជាប់ខាងក្រៅ"
+      integration_sync_enqueued: "ការធ្វើសមកាលកម្មបានដាក់ក្នុងជួរ"
+      integration_inactive: "ការភ្ជាប់មិនដំណើរការ"
+      external_integrations:
+        view_result: "មើលលទ្ធផល"
+        sync_result: "លទ្ធផលធ្វើសមកាលកម្ម"
+        external_payload: "ទិន្នន័យខាងក្រៅ"
+        no_results: "មិនមានលទ្ធផលទេ"
     event:
       check_in:
         success: "Guest check-in in successfully"

data/config/routes.rb

@@ -283,6 +283,13 @@ Spree::Core::Engine.add_routes do
         post :set_webhook
       end
     end
+    resources :integrations do
+      member do
+        post :enqueue_polling
+      end
+      resources :sessions, only: [:index], controller: 'integration_sessions'
+      resources :mappings, only: [:index], controller: 'integration_mappings'
+    end
 
     resources :webhooks_subscribers do
       resources :rules, controller: :webhooks_subscriber_rules, except: %i[index show]
@@ -695,6 +702,7 @@ Spree::Core::Engine.add_routes do
 
         resources :seat_layouts, only: %i[show index]
         resources :inventory_items, only: %i[index]
+        resources :event_matches, only: %i[index]
         namespace :transit do
           resources :draft_orders, only: %i[create]
         end

data/db/migrate/20251017094845_create_cm_integrations.rb

@@ -0,0 +1,22 @@
+class CreateCmIntegrations < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cm_integrations, if_not_exists: true do |t|
+      t.string :type, null: false
+      t.string :name, null: false
+
+      t.integer :status, null: false, default: 0
+      t.integer :conflict_strategy, null: false, default: 0
+
+      t.integer :incremental_sync_interval_seconds, null: false, default: 10
+      t.integer :full_sync_interval_hours, null: false, default: 24
+
+      t.references :tenant, foreign_key: { to_table: :cm_tenants }, null: true
+      t.references :vendor, foreign_key: { to_table: :spree_vendors }, null: false
+
+      t.jsonb :public_metadata, default: {}
+      t.jsonb :private_metadata, default: {}
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20251017101555_create_cm_integration_sync_sessions.rb

@@ -0,0 +1,68 @@
+class CreateCmIntegrationSyncSessions < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cm_integration_sync_sessions, if_not_exists: true do |t|
+      t.integer :status, null: false
+      t.integer :sync_type, null: false
+
+      t.datetime :started_at
+      t.datetime :ended_at
+
+      t.references :integration, foreign_key: { to_table: :cm_integrations }, null: false
+      t.references :tenant, foreign_key: { to_table: :cm_tenants }, null: true
+
+      # Stores the serialized sync result (SyncResult#to_h) for this session.
+      # This field is used to persist the outcome of the sync operation,
+      # allowing for detailed tracking of results, whether the sync was successful or not.
+      #
+      # Base class: app/services/spree_cm_commissioner/integrations/base/sync_result.rb
+      #
+      # Example implementations include:
+      # - Full sync results: integrations/stadium_x_v1/sync_results/full_sync_result.rb
+      # - Incremental sync results: integrations/stadium_x_v1/sync_results/incremental_sync_result.rb
+      #
+      # The result is saved upon completion of the session in the SyncManager#run_execution method:
+      # - app/services/spree_cm_commissioner/integrations/base/sync_manager.rb
+      t.jsonb :sync_result, default: {}
+
+      t.timestamps
+    end
+
+    # Indexes for PollingScheduler queries (optimized for performance)
+    # Initially used in polling_scheduler.rb
+    #
+    # Index 1: Find in_progress/pending syncs created within last hour
+    # Used by: should_run_full_sync? and should_run_incremental_sync?
+    # Query: .where(sync_type: [...], status: [...]).where('created_at > ?', 1.hour.ago).exists?
+    # Why: Composite index on all filter columns for fast lookup of active syncs
+    unless index_exists?(:cm_integration_sync_sessions, [:integration_id, :sync_type, :status, :created_at], name: 'idx_sync_sessions_integration_type_status_created_at')
+      add_index :cm_integration_sync_sessions, [:integration_id, :sync_type, :status, :created_at],
+                name: 'idx_sync_sessions_integration_type_status_created_at'
+    end
+
+    # Index 2: Find latest completed full sync (partial index - only completed rows)
+    # Used by: should_run_full_sync?
+    # Query: .where(sync_type: :full, status: :completed).order(created_at: :desc).first
+    # Why: Partial index reduces size by ~60% (excludes in_progress/pending/failed rows)
+    #      Descending order on created_at allows DB to return latest without sorting
+    #      Only 2 columns needed since sync_type and status are filtered by WHERE clause
+    unless index_exists?(:cm_integration_sync_sessions, [:integration_id, :created_at], name: 'idx_sync_sessions_full_completed')
+      add_index :cm_integration_sync_sessions, [:integration_id, :created_at],
+                name: 'idx_sync_sessions_full_completed',
+                where: "sync_type = 0 AND status = 2", # full=0, completed=2
+                order: { created_at: :desc }
+    end
+
+    # Index 3: Find latest completed incremental sync (partial index - only completed rows)
+    # Used by: should_run_incremental_sync?
+    # Query: .where(sync_type: :incremental, status: :completed).order(created_at: :desc).first
+    # Why: Partial index reduces size by ~60% (excludes in_progress/pending/failed rows)
+    #      Descending order on created_at allows DB to return latest without sorting
+    #      Only 2 columns needed since sync_type and status are filtered by WHERE clause
+    unless index_exists?(:cm_integration_sync_sessions, [:integration_id, :created_at], name: 'idx_sync_sessions_incremental_completed')
+      add_index :cm_integration_sync_sessions, [:integration_id, :created_at],
+                name: 'idx_sync_sessions_incremental_completed',
+                where: "sync_type = 1 AND status = 2", # incremental=1, completed=2
+                order: { created_at: :desc }
+    end
+  end
+end

data/db/migrate/20251017101605_create_cm_integration_mappings.rb

@@ -0,0 +1,52 @@
+class CreateCmIntegrationMappings < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cm_integration_mappings, if_not_exists: true do |t|
+      t.string :external_id, null: false
+      t.string :internal_type, null: false
+      t.bigint :internal_id, null: false
+      t.jsonb :external_payload, default: nil
+
+      # optional for record that can have different mappings on different dates
+      t.date :date, null: true
+      t.integer :status, null: false, default: 0
+      t.references :integration, null: false, foreign_key: { to_table: :cm_integrations }
+
+      t.jsonb :public_metadata, default: {}
+      t.jsonb :private_metadata, default: {}
+
+      t.datetime :last_synced_at
+      t.timestamps
+    end
+
+    # Index 1: Unique constraint for external_id mappings
+    # Used by: IntegrationMapping#validates :external_id
+    # Query: validates :external_id, uniqueness: { scope: %i[integration_id internal_type internal_id date] }
+    # Why: Ensures a single external_id maps to only one internal record per integration/date combination
+    #      Prevents duplicate mappings that could cause sync conflicts
+    #      Unique index enforces this at database level for data integrity
+    unless index_exists?(:cm_integration_mappings, [:integration_id, :external_id, :internal_type, :internal_id, :date], name: 'idx_external_internal_mapping')
+      add_index :cm_integration_mappings, [:integration_id, :external_id, :internal_type, :internal_id, :date], unique: true, name: 'idx_external_internal_mapping'
+    end
+
+    # Index 2: Efficient lookup by integration_id and external_id
+    # Used by: IntegrationMappable#find_by_integration, IntegrationMappable#find_or_initialize_by_integration,
+    # IntegrationMappable#find_or_initialize_by_integration_with_mapping
+    #
+    # Query: .find_by(integration_id: integration_id, external_id: external_id)
+    # Why: Composite index allows efficient lookup by both integration_id and external_id
+    #      These methods are called frequently during sync operations
+    unless index_exists?(:cm_integration_mappings, [:integration_id, :internal_type, :external_id], name: 'idx_integration_external_id')
+      add_index :cm_integration_mappings, [:integration_id, :internal_type, :external_id], name: 'idx_integration_external_id'
+    end
+
+    # Index 3: Incremental sync query optimization
+    # Used by: IntegrationMappable#find_oldest_active_mapping (called by IncrementalSyncStrategy every 10 seconds)
+    # Query: .where(integration_id: integration_id, internal_type: model_name).active.order(:last_synced_at).first
+    # Why: Composite index filters by integration_id, internal_type, status efficiently
+    #      Includes last_synced_at for ORDER BY to avoid expensive sort operation
+    #      Runs every 10s so performance is critical - even small optimizations matter at this frequency
+    unless index_exists?(:cm_integration_mappings, [:integration_id, :internal_type, :status, :last_synced_at], name: 'idx_incremental_sync')
+      add_index :cm_integration_mappings, [:integration_id, :internal_type, :status, :last_synced_at], name: 'idx_incremental_sync'
+    end
+  end
+end

data/lib/cm_app_logger.rb

@@ -12,6 +12,7 @@ module CmAppLogger
 
     message[:start_time] = start_time
     message[:duration_ms] = (Time.current - start_time) * 1000
+    message[:result] = block_result
     Rails.logger.info(message.to_json)
     block_result
   end

data/lib/spree_cm_commissioner/test_helper/factories/integration_factory.rb

@@ -0,0 +1,25 @@
+FactoryBot.define do
+  factory :cm_integration, class: SpreeCmCommissioner::Integration do
+    type { 'SpreeCmCommissioner::Integrations::StadiumXV1' }
+    name { FFaker::Company.name }
+    status { :active }
+    conflict_strategy { :newest_wins }
+    incremental_sync_interval_seconds { 300 }
+    full_sync_interval_hours { 24 }
+    association :vendor, factory: :cm_vendor
+
+    trait :active do
+      status { :active }
+    end
+
+    trait :inactive do
+      status { :inactive }
+    end
+  end
+
+  factory :cm_stadium_x_v1_integration, parent: :cm_integration, class: SpreeCmCommissioner::Integrations::StadiumXV1 do
+    public_key { FFaker::Lorem.characters(20) }
+    private_key { FFaker::Lorem.characters(40) }
+    base_url { 'https://api.stadiumx.com' }
+  end
+end

data/lib/spree_cm_commissioner/test_helper/factories/integration_mapping_factory.rb

@@ -0,0 +1,14 @@
+FactoryBot.define do
+  factory :cm_integration_mapping, class: SpreeCmCommissioner::IntegrationMapping do
+    external_id { SecureRandom.alphanumeric(10) }
+    association :integration, factory: :cm_integration
+    status { :active }
+
+    transient do
+      internal { create(:cm_product) }
+    end
+
+    internal_id { internal.id }
+    internal_type { internal.class.name }
+  end
+end

data/lib/spree_cm_commissioner/test_helper/factories/integration_sync_session_factory.rb

@@ -0,0 +1,7 @@
+FactoryBot.define do
+  factory :cm_integration_sync_session, class: SpreeCmCommissioner::IntegrationSyncSession do
+    status { :pending }
+    sync_type { :full }
+    association :integration, factory: :cm_integration
+  end
+end

data/lib/spree_cm_commissioner/version.rb

@@ -1,5 +1,5 @@
 module SpreeCmCommissioner
-  VERSION = '2.5.0.pre.pre2'.freeze
+  VERSION = '2.5.0-pre4'.freeze
 
   module_function
 

data/lib/spree_cm_commissioner.rb

@@ -55,16 +55,17 @@ require 'byebug' if Rails.env.development? || Rails.env.test?
 
 module SpreeCmCommissioner
   class << self
-    # Allows overriding the default Redis connection pool with a custom one
-    attr_writer :redis_pool
+    # Allows overriding the default Redis connection pools with custom ones
+    attr_writer :inventory_redis_pool
 
-    def redis_pool
-      @redis_pool ||= default_redis_pool
+    # Inventory Redis pool for inventory management
+    def inventory_redis_pool
+      @inventory_redis_pool ||= default_redis_pool
     end
 
-    # Resets the Redis pool, useful for testing or reinitialization
-    def reset_redis_pool
-      @redis_pool = nil
+    # Resets all Redis pools, useful for testing or reinitialization
+    def reset_redis_pools
+      @inventory_redis_pool = nil
     end
 
     private