rails_analytics 1.0.0

data/app/controllers/rails_analytics/dashboards_controller.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  class DashboardsController < ApplicationController
+    def overview
+      since = default_since
+      daily_series = Stats.visits_by_day(since: since)
+
+      @stats = {
+        total_visits: Stats.total_visits(since: since),
+        total_unique: Stats.total_unique_visitors(since: since),
+        total_events: Stats.total_events(since: since),
+        bounce_rate: Stats.bounce_rate(since: since),
+        top_sources: Stats.top_sources(limit: 10, since: since),
+        top_events: Stats.top_events(limit: 10, since: since),
+        devices: Stats.devices(since: since),
+        utm_breakdown: Stats.utm_breakdown(since: since)
+      }
+      @chart = ChartBuilder.new(
+        daily_series.map { |date, count| { date: date, count: count } }
+      ).build
+    end
+
+    def events
+      @event_name = params[:name]
+      @page = (params[:page] || 1).to_i
+      @events = Stats.events_paginated(name: @event_name.presence, page: @page, since: default_since)
+    end
+
+    def visits
+      @page = (params[:page] || 1).to_i
+      @visits = Stats.visits_paginated(page: @page, since: default_since)
+    end
+
+    private
+
+    def default_since
+      RailsAnalytics.config.since_default.ago
+    end
+  end
+end

data/app/helpers/rails_analytics/application_helper.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  module ApplicationHelper
+    def rails_analytics_tracker_tag(options = {})
+      endpoint = options[:endpoint] || RailsAnalytics.config.mount_path
+      tag.script(src: "#{endpoint}/tracker.js",
+                 data: { rails_analytics: true, endpoint: endpoint },
+                 defer: true)
+    end
+  end
+end

data/app/jobs/rails_analytics/retention_job.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  class RetentionJob < ActiveJob::Base
+    queue_as :default
+
+    RETENTION_PERIOD = 6.months
+
+    def perform
+      cutoff = RETENTION_PERIOD.ago
+      deleted_visits = 0
+      deleted_events = 0
+
+      Visit.where(Visit.arel_table[:started_at].lt(cutoff)).find_in_batches(batch_size: 1000) do |batch|
+        visit_ids = batch.map(&:id)
+
+        events_count = Event.where(visit_id: visit_ids).delete_all
+        visits_count = Visit.where(id: visit_ids).delete_all
+
+        deleted_events += events_count
+        deleted_visits += visits_count
+      end
+
+      Rails.logger.info "[rails_analytics] RetentionJob: deleted #{deleted_visits} visits and #{deleted_events} events older than #{cutoff}"
+    end
+  end
+end

data/app/models/rails_analytics/chart_builder.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  # SVG line chart. Server-rendered, zero JS.
+  class ChartBuilder
+    WIDTH = 800
+    HEIGHT = 220
+    PAD = 8
+    RIGHT_PAD = 40
+
+    def initialize(series)
+      @series = series # Array<Hash> with :date and :count
+    end
+
+    def build
+      return empty_chart if @series.empty?
+
+      max = [@series.map { |s| s[:count] }.max.to_f, 1].max
+      points = @series.map.with_index do |s, i|
+        x = pad(i)
+        y = HEIGHT - PAD - ((s[:count] / max) * (HEIGHT - PAD * 2)).round
+        "#{x.round(2)},#{y.round(2)}"
+      end.join(" ")
+
+      <<~SVG
+        <svg viewBox="0 0 #{WIDTH + RIGHT_PAD} #{HEIGHT}" role="img" aria-label="#{I18n.t('rails_analytics.chart.visits_per_day')}" xmlns="http://www.w3.org/2000/svg">
+          <polyline points="#{points}" fill="none" stroke="var(--ra-accent, #3b82f6)" stroke-width="2" stroke-linejoin="round" stroke-linecap="round" />
+          #{dots(points)}
+        </svg>
+      SVG
+    end
+
+    private
+
+    def pad(index)
+      PAD + index * ((WIDTH - PAD) / [@series.length - 1, 1].max.to_f)
+    end
+
+    def dots(points_str)
+      points_str.split(" ").map do |pt|
+        x, y = pt.split(",")
+        %(<circle cx="#{x}" cy="#{y}" r="3" fill="var(--ra-accent, #3b82f6)" />)
+      end.join
+    end
+
+    def empty_chart
+      <<~SVG
+        <svg viewBox="0 0 #{WIDTH} #{HEIGHT}" role="img" xmlns="http://www.w3.org/2000/svg">
+          <text x="#{WIDTH / 2}" y="#{HEIGHT / 2}" text-anchor="middle" fill="var(--ra-muted, #6b7280)">#{I18n.t('rails_analytics.chart.no_data')}</text>
+        </svg>
+      SVG
+    end
+  end
+end

