saas_platform 0.1.0

data/app/models/saas_platform/order.rb

@@ -0,0 +1,43 @@
+module SaasPlatform
+  class Order < ApplicationRecord
+    has_paper_trail
+    include AASM
+    acts_as_tenant :account, class_name: 'SaasPlatform::Account'
+    
+    belongs_to :user, class_name: 'SaasPlatform::User'
+    has_many :items, class_name: 'SaasPlatform::OrderItem', dependent: :destroy
+    has_many :transactions, as: :reference, class_name: 'SaasPlatform::Transaction'
+    
+    monetize :total_cents
+    
+    aasm column: :status do
+      state :pending, initial: true
+      state :paid
+      state :shipped
+      state :completed
+      state :cancelled
+      state :refunded
+
+      event :pay do
+        transitions from: :pending, to: :paid
+      end
+
+      event :ship do
+        transitions from: :paid, to: :shipped
+      end
+
+      event :complete do
+        transitions from: :shipped, to: :completed
+      end
+
+      event :cancel do
+        transitions from: [:pending, :paid], to: :cancelled
+      end
+    end
+    
+    def calculate_total!
+      self.total = items.sum { |item| item.unit_price * item.quantity }
+      save!
+    end
+  end
+end

data/app/models/saas_platform/order_item.rb

@@ -0,0 +1,18 @@
+module SaasPlatform
+  class OrderItem < ApplicationRecord
+    belongs_to :order, class_name: 'SaasPlatform::Order'
+    belongs_to :product, class_name: 'SaasPlatform::Product'
+    
+    monetize :unit_price_cents
+    
+    validates :quantity, presence: true, numericality: { greater_than: 0 }
+    
+    before_validation :set_unit_price, on: :create
+    
+    private
+    
+    def set_unit_price
+      self.unit_price = product.price if product
+    end
+  end
+end

data/app/models/saas_platform/product.rb

@@ -0,0 +1,15 @@
+module SaasPlatform
+  class Product < ApplicationRecord
+    include PgSearch::Model
+    pg_search_scope :search_by_name, against: [:name, :description]
+    
+    acts_as_tenant :account, class_name: 'SaasPlatform::Account'
+    
+    monetize :price_cents
+    
+    validates :name, presence: true
+    validates :price_cents, numericality: { greater_than_or_equal_to: 0 }
+    
+    scope :active, -> { where(status: 'active') }
+  end
+end

data/app/models/saas_platform/role.rb

@@ -0,0 +1,15 @@
+module SaasPlatform
+  class Role < ApplicationRecord
+    has_and_belongs_to_many :users, join_table: :saas_platform_users_saas_platform_roles
+    
+    belongs_to :resource,
+               polymorphic: true,
+               optional: true
+    
+    validates :resource_type,
+              inclusion: { in: Rolify.resource_types },
+              allow_nil: true
+
+    scopify
+  end
+end

data/app/models/saas_platform/transaction.rb

@@ -0,0 +1,15 @@
+module SaasPlatform
+  class Transaction < ApplicationRecord
+    belongs_to :wallet, class_name: 'SaasPlatform::Wallet'
+    belongs_to :reference, polymorphic: true, optional: true
+    
+    monetize :amount_cents
+    
+    validates :transaction_type, inclusion: { in: %w[credit debit] }
+    validates :status, presence: true
+    
+    scope :recent, -> { order(created_at: :desc) }
+    scope :credits, -> { where(transaction_type: 'credit') }
+    scope :debits, -> { where(transaction_type: 'debit') }
+  end
+end

data/app/models/saas_platform/user.rb

@@ -0,0 +1,52 @@
+module SaasPlatform
+  class User < ApplicationRecord
+    include PgSearch::Model
+    pg_search_scope :search_by_name, against: [:first_name, :last_name, :email]
+    
+    acts_as_tenant :account, class_name: 'SaasPlatform::Account'
+    rolify role_cname: 'SaasPlatform::Role'
+    
+    # Include default devise modules. Others available are:
+    # :omniauthable
+    devise :two_factor_authenticatable, :database_authenticatable, :registerable,
+           :recoverable, :rememberable, :validatable, :confirmable, :lockable,
+           :trackable, :omniauthable,
+           otp_secret_encryption_key: ENV['OTP_SECRET_ENCRYPTION_KEY']
+
+    # Validations
+    validates :first_name, presence: true
+    validates :last_name, presence: true
+
+    # Scopes
+    scope :active, -> { where(status: 'active', deleted_at: nil) }
+    scope :deleted, -> { where.not(deleted_at: nil) }
+
+    def name
+      "#{first_name} #{last_name}"
+    end
+
+    def super_admin?
+      has_role?(:super_admin)
+    end
+
+    def admin?
+      has_role?(:admin) || super_admin?
+    end
+
+    def manager?
+      has_role?(:manager) || admin?
+    end
+
+    def staff?
+      has_role?(:staff) || manager?
+    end
+
+    def soft_delete
+      update(deleted_at: Time.current, status: 'deleted')
+    end
+
+    def active_for_authentication?
+      super && deleted_at.nil? && status == 'active'
+    end
+  end
+end

