feat: Implement promoter payout system for event revenue processing

- Add Payout model with associations to User and Event
- Create payout requests for completed events with proper earnings calculation
- Exclude refunded tickets from payout calculations
- Add promoter dashboard views for managing payouts
- Implement admin interface for processing payouts
- Integrate with Stripe for actual payment processing
- Add comprehensive tests for payout functionality

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

app/models/event.rb

@@ -30,6 +30,7 @@ class Event < ApplicationRecord
   has_many :tickets, through: :ticket_types
   has_many :orders
   has_many :earnings, dependent: :destroy
+  has_many :payouts, dependent: :destroy
 
   # === Callbacks ===
   before_validation :geocode_address, if: :should_geocode_address?
@@ -73,6 +74,7 @@ class Event < ApplicationRecord
   end
 
   def total_earnings_cents
+    # Only count earnings from non-refunded tickets
     earnings.pending.sum(:amount_cents)
   end
 

app/models/order.rb

@@ -160,22 +160,9 @@ class Order < ApplicationRecord
     self.expires_at = DRAFT_EXPIRY_TIME.from_now if expires_at.blank?
   end
 
-def draft?
-  status == "draft"
-end
-
-def create_earnings_if_paid
-  return unless event.present? && user.present?
-  return if event.earnings.exists?(order_id: id)
-
-  event.earnings.create!(
-    user: user,
-    order: self,
-    amount_cents: promoter_payout_cents,
-    fee_cents: platform_fee_cents,
-    status: :pending
-  )
-end
+  def draft?
+    status == "draft"
+  end
 
   def create_earnings_if_paid
     return unless event.present? && user.present?

app/models/payout.rb

@@ -0,0 +1,59 @@
+class Payout < ApplicationRecord
+  # === Relations ===
+  belongs_to :user
+  belongs_to :event
+
+  # === Enums ===
+  enum :status, {
+    pending: 0,      # Payout requested but not processed
+    processing: 1,   # Payout being processed
+    completed: 2,    # Payout successfully completed
+    failed: 3        # Payout failed
+  }, default: :pending
+
+  # === Validations ===
+  validates :amount_cents, presence: true, numericality: { greater_than_or_equal_to: 0 }
+  validates :fee_cents, presence: true, numericality: { greater_than_or_equal_to: 0 }
+  validates :status, presence: true
+  validates :total_orders_count, presence: true, numericality: { greater_than_or_equal_to: 0 }
+  validates :refunded_orders_count, presence: true, numericality: { greater_than_or_equal_to: 0 }
+  validates :stripe_payout_id, allow_blank: true, uniqueness: true
+
+  # === Scopes ===
+  scope :completed, -> { where(status: :completed) }
+  scope :pending, -> { where(status: :pending) }
+  scope :processing, -> { where(status: :processing) }
+
+  # === Instance Methods ===
+
+  # Amount in euros (formatted)
+  def amount_euros
+    amount_cents / 100.0
+  end
+
+  # Fee in euros (formatted)
+  def fee_euros
+    fee_cents / 100.0
+  end
+
+  # Net amount after fees
+  def net_amount_cents
+    amount_cents - fee_cents
+  end
+
+  # Net amount in euros
+  def net_amount_euros
+    net_amount_cents / 100.0
+  end
+
+  # Check if payout can be processed
+  def can_process?
+    pending? && amount_cents > 0
+  end
+
+  # Process the payout through Stripe
+  def process_payout!
+    service = PayoutService.new(self)
+    service.process!
+  end
+end

app/models/user.rb

@@ -24,6 +24,7 @@ class User < ApplicationRecord
   has_many :tickets, dependent: :destroy
   has_many :orders, dependent: :destroy
   has_many :earnings, dependent: :destroy
+  has_many :payouts, dependent: :destroy
 
   # Validations - allow reasonable name lengths
   validates :last_name,   length: { minimum: 2, maximum: 50, allow_blank: true }