profitable 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f82abb3e6ad9cf2adc1c3bc0784458f78151171767d5435844506937432b06f1
-  data.tar.gz: c688c5cff7678cdbe18fce6d450040b49a4055329953ca2845dce01923ed396a
+  metadata.gz: cd833a8b05f27ea248099d3965e9d491a13f90c51c0ad29aa524384d6b92ddce
+  data.tar.gz: 3b57ba527cc3ac287688222be53415d16f9bdf2635b07496883e50da3671e77f
 SHA512:
-  metadata.gz: 209dd44cb7bbeeca27cd6cd738470bc2179e1cb748669e5c740b6e9d583fcb2a22f6e7af3af87c37b2b9c1967b05d30fe0076d3bf44bf2c791aa9299af94c1d4
-  data.tar.gz: e50c1a56b94f3da49bafa494dfc77a593ef82df75b7d26211e1c5860846a020897d187e006eba1d451a8694e1bd14eb0e951df66eee5c48d83828c9a60fe03f2
+  metadata.gz: daf28e6f4a6da261bb56fce23abb8a0a4f417d2c637eff0c1d696abcd19ebd7f123a283eddffbf66509ef9edf08f4e2ca4e0d9818c64ee9b2f7a188c7dafd2ca
+  data.tar.gz: 982180e6b08385d430a3a7576d9e474ff96d108d086aec428272ca2d2399489eb663837efe85f0b03fe830350cab72ab25e264d498951fed1f4cef72c6231ccf

data/CHANGELOG.md

@@ -1,5 +1,9 @@
-## [Unreleased]
+# `profitable`
+
+## [0.2.0] - 2024-08-31
+
+- Initial production ready release
 
 ## [0.1.0] - 2024-08-29
 
-- Initial release
+- Initial test release (not production ready)

data/README.md

@@ -52,27 +52,34 @@ All methods return numbers that can be converted to a nicely-formatted, human-re
 - `Profitable.mrr`: Monthly Recurring Revenue (MRR)
 - `Profitable.arr`: Annual Recurring Revenue (ARR)
 - `Profitable.all_time_revenue`: Total revenue since launch
+- `Profitable.revenue_in_period(in_the_last: 30.days)`: Total revenue (recurring and non-recurring) in the specified period
+- `Profitable.recurring_revenue_in_period(in_the_last: 30.days)`: Only recurring revenue in the specified period
+- `Profitable.recurring_revenue_percentage(in_the_last: 30.days)`: Percentage of revenue that is recurring in the specified period
 - `Profitable.new_mrr(in_the_last: 30.days)`: New MRR added in the specified period
 - `Profitable.churned_mrr(in_the_last: 30.days)`: MRR lost due to churn in the specified period
 - `Profitable.average_revenue_per_customer`: Average revenue per customer (ARPC)
 - `Profitable.lifetime_value`: Estimated customer lifetime value (LTV)
+- `Profitable.estimated_valuation(multiplier = "3x")`: Estimated company valuation based on ARR
 
 ### Customer metrics
 
-- `Profitable.total_customers`: Total number of customers
-- `Profitable.total_subscribers`: Total number of active subscribers
-- `Profitable.new_customers(in_the_last: 30.days)`: Number of new customers (both subscribers and non-subscribers) added in the specified period
+- `Profitable.total_customers`: Total number of customers who have ever made a purchase or had a subscription (current and past)
+- `Profitable.total_subscribers`: Total number of customers who have ever had a subscription (active or not)
+- `Profitable.active_subscribers`: Number of customers with currently active subscriptions
+- `Profitable.new_customers(in_the_last: 30.days)`: Number of new customers added in the specified period
 - `Profitable.new_subscribers(in_the_last: 30.days)`: Number of new subscribers added in the specified period
 - `Profitable.churned_customers(in_the_last: 30.days)`: Number of customers who churned in the specified period
 
 ### Other metrics
 
-- `Profitable.churn(in_the_last: 30.days)`: Churn rate as a percentage
-- `Profitable.estimated_valuation(multiplier = "3x")`: Estimated valuation based on ARR
+- `Profitable.churn(in_the_last: 30.days)`: Churn rate for the specified period
+- `Profitable.mrr_growth_rate(in_the_last: 30.days)`: MRR growth rate for the specified period
+- `Profitable.time_to_next_mrr_milestone`: Estimated time to reach the next MRR milestone
 
 ### Growth metrics
 
-- `Profitable.mrr_growth_rate(period: 30.days)`: Calculates the MRR growth rate over the specified period
+- `Profitable.mrr_growth(in_the_last: 30.days)`: Calculates the absolute MRR growth over the specified period
+- `Profitable.mrr_growth_rate(in_the_last: 30.days)`: Calculates the MRR growth rate (as a percentage) over the specified period
 
 ### Milestone metrics
 
@@ -146,15 +153,16 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 To install this gem onto your local machine, run `bundle exec rake install`.
 
 ## TODO
+- [ ] Calculate split by plan / add support for multiple plans (churn by plan, MRR by plan, etc) – not just aggregated
+- [ ] Calculate MRR expansion (plan upgrades), contraction (plan downgrades), etc. like Stripe does
 - [ ] Add active customers (not just total customers)
-- [ ] Add revenue last month to dashboard
-- [ ] Add % of change over last period
-- [ ] Support other currencies other than USD
-- [ ] Support for multiple plans (churn by plan, MRR by plan, etc)
-- [ ] Make sure other payment processors other than Stripe work as intended
-- [ ] Account for subscription upgrades/downgrades within a period
+- [ ] Add % of change over last period (this period vs last period)
+- [ ] Calculate total period revenue vs period recurring revenue (started, but not sure if accurate)
+- [ ] Add revenue last month to dashboard (not just past 30d, like previous month)
+- [ ] Support other currencies other than USD (convert currencies)
+- [ ] Make sure other payment processors other than Stripe work as intended (Paddle, Braintree, etc. – I've never used them)
 - [ ] Add a way to input monthly costs (maybe via config file?) so that we can calculate a profit margin %
-- [ ] Allow dashboard configuration via config file
+- [ ] Allow dashboard configuration via config file (which metrics to show, etc.)
 - [ ] Return a JSON in the dashboard endpoint with main metrics (for monitoring / downstream consumption)
 
 ## Contributing

data/app/views/profitable/dashboard/index.html.erb

@@ -88,6 +88,7 @@
         <h2><%= Profitable.churn(in_the_last: period).to_readable %></h2>
         <p>churn (<%= period_short %>)</p>
       </div>
+
       <div class="card">
         <h2><%= Profitable.new_mrr(in_the_last: period).to_readable %></h2>
         <p>new MRR (<%= period_short %>)</p>
@@ -96,6 +97,16 @@
         <h2><%= Profitable.churned_mrr(in_the_last: period).to_readable %></h2>
         <p>churned MRR (<%= period_short %>)</p>
       </div>
+      <div class="card">
+        <h2><%= Profitable.mrr_growth(in_the_last: period).to_readable %></h2>
+        <p>MRR growth (<%= period_short %>)</p>
+      </div>
+
+      <div class="card">
+        <h2><%= Profitable.revenue_in_period(in_the_last: period).to_readable %></h2>
+        <p>total revenue (<%= period_short %>)</p>
+      </div>
+
     </div>
   <% end %>
 

data/lib/profitable/mrr_calculator.rb

@@ -17,7 +17,7 @@ module Profitable
 
       subscriptions.find_each do |subscription|
         mrr = process_subscription(subscription)
-        total_mrr += mrr
+        total_mrr += mrr if mrr.is_a?(Numeric) && mrr > 0
       end
 
       total_mrr
@@ -30,7 +30,10 @@ module Profitable
       return 0 if subscription.nil? || subscription.data.nil?
 
       processor_class = processor_for(subscription.customer_processor)
-      processor_class.new(subscription).calculate_mrr
+      mrr = processor_class.new(subscription).calculate_mrr
+
+      # Ensure MRR is a non-negative number
+      mrr.is_a?(Numeric) ? [mrr, 0].max : 0
     rescue => e
       Rails.logger.error("Error calculating MRR for subscription #{subscription.id}: #{e.message}")
       0

data/lib/profitable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Profitable
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/profitable.rb

@@ -34,29 +34,40 @@ module Profitable
       NumericResult.new(calculate_all_time_revenue)
     end
 
+    def revenue_in_period(in_the_last: DEFAULT_PERIOD)
+      NumericResult.new(calculate_revenue_in_period(in_the_last))
+    end
+
+    def recurring_revenue_in_period(in_the_last: DEFAULT_PERIOD)
+      NumericResult.new(calculate_recurring_revenue_in_period(in_the_last))
+    end
+
+    def recurring_revenue_percentage(in_the_last: DEFAULT_PERIOD)
+      NumericResult.new(calculate_recurring_revenue_percentage(in_the_last), :percentage)
+    end
+
     def estimated_valuation(multiplier = "3x")
       NumericResult.new(calculate_estimated_valuation(multiplier))
     end
 
     def total_customers
-      NumericResult.new(Pay::Customer.count, :integer)
+      NumericResult.new(calculate_total_customers, :integer)
     end
 
     def total_subscribers
-      NumericResult.new(Pay::Subscription.active.distinct.count('customer_id'), :integer)
+      NumericResult.new(calculate_total_subscribers, :integer)
+    end
+
+    def active_subscribers
+      NumericResult.new(calculate_active_subscribers, :integer)
     end
 
     def new_customers(in_the_last: DEFAULT_PERIOD)
-      NumericResult.new(Pay::Customer.where(created_at: in_the_last.ago..Time.current).count, :integer)
+      NumericResult.new(calculate_new_customers(in_the_last), :integer)
     end
 
     def new_subscribers(in_the_last: DEFAULT_PERIOD)
-      NumericResult.new(
-        Pay::Subscription.active
-          .where(pay_subscriptions: { created_at: in_the_last.ago..Time.current })
-          .distinct.count('pay_customers.id'),
-        :integer
-      )
+      NumericResult.new(calculate_new_subscribers(in_the_last), :integer)
     end
 
     def churned_customers(in_the_last: DEFAULT_PERIOD)
@@ -79,6 +90,10 @@ module Profitable
       NumericResult.new(calculate_lifetime_value)
     end
 
+    def mrr_growth(in_the_last: DEFAULT_PERIOD)
+      NumericResult.new(calculate_mrr_growth(in_the_last))
+    end
+
     def mrr_growth_rate(in_the_last: DEFAULT_PERIOD)
       NumericResult.new(calculate_mrr_growth_rate(in_the_last), :percentage)
     end
@@ -99,8 +114,13 @@ module Profitable
 
     private
 
+    def paid_charges
+      Pay::Charge.where("(pay_charges.data ->> 'paid' IS NULL OR pay_charges.data ->> 'paid' != ?) AND pay_charges.amount > 0", 'false')
+                 .where("pay_charges.data ->> 'status' = ? OR pay_charges.data ->> 'status' IS NULL", 'succeeded')
+    end
+
     def calculate_all_time_revenue
-      Pay::Charge.sum(:amount)
+      paid_charges.sum(:amount)
     end
 
     def calculate_arr
@@ -122,6 +142,9 @@ module Profitable
 
     def churned_subscriptions(period = DEFAULT_PERIOD)
       Pay::Subscription
+        .includes(:customer)
+        .select('pay_subscriptions.*, pay_customers.processor as customer_processor')
+        .joins(:customer)
         .where(status: ['canceled', 'ended'])
         .where(ends_at: period.ago..Time.current)
     end
@@ -150,6 +173,59 @@ module Profitable
       end
     end
 
+    def calculate_revenue_in_period(period)
+      paid_charges.where(created_at: period.ago..Time.current).sum(:amount)
+    end
+
+    def calculate_recurring_revenue_in_period(period)
+      paid_charges
+        .joins('INNER JOIN pay_subscriptions ON pay_charges.subscription_id = pay_subscriptions.id')
+        .where(created_at: period.ago..Time.current)
+        .sum(:amount)
+    end
+
+    def calculate_recurring_revenue_percentage(period)
+      total_revenue = calculate_revenue_in_period(period)
+      recurring_revenue = calculate_recurring_revenue_in_period(period)
+
+      return 0 if total_revenue.zero?
+
+      ((recurring_revenue.to_f / total_revenue) * 100).round(2)
+    end
+
+    def calculate_total_customers
+      actual_customers.count
+    end
+
+    def calculate_total_subscribers
+      Pay::Customer.joins(:subscriptions).distinct.count
+    end
+
+    def calculate_active_subscribers
+      Pay::Customer.joins(:subscriptions)
+                   .where(pay_subscriptions: { status: 'active' })
+                   .distinct
+                   .count
+    end
+
+    def actual_customers
+      Pay::Customer.joins("LEFT JOIN pay_subscriptions ON pay_customers.id = pay_subscriptions.customer_id")
+                   .joins("LEFT JOIN pay_charges ON pay_customers.id = pay_charges.customer_id")
+                   .where("pay_subscriptions.id IS NOT NULL OR pay_charges.amount > 0")
+                   .distinct
+    end
+
+    def calculate_new_customers(period)
+      actual_customers.where(created_at: period.ago..Time.current).count
+    end
+
+    def calculate_new_subscribers(period)
+      Pay::Customer.joins(:subscriptions)
+                   .where(created_at: period.ago..Time.current)
+                   .distinct
+                   .count
+    end
+
     def calculate_average_revenue_per_customer
       return 0 if total_customers.zero?
       (all_time_revenue.to_f / total_customers).round
@@ -162,6 +238,12 @@ module Profitable
       (average_revenue_per_customer.to_f / churn_rate).round
     end
 
+    def calculate_mrr_growth(period = DEFAULT_PERIOD)
+      new_mrr = calculate_new_mrr(period)
+      churned_mrr = calculate_churned_mrr(period)
+      new_mrr - churned_mrr
+    end
+
     def calculate_mrr_growth_rate(period = DEFAULT_PERIOD)
       end_date = Time.current
       start_date = end_date - period
@@ -185,5 +267,6 @@ module Profitable
           MrrCalculator.process_subscription(subscription)
         end
     end
+
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: profitable
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - rameerez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-30 00:00:00.000000000 Z
+date: 2024-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pay