feat(payouts): implement promoter earnings viewing, request flow, and admin Stripe processing with webhooks

Add model methods for accurate net calculations (€0.50 + 1.5% fees), eligibility, refund handling
Update promoter/payouts controller for index (pending events), create (eligibility checks)
Integrate admin processing via Stripe::Transfer, webhook for status sync
Enhance views: index pending cards, events/show preview/form
Add comprehensive tests (models, controllers, service, integration); run migrations

app/models/earning.rb

@@ -1,4 +1,22 @@
 class Earning < ApplicationRecord
+  def self.create_from_order(order)
+    return unless order.paid? || order.completed?
+
+    gross_cents = order.tickets.active.sum(:price_cents)
+    fee_cents = order.tickets.active.sum do |ticket|
+      50 + (ticket.price_cents * 0.015).to_i
+    end
+    amount_cents = gross_cents - fee_cents
+
+    create!(
+      event: order.event,
+      user: order.event.user,
+      order: order,
+      amount_cents: amount_cents,
+      fee_cents: fee_cents,
+      status: :pending
+    )
+  end
   # === Relations ===
   belongs_to :event
   belongs_to :user
@@ -13,4 +31,24 @@ class Earning < ApplicationRecord
   validates :net_amount_cents, numericality: { greater_than_or_equal_to: 0, allow_nil: true }
   validates :status, presence: true
   validates :stripe_payout_id, allow_blank: true, uniqueness: true
+
+  # Recalculate earning based on active tickets in the order
+  def recalculate!
+    return unless order.present?
+
+    active_tickets = order.tickets.active
+    if active_tickets.empty?
+      update!(amount_cents: 0, fee_cents: 0)
+    else
+      gross_cents = active_tickets.sum(:price_cents)
+      fee_cents = active_tickets.sum do |ticket|
+        50 + (ticket.price_cents * 0.015).to_i
+      end
+      update!(amount_cents: gross_cents - fee_cents, fee_cents: fee_cents)
+    end
+  end
+
+  def recalculate_on_refund(order)
+    recalculate!
+  end
 end

app/models/event.rb

@@ -66,24 +66,26 @@ class Event < ApplicationRecord
   # Scope for published events ordered by start time
   scope :upcoming, -> { published.where("start_time >= ?", Time.current).order(start_time: :asc) }
 
+  # Scope for events eligible for payout
+  scope :eligible_for_payout, -> { where("end_time <= ?", Time.current).joins(:earnings).group("events.id").having("SUM(earnings.amount_cents) > 0") }
+
   # === Instance Methods ===
 
   # Payout methods
-  def can_request_payout?
-    event_ended? && earnings.pending.any? && user.can_receive_payouts?
-  end
-
-  def total_earnings_cents
-    # Only count earnings from non-refunded tickets
-    earnings.pending.sum(:amount_cents)
+  def total_gross_cents
+    tickets.active.sum(:price_cents)
   end
 
   def total_fees_cents
-    (total_earnings_cents * 0.1).to_i # 10% platform fee
+    earnings.pending.sum(:fee_cents)
   end
 
   def net_earnings_cents
-    total_earnings_cents - total_fees_cents
+    total_gross_cents - total_fees_cents
+  end
+
+  def can_request_payout?(user = self.user)
+    event_ended? && (net_earnings_cents > 0) && user.is_professionnal? && payouts.pending.empty?
   end
 
   # Check if coordinates were successfully geocoded or are fallback coordinates

app/models/order.rb

@@ -3,6 +3,16 @@ class Order < ApplicationRecord
   DRAFT_EXPIRY_TIME = 15.minutes
   MAX_PAYMENT_ATTEMPTS = 3
 
+  # === Enums ===
+  enum :status, {
+    draft: 0,
+    pending_payment: 1,
+    paid: 2,
+    completed: 3,
+    cancelled: 4,
+    expired: 5
+  }, default: :draft
+
   # === Associations ===
   belongs_to :user
   belongs_to :event