data/app/models/saas_platform/wallet.rb

@@ -0,0 +1,38 @@
+module SaasPlatform
+  class Wallet < ApplicationRecord
+    has_paper_trail
+    belongs_to :account, class_name: 'SaasPlatform::Account'
+    has_many :transactions, class_name: 'SaasPlatform::Transaction', dependent: :destroy
+    
+    register_currency :usd
+    monetize :balance_cents
+    
+    validates :currency, presence: true
+    
+    def credit!(amount, category: nil, reference: nil, metadata: {})
+      transactions.create!(
+        amount: amount,
+        transaction_type: 'credit',
+        category: category,
+        reference: reference,
+        metadata: metadata,
+        status: 'completed'
+      )
+      update!(balance: balance + amount)
+    end
+
+    def debit!(amount, category: nil, reference: nil, metadata: {})
+      raise "Insufficient funds" if balance < amount
+      
+      transactions.create!(
+        amount: amount,
+        transaction_type: 'debit',
+        category: category,
+        reference: reference,
+        metadata: metadata,
+        status: 'completed'
+      )
+      update!(balance: balance - amount)
+    end
+  end
+end

data/app/models/saas_platform/webhook_endpoint.rb

@@ -0,0 +1,18 @@
+module SaasPlatform
+  class WebhookEndpoint < ApplicationRecord
+    acts_as_tenant :account, class_name: 'SaasPlatform::Account'
+    
+    validates :url, presence: true, format: { with: URI::DEFAULT_PARSER.make_regexp(['http', 'https']) }
+    validates :secret, presence: true
+    
+    before_validation :generate_secret, on: :create
+    
+    scope :active, -> { where(active: true) }
+
+    private
+    
+    def generate_secret
+      self.secret = "whsec_#{SecureRandom.hex(24)}"
+    end
+  end
+end

data/app/models/saas_platform/webhook_event.rb

@@ -0,0 +1,10 @@
+module SaasPlatform
+  class WebhookEvent < ApplicationRecord
+    acts_as_tenant :account, class_name: 'SaasPlatform::Account'
+    
+    belongs_to :webhook_endpoint, class_name: 'SaasPlatform::WebhookEndpoint'
+    
+    validates :event_type, presence: true
+    validates :payload, presence: true
+  end
+end

data/app/policies/saas_platform/application_policy.rb

@@ -0,0 +1,53 @@
+module SaasPlatform
+  class ApplicationPolicy
+    attr_reader :user, :record
+
+    def initialize(user, record)
+      @user = user
+      @record = record
+    end
+
+    def index?
+      false
+    end
+
+    def show?
+      false
+    end
+
+    def create?
+      false
+    end
+
+    def new?
+      create?
+    end
+
+    def update?
+      false
+    end
+
+    def edit?
+      update?
+    end
+
+    def destroy?
+      false
+    end
+
+    class Scope
+      def initialize(user, scope)
+        @user = user
+        @scope = scope
+      end
+
+      def resolve
+        scope.all
+      end
+
+      private
+
+      attr_reader :user, :scope
+    end
+  end
+end

data/app/services/saas_platform/analytics_service.rb

@@ -0,0 +1,29 @@
+module SaasPlatform
+  class AnalyticsService
+    def initialize(account)
+      @account = account
+    end
+
+    def revenue_over_time(period: :day, last: 30)
+      @account.orders.paid
+              .group_by_period(period, :created_at, last: last)
+              .sum(:total_cents)
+              .transform_values { |v| v / 100.0 }
+    end
+
+    def top_products(limit: 5)
+      SaasPlatform::OrderItem.joins(:order)
+                             .where(saas_platform_orders: { account_id: @account.id, status: 'paid' })
+                             .joins(:product)
+                             .group('saas_platform_products.name')
+                             .sum(:quantity)
+                             .sort_by { |_k, v| -v }
+                             .first(limit)
+                             .to_h
+    end
+
+    def user_growth(period: :week, last: 12)
+      @account.users.group_by_period(period, :created_at, last: last).count
+    end
+  end
+end