data/app/models/rails_analytics/daily_salt.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "securerandom"
+require "digest"
+
+module RailsAnalytics
+  class DailySalt < ActiveRecord::Base
+    self.table_name = "rails_analytics_daily_salts"
+
+    validates :date, presence: true, uniqueness: true
+    validates :salt, presence: true
+
+    def self.for_date(date = Date.today)
+      find_or_create_by!(date: date) do |ds|
+        ds.salt = SecureRandom.hex(32)
+      end.salt
+    rescue ActiveRecord::StatementInvalid, ActiveRecord::NoDatabaseError
+      derive_salt(date)
+    end
+
+    def self.derive_salt(date)
+      key = Rails.application.try(:secret_key_base) || Rails.application.try(:secrets).try(:secret_key_base) || "rails_analytics_fallback"
+      Digest::SHA256.hexdigest("#{key}:#{date.iso8601}")
+    end
+  end
+end

data/app/models/rails_analytics/event.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  class Event < ActiveRecord::Base
+    self.table_name = "rails_analytics_events"
+
+    belongs_to :visit, class_name: "RailsAnalytics::Visit"
+
+    validates :name, presence: true
+    validates :time, presence: true
+
+    scope :since, ->(time) { where(arel_table[:time].gteq(time)) }
+    scope :named, ->(name) { where(name: name) }
+  end
+end

data/app/models/rails_analytics/visit.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  class Visit < ActiveRecord::Base
+    self.table_name = "rails_analytics_visits"
+
+    has_many :events, class_name: "RailsAnalytics::Event", dependent: :delete_all
+
+    validates :anonymity_key, presence: true
+    validates :masked_ip, presence: true
+    validates :started_at, presence: true
+
+    scope :since, ->(time) { where(arel_table[:started_at].gteq(time)) }
+    scope :for_key, ->(key) { where(anonymity_key: key) }
+
+    INACTIVITY_WINDOW = 4.hours
+
+    def self.find_or_create_for(anonymity_key, attrs = {})
+      recent = for_key(anonymity_key)
+               .where(started_at: (attrs[:started_at] || Time.current) - INACTIVITY_WINDOW..)
+               .order(started_at: :desc)
+               .first
+
+      return recent if recent
+
+      create!(attrs.merge(anonymity_key: anonymity_key))
+    end
+
+    def self.parse_utm_params(path)
+      return {} if path.blank?
+
+      query = URI.parse(path).query.to_s
+      params = URI.decode_www_form(query).to_h
+      {
+        utm_source:   params["utm_source"],
+        utm_medium:   params["utm_medium"],
+        utm_campaign: params["utm_campaign"],
+        utm_term:     params["utm_term"],
+        utm_content:  params["utm_content"]
+      }
+    rescue URI::InvalidURIError
+      {}
+    end
+  end
+end

data/app/views/layouts/rails_analytics.html.erb

