rails_analytics 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f985132b2aa456db104a03635f1d8334772e8a5c8e3902319d111082d7a5f5b5
-  data.tar.gz: 8b4b04a1bab3a4c15b0cff8f44892146f5469713e325266054e8e23131937c8e
+  metadata.gz: e3c81421bd38061c3f25577abd64335008fdd4789e6b25d3081445d3b90c46f6
+  data.tar.gz: 85d5e60a3a0148be7252252528cca77f736e03839897d97a78df0c34fd299200
 SHA512:
-  metadata.gz: 277a1e2be087cae4e5f511af0c3f3d56051ad625fadfe643356ae0697fbe6f353c8eef2a9e59c842899d051abdc232a93eea22f1faa4e631fb8fbe4ee0e29a1f
-  data.tar.gz: c1968ddf6c68fc5dee7856f61ffc94345da3855ee2d0d4188ca04756802ca47afbb252770014e96c567490180be008dedd87244e7c980b669f507c53c44e519a
+  metadata.gz: ffe8c9ed37fa8188b6b6f4ba200208e7d7657d98d2f564523d291ed0164c0ab5caf7edc4f18cabd95b581129a26e254771bb9d4d7f6929d943712e17de5be28e
+  data.tar.gz: 5819b81fc445fbc5d0dfc876f0e128d69685c40137668662895cf452b172e7ada08e88748c983a6363a83ce360b51a58f670929017b38a329ae3c73c1af92832

data/README.md

@@ -5,6 +5,10 @@ third-party analytics dependencies — it collects traffic **server-side**, stor
 your own database, and renders an aggregated dashboard with zero client-side JS
 dependencies.
 
+The dashboard's chart shows CSS-only tooltips: hover (or keyboard-focus) any
+data point to see its date and visit count — labels on the x-axis mark first,
+last and month boundaries. No JavaScript anywhere.
+
 ## Screenshots
 
 | Dashboard — aggregated overview | Dashboard — events & visits |