@@ -23,8 +33,9 @@ class Order < ApplicationRecord
   attr_accessor :stripe_invoice_id
 
   # === Scopes ===
-  scope :draft, -> { where(status: "draft") }
-  scope :active, -> { where(status: %w[paid completed]) }
+  scope :draft, -> { where(status: :draft) }
+  scope :active, -> { where(status: [ :paid, :completed ]) }
+  scope :paid, -> { where(status: :paid) }
   scope :expired_drafts, -> { draft.where("expires_at < ?", Time.current) }
   scope :can_retry_payment, -> {
     draft.where("payment_attempts < ? AND expires_at > ?",

app/models/payout.rb

@@ -12,18 +12,44 @@ class Payout < ApplicationRecord
   }, default: :pending
 
   # === Validations ===
-  validates :amount_cents, presence: true, numericality: { greater_than_or_equal_to: 0 }
+  validates :amount_cents, presence: true, numericality: { greater_than: 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
+  validate :unique_pending_event_id, if: :pending?
+
+  validate :net_earnings_greater_than_zero, if: :pending?
+
+  def net_earnings_greater_than_zero
+    if event.net_earnings_cents <= 0
+      errors.add(:base, "net earnings must be greater than 0")
+    end
+  end
+
+  validate :net_earnings_greater_than_zero, if: :pending?
+
+  def net_earnings_greater_than_zero
+    if event.net_earnings_cents <= 0
+      errors.add(:base, "net earnings must be greater than 0")
+    end
+  end
+
+  def unique_pending_event_id
+    if Payout.pending.where(event_id: event_id).where.not(id: id).exists?
+      errors.add(:base, "only one pending payout allowed per event")
+    end
+  end
 
   # === Scopes ===
   scope :completed, -> { where(status: :completed) }
   scope :pending, -> { where(status: :pending) }
   scope :processing, -> { where(status: :processing) }
 
+  # === Callbacks ===
+  after_create :calculate_refunded_orders_count
+
   # === Instance Methods ===
 
   # Amount in euros (formatted)
@@ -56,4 +82,14 @@ class Payout < ApplicationRecord
     service = PayoutService.new(self)
     service.process!
   end
-end
+  public
+
+  # === Instance Methods ===
+
+  def calculate_refunded_orders_count
+    refunded_order_ids = event.tickets.where(status: "refunded").select(:order_id).distinct.pluck(:order_id)
+    paid_statuses = %w[paid completed]
+    count = event.orders.where(status: paid_statuses).where(id: refunded_order_ids).count
+    update_column(:refunded_orders_count, count)
+  end
+end

app/models/ticket.rb

@@ -22,6 +22,8 @@ class Ticket < ApplicationRecord
   before_validation :set_price_from_ticket_type, on: :create
   before_validation :generate_qr_code, on: :create
 
+  after_update :recalculate_earning_if_refunded, if: :saved_change_to_status?
+
   # Generate PDF ticket
   def to_pdf
     TicketPdfGenerator.new(self).generate
@@ -73,4 +75,12 @@ class Ticket < ApplicationRecord
   def draft?
     status == "draft"
   end
+
+  private
+
+  def recalculate_earning_if_refunded
+    if status == "refunded"
+      order.earning&.recalculate!
+    end
+  end
 end

app/models/user.rb

@@ -65,6 +65,19 @@ class User < ApplicationRecord
   end
 
   def can_receive_payouts?
-    has_stripe_account? && promoter?
+    stripe_connected_account_id.present? && stripe_connect_verified?
+  end
+  private
+
+  def stripe_connect_verified?
+    return false unless stripe_connected_account_id.present?
+
+    begin
+      account = Stripe::Account.retrieve(stripe_connected_account_id)
+      account.charges_enabled
+    rescue Stripe::StripeError => e
+      Rails.logger.error "Failed to verify Stripe account #{stripe_connected_account_id}: #{e.message}"
+      false
+    end
   end
 end