@@ -0,0 +1,26 @@
+<%# app/views/layouts/rails_analytics.html.erb %>
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%= t("rails_analytics.title") %></title>
+    <link rel="stylesheet" href="<%= request.base_url %>/rails_analytics/dashboard.css" media="all">
+  </head>
+  <body>
+    <header class="ra-header">
+      <h1 class="ra-brand"><%= t("rails_analytics.title") %></h1>
+      <nav class="ra-nav">
+        <%= link_to t("rails_analytics.nav.overview"), rails_analytics.root_path %>
+        <%= link_to t("rails_analytics.nav.events"), rails_analytics.events_path %>
+        <%= link_to t("rails_analytics.nav.visits"), rails_analytics.visits_path %>
+      </nav>
+    </header>
+    <main class="ra-main">
+      <%= yield %>
+    </main>
+    <footer class="ra-footer">
+      <span><%= t("rails_analytics.footer") %></span>
+    </footer>
+  </body>
+</html>

data/app/views/rails_analytics/dashboards/events.html.erb

@@ -0,0 +1,50 @@
+<%# app/views/rails_analytics/dashboards/events.html.erb %>
+<section class="ra-card">
+  <h2 class="ra-card-title"><%= t("rails_analytics.nav.events") %></h2>
+
+  <div class="ra-filter">
+    <%= form_tag rails_analytics.events_path, method: :get do %>
+      <%= select_tag :name,
+            options_for_select(
+              [[t("rails_analytics.filter.all_events"), ""]] +
+              RailsAnalytics::Stats.event_counts_by_name.keys.map { |n| [n, n] },
+              @event_name
+            ),
+            onchange: "this.form.submit()" %>
+      <noscript><%= submit_tag t("rails_analytics.filter.filter") %></noscript>
+    <% end %>
+  </div>
+
+  <% if @events[:data].any? %>
+    <table class="ra-table">
+      <thead>
+        <tr>
+          <th><%= t("rails_analytics.tables.date") %></th>
+          <th><%= t("rails_analytics.tables.event_name") %></th>
+          <th class="ra-num"><%= t("rails_analytics.tables.count") %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @events[:data].each do |row| %>
+          <tr>
+            <td class="ra-mono"><%= row[:date] %></td>
+            <td class="ra-mono"><%= row[:name] %></td>
+            <td class="ra-num"><%= number_with_delimiter(row[:count]) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+
+    <div class="ra-pagination">
+      <% if @page > 1 %>
+        <%= link_to t("rails_analytics.pagination.previous"), rails_analytics.events_path(page: @page - 1, name: @event_name) %>
+      <% end %>
+      <span class="current"><%= @page %></span>
+      <% if @events[:data].length == @events[:per_page] %>
+        <%= link_to t("rails_analytics.pagination.next"), rails_analytics.events_path(page: @page + 1, name: @event_name) %>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="ra-empty"><%= t("rails_analytics.empty") %></p>
+  <% end %>
+</section>

data/app/views/rails_analytics/dashboards/overview.html.erb