data/app/services/saas_platform/payment_service.rb

@@ -0,0 +1,32 @@
+module SaasPlatform
+  class PaymentService
+    def initialize(account)
+      @account = account
+      @wallet = account.wallet || account.create_wallet(currency: 'USD')
+    end
+
+    def process_order_payment(order, stripe_payment_intent_id)
+      # In a real app, verify with Stripe
+      # stripe_payload = Stripe::PaymentIntent.retrieve(stripe_payment_intent_id)
+      
+      Order.transaction do
+        order.pay!
+        @wallet.credit!(order.total, category: 'sale', reference: order)
+        
+        # Log audit trail
+        @account.notifications.create(
+          message: "Payment of #{order.total.format} received for Order ##{order.id}",
+          category: 'payment'
+        )
+      end
+    end
+
+    def withdraw_funds(amount)
+      raise "Insufficient balance" if @wallet.balance < amount
+      
+      @wallet.debit!(amount, category: 'withdrawal', status: 'pending')
+      # Trigger background job for payout
+      # PayoutJob.perform_later(@account.id, amount.cents)
+    end
+  end
+end

data/app/services/saas_platform/plan_service.rb

@@ -0,0 +1,45 @@
+module SaasPlatform
+  class PlanService
+    PLANS = {
+      'free' => {
+        name: 'Free',
+        max_users: 2,
+        max_products: 5,
+        features: [:basic_analytics]
+      },
+      'pro' => {
+        name: 'Pro',
+        max_users: 10,
+        max_products: 100,
+        features: [:basic_analytics, :advanced_analytics, :api_access]
+      },
+      'enterprise' => {
+        name: 'Enterprise',
+        max_users: 1000,
+        max_products: 10000,
+        features: [:basic_analytics, :advanced_analytics, :api_access, :webhooks, :audit_logs]
+      }
+    }.freeze
+
+    def initialize(account)
+      @account = account
+      @plan_config = PLANS[account.plan_name] || PLANS['free']
+    end
+
+    def can_add_user?
+      @account.users.count < @plan_config[:max_users]
+    end
+
+    def can_add_product?
+      @account.products.count < @plan_config[:max_products]
+    end
+
+    def has_feature?(feature)
+      @plan_config[:features].include?(feature.to_sym)
+    end
+
+    def plan_details
+      @plan_config
+    end
+  end
+end

data/app/services/saas_platform/search_service.rb

@@ -0,0 +1,20 @@
+module SaasPlatform
+  class SearchService
+    def initialize(account, query)
+      @account = account
+      @query = query
+    end
+
+    def perform
+      return {} if @query.blank?
+
+      ActsAsTenant.with_tenant(@account) do
+        {
+          users: SaasPlatform::User.search_by_name(@query).limit(5),
+          products: SaasPlatform::Product.search_by_name(@query).limit(5),
+          orders: SaasPlatform::Order.where(id: @query.to_i).limit(5) # Simple ID search for orders
+        }
+      end
+    end
+  end
+end

data/app/views/devise/registrations/new.html.erb

