spree_cm_commissioner 2.6.2.pre.pre1 → 2.6.2.pre.pre.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e063a62652e0598802f2cacf7f08755457cbf97a5702c0d2ec862adff84238ee
-  data.tar.gz: 9a3a9cb10a7c94363a79c5ebb22fcf71c6854e688b9a17d220de72566c562bba
+  metadata.gz: 4c381df113afbf82a9586168ede0e86f1bfee87849e50d3f9aed7a4b5455c2ab
+  data.tar.gz: 8466ba5865693c20fe012ca0463b584c9be3fe1aed6e25f3d37d31ef3ad76121
 SHA512:
-  metadata.gz: 2ed2e276d121939627ca4d38480eada55aa4a60b7933891b987d0337a74fdfefe8deea48b424ee20a66a30b1a44f09369330263433a76baf14ae26c2a5301bdb
-  data.tar.gz: dded17adb10e46eee97c2eff877a1520a897b84cf71695ea00a2d418a83131ad9c03b713c6379804f27270f61426a1bf44249b73ab18c74aea74131c4b5398a5
+  metadata.gz: e8ad8ac4e47e7a75a68f60244bf4033fb5d035bbd722e7f7d8ecebad7f81d08634990087a47e8702d47fb919bea1c60e3ba81f35fc1f772c2d0e0efa41c59b2f
+  data.tar.gz: 4a0ae2cd87ccca4f91cd2604a979771192cabffaf63978290a86dae624e25e18c1cf581f2d09a5f9805fa32f159b6e7f4b1982b3bc85958dd53da3b1385764c3

data/Gemfile.lock

@@ -34,7 +34,7 @@ GIT
 PATH
   remote: .
   specs:
-    spree_cm_commissioner (2.6.2.pre.pre1)
+    spree_cm_commissioner (2.6.2.pre.pre.4)
       activerecord-multi-tenant
       activerecord_json_validator (~> 2.1, >= 2.1.3)
       aws-sdk-cloudfront

data/README.md

@@ -153,37 +153,8 @@ PIN_CODE_DEBUG_NOTIFIY_TELEGRAM_ENABLE="yes"
 EXCEPTION_NOTIFY_ENABLE="yes" # yes or no
 EXCEPTION_TELEGRAM_BOT_TOKEN=""
 EXCEPTION_NOTIFIER_TELEGRAM_CHANNEL_ID=""