@@ -0,0 +1,102 @@
+<%# app/views/rails_analytics/dashboards/overview.html.erb %>
+<section class="ra-kpis">
+  <div class="ra-card">
+    <span class="ra-kpi-label"><%= t("rails_analytics.kpi.visits") %></span>
+    <strong class="ra-kpi-value"><%= number_with_delimiter(@stats[:total_visits]) %></strong>
+  </div>
+  <div class="ra-card">
+    <span class="ra-kpi-label"><%= t("rails_analytics.kpi.unique_visitors") %></span>
+    <strong class="ra-kpi-value"><%= number_with_delimiter(@stats[:total_unique]) %></strong>
+  </div>
+  <div class="ra-card">
+    <span class="ra-kpi-label"><%= t("rails_analytics.kpi.events") %></span>
+    <strong class="ra-kpi-value"><%= number_with_delimiter(@stats[:total_events]) %></strong>
+  </div>
+  <div class="ra-card">
+    <span class="ra-kpi-label"><%= t("rails_analytics.kpi.bounce_rate") %></span>
+    <strong class="ra-kpi-value"><%= (@stats[:bounce_rate] * 100).round(1) %>%</strong>
+  </div>
+</section>
+
+<section class="ra-card ra-chart-card">
+  <h2 class="ra-card-title"><%= t("rails_analytics.chart.visits_per_day") %></h2>
+  <div class="ra-chart">
+    <%= raw @chart %>
+  </div>
+</section>
+
+<section class="ra-grid">
+  <div class="ra-card">
+    <h2 class="ra-card-title"><%= t("rails_analytics.tables.top_sources") %></h2>
+    <% if @stats[:top_sources].any? %>
+      <table class="ra-table">
+        <thead>
+          <tr><th><%= t("rails_analytics.tables.source") %></th><th class="ra-num"><%= t("rails_analytics.tables.count") %></th></tr>
+        </thead>
+        <tbody>
+          <% @stats[:top_sources].each do |ref, count| %>
+            <tr><td class="ra-mono"><%= ref %></td><td class="ra-num"><%= number_with_delimiter(count) %></td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    <% else %>
+      <p class="ra-empty"><%= t("rails_analytics.empty") %></p>
+    <% end %>
+  </div>
+
+  <div class="ra-card">
+    <h2 class="ra-card-title"><%= t("rails_analytics.tables.top_events") %></h2>
+    <% if @stats[:top_events].any? %>
+      <table class="ra-table">
+        <thead>
+          <tr><th><%= t("rails_analytics.tables.event_name") %></th><th class="ra-num"><%= t("rails_analytics.tables.count") %></th></tr>
+        </thead>
+        <tbody>
+          <% @stats[:top_events].each do |name, count| %>
+            <tr><td class="ra-mono"><%= name %></td><td class="ra-num"><%= number_with_delimiter(count) %></td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    <% else %>
+      <p class="ra-empty"><%= t("rails_analytics.empty") %></p>
+    <% end %>
+  </div>
+</section>
+
+<% if @stats[:utm_breakdown].any? %>
+  <section class="ra-card">
+    <h2 class="ra-card-title"><%= t("rails_analytics.tables.utm") %></h2>
+    <table class="ra-table ra-utm-table">
+      <thead>
+        <tr>
+          <th><%= t("rails_analytics.tables.source") %></th>
+          <th><%= t("rails_analytics.tables.campaign") %></th>
+          <th><%= t("rails_analytics.tables.medium") %></th>
+          <th class="ra-num"><%= t("rails_analytics.tables.count") %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @stats[:utm_breakdown].each do |row| %>
+          <tr>
+            <td class="ra-mono"><%= row["utm_source"] %></td>
+            <td class="ra-mono"><%= row["utm_campaign"] %></td>
+            <td class="ra-mono"><%= row["utm_medium"] %></td>
+            <td class="ra-num"><%= number_with_delimiter(row["count"]) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </section>
+<% end %>
+
+<section class="ra-card">
+  <h2 class="ra-card-title"><%= t("rails_analytics.tables.devices") %></h2>
+  <div class="ra-devices">
+    <% @stats[:devices].each do |device, count| %>
+      <div class="ra-device">
+        <span class="ra-kpi-label"><%= device %></span>
+        <strong class="ra-kpi-value"><%= number_with_delimiter(count) %></strong>
+      </div>
+    <% end %>
+  </div>
+</section>

data/app/views/rails_analytics/dashboards/visits.html.erb