@@ -0,0 +1,59 @@
+<% content_for :header do %>
+  Create your account
+<% end %>
+
+<%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { class: "space-y-6" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="grid grid-cols-2 gap-4">
+    <div>
+      <%= f.label :first_name, class: "block text-sm font-medium text-apple-gray" %>
+      <div class="mt-1">
+        <%= f.text_field :first_name, autofocus: true, class: "block w-full appearance-none rounded-apple border border-gray-200 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-apple-blue focus:outline-none focus:ring-apple-blue sm:text-sm transition-all" %>
+      </div>
+    </div>
+    <div>
+      <%= f.label :last_name, class: "block text-sm font-medium text-apple-gray" %>
+      <div class="mt-1">
+        <%= f.text_field :last_name, class: "block w-full appearance-none rounded-apple border border-gray-200 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-apple-blue focus:outline-none focus:ring-apple-blue sm:text-sm transition-all" %>
+      </div>
+    </div>
+  </div>
+
+  <div>
+    <%= f.label :email, class: "block text-sm font-medium text-apple-gray" %>
+    <div class="mt-1">
+      <%= f.email_field :email, autocomplete: "email", class: "block w-full appearance-none rounded-apple border border-gray-200 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-apple-blue focus:outline-none focus:ring-apple-blue sm:text-sm transition-all" %>
+    </div>
+  </div>
+
+  <div>
+    <%= f.label :password, class: "block text-sm font-medium text-apple-gray" %>
+    <% if @minimum_password_length %>
+      <em class="text-xs text-apple-gray">(<%= @minimum_password_length %> characters minimum)</em>
+    <% end %>
+    <div class="mt-1">
+      <%= f.password_field :password, autocomplete: "new-password", class: "block w-full appearance-none rounded-apple border border-gray-200 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-apple-blue focus:outline-none focus:ring-apple-blue sm:text-sm transition-all" %>
+    </div>
+  </div>
+
+  <div>
+    <%= f.label :password_confirmation, class: "block text-sm font-medium text-apple-gray" %>
+    <div class="mt-1">
+      <%= f.password_field :password_confirmation, autocomplete: "new-password", class: "block w-full appearance-none rounded-apple border border-gray-200 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-apple-blue focus:outline-none focus:ring-apple-blue sm:text-sm transition-all" %>
+    </div>
+  </div>
+
+  <div>
+    <%= render SaasPlatform::ButtonComponent.new(variant: :primary, type: :submit, class: "w-full") do %>
+      Create Account
+    <% end %>
+  </div>
+<% end %>
+
+<% content_for :footer do %>
+  <p class="text-sm text-apple-gray">
+    Already have an account? 
+    <%= link_to "Sign in", new_session_path(resource_name), class: "font-medium text-apple-blue hover:text-blue-500" %>
+  </p>
+<% end %>

data/app/views/devise/saas_platform_users/confirmations/new.html.erb

@@ -0,0 +1,16 @@
+<h2>Resend confirmation instructions</h2>
+
+<%= form_for(resource, as: resource_name, url: confirmation_path(resource_name), html: { method: :post }) do |f| %>
+  <%= render "saas_platform_users/shared/error_messages", resource: resource %>
+
+  <div class="field">
+    <%= f.label :email %><br />
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", value: (resource.pending_reconfirmation? ? resource.unconfirmed_email : resource.email) %>
+  </div>
+
+  <div class="actions">
+    <%= f.submit "Resend confirmation instructions" %>
+  </div>
+<% end %>
+
+<%= render "saas_platform_users/shared/links" %>

data/app/views/devise/saas_platform_users/mailer/confirmation_instructions.html.erb

@@ -0,0 +1,5 @@
+<p>Welcome <%= @email %>!</p>
+
+<p>You can confirm your account email through the link below:</p>
+
+<p><%= link_to 'Confirm my account', confirmation_url(@resource, confirmation_token: @token) %></p>

data/app/views/devise/saas_platform_users/mailer/email_changed.html.erb

@@ -0,0 +1,7 @@
+<p>Hello <%= @email %>!</p>
+
+<% if @resource.try(:unconfirmed_email?) %>
+  <p>We're contacting you to notify you that your email is being changed to <%= @resource.unconfirmed_email %>.</p>
+<% else %>
+  <p>We're contacting you to notify you that your email has been changed to <%= @resource.email %>.</p>
+<% end %>

data/app/views/devise/saas_platform_users/mailer/password_change.html.erb

@@ -0,0 +1,3 @@
+<p>Hello <%= @resource.email %>!</p>
+
+<p>We're contacting you to notify you that your password has been changed.</p>

data/app/views/devise/saas_platform_users/mailer/reset_password_instructions.html.erb

@@ -0,0 +1,8 @@
+<p>Hello <%= @resource.email %>!</p>
+
+<p>Someone has requested a link to change your password. You can do this through the link below.</p>
+
+<p><%= link_to 'Change my password', edit_password_url(@resource, reset_password_token: @token) %></p>
+
+<p>If you didn't request this, please ignore this email.</p>
+<p>Your password won't change until you access the link above and create a new one.</p>

data/app/views/devise/saas_platform_users/mailer/unlock_instructions.html.erb

@@ -0,0 +1,7 @@
+<p>Hello <%= @resource.email %>!</p>
+
+<p>Your account has been locked due to an excessive number of unsuccessful sign in attempts.</p>
+
+<p>Click the link below to unlock your account:</p>
+
+<p><%= link_to 'Unlock my account', unlock_url(@resource, unlock_token: @token) %></p>

data/app/views/devise/saas_platform_users/passwords/edit.html.erb

@@ -0,0 +1,25 @@
+<h2>Change your password</h2>
+
+<%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :put }) do |f| %>
+  <%= render "saas_platform_users/shared/error_messages", resource: resource %>
+  <%= f.hidden_field :reset_password_token %>
+
+  <div class="field">
+    <%= f.label :password, "New password" %><br />
+    <% if @minimum_password_length %>
+      <em>(<%= @minimum_password_length %> characters minimum)</em><br />
+    <% end %>
+    <%= f.password_field :password, autofocus: true, autocomplete: "new-password" %>
+  </div>
+
+  <div class="field">
+    <%= f.label :password_confirmation, "Confirm new password" %><br />
+    <%= f.password_field :password_confirmation, autocomplete: "new-password" %>
+  </div>
+
+  <div class="actions">
+    <%= f.submit "Change my password" %>
+  </div>
+<% end %>
+
+<%= render "saas_platform_users/shared/links" %>

