spree_cm_commissioner 2.4.2 → 2.5.0.pre.pre1

data/app/services/spree_cm_commissioner/telegram_alerts/integration_sync_failure.rb

@@ -0,0 +1,49 @@
+module SpreeCmCommissioner
+  module TelegramAlerts
+    class IntegrationSyncFailure
+      prepend ::Spree::ServiceModule::Base
+
+      # Send Telegram alert for integration sync failure
+      # @param error_message [String] The error message
+      # @param data [Hash] Additional context data (e.g., sync_type, match_id, event_type)
+      def call(error_message:, data: {})
+        chat_id = ENV.fetch('EXCEPTION_NOTIFIER_TELEGRAM_CHANNEL_ID', nil)
+        return failure(nil, 'Telegram chat ID not configured') if chat_id.blank?
+
+        telegram_client = ::Telegram.bots[:exception_notifier]
+        return failure(nil, 'Telegram bot not configured') if telegram_client.blank?
+
+        telegram_client.send_message(
+          chat_id: chat_id,
+          parse_mode: 'HTML',
+          text: format_message(error_message, data)
+        )
+
+        success(message: 'Alert sent successfully')
+      rescue StandardError => e
+        failure(nil, "Failed to send Telegram alert: #{e.message}")
+      end
+
+      private
+
+      def format_message(error_message, data)
+        text = []
+
+        text << '🚨 <b>Integration Sync Failed</b>'
+
+        # Render all data fields dynamically
+        data.each do |key, value|
+          next if value.blank?
+
+          formatted_key = key.to_s.humanize
+          text << "<b>#{formatted_key}:</b> <code>#{value}</code>"
+        end
+
+        text << "<b>Error:</b> <code>#{error_message}</code>"
+        text << "<b>Time:</b> <code>#{Time.current.iso8601}</code>"
+
+        text.compact.join("\n")
+      end
+    end
+  end
+end

data/app/views/spree/admin/integration_mappings/_integration_mappings.html.erb

@@ -0,0 +1,107 @@
+<div class="table-responsive">
+  <table class="table table-sm" id="listing_integration_mappings" data-hook>
+    <thead class="text-muted">
+      <tr>
+        <th><%= Spree.t(:id) %></th>
+        <th><%= Spree.t(:external_id) %></th>
+        <th><%= Spree.t(:internal_type) %></th>
+        <th><%= Spree.t(:internal_id) %></th>
+        <th><%= Spree.t(:status) %></th>
+        <th><%= Spree.t(:last_synced_at) %></th>
+        <th><%= Spree.t(:created_at) %></th>
+        <th><%= Spree.t(:updated_at) %></th>
+        <th></th>
+      </tr>
+    </thead>
+
+    <tbody>
+      <% mappings = defined?(@mappings) ? @mappings : integration.integration_mappings.order(updated_at: :desc).limit(25) %>
+      <% mappings.each do |mapping| %>
+        <tr id="integration_mapping_<%= mapping.id %>">
+          <td><%= mapping.id %></td>
+          <td><%= mapping.external_id %></td>
+          <td><%= mapping.internal_type %></td>
+          <td>
+            <%= integration_mapping_internal_link(mapping) %>
+          </td>
+          <td><%= mapping.status %></td>
+          <td><%= mapping.last_synced_at %></td>
+          <td><%= mapping.created_at %></td>
+          <td><%= mapping.updated_at %></td>
+
+          <td class="actions">
+            <% if mapping.external_payload.present? %>
+              <%= link_to_with_icon 'activity.svg', Spree.t("admin.external_integrations.view_result"), "#mapping_payload_modal_#{mapping.id}",
+                class: 'btn btn-light btn-sm',
+                no_text: true,
+                data: { toggle: 'modal', target: "#mapping_payload_modal_#{mapping.id}" },
+                title: Spree.t("admin.external_integrations.external_payload") %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <% if mappings.empty? %>
+    <small class="form-text text-muted"><%= Spree.t("admin.external_integrations.no_results") %></small>
+  <% end %>
+
+  <% if defined?(@mappings) && @mappings.respond_to?(:total_pages) %>
+    <div class="mt-3">
+      <%= paginate @mappings, theme: 'admin-twitter-bootstrap-4' %>
+    </div>
+  <% end %>
+</div>
+
+<% mappings.each do |mapping| %>
+  <% if mapping.external_payload.present? %>
+    <div
+      class="modal fade"
+      id="mapping_payload_modal_<%= mapping.id %>"
+      tabindex="-1"
+      role="dialog"
+      aria-labelledby="mapping_payload_modal_label_<%= mapping.id %>"
+      aria-hidden="true"
+    >
+      <div class="modal-dialog modal-lg" role="document">
+        <div class="modal-content">
+          <div class="modal-header">
+            <h5
+              class="modal-title"
+              id="mapping_payload_modal_label_<%= mapping.id %>"
+            >
+              <%= Spree.t("admin.external_integrations.external_payload") %> - Mapping #<%= mapping.id %>
+            </h5>
+
+            <button
+              type="button"
+              class="close"
+              data-dismiss="modal"
+              aria-label="Close"
+            >
+              <span aria-hidden="true">&times;</span>
+            </button>
+          </div>
+
+          <div class="modal-body">
+            <pre
+              class="small mb-0 p-2 bg-light border rounded"
+              style="max-height: 500px; overflow-y: auto;"
+            ><code><%= JSON.pretty_generate(mapping.external_payload) %></code></pre>
+          </div>
+
+          <div class="modal-footer">
+            <button
+              type="button"
+              class="btn btn-secondary"
+              data-dismiss="modal"
+            >
+              <%= Spree.t(:close) %>
+            </button>
+          </div>
+        </div>
+      </div>
+    </div>
+  <% end %>
+<% end %>

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