@@ -0,0 +1,39 @@
+<%# app/views/rails_analytics/dashboards/visits.html.erb %>
+<section class="ra-card">
+  <h2 class="ra-card-title"><%= t("rails_analytics.nav.visits") %></h2>
+
+  <% if @visits[:data].any? %>
+    <table class="ra-table">
+      <thead>
+        <tr>
+          <th><%= t("rails_analytics.tables.date") %></th>
+          <th class="ra-num"><%= t("rails_analytics.tables.visits") %></th>
+          <th class="ra-num"><%= t("rails_analytics.tables.unique_visitors") %></th>
+          <th><%= t("rails_analytics.tables.top_source") %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @visits[:data].each do |row| %>
+          <tr>
+            <td class="ra-mono"><%= row[:date] %></td>
+            <td class="ra-num"><%= number_with_delimiter(row[:visits]) %></td>
+            <td class="ra-num"><%= number_with_delimiter(row[:unique_visitors]) %></td>
+            <td class="ra-mono"><%= row[:top_source] %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+
+    <div class="ra-pagination">
+      <% if @page > 1 %>
+        <%= link_to t("rails_analytics.pagination.previous"), rails_analytics.visits_path(page: @page - 1) %>
+      <% end %>
+      <span class="current"><%= @page %></span>
+      <% if @visits[:data].length == @visits[:per_page] %>
+        <%= link_to t("rails_analytics.pagination.next"), rails_analytics.visits_path(page: @page + 1) %>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="ra-empty"><%= t("rails_analytics.empty") %></p>
+  <% end %>
+</section>

data/config/locales/rails_analytics.en.yml

@@ -0,0 +1,37 @@
+en:
+  rails_analytics:
+    title: "Rails Analytics"
+    nav:
+      overview: "Overview"
+      events: "Events"
+      visits: "Visits"
+    footer: "Aggregated and anonymous data — 6 month retention"
+    kpi:
+      visits: "Visits"
+      unique_visitors: "Unique visitors"
+      events: "Events"
+      bounce_rate: "Bounce rate"
+    chart:
+      visits_per_day: "Visits per day"
+      no_data: "No data"
+    tables:
+      top_sources: "Traffic sources"
+      top_events: "Top events"
+      devices: "Devices"
+      utm: "UTM"
+      date: "Date"
+      visits: "Visits"
+      unique_visitors: "Unique visitors"
+      top_source: "Top source"
+      event_name: "Event name"
+      count: "Count"
+      source: "Source"
+      campaign: "Campaign"
+      medium: "Medium"
+    empty: "No data recorded yet."
+    filter:
+      all_events: "All events"
+      filter: "Filter"
+    pagination:
+      previous: "Previous"
+      next: "Next"

data/config/locales/rails_analytics.pt-BR.yml

@@ -0,0 +1,37 @@
+pt-BR:
+  rails_analytics:
+    title: "Rails Analytics"
+    nav:
+      overview: "Visão geral"
+      events: "Eventos"
+      visits: "Visitas"
+    footer: "Dados agregados e anônimos — retenção 6 meses"
+    kpi:
+      visits: "Visitas"
+      unique_visitors: "Visitantes únicos"
+      events: "Eventos"
+      bounce_rate: "Taxa de rejeição"
+    chart:
+      visits_per_day: "Visitas por dia"
+      no_data: "Sem dados"
+    tables:
+      top_sources: "Origem do tráfego"
+      top_events: "Clics por botão"
+      devices: "Dispositivos"
+      utm: "UTM"
+      date: "Data"
+      visits: "Visitas"
+      unique_visitors: "Visitantes únicos"
+      top_source: "Origem principal"
+      event_name: "Nome do evento"
+      count: "Contagem"
+      source: "Origem"
+      campaign: "Campanha"
+      medium: "Mídia"
+    empty: "Nenhum dado registrado ainda."
+    filter:
+      all_events: "Todos os eventos"
+      filter: "Filtrar"
+    pagination:
+      previous: "Anterior"
+      next: "Próximo"

data/config/routes.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+RailsAnalytics::Engine.routes.draw do
+  get "tracker.js" => "analytics#tracker"
+  get "dashboard.css" => "analytics#dashboard_css"
+  post "collect" => "analytics#collect"
+  get  "token" => "analytics#token"
+  root to: "dashboards#overview"
+  get "events" => "dashboards#events"
+  get "visits" => "dashboards#visits"
+end

data/db/migrate/20260906000001_create_rails_analytics_daily_salts.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class CreateRailsAnalyticsDailySalts < ActiveRecord::Migration[7.0]
+  def change
+    create_table :rails_analytics_daily_salts do |t|
+      t.date :date, null: false
+      t.string :salt, null: false
+
+      t.timestamps
+    end
+
+    add_index :rails_analytics_daily_salts, :date, unique: true
+  end
+end