-
-TURNSTILE_SECRET_KEY="" # Cloudflare Turnstile secret key (server-side verification)
 ```
 
-### Cloudflare Turnstile
-
-Cloudflare Turnstile is used to protect sensitive API endpoints from bots. The server-side validation is handled by `SpreeCmCommissioner::TurnstileTokenValidator` and the concern `SpreeCmCommissioner::TurnstileProtectable`.
-
-**Protected endpoints:**
-
-- `POST /api/v2/storefront/pin_code_generators`
-- `POST /api/v2/storefront/pin_code_otp_generators`
-- `POST /api/v2/storefront/user_registration_with_pin_codes`
-- `PUT  /api/v2/storefront/reset_passwords`
-- `PATCH /api/v2/storefront/checkout/complete`
-
-**How it works:**
-
-1. The client sends a Turnstile token via the `X-Turnstile-Token` HTTP header
-2. `TurnstileProtectable` reads the header and calls `TurnstileTokenValidator`
-3. The validator POSTs to Cloudflare's siteverify API with the token and `TURNSTILE_SECRET_KEY`
-4. Returns 403 if verification fails
-
-**Configuration:**
-
-1. Set `TURNSTILE_SECRET_KEY` in `.env` (obtained from [Cloudflare Turnstile dashboard](https://dash.cloudflare.com/))
-2. For local development testing, use Cloudflare's test keys:
-   - Always pass: `1x0000000000000000000000000000000AA`
-   - Always fail: `2x0000000000000000000000000000000AA`
-   - Token spent: `3x0000000000000000000000000000000AA`
-
 ## JSON Format Examples For Store and Tenant Preferences
 
 ### Asset Links Format

data/app/controllers/concerns/spree/admin/service_calendars_concern.rb

@@ -44,8 +44,6 @@ module Spree
       private
 
       def build_exception_rules(exception_rules)
-        return [] if exception_rules.nil?
-
         exception_rules.values.reject! { |rule| rule['from'].blank? || rule['to'].blank? || rule['type'].blank? } || exception_rules.values
       end
 
@@ -59,7 +57,7 @@ module Spree
       end
 
       def set_exception_rules
-        @exception_rules = (@object.exception_rules.presence || [{ from: DateTime.now, to: DateTime.now, type: 'exclusion', reason: nil }])
+        @exception_rules = [{ from: DateTime.now, to: DateTime.now, type: 'exclusion', reason: nil }]
       end
 
       def build_resource

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

@@ -6,7 +6,6 @@ module Spree
       before_action :load_product
       before_action :ensure_product_type_supports_calendar
       before_action :ensure_product_has_no_calendar, only: %i[new create]
-      before_action :set_exception_rules, only: %i[edit update]
 
       create.before :set_calendarable
       update.before :set_calendarable

data/app/controllers/spree/api/v2/tenant/show_contestants_controller.rb

@@ -0,0 +1,50 @@
+module Spree
+  module Api
+    module V2
+      module Tenant
+        class ShowContestantsController < BaseController
+          private
+
+          # override
+          def model_class
+            SpreeCmCommissioner::ShowContestant
+          end
+
+          # override
+          def scope
+            return model_class.none unless current_show
+
+            model_class
+              .where(show_id: current_show.id)
+              .includes(
+                :show_contestant_images,
+                :current_voting_session,
+                assigned_show_person: :show_person_images,
+                show: [
+                  :parent,
+                  { episodes: :voting_sessions },
+                  { seasons: { episodes: :voting_sessions } }
+                ]
+              )
+          end
+
+          def current_show
+            @current_show ||= show_scope.find_by!(slug: params[:show_id])
+          end
+
+          def show_scope
+            vendor_ids = @tenant.vendors.select(:id)
+            return SpreeCmCommissioner::Show.none if vendor_ids.blank?
+
+            SpreeCmCommissioner::Show.where(vendor_id: vendor_ids)
+          end
+
+          # override
+          def resource_serializer
+            Spree::V2::Tenant::ShowContestantSerializer
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/tenant/show_people_controller.rb

@@ -0,0 +1,54 @@
+module Spree
+  module Api
+    module V2
+      module Tenant
+        class ShowPeopleController < BaseController
+          private
+
+          # override
+          def model_class
+            SpreeCmCommissioner::ShowPerson
+          end
+
+          # override
+          def scope
+            scope = current_show.show_people
+                                .joins(:assignments)
+                                .distinct
+                                .includes(
+                                  :assignments,
+                                  assigned_contestants: %i[show_contestant_images current_voting_session]
+                                )
+
+            role = params[:role].presence
+            return scope if role.blank?
+
+            role_value = SpreeCmCommissioner::ShowPersonAssignment.roles[role.to_s]
+            return scope.none if role_value.nil?
+
+            scope.where(cm_show_people_assignments: { role: role_value })
+          end
+
+          # override
+          def resource_serializer
+            Spree::V2::Tenant::ShowPersonSerializer
+          end
+
+          # override
+          def collection_serializer
+            Spree::V2::Tenant::ShowPersonSerializer
+          end
+
+          def current_show
+            @current_show ||= show_scope.find_by!(slug: params[:show_id])
+          end
+
+          def show_scope
+            vendor_ids = @tenant.vendors.select(:id)
+            SpreeCmCommissioner::Show.where(vendor_id: vendor_ids)
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/tenant/show_person_assignments_controller.rb

@@ -0,0 +1,36 @@
+module Spree
+  module Api
+    module V2
+      module Tenant
+        class ShowPersonAssignmentsController < BaseController
+          private
+
+          def model_class
+            SpreeCmCommissioner::ShowPersonAssignment
+          end
+
+          def scope
+            vendor_ids = @tenant.vendors.select(:id)
+            show_ids = SpreeCmCommissioner::Show.where(vendor_id: vendor_ids).select(:id)
+
+            model_class.where(show_id: show_ids)
+                       .where(show_person_id: params[:person_id], show_id: current_show.id)
+                       .includes(:show_person, :show)
+          end
+
+          def current_show
+            @current_show ||= SpreeCmCommissioner::Show.find_by!(slug: params[:show_id])
+          end
+
+          def resource_serializer
+            Spree::V2::Tenant::ShowPersonAssignmentSerializer
+          end
+
+          def collection_serializer
+            Spree::V2::Tenant::ShowPersonAssignmentSerializer
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/tenant/shows_controller.rb

@@ -0,0 +1,39 @@
+module Spree
+  module Api
+    module V2
+      module Tenant
+        class ShowsController < BaseController
+          private
+
+          # override
+          def model_class
+            SpreeCmCommissioner::Show
+          end
+
+          def resource
+            @resource ||= scope.find_by!(slug: params[:id])
+          end
+
+          # override
+          def scope
+            vendor_ids = @tenant.vendors.select(:id)
+            return model_class.none if vendor_ids.blank?
+
+            model_class.where(vendor_id: vendor_ids)
+                       .includes(:parent, :app_banner, episodes: :voting_sessions, seasons: { episodes: :voting_sessions })
+          end
+
+          # override
+          def resource_serializer
+            Spree::V2::Tenant::ShowSerializer
+          end
+
+          # override
+          def collection_serializer
+            Spree::V2::Tenant::ShowSerializer
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/tenant/voting_contestants_controller.rb

@@ -0,0 +1,45 @@
+module Spree
+  module Api
+    module V2
+      module Tenant
+        class VotingContestantsController < BaseController
+          before_action :load_voting_session, only: %i[index]
+
+          # override
+          def collection
+            @collection ||= @voting_session
+                            .voting_contestants
+                            .includes(show_contestant: :show_contestant_images)
+                            .order(:id)
+          end
+
+          # override
+          def collection_serializer
+            Spree::V2::Tenant::VotingContestantSerializer
+          end
+
+          private
+
+          # override
+          def model_class
+            SpreeCmCommissioner::VotingSession
+          end
+
+          # override
+          def scope
+            vendor_ids = @tenant.vendors.select(:id)
+            show_ids = SpreeCmCommissioner::Show.where(vendor_id: vendor_ids).select(:id)
+            episode_ids = Spree::Product.where(event_id: show_ids, type: 'SpreeCmCommissioner::ShowEpisode').select(:id)
+            model_class
+              .where(episode_id: episode_ids)
+              .includes(:episode)
+          end
+
+          def load_voting_session
+            @voting_session = scope.find(params[:voting_session_id])
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/spree_cm_commissioner/admin/homepage_segment_helper.rb

@@ -15,6 +15,8 @@ module SpreeCmCommissioner
           'badge badge-success text-uppercase'
         when :football
           'badge badge-dark text-uppercase'
+        when :show
+          'badge badge-danger text-uppercase'
         else
           'badge'
         end

data/app/interactors/spree_cm_commissioner/create_vendor.rb

@@ -11,8 +11,6 @@ module SpreeCmCommissioner
         create_logo
         create_role
       end
-
-      context.vendor = @vendor
     end
 
     private

data/app/interactors/spree_cm_commissioner/pin_code_sender.rb

@@ -20,8 +20,7 @@ module  SpreeCmCommissioner
       options = {
         from: context.pin_code&.application&.sms_sender_id,
         to: context.pin_code.contact,
-        body: I18n.t('pincode_sender.sms.body', code: context.pin_code.code, readable_type: context.pin_code.readable_type),
-        tenant_id: context.pin_code&.application&.tenant_id
+        body: I18n.t('pincode_sender.sms.body', code: context.pin_code.code, readable_type: context.pin_code.readable_type)
       }
 
       SpreeCmCommissioner::SmsPinCodeJob.perform_later(options)

data/app/interactors/spree_cm_commissioner/sms.rb

@@ -36,13 +36,12 @@ module  SpreeCmCommissioner
         from_number: sms_options[:from],
         to_number: sms_options[:to],
         body: sms_options[:body],
-        adapter_name: adapter.class.name.demodulize,
-        tenant_id: sms_options[:tenant_id]
+        adapter_name: adapter.class.name.demodulize
       )
     end
 
     def sms_options
-      opts = { to: context.to, body: context.body, tenant_id: context.tenant_id }
+      opts = { to: context.to, body: context.body }
       opts[:to] = sanitize(opts[:to]) if opts[:to].present?
       opts[:from] = from_number
       opts

data/app/jobs/spree_cm_commissioner/sms_pin_code_job.rb

@@ -1,6 +1,6 @@
 module SpreeCmCommissioner
   class SmsPinCodeJob < SpreeCmCommissioner::SmsJob
-    # options = { from: xxxx, to: xxxx, body: xxxx , tenant_id: xxxx}
+    # options = { from: xxxx, to: xxxx, body: xxxx }
     def perform(options = {})
       SpreeCmCommissioner::Sms.call(options)
     end

data/app/jobs/spree_cm_commissioner/voting_credit_allocation_job.rb

@@ -0,0 +1,10 @@
+module SpreeCmCommissioner
+  class VotingCreditAllocationJob < ApplicationUniqueJob
+    def perform(options = {})
+      order = Spree::Order.find_by(id: options[:order_id])
+      return if order.nil?
+
+      SpreeCmCommissioner::VotingCredits::Allocate.new(order).call
+    end
+  end
+end

data/app/jobs/spree_cm_commissioner/voting_credit_de_allocation_job.rb

@@ -0,0 +1,10 @@
+module SpreeCmCommissioner
+  class VotingCreditDeAllocationJob < ApplicationUniqueJob
+    def perform(options = {})
+      order = Spree::Order.find_by(id: options[:order_id])
+      return if order.nil?
+
+      SpreeCmCommissioner::VotingCredits::DeAllocate.new(order).call
+    end
+  end
+end

data/app/models/concerns/spree_cm_commissioner/homepage_section_bitwise.rb

@@ -8,7 +8,8 @@ module SpreeCmCommissioner
       tour: 0b00100,
       accommodation: 0b01000,
       things_to_do: 0b10000,
-      football: 0b100000
+      football: 0b100000,
+      show: 0b1000000
     }.freeze
 
     BIT_SEGMENT.each do |segment, bit_value|

data/app/models/concerns/spree_cm_commissioner/option_type_attr_type.rb

@@ -45,7 +45,8 @@ module SpreeCmCommissioner
       'color' => 'color',
       'ticket-type' => 'string',
       'seat-type' => 'string',
-      'intercity-taxi' => 'string'
+      'intercity-taxi' => 'string',
+      'vote-package' => 'integer'
     }.freeze
 
     included do

data/app/models/concerns/spree_cm_commissioner/order_state_machine.rb

@@ -27,8 +27,10 @@ module SpreeCmCommissioner
 
       state_machine.after_transition to: :canceled, do: :precalculate_conversion
       state_machine.after_transition to: :canceled, do: :restock_inventory!
+      state_machine.after_transition to: :canceled, do: :de_allocate_resources
 
       state_machine.after_transition to: :complete, do: :increment_route_fulfilled_order_count
+      state_machine.after_transition to: :complete, do: :allocate_resources
 
       scope :accepted, -> { where(request_state: 'accepted') }
 
@@ -322,5 +324,13 @@ module SpreeCmCommissioner
       factory = OrderTelegramMessageFactory.new(title: title, order: self)
       TelegramNotificationSenderJob.perform_later(chat_id: chat_id, message: factory.message, parse_mode: factory.parse_mode)
     end
+
+    def allocate_resources
+      SpreeCmCommissioner::VotingCreditAllocationJob.perform_later(order_id: id)
+    end
+
+    def de_allocate_resources
+      SpreeCmCommissioner::VotingCreditDeAllocationJob.perform_later(order_id: id)
+    end
   end
 end

data/app/models/concerns/spree_cm_commissioner/product_type.rb

@@ -5,7 +5,7 @@ module SpreeCmCommissioner
   module ProductType
     extend ActiveSupport::Concern
 
-    PRODUCT_TYPES = %i[accommodation service ecommerce transit].freeze
+    PRODUCT_TYPES = %i[accommodation service ecommerce transit vote_package].freeze
     PERMANENT_STOCK_PRODUCT_TYPES = %w[accommodation service transit].freeze
     PRE_INVENTORY_DAYS = { 'transit' => 90, 'accommodation' => 365, 'service' => 30 }.freeze
 

data/app/models/spree_cm_commissioner/pin_code.rb

@@ -132,7 +132,7 @@ module SpreeCmCommissioner
         'SpreeCmCommissioner::PinCodeMobileConfirm' => I18n.t('pincode.readable_type.confirmation_code'),
         'SpreeCmCommissioner::PinCodeUpdateUserLogin' => I18n.t('pincode.readable_type.update_user_login'),
         'SpreeCmCommissioner::PinCodeEmailConfirm' => I18n.t('pincode.readable_type.confirmation_code'),
-        'SpreeCmCommissioner::PinCodeOtp' => I18n.t('pincode.readable_type.otp_code'),
+        'SpreeCmCommissioner::OtpCode' => I18n.t('pincode.readable_type.otp_code'),
         'SpreeCmCommissioner::PinCodeTelegram' => I18n.t('pincode.readable_type.telegram_verification')
       }
     end

data/app/models/spree_cm_commissioner/role_decorator.rb

@@ -1,8 +1,6 @@
 module SpreeCmCommissioner
   module RoleDecorator
     def self.prepended(base)
-      base.enum role_type: { internal: 0, external: 1 }
-
       base.has_many :role_permissions, class_name: 'SpreeCmCommissioner::RolePermission'
       base.has_many :permissions, through: :role_permissions, class_name: 'SpreeCmCommissioner::Permission'
 
@@ -12,7 +10,6 @@ module SpreeCmCommissioner
       base.scope :filter_by_vendor, lambda { |vendor|
         where(vendor_id: vendor)
       }
-      base.scope :filter_external, -> { where(role_type: :external) }
 
       base.accepts_nested_attributes_for :role_permissions, allow_destroy: true
 

data/app/models/spree_cm_commissioner/show.rb

@@ -0,0 +1,140 @@
+module SpreeCmCommissioner
+  class Show < Spree::Taxon
+    include SpreeCmCommissioner::StoreMetadata
+
+    has_many :seasons, class_name: 'SpreeCmCommissioner::Show', foreign_key: :parent_id, inverse_of: :parent
+    has_many :show_contestants, class_name: 'SpreeCmCommissioner::ShowContestant', inverse_of: :show, dependent: :destroy
+    has_many :show_people_assignments, class_name: 'SpreeCmCommissioner::ShowPersonAssignment', dependent: :destroy
+    has_many :show_people, through: :show_people_assignments, source: :show_person
+    has_many :episodes, class_name: 'SpreeCmCommissioner::ShowEpisode', foreign_key: :event_id
+    has_one :current_episode, -> { current_or_next_upcoming }, class_name: 'SpreeCmCommissioner::ShowEpisode', foreign_key: :event_id
+    has_one :current_voting_session, through: :current_episode
+
+    before_validation { self.type = self.class.name }
+    before_validation { self.kind = :event }
+    before_validation :assign_taxonomy_and_parent, on: :create
+
+    store_private_metadata :season_number, :integer
+    store_private_metadata :season_year, :integer
+
+    # Define standard voting configuration keys
+    store_accessor :voting_config,
+                   :free_vote_limit,
+                   :free_vote_limit_type,
+                   :paid_vote_enabled,
+                   :max_paid_votes_per_session,
+                   :sms_vote_enabled,
+                   :sms_vote_cost_usd,
+                   :operator_vote_enabled
+
+    # voting_credit_scope determines how purchased vote credits are grouped (scoped).
+    # Changing this after credits have been allocated will cause inconsistencies:
+    #   - existing credits are scoped to the old type (e.g. ShowEpisode),
+    #     but new purchases will create credits under the new type (e.g. Show),
+    #     leading to split balances that cannot be merged.
+    # UI rule: once voting_credit_scope is set and any VotingCredit exists for this show, the field must be read-only — do not allow changes.
+    # Note: VoteCredit of user should base on CREDIT_SCOPES
+    #   - if scope is Show, User's credits should be only 1 per show, and can be used for any episode under the show.
+    #   - if scope is ShowEpisode, User's credits should be N per show (N is the number of episodes), and can be only used for specific episode.
+    #   - if scope is VotingSession, User's credits should be N per show (N is the number of voting sessions), and can be only used for specific voting session. # rubocop:disable Layout/LineLength
+    CREDIT_SCOPES = %w[Show ShowEpisode VotingSession].freeze
+
+    def self.polymorphic_name
+      name
+    end
+
+    validate :voting_credit_scope_immutable, if: :voting_credit_scope_changed?
+
+    def credit_votable_type
+      voting_credit_scope = self[:voting_credit_scope] || 'ShowEpisode'
+
+      type = CREDIT_SCOPES.include?(voting_credit_scope) ? voting_credit_scope : 'ShowEpisode'
+      "SpreeCmCommissioner::#{type}"
+    end
+
+    # Define standard fraud configuration keys
+    store_accessor :fraud_config,
+                   :max_votes_per_minute_per_user,
+                   :max_votes_per_minute_per_ip,
+                   :max_accounts_per_device,
+                   :block_vpn
+
+    def show?
+      depth == 1
+    end
+
+    def season?
+      depth == 2
+    end
+
+    def display_name
+      if season? && parent.present?
+        "#{parent.name} #{name}"
+      else
+        name
+      end
+    end
+
+    def contestants
+      show_contestants
+    end
+
+    def effective_voting_config
+      config = parse_json_config(voting_config)
+      return config if show?
+
+      config.reverse_merge(parent&.effective_voting_config || {})
+    end
+
+    def effective_fraud_config
+      config = parse_json_config(fraud_config)
+      return config if show?
+
+      config.reverse_merge(parent&.effective_fraud_config || {})
+    end
+
+    def build_next_season(attributes = {})
+      last_season = seasons.order(created_at: :desc).first
+
+      default_number = (last_season&.season_number || 0) + 1
+      default_year = last_season&.season_year || Time.current.year
+
+      seasons.new(
+        {
+          season_number: default_number,
+          season_year: default_year
+        }.merge(attributes)
+      )
+    end
+
+    private
+
+    def assign_taxonomy_and_parent
+      if parent.present?
+        self.taxonomy ||= parent.taxonomy
+      elsif taxonomy_id.blank?
+        self.taxonomy = Spree::Taxonomy.shows
+        self.parent = taxonomy.root
+      end
+    end
+
+    def voting_credit_scope_immutable
+      show_has_credits = SpreeCmCommissioner::VotingCredit.exists?(votable_type: 'SpreeCmCommissioner::Show', votable_id: id)
+      episode_has_credits = SpreeCmCommissioner::VotingCredit.exists?(votable_type: 'SpreeCmCommissioner::ShowEpisode',
+                                                                      votable_id: episodes.select(:id)
+                                                                     )
+      return unless show_has_credits || episode_has_credits
+
+      errors.add(:voting_credit_scope, 'cannot be changed after voting credits have been allocated')
+    end
+
+    def parse_json_config(value)
+      return {} if value.nil? || value == ''
+      return value if value.is_a?(Hash)
+
+      JSON.parse(value)
+    rescue JSON::ParserError
+      {}
+    end
+  end
+end

data/app/models/spree_cm_commissioner/show_contestant.rb

@@ -0,0 +1,29 @@
+module SpreeCmCommissioner
+  class ShowContestant < SpreeCmCommissioner::Base
+    belongs_to :show, class_name: 'SpreeCmCommissioner::Show', optional: false
+    belongs_to :assigned_show_person, class_name: 'SpreeCmCommissioner::ShowPerson', optional: true
+    belongs_to :user, class_name: 'Spree::User', optional: true
+    has_many :show_contestant_images, lambda {
+                                        order(:position)
+                                      }, as: :viewable, class_name: 'SpreeCmCommissioner::ShowContestantImage', dependent: :destroy
+    has_one :show_person_images, -> { order(:position) }, as: :viewable, class_name: 'SpreeCmCommissioner::ShowPersonImage', dependent: :destroy
+
+    has_many :voting_contestants, class_name: 'SpreeCmCommissioner::VotingContestant', dependent: :destroy
+    has_one :current_voting_session, through: :show
+
+    enum status: { active: 0, eliminated: 1, advanced: 2, winner: 3, withdrawn: 4 }
+    enum gender: { :other => 0, :male => 1, :female => 2 }
+
+    enum category: { boys: 0, girls: 1, groups: 2, overs: 3 }
+
+    # Define standard Social Link Keys
+    store_accessor :social_links, :facebook, :instagram, :twitter, :linkedin, :youtube, :tiktok, :telegram
+
+    validates :name, presence: true
+    validates :contestant_number, uniqueness: { scope: :show_id }, allow_nil: true
+
+    scope :ordered, -> { order(:position, :id) }
+
+    self.whitelisted_ransackable_attributes = %w[name contestant_number status gender category]
+  end
+end

data/app/models/spree_cm_commissioner/show_contestant_image.rb

@@ -0,0 +1,11 @@
+module SpreeCmCommissioner
+  class ShowContestantImage < Asset
+    def asset_styles
+      {
+        thumb: '60x60>',
+        small: '180x180>',
+        medium: '480x480>'
+      }
+    end
+  end
+end