@@ -0,0 +1,33 @@
+<% content_for :page_title do %>
+  <%= link_to Spree.t('external_integrations'), spree.admin_integrations_url %> / <%= @integration.name %>
+<% end %>
+
+<% content_for :page_tabs do %>
+  <li class="nav-item">
+    <%= link_to Spree.t(:edit),
+      edit_admin_integration_path(@integration),
+      class: "nav-link" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_sync_sessions),
+      admin_integration_sessions_path(@integration),
+      class: "nav-link" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_mappings),
+      admin_integration_mappings_path(@integration),
+      class: "nav-link active" %>
+  </li>
+<% end %>
+
+<div data-hook="admin_integrations_mappings" class="card mb-3">
+  <div class="card-header">
+    <h5 class="card-title mb-0 h6"><%= Spree.t(:integration_mappings) %></h5>
+  </div>
+
+  <div class="card-body">
+    <%= render partial: 'integration_mappings', locals: { integration: @integration } %>
+  </div>
+</div>

data/app/views/spree/admin/integration_sessions/_integration_sync_sessions.html.erb

@@ -0,0 +1,116 @@
+<div class="table-responsive">
+  <table
+    class="table table-sm"
+    id="listing_integration_sync_sessions"
+    data-hook
+  >
+    <thead class="text-muted">
+      <tr>
+        <th><%= Spree.t(:id) %></th>
+        <th><%= Spree.t(:sync_type) %></th>
+        <th><%= Spree.t(:status) %></th>
+        <th><%= Spree.t(:started_at) %></th>
+        <th><%= Spree.t(:ended_at) %></th>
+        <th><%= Spree.t(:duration) %></th>
+        <th></th>
+      </tr>
+    </thead>
+
+    <tbody>
+      <% sync_sessions = defined?(@sync_sessions) ? @sync_sessions : integration.integration_sync_sessions.order(created_at: :desc).limit(25) %>
+      <% sync_sessions.each do |sess| %>
+        <tr id="integration_sync_session_<%= sess.id %>">
+          <td><%= sess.id %></td>
+          <td><%= sess.sync_type %></td>
+          <td><%= sess.status %></td>
+          <td><%= sess.started_at %></td>
+          <td><%= sess.ended_at %></td>
+          <td>
+            <% if sess.started_at && sess.ended_at %>
+              <% duration = (sess.ended_at - sess.started_at).to_i %>
+
+              <% if duration < 60 %>
+                <%= "#{duration} sec" %>
+              <% else %>
+                <%= "#{duration / 60} min" %>
+              <% end %>
+            <% else %>
+              N/A
+            <% end %>
+          </td>
+          <td class="actions">
+            <% if sess.sync_result.present? %>
+              <%= link_to_with_icon 'activity.svg', Spree.t("admin.external_integrations.view_result"), "#session_result_modal_#{sess.id}",
+                class: 'btn btn-light btn-sm',
+                no_text: true,
+                data: { toggle: 'modal', target: "#session_result_modal_#{sess.id}" },
+                title: Spree.t("admin.external_integrations.sync_result") %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <% if sync_sessions.empty? %>
+    <small class="form-text text-muted"><%= Spree.t("admin.external_integrations.no_results") %></small>
+  <% end %>
+
+  <% if defined?(@sync_sessions) && @sync_sessions.respond_to?(:total_pages) %>
+    <div class="mt-3">
+      <%= paginate @sync_sessions, theme: 'admin-twitter-bootstrap-4' %>
+    </div>
+  <% end %>
+</div>
+
+<% sync_sessions.each do |sess| %>
+  <% if sess.sync_result.present? %>
+    <div
+      class="modal fade"
+      id="session_result_modal_<%= sess.id %>"
+      tabindex="-1"
+      role="dialog"
+      aria-labelledby="session_result_modal_label_<%= sess.id %>"
+      aria-hidden="true"
+    >
+      <div class="modal-dialog modal-lg" role="document">
+        <div class="modal-content">
+          <div class="modal-header">
+            <h5
+              class="modal-title"
+              id="session_result_modal_label_<%= sess.id %>"
+            >
+              <%= Spree.t("admin.external_integrations.sync_result") %> - Session #<%= sess.id %>
+            </h5>
+
+            <button
+              type="button"
+              class="close"
+              data-dismiss="modal"
+              aria-label="Close"
+            >
+              <span aria-hidden="true">&times;</span>
+            </button>
+          </div>
+
+          <div class="modal-body">
+            <pre
+              class="small mb-0 p-2 bg-light border rounded"
+              style="max-height: 500px; overflow-y: auto;"
+            ><code><%= JSON.pretty_generate(sess.sync_result) %></code></pre>
+          </div>
+
+          <div class="modal-footer">
+            <button
+              type="button"
+              class="btn btn-secondary"
+              data-dismiss="modal"
+            >
+              <%= Spree.t(:close) %>
+            </button>
+          </div>
+        </div>
+      </div>
+    </div>
+  <% end %>
+<% end %>

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

@@ -0,0 +1,42 @@
+<% content_for :page_title do %>
+  <%= link_to Spree.t('external_integrations'), spree.admin_integrations_url %> / <%= @integration.name %>
+<% end %>
+
+<% content_for :page_tabs do %>
+  <li class="nav-item">
+    <%= link_to Spree.t(:edit),
+      edit_admin_integration_path(@integration),
+      class: "nav-link" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_sync_sessions),
+      admin_integration_sessions_path(@integration),
+      class: "nav-link active" %>
+  </li>
+
+  <li class="nav-item">
+    <%= link_to Spree.t(:integration_mappings),
+      admin_integration_mappings_path(@integration),
+      class: "nav-link" %>
+  </li>
+<% end %>
+
+<div data-hook="admin_integrations_sessions" class="card mb-3">
+  <div class="card-header d-flex justify-content-between align-items-center">
+    <h5 class="card-title mb-0 h6">
+      <%= Spree.t(:integration_sync_sessions) %>
+    </h5>
+
+    <div class="card-header-actions">
+      <%= button_to Spree.t(:enqueue_full_sync),
+          enqueue_polling_admin_integration_path(@integration, sync_type: :full),
+          method: :post,
+          class: 'btn btn-primary btn-sm' %>
+    </div>
+  </div>
+
+  <div class="card-body">
+    <%= render partial: 'integration_sync_sessions', locals: { integration: @integration } %>
+  </div>
+</div>

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