data/db/migrate/20260906000002_create_rails_analytics_visits.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class CreateRailsAnalyticsVisits < ActiveRecord::Migration[7.0]
+  def change
+    create_table :rails_analytics_visits do |t|
+      t.string   :anonymity_key,  null: false
+      t.string   :masked_ip,      null: false
+      t.string   :referrer_domain
+      t.text     :landing_page_path
+      t.string   :device_type
+      t.string   :viewport
+      t.string   :language
+      t.string   :country
+      t.string   :utm_source
+      t.string   :utm_medium
+      t.string   :utm_campaign
+      t.string   :utm_term
+      t.string   :utm_content
+      t.datetime :started_at,     null: false
+
+      t.timestamps
+    end
+
+    add_index :rails_analytics_visits, :started_at
+    add_index :rails_analytics_visits, [:anonymity_key, :started_at], name: "idx_visits_anonymity_started"
+  end
+end

data/db/migrate/20260906000003_create_rails_analytics_events.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class CreateRailsAnalyticsEvents < ActiveRecord::Migration[7.0]
+  def change
+    create_table :rails_analytics_events do |t|
+      t.references :visit, null: false, foreign_key: { to_table: :rails_analytics_visits }
+      t.string     :name, null: false
+      if ActiveRecord::Base.connection.adapter_name == "PostgreSQL"
+        t.jsonb :properties, default: {}
+      else
+        t.json :properties, default: {}
+      end
+      t.datetime   :time, null: false
+
+      t.timestamps
+    end
+
+    add_index :rails_analytics_events, :name
+    add_index :rails_analytics_events, :time
+    add_index :rails_analytics_events, [:name, :time]
+    if ActiveRecord::Base.connection.adapter_name == "PostgreSQL"
+      add_index :rails_analytics_events, :properties, using: :gin
+    end
+  end
+end

data/lib/generators/rails_analytics/install/install_generator.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Instala o rails_analytics: copia migrations, monta engine, cria initializer e pina tracker no importmap."
+
+      def copy_migrations
+        migrations_dir = RailsAnalytics::Engine.root.join("db/migrate")
+        Dir["#{migrations_dir}/*.rb"].sort.each do |migration|
+          filename = File.basename(migration)
+          copy_file migration, "db/migrate/#{filename}"
+        end
+        say_status :ok, "Migrations copiadas para db/migrate/"
+      end
+
+      def create_initializer
+        template "initializer.rb", "config/initializers/rails_analytics.rb"
+        say_status :ok, "Initializer criado em config/initializers/rails_analytics.rb"
+      end
+
+      def mount_engine
+        route %(mount RailsAnalytics::Engine => RailsAnalytics.config.mount_path)
+        say_status :ok, "Engine montada em config/routes.rb"
+      end
+
+      def pin_tracker
+        importmap_path = "config/importmap.rb"
+        if File.exist?(importmap_path)
+          unless File.read(importmap_path).include?("rails_analytics/tracker")
+            append_to_file importmap_path, %(\npin "rails_analytics/tracker", to: RailsAnalytics.config.mount_path + "/tracker.js"\n)
+            say_status :ok, "Tracker pinado em config/importmap.rb"
+          end
+        else
+          say_status :skipped, "config/importmap.rb não encontrado — adicione manualmente:", :yellow
+          say %(  Adicione ao seu layout: <script src="<%= RailsAnalytics.config.mount_path %>/tracker.js" defer></script>), :yellow
+        end
+      end
+
+      def instructions
+        say "\n✅ rails_analytics instalado! Próximos passos:", :green
+        say "  1. bin/rails db:migrate"
+        say "  2. Configure a autenticação no initializer: config/initializers/rails_analytics.rb"
+        say "  3. Acesse o dashboard em #{RailsAnalytics.config.mount_path}"
+        say ""
+      end
+    end
+  end
+end