data/app/views/devise/saas_platform_users/passwords/new.html.erb

@@ -0,0 +1,16 @@
+<h2>Forgot your password?</h2>
+
+<%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :post }) do |f| %>
+  <%= render "saas_platform_users/shared/error_messages", resource: resource %>
+
+  <div class="field">
+    <%= f.label :email %><br />
+    <%= f.email_field :email, autofocus: true, autocomplete: "email" %>
+  </div>
+
+  <div class="actions">
+    <%= f.submit "Send me reset password instructions" %>
+  </div>
+<% end %>
+
+<%= render "saas_platform_users/shared/links" %>

data/app/views/devise/saas_platform_users/registrations/edit.html.erb

@@ -0,0 +1,43 @@
+<h2>Edit <%= resource_name.to_s.humanize %></h2>
+
+<%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { method: :put }) do |f| %>
+  <%= render "saas_platform_users/shared/error_messages", resource: resource %>
+
+  <div class="field">
+    <%= f.label :email %><br />
+    <%= f.email_field :email, autofocus: true, autocomplete: "email" %>
+  </div>
+
+  <% if devise_mapping.confirmable? && resource.pending_reconfirmation? %>
+    <div>Currently waiting confirmation for: <%= resource.unconfirmed_email %></div>
+  <% end %>
+
+  <div class="field">
+    <%= f.label :password %> <i>(leave blank if you don't want to change it)</i><br />
+    <%= f.password_field :password, autocomplete: "new-password" %>
+    <% if @minimum_password_length %>
+      <br />
+      <em><%= @minimum_password_length %> characters minimum</em>
+    <% end %>
+  </div>
+
+  <div class="field">
+    <%= f.label :password_confirmation %><br />
+    <%= f.password_field :password_confirmation, autocomplete: "new-password" %>
+  </div>
+
+  <div class="field">
+    <%= f.label :current_password %> <i>(we need your current password to confirm your changes)</i><br />
+    <%= f.password_field :current_password, autocomplete: "current-password" %>
+  </div>
+
+  <div class="actions">
+    <%= f.submit "Update" %>
+  </div>
+<% end %>
+
+<h3>Cancel my account</h3>
+
+<div>Unhappy? <%= button_to "Cancel my account", registration_path(resource_name), data: { confirm: "Are you sure?", turbo_confirm: "Are you sure?" }, method: :delete %></div>
+
+<%= link_to "Back", :back %>

data/app/views/devise/saas_platform_users/registrations/new.html.erb

@@ -0,0 +1,29 @@
+<h2>Sign up</h2>
+
+<%= form_for(resource, as: resource_name, url: registration_path(resource_name)) do |f| %>
+  <%= render "saas_platform_users/shared/error_messages", resource: resource %>
+
+  <div class="field">
+    <%= f.label :email %><br />
+    <%= f.email_field :email, autofocus: true, autocomplete: "email" %>
+  </div>
+
+  <div class="field">
+    <%= f.label :password %>
+    <% if @minimum_password_length %>
+    <em>(<%= @minimum_password_length %> characters minimum)</em>
+    <% end %><br />
+    <%= f.password_field :password, autocomplete: "new-password" %>
+  </div>
+
+  <div class="field">
+    <%= f.label :password_confirmation %><br />
+    <%= f.password_field :password_confirmation, autocomplete: "new-password" %>
+  </div>
+
+  <div class="actions">
+    <%= f.submit "Sign up" %>
+  </div>
+<% end %>
+
+<%= render "saas_platform_users/shared/links" %>