@@ -88,20 +92,25 @@ Done — collection is automatic and the dashboard lives at **`/analytics`** (or
 
 ## Mounting
 
-You can mount the engine at any path:
+The engine's mount point is **a single configuration** — the `mount` line in
+`config/routes.rb`. There is no separate `mount_path` to keep in sync: the tracker tag,
+the dashboard CSS and the collect endpoint all derive their URLs from the engine's own
+route helpers at runtime, so they follow whatever path you mount the engine at.
 
 ```ruby
 # config/routes.rb
-mount RailsAnalytics::Engine => "/analytics"
+mount RailsAnalytics::Engine => "/analytics"   # default
+# mount RailsAnalytics::Engine => "/admin/analytics"  # any custom path works
 ```
 
 ```erb
 <!-- layout -->
-<%= rails_analytics_tracker_tag endpoint: "/analytics" %>
+<%= rails_analytics_tracker_tag %>
 ```
 
-> The `endpoint:` passed to the helper must match the path the engine is mounted at.
-> You can also set a global default via `RailsAnalytics.configure { |c| c.mount_path = "/analytics" }`.
+> No need to pass an `endpoint:` to the helper — it resolves the mount automatically.
+> The only exception is serving the tracker from a CDN:
+> `<%= rails_analytics_tracker_tag endpoint: "/cdn/path" %>`.
 
 ## Authentication
 

data/app/assets/stylesheets/rails_analytics/dashboard.css

@@ -66,6 +66,32 @@ body {
 .ra-chart rect { fill: var(--ra-accent); opacity: 0.85; }
 .ra-chart rect:hover { opacity: 1; }
 
+/* Chart nodes: CSS-only tooltip (no JS). The tooltip is an SVG group
+   revealed on :hover/:focus-within of its parent .ra-dot group. */
+.ra-chart .ra-dot { cursor: pointer; outline: none; }
+.ra-chart .ra-dot:focus-visible .ra-dot-circle,
+.ra-chart .ra-dot:focus .ra-dot-circle { stroke: var(--ra-text); stroke-width: 2; }
+
+.ra-chart .ra-tooltip { opacity: 0; pointer-events: none; transition: opacity 0.12s ease; }
+.ra-chart .ra-dot:hover .ra-tooltip,
+.ra-chart .ra-dot:focus .ra-tooltip,
+.ra-chart .ra-dot:focus-within .ra-tooltip { opacity: 1; }
+
+.ra-chart .ra-tooltip rect { fill: var(--ra-text); opacity: 1; stroke: none; }
+.ra-chart .ra-tooltip text {
+  fill: var(--ra-card);
+  font-size: 12px;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+}
+
+/* X-axis date labels */
+.ra-chart .ra-axis-label {
+  fill: var(--ra-muted);
+  font-size: 10px;
+  font-variant-numeric: tabular-nums;
+}
+
 .ra-grid {
   display: grid;
   grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));

data/app/helpers/rails_analytics/application_helper.rb

@@ -2,9 +2,15 @@
 
 module RailsAnalytics
   module ApplicationHelper
+    # Single source of truth: the engine's mount point is whatever the host
+    # declared in routes.rb (`mount RailsAnalytics::Engine => "/..."`). We derive
+    # the tracker endpoint from the engine's own route helper, so there is no
+    # separate `mount_path` to keep in sync. `options[:endpoint]` still allows an
+    # explicit override (e.g. when serving the tracker from a CDN).
     def rails_analytics_tracker_tag(options = {})
-      endpoint = options[:endpoint] || RailsAnalytics.config.mount_path
-      tag.script(src: "#{endpoint}/tracker.js",
+      tracker = options[:tracker] || rails_analytics.tracker_path
+      endpoint = options[:endpoint] || rails_analytics.root_path.chomp("/")
+      tag.script(src: tracker,
                  data: { rails_analytics: true, endpoint: endpoint },
                  defer: true)
     end

data/app/models/rails_analytics/chart_builder.rb

@@ -2,11 +2,29 @@
 
 module RailsAnalytics
   # SVG line chart. Server-rendered, zero JS.
+  #
+  # Each data point renders as a focusable group containing the visible dot,
+  # a larger invisible hit area and a CSS-only tooltip (shown on :hover and
+  # :focus). X-axis labels mark the first and last point plus month boundaries.
   class ChartBuilder
     WIDTH = 800
     HEIGHT = 220
     PAD = 8
     RIGHT_PAD = 40
+    DOT_RADIUS = 3
+    HIT_RADIUS = 12
+
+    # Tooltip geometry. The tooltip is part of the SVG (server-computed),
+    # revealed purely with CSS on :hover/:focus — no JavaScript involved.
+    TOOLTIP_WIDTH = 130
+    TOOLTIP_HEIGHT = 30
+    TOOLTIP_OFFSET = 10
+
+    # Plot area keeps HEIGHT; the viewBox gains a strip for x-axis labels.
+    AXIS_PAD = 20
+
+    # Minimum horizontal gap (px) between x-axis labels.
+    AXIS_MIN_GAP = 70
 
     def initialize(series)
       @series = series # Array<Hash> with :date and :count
@@ -16,31 +34,96 @@ module RailsAnalytics
       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(" ")
+      nodes = @series.map.with_index { |s, i| dot_node(s, i, max) }.join("\n")
 
       <<~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 viewBox="0 0 #{WIDTH + RIGHT_PAD} #{HEIGHT + AXIS_PAD}" role="img" aria-label="#{I18n.t('rails_analytics.chart.visits_per_day')}" xmlns="http://www.w3.org/2000/svg">
+          <polyline points="#{points(max)}" fill="none" stroke="var(--ra-accent, #3b82f6)" stroke-width="2" stroke-linejoin="round" stroke-linecap="round" />
+          #{axis_labels}
+          #{nodes}
         </svg>
       SVG
     end
 
     private
 
-    def pad(index)
+    def points(max)
+      @series.each_with_index.map do |s, i|
+        "#{x(i).round(2)},#{y(s[:count], max).round(2)}"
+      end.join(" ")
+    end
+
+    def dot_node(series, index, max)
+      cx = x(index).round(2)
+      cy = y(series[:count], max).round(2)
+      label = tooltip_text(series)
+
+      <<~NODE.strip
+        <g class="ra-dot" tabindex="0" role="img" aria-label="#{label}">
+          <circle cx="#{cx}" cy="#{cy}" r="#{HIT_RADIUS}" fill="transparent" />
+          <circle cx="#{cx}" cy="#{cy}" r="#{DOT_RADIUS}" class="ra-dot-circle" />
+          #{tooltip(cx, cy, label)}
+        </g>
+      NODE
+    end
+
+    def tooltip(cx, cy, label)
+      # Above the dot; flips to the far side when it would clip the top edge.
+      tx = (cx - TOOLTIP_WIDTH / 2).clamp(0, WIDTH + RIGHT_PAD - TOOLTIP_WIDTH)
+      ty = cy - DOT_RADIUS - TOOLTIP_OFFSET - TOOLTIP_HEIGHT
+      ty = cy + DOT_RADIUS + TOOLTIP_OFFSET if ty < 0
+
+      <<~TOOLTIP.strip
+        <g class="ra-tooltip">
+          <rect x="#{tx}" y="#{ty}" width="#{TOOLTIP_WIDTH}" height="#{TOOLTIP_HEIGHT}" rx="6" />
+          <text x="#{tx + TOOLTIP_WIDTH / 2}" y="#{ty + TOOLTIP_HEIGHT / 2 + 4}" text-anchor="middle">#{label}</text>
+        </g>
+      TOOLTIP
+    end
+
+    def tooltip_text(series)
+      I18n.t("rails_analytics.chart.tooltip", count: series[:count],
+             date: series[:date].strftime(I18n.t("rails_analytics.chart.date_format")),
+             formatted_count: ActiveSupport::NumberHelper.number_to_delimited(series[:count]))
+    end
+
+    def x(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
+    def y(count, max)
+      HEIGHT - PAD - ((count / max) * (HEIGHT - PAD * 2))
+    end
+
+    # X-axis labels: first and last point always; month boundaries in between
+    # only when far enough from the neighbouring label to avoid collision.
+    def axis_labels
+      return "" if @series.length < 2
+
+      axis_indices.map do |i|
+        anchor = "start" if i.zero?
+        anchor = "end" if i == @series.length - 1
+        anchor ||= "middle"
+        %(<text x="#{x(i).round(2)}" y="#{HEIGHT + 13}" class="ra-axis-label" text-anchor="#{anchor}">#{write_date(@series[i][:date])}</text>)
+      end.join("\n")
+    end
+
+    def axis_indices
+      last = @series.length - 1
+      kept = [0]
+      (1...last).each do |i|
+        next unless @series[i][:date].day == 1 # month boundary
+
+        left_gap = x(i) - x(kept.last)
+        right_gap = x(last) - x(i)
+        kept << i if left_gap >= AXIS_MIN_GAP && right_gap >= AXIS_MIN_GAP
+      end
+      kept << last
+      kept.uniq
+    end
+
+    def write_date(date)
+      date.strftime(I18n.t("rails_analytics.chart.date_format"))
     end
 
     def empty_chart
@@ -51,4 +134,4 @@ module RailsAnalytics
       SVG
     end
   end
-end
+end

data/config/locales/rails_analytics.en.yml

@@ -14,6 +14,10 @@ en:
     chart:
       visits_per_day: "Visits per day"
       no_data: "No data"
+      date_format: "%m/%d"
+      tooltip:
+        one: "%{date} — 1 visit"
+        other: "%{date} — %{formatted_count} visits"
     tables:
       top_sources: "Traffic sources"
       top_events: "Top events"

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

@@ -14,6 +14,10 @@ pt-BR:
     chart:
       visits_per_day: "Visitas por dia"
       no_data: "Sem dados"
+      date_format: "%d/%m"
+      tooltip:
+        one: "%{date} — 1 visita"
+        other: "%{date} — %{formatted_count} visitas"
     tables:
       top_sources: "Origem do tráfego"
       top_events: "Clics por botão"

data/config/routes.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 RailsAnalytics::Engine.routes.draw do
-  get "tracker.js" => "analytics#tracker"
+  get "tracker.js" => "analytics#tracker", as: "tracker"
   get "dashboard.css" => "analytics#dashboard_css", as: "dashboard_css"
   post "collect" => "analytics#collect"
   get  "token" => "analytics#token"

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

@@ -6,6 +6,11 @@ module RailsAnalytics
       source_root File.expand_path("templates", __dir__)
       desc "Instala o rails_analytics: copia migrations, monta engine, cria initializer e pina tracker no importmap."
 
+      # The only mount configuration that matters is the `mount` line this generator
+      # writes into config/routes.rb. Changing that line is enough — the tracker and
+      # dashboard derive their URLs from the engine's route helpers at runtime.
+      DEFAULT_MOUNT_PATH = "/analytics"
+
       def copy_migrations
         migrations_dir = RailsAnalytics::Engine.root.join("db/migrate")
         Dir["#{migrations_dir}/*.rb"].sort.each do |migration|
@@ -21,20 +26,20 @@ module RailsAnalytics
       end
 
       def mount_engine
-        route %(mount RailsAnalytics::Engine => RailsAnalytics.config.mount_path)
-        say_status :ok, "Engine montada em config/routes.rb"
+        route %(mount RailsAnalytics::Engine => "#{DEFAULT_MOUNT_PATH}")
+        say_status :ok, "Engine montada em config/routes.rb (montada em #{DEFAULT_MOUNT_PATH})"
       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)
+            append_to_file importmap_path, %(\npin "rails_analytics/tracker", to: "#{DEFAULT_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
+          say %(  Adicione ao seu layout: <script src="#{DEFAULT_MOUNT_PATH}/tracker.js" defer></script>), :yellow
         end
       end
 
@@ -42,7 +47,7 @@ module RailsAnalytics
         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 "  3. Acesse o dashboard em #{DEFAULT_MOUNT_PATH} (se quiser outro path, edite o mount em config/routes.rb)"
         say ""
       end
     end

data/lib/generators/rails_analytics/install/templates/initializer.rb

@@ -5,10 +5,6 @@ RailsAnalytics.configure do |config|
   # Pode ser um Symbol (ex: :authenticate_admin!) ou um callable (ex: -> { current_user&.admin? }).
   config.auth_callback = :authenticate_admin!
 
-  # Caminho onde o engine é montado (debe coincidir com el mount en config/routes.rb).
-  # Padrão: "/analytics". Puedes cambiarlo libremente (ex: "/admin/analytics").
-  config.mount_path = "/analytics"
-
   # Período padrão para as consultas do dashboard (ex: 30.days).
   config.since_default = 30.days
 end

data/lib/rails_analytics/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAnalytics
-  VERSION = "1.0.3"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_analytics
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - br4zz4
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-07 00:00:00.000000000 Z
+date: 2026-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails