Create GET "/api/ca_dashboard/stats" endpoint

app/controllers/api/ca_dashboard/stats_controller.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Api
+  module CaDashboard
+    # Handles CRUD operations for "/api/ca_dashboard/stats"
+    class StatsController < Api::V1::BaseApiController
+
+      # GET /api/ca_dashboard/stats
+      def index
+        # To access this endpoint, the user must provide a valid JWT
+        # JWT is acquired by authenticating via POST /api/v1/authenticate
+        base_hash = {
+          'plans' => Plan.all,
+          'orgs' => Org.where(managed: true).all,
+          'users' => User.all
+        }
+        @totals = {
+          'all_time' => all_time_counts(base_hash),
+          'last_30_days' => last_30_days_counts(base_hash)
+        }
+        begin
+          @totals['custom_range'] = custom_range_counts(base_hash) if date_params_present?
+          render 'api/ca_dashboard/stats/index', status: :ok
+        rescue ArgumentError
+          error_msg = _('Invalid date format. please use YYYY-MM-DD when supplying `start` or `end` params.')
+          render_error(errors: [error_msg], status: :bad_request)
+        end
+      end
+
+      private
+
+      def all_time_counts(base_hash)
+        base_hash.transform_values(&:count)
+      end
+
+      def last_30_days_counts(base_hash)
+        base_hash.transform_values do |scope|
+          scope.where('created_at >= ?', 30.days.ago).count
+        end
+      end
+
+      def custom_range_counts(base_hash)
+        start_date = parse_date(params[:start])
+        end_date = parse_date(params[:end])
+        base_hash.transform_values do |scope|
+          scope.where(created_at: start_date..end_date).count
+        end
+      end
+
+      def date_params_present?
+        params[:start].present? || params[:end].present?
+      end
+
+      def parse_date(date_string)
+        Date.strptime(date_string, '%Y-%m-%d') if date_string.present?
+      end
+    end
+  end
+end

app/views/api/ca_dashboard/stats/index.json.jbuilder

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+json.partial! 'api/v1/standard_response'
+json.stats do
+  json.totals @totals
+end

config/routes.rb

@@ -204,6 +204,10 @@
       resources :plans, only: %i[create show index]
       resources :templates, only: [:index]
     end
+
+    namespace :ca_dashboard do
+      resources :stats, only: [:index]
+    end
   end
 
   namespace :paginable do