@@ -0,0 +1,104 @@
+<div data-hook="admin_external_integrations_form_fields" class="row">
+  <div class="col-6">
+    <%= f.field_container :type do %>
+      <%= f.label :type, raw(I18n.t('spree.admin.external_integrations.integration_type', default: 'Integration type') + required_span_tag) %>
+
+      <% if f.object.persisted? %>
+        <%= f.text_field :type, value: f.object.type, class: 'form-control', disabled: true, readonly: true %>
+        <%= f.hidden_field :type, value: f.object.type %>
+      <% else %>
+        <%= f.select :type,
+          options_for_select(@integration_type_options, f.object.type),
+          { include_blank: Spree.t(:choose_an_option) },
+          class: 'form-control select2',
+          required: true %>
+      <% end %>
+
+      <%= f.error_message_on :type %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :name do %>
+      <%= f.label :name, raw(Spree.t(:name) + required_span_tag) %>
+      <%= f.text_field :name, required: true, class: 'form-control', placeholder: Spree.t(:name) %>
+      <%= f.error_message_on :name %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :vendor_id do %>
+      <%= f.label :vendor_id, raw(I18n.t('spree.admin.external_integrations.vendor', default: 'Vendor') + required_span_tag) %>
+
+      <%= f.select :vendor_id,
+        options_from_collection_for_select(@vendors, :id, :name, f.object.vendor_id),
+        { include_blank: Spree.t(:choose_an_option) },
+        class: 'form-control select2',
+        required: true %>
+
+      <%= f.error_message_on :vendor_id %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :tenant_id do %>
+      <%= f.label :tenant_id, I18n.t('spree.admin.external_integrations.tenant', default: 'Tenant') %>
+
+      <%= f.select :tenant_id,
+          options_from_collection_for_select(@tenants, :id, :name, f.object.tenant_id),
+          { include_blank: Spree.t(:choose_an_option), prompt: Spree.t(:optional) },
+          class: 'form-control select2',
+          data: { allow_clear: true, placeholder: Spree.t(:optional) } %>
+
+      <%= f.error_message_on :tenant_id %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :status do %>
+      <%= f.label :status, raw(Spree.t(:status) + required_span_tag) %>
+
+      <%= f.select :status,
+        options_for_select(@status_options, f.object.status),
+        {},
+        class: 'form-control select2',
+        required: true %>
+
+      <%= f.error_message_on :status %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :conflict_strategy do %>
+      <%= f.label :conflict_strategy, raw(I18n.t('spree.admin.external_integrations.conflict_strategy', default: 'Conflict strategy') + required_span_tag) %>
+
+      <%= f.select :conflict_strategy,
+        options_for_select(@conflict_strategy_options, f.object.conflict_strategy),
+        {},
+        class: 'form-control select2',
+        required: true %>
+
+      <%= f.error_message_on :conflict_strategy %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :incremental_sync_interval_seconds do %>
+      <%= f.label :incremental_sync_interval_seconds, raw(I18n.t('spree.admin.external_integrations.incremental_sync_interval_seconds', default: 'Incremental sync interval (seconds)') + required_span_tag) %>
+      <%= f.number_field :incremental_sync_interval_seconds, class: 'form-control', min: 1, max: 3600, required: true %>
+      <%= f.error_message_on :incremental_sync_interval_seconds %>
+    <% end %>
+  </div>
+
+  <div class="col-6">
+    <%= f.field_container :full_sync_interval_hours do %>
+      <%= f.label :full_sync_interval_hours, raw(I18n.t('spree.admin.external_integrations.full_sync_interval_hours', default: 'Full sync interval (hours)') + required_span_tag) %>
+      <%= f.number_field :full_sync_interval_hours, class: 'form-control', min: 1, max: 168, required: true %>
+      <%= f.error_message_on :full_sync_interval_hours %>
+    <% end %>
+  </div>
+
+  <% if f.object.type == 'SpreeCmCommissioner::Integrations::StadiumXV1' || (f.object.new_record? && params[:type] == 'SpreeCmCommissioner::Integrations::StadiumXV1') %>
+    <%= render partial: 'stadium_x_v1_fields', locals: { f: f } %>
+  <% end %>
+</div>

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>