content_signals 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f129ecbd94abc76038d938efb823655c1aaffd4b1fc8b217c483ea86e9405626
-  data.tar.gz: bba0405e60cdfb09fba1b8670fe4da9e8bcbb8845aa6e64447ab96cd7a1a5530
+  metadata.gz: 3c7724fb7019bc1a3ac2f2eb35edad5cd27cfb64e53c3c1f94c1ed9cb45fda40
+  data.tar.gz: 19e23f5b28e88ffdba2d8657e5aaa6664292cc87c170107a5ddd31d43e3e78a5
 SHA512:
-  metadata.gz: 7c753478d857862451a8631ed95685041ca4cdbdb159e9b02c0b543cee99333afdebbaa73dda3bdf57a86a4129c9969a1b5784dc2777f236050091cfed29a7f4
-  data.tar.gz: 96ee5adb3cdcca8182683d6ecc18733afdc5383e87f83581206f605ac52c4097ae2b23ac157a013506670a71ec6f9de24d85f7114d28256a86736a868ecf6361
+  metadata.gz: dbe5d299d3266d8902fbbc0aee794f6b0ed2aafed261536745e91964318cb9bc25ad69c6cf2f05c620f658bcf5def00f03042b36b7b9967555ac471381181563
+  data.tar.gz: f3c14ea5307b6ff4bb39a4382de83783154af50ab27dd3ac90951204203d8361dae7ae47a5cd88f2cf304f98d41a37f4fabb2b76a66d72f7c5fa788af1b9ba64

data/lib/content_signals/configuration.rb

@@ -11,7 +11,8 @@ module ContentSignals
                   :track_bots,
                   :track_admins,
                   :geoip_provider,  # Symbol (:maxmind, :ipinfo, :null) or a provider class
-                  :geoip_token      # API token for online providers (e.g. IPinfo)
+                  :geoip_token,     # API token for online providers (e.g. IPinfo)
+                  :retention_days   # Days to keep raw page_views before purging (default: 90)
 
     def initialize
       @multitenancy = false
@@ -24,6 +25,7 @@ module ContentSignals
       @track_admins = false
       @geoip_provider = :maxmind
       @geoip_token = nil
+      @retention_days = 90
     end
 
     # Returns the resolved provider class for IP geolocation.

data/lib/content_signals/jobs/aggregate_analytics_job.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module ContentSignals
+  class AggregateAnalyticsJob < ActiveJob::Base
+    queue_as :default
+
+    # Aggregates raw page_views for a given date into analytics_daily_stats.
+    # Designed to be run hourly — today's entry is upserted on each run.
+    # Pass date: as a Date or String (default: aggregates yesterday + today).
+    def perform(date: nil)
+      if date
+        aggregate_for_date(date.to_date)
+      else
+        aggregate_for_date(Date.yesterday)
+        aggregate_for_date(Date.today)
+      end
+    end
+
+    private
+
+    def aggregate_for_date(date)
+      day_scope = PageView.where(viewed_at: date.beginning_of_day..date.end_of_day)
+      return if day_scope.none?
+
+      groups = day_scope
+        .group(:tenant_id, :trackable_type, :trackable_id)
+        .count
+
+      groups.each_key do |(tenant_id, trackable_type, trackable_id)|
+        scope = day_scope.where(
+          tenant_id: tenant_id,
+          trackable_type: trackable_type,
+          trackable_id: trackable_id
+        )
+
+        row = {
+          tenant_id:,
+          trackable_type:,
+          trackable_id:,
+          date:,
+          total_views:       scope.count,
+          unique_visitors:   scope.distinct.count(:visitor_id),
+          app_views:         scope.where.not(app_platform: [ nil, "" ]).count,
+          device_breakdown:  breakdown(scope, :device_type),
+          os_breakdown:      breakdown(scope, :os),
+          browser_breakdown: breakdown(scope, :browser),
+          country_breakdown: breakdown(scope, :country_name),
+          city_breakdown:    breakdown(scope, :city),
+          referrer_breakdown: referrer_breakdown(scope),
+          locale_breakdown:  breakdown(scope, :locale),
+          hourly_breakdown:  hourly_breakdown(scope),
+          updated_at:        Time.current
+        }
+
+        AnalyticsDailyStat.upsert(
+          row,
+          unique_by: %i[tenant_id trackable_type trackable_id date]
+        )
+      end
+    end
+
+    def breakdown(scope, column)
+      scope.where.not(column => [ nil, "" ])
+           .group(column)
+           .count
+           .to_json
+    end
+
+    def referrer_breakdown(scope)
+      scope.where.not(referrer: [ nil, "" ])
+           .group(:referrer)
+           .count
+           .each_with_object({}) { |(url, count), h|
+             domain = extract_domain(url)
+             h[domain] = (h[domain] || 0) + count
+           }
+           .to_json
+    end
+
+    def hourly_breakdown(scope)
+      scope.group("CAST(EXTRACT(HOUR FROM viewed_at) AS INTEGER)")
+           .count
+           .transform_keys(&:to_s)
+           .to_json
+    end
+
+    def extract_domain(url)
+      URI.parse(url).host&.sub(/\Awww\./, "") || url
+    rescue URI::InvalidURIError
+      url.to_s.truncate(60)
+    end
+  end
+end

data/lib/content_signals/jobs/purge_page_views_job.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ContentSignals
+  class PurgePageViewsJob < ActiveJob::Base
+    queue_as :default
+
+    # Deletes raw page_views older than retention_days (default 90).
+    # Run daily. Only deletes records that have already been aggregated
+    # (i.e., older than 1 day beyond retention window to be safe).
+    def perform
+      retention_days = ContentSignals.configuration.retention_days
+      cutoff = retention_days.days.ago.beginning_of_day
+
+      deleted = 0
+      PageView.where("viewed_at < ?", cutoff).in_batches(of: 2000) do |batch|
+        deleted += batch.delete_all
+      end
+
+      Rails.logger.info "[ContentSignals] PurgePageViewsJob: deleted #{deleted} records older than #{cutoff.to_date}"
+    end
+  end
+end

data/lib/content_signals/models/analytics_daily_stat.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module ContentSignals
+  class AnalyticsDailyStat < ActiveRecord::Base
+    self.table_name = "content_signals_analytics_daily_stats"
+
+    validates :trackable_type, :trackable_id, :date, presence: true
+
+    # JSON breakdown columns — stored as text, parsed on read
+    BREAKDOWN_COLUMNS = %i[
+      device_breakdown
+      os_breakdown
+      browser_breakdown
+      country_breakdown
+      city_breakdown
+      referrer_breakdown
+      locale_breakdown
+      hourly_breakdown
+    ].freeze
+
+    BREAKDOWN_COLUMNS.each do |col|
+      define_method(col) do
+        raw = super()
+        return {} if raw.blank?
+        JSON.parse(raw)
+      rescue JSON::ParserError
+        {}
+      end
+
+      define_method(:"#{col}=") do |value|
+        super(value.is_a?(Hash) ? value.to_json : value)
+      end
+    end
+
+    scope :for_tenant,     ->(id)   { where(tenant_id: id) }
+    scope :for_trackable,  ->(type, ids) { where(trackable_type: type, trackable_id: ids) }
+    scope :in_range,       ->(range) { where(date: range) }
+  end
+end

data/lib/content_signals/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContentSignals
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
 end

data/lib/content_signals.rb

@@ -45,6 +45,7 @@ require_relative "content_signals/engine" if defined?(Rails::Engine)
 # Always load models when ActiveRecord is available
 if defined?(ActiveRecord)
   require_relative "content_signals/models/page_view"
+  require_relative "content_signals/models/analytics_daily_stat"
 end
 
 # Load geoip providers
@@ -62,6 +63,8 @@ require_relative "content_signals/services/device_detector_service"
 if defined?(ActiveJob)
   require_relative "content_signals/jobs/track_page_view_job"
   require_relative "content_signals/jobs/update_geoip_database_job"
+  require_relative "content_signals/jobs/aggregate_analytics_job"
+  require_relative "content_signals/jobs/purge_page_views_job"
 end
 
 # Load concerns if ActiveSupport is available

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: content_signals
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Ionuț Munteanu Alexandru
@@ -120,8 +120,11 @@ files:
 - lib/content_signals/geoip/ipinfo_provider.rb
 - lib/content_signals/geoip/maxmind_provider.rb
 - lib/content_signals/geoip/null_provider.rb
+- lib/content_signals/jobs/aggregate_analytics_job.rb
+- lib/content_signals/jobs/purge_page_views_job.rb
 - lib/content_signals/jobs/track_page_view_job.rb
 - lib/content_signals/jobs/update_geoip_database_job.rb
+- lib/content_signals/models/analytics_daily_stat.rb
 - lib/content_signals/models/page_view.rb
 - lib/content_signals/services/device_detector_service.rb
 - lib/content_signals/services/page_view_tracker.rb