rails_analytics 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6a607ecb6f634b056bce7db997068d29e41ecc29c20d1fe38fb352a2e81b70d
-  data.tar.gz: 9ce65316e5f58c2c644df424315d29597d129560ead62e530c2499a1cbd2c26f
+  metadata.gz: 235ecc86f0e45e6c0989fbe9a5bc7b3623ab9f5b1f38ede89d991d938c6b6235
+  data.tar.gz: 7e46192a35e21e6e255b6f87f09329ddd74d1b2bcd177beaa5063161d4361006
 SHA512:
-  metadata.gz: 48c2a3920a2ffab6d0d59093608dd61607c6a3fabf1f1cb998b0acd368781473bdcd672e9a4d384b439123a9029912d9e519ef08e0e6624cd87721b5f4115541
-  data.tar.gz: c19d0b161aeeb89208cac8c59e975e21be96539cb7ac1adbd8a6e693fcd0461decce6a65338a04262fac527119438671e66f3e6d1eedb06c688450463765850f
+  metadata.gz: b30ba06c428da41976626821312671a5c66f8463522b5e35bdef6355b60762deb06b33ba51b518e1381378caf083ec418e378511d358e9c0d402d1ca316e9382
+  data.tar.gz: d06bdbee94eb980257e973ed7d9c7158af4203b8d907af502f56c15935c592cbaa8f6d3cb39e00e0f7cc6a105695fc478211a7ef4c07d5e7e032b985acab4c70

data/README.md

@@ -9,6 +9,12 @@ 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.
 
+The **Journeys** view lists recent sessions as cards: each card shows the
+user's ordered trajectory (landing page → clicks → scroll depth → forms) with
+arrows between steps, hover/focus details on every step, and origin, device
+and UTM in the card header. Filter by event name to see the journeys that
+contain a specific click/topic.
+
 ## Screenshots
 
 | Dashboard — aggregated overview | Dashboard — events & visits |

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

@@ -139,6 +139,107 @@ body {
   }
 }
 
+/* Journey cards */
+.ra-journey {
+  border: 1px solid var(--ra-border);
+  border-radius: var(--ra-radius);
+  margin-bottom: 16px;
+  overflow: hidden;
+}
+
+.ra-journey-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 14px;
+  background: var(--ra-accent-soft);
+  border-bottom: 1px solid var(--ra-border);
+  font-size: 12px;
+}
+
+.ra-journey-origin {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-weight: 700;
+}
+.ra-journey-origin:empty::before { content: "direct"; }
+
+.ra-journey-meta { color: var(--ra-muted); }
+.ra-journey-utm {
+  background: var(--ra-accent);
+  color: #fff;
+  border-radius: 10px;
+  padding: 1px 8px;
+  font-size: 11px;
+}
+.ra-journey-steps { margin-left: auto; color: var(--ra-muted); font-variant-numeric: tabular-nums; }
+
+.ra-journey-path {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  align-items: center;
+  padding: 14px;
+}
+
+.ra-journey-arrow {
+  color: var(--ra-muted);
+  font-size: 12px;
+  flex: none;
+}
+
+/* Step chip. Tooltip is CSS-only: shown on :hover and :focus. */
+.ra-journey-step {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  border: 1px solid var(--ra-border);
+  border-radius: 999px;
+  padding: 4px 12px;
+  background: var(--ra-card);
+  cursor: default;
+  outline: none;
+}
+.ra-journey-step:focus-visible { border-color: var(--ra-accent); }
+
+.ra-journey-step:focus-visible,
+.ra-journey-step:focus:not(:focus-visible) {
+  border-color: var(--ra-accent);
+}
+
+.ra-journey-step--click { border-color: var(--ra-accent); color: var(--ra-accent); font-weight: 600; }
+.ra-journey-step--outbound { border-style: dashed; color: var(--ra-muted); }
+.ra-journey-step--form { border-color: #059669; color: #059669; }
+.ra-journey-step--scroll { color: var(--ra-muted); }
+.ra-journey-step--email { border-color: #d97706; color: #d97706; }
+.ra-journey-step--pageview { background: var(--ra-bg); font-weight: 600; }
+
+.ra-journey-step-detail {
+  position: absolute;
+  bottom: calc(100% + 8px);
+  left: 50%;
+  transform: translateX(-50%);
+  min-width: 140px;
+  max-width: 260px;
+  background: var(--ra-text);
+  color: var(--ra-card);
+  border-radius: 8px;
+  padding: 6px 10px;
+  font-size: 12px;
+  line-height: 1.5;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity 0.12s ease;
+  z-index: 10;
+}
+
+.ra-journey-step:hover .ra-journey-step-detail,
+.ra-journey-step:focus .ra-journey-step-detail { opacity: 1; }
+
+.ra-journey-step-time { font-weight: 700; opacity: 0.75; }
+
 /* Pagination */
 .ra-pagination {
   display: flex;

data/app/controllers/rails_analytics/journeys_controller.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  class JourneysController < ApplicationController
+    def index
+      @event_name = params[:event]
+      @page = (params[:page] || 1).to_i
+      @journeys = Stats.journeys(event: @event_name.presence, page: @page)
+      @event_names = Stats.event_counts_by_name.keys.sort
+    end
+  end
+end

data/app/models/rails_analytics/journey.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module RailsAnalytics
+  # Serializes a Visit (session) into a user journey: ordered steps with
+  # kind/label/detail, plus origin and context metadata for the card header.
+  class Journey
+    def initialize(visit)
+      @visit = visit
+    end
+
+    def to_h
+      {
+        id: @visit.id,
+        origin: origin,
+        device: @visit.device_type,
+        viewport: @visit.viewport,
+        language: @visit.language,
+        utm: utm,
+        started_at: @visit.started_at,
+        duration: duration,
+        steps: steps
+      }
+    end
+
+    private
+
+    def origin
+      @visit.referrer_domain.presence || "direct"
+    end
+
+    def utm
+      {
+        source: @visit.utm_source,
+        campaign: @visit.utm_campaign,
+        medium: @visit.utm_medium
+      }.compact
+    end
+
+    def duration
+      last = @visit.events.map(&:time).max || @visit.started_at
+      (last - @visit.started_at).to_i
+    end
+
+    # Ordered: landing page first, then tracked events by time.
+    def steps
+      sorted = @visit.events.sort_by(&:time)
+      [pageview_step] + sorted.map { |event| event_step(event) }
+    end
+
+    def pageview_step
+      {
+        kind: :pageview,
+        label: @visit.landing_page_path.to_s.split("?").first.presence || "/",
+        detail: pageview_detail,
+        time: @visit.started_at
+      }
+    end
+
+    def pageview_detail
+      parts = [I18n.t("rails_analytics.journeys.devices.#{@visit.device_type}", default: @visit.device_type)]
+      parts << I18n.t("rails_analytics.journeys.details.viewport", value: @visit.viewport) if @visit.viewport.present?
+      parts << I18n.t("rails_analytics.journeys.details.language", value: @visit.language) if @visit.language.present?
+      parts.join(" · ")
+    end
+
+    def event_step(event)
+      props = event.properties.is_a?(Hash) ? event.properties.symbolize_keys : {}
+      kind = kind_for(event.name)
+
+      {
+        kind: kind,
+        label: label_for(event.name, kind, props),
+        detail: detail_for(props),
+        time: event.time
+      }
+    end
+
+    def kind_for(name)
+      case name
+      when /outbound/ then :outbound
+      when /email/ then :email
+      when /scroll/ then :scroll
+      when /form/ then :form
+      when /time/ then :time
+      when /click/ then :click
+      else :other
+      end
+    end
+
+    def label_for(name, kind, props)
+      case kind
+      when :click then props[:value].presence || name
+      when :scroll then I18n.t("rails_analytics.journeys.steps.scroll", mark: props[:mark].to_i)
+      when :outbound then props[:target].presence || name
+      when :email then I18n.t("rails_analytics.journeys.steps.email")
+      when :form then I18n.t("rails_analytics.journeys.steps.form", form: props[:form].to_s)
+      when :time then I18n.t("rails_analytics.journeys.steps.time_on_page", seconds: props[:seconds].to_i)
+      else props[:value].presence || name
+      end
+    end
+
+    def detail_for(props)
+      return if props.empty?
+
+      props
+        .reject { |_, value| value.blank? }
+        .map { |key, value| "#{key}: #{value}" }
+        .join(" · ")
+    end
+  end
+end

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

@@ -14,6 +14,7 @@
         <%= 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 %>
+        <%= link_to t("rails_analytics.nav.journeys"), rails_analytics.journeys_path %>
       </nav>
     </header>
     <main class="ra-main">

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

@@ -28,9 +28,11 @@
         <% @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>
+            <td class="ra-mono">
+              <%= row[:name] %>
+              <%= link_to t("rails_analytics.journeys.view"), rails_analytics.journeys_path(event: row[:name]) %>
+            </td>
+            <td class="ra-num"><%= number_with_delimiter(row[:count]) %></td>          </tr>
         <% end %>
       </tbody>
     </table>

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

@@ -53,7 +53,13 @@
         </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>
+            <tr>
+              <td class="ra-mono">
+                <%= name %>
+                <%= link_to t("rails_analytics.journeys.view"), rails_analytics.journeys_path(event: name) %>
+              </td>
+              <td class="ra-num"><%= number_with_delimiter(count) %></td>
+            </tr>
           <% end %>
         </tbody>
       </table>

data/app/views/rails_analytics/journeys/index.html.erb

@@ -0,0 +1,62 @@
+<%# app/views/rails_analytics/journeys/index.html.erb %>
+<% fmt = t("rails_analytics.journeys.datetime_format") %>
+<section class="ra-card">
+  <h2 class="ra-card-title"><%= t("rails_analytics.journeys.title") %></h2>
+
+  <div class="ra-filter">
+    <%= form_tag rails_analytics.journeys_path, method: :get do %>
+      <%= select_tag :event,
+            options_for_select(
+              [[t("rails_analytics.filter.all_events"), ""]] +
+              @event_names.map { |n| [n, n] },
+              @event_name
+            ),
+            onchange: "this.form.submit()" %>
+      <noscript><%= submit_tag t("rails_analytics.filter.filter") %></noscript>
+    <% end %>
+  </div>
+
+  <% if @journeys[:data].any? %>
+    <% @journeys[:data].each do |journey| %>
+      <% j = journey.to_h %>
+      <article class="ra-journey">
+        <header class="ra-journey-head">
+          <span class="ra-journey-origin" title="<%= t("rails_analytics.journeys.origin") %>"><%= j[:origin] %></span>
+          <span class="ra-journey-meta"><%= j[:device] %></span>
+          <% if j[:utm][:source].present? %>
+            <span class="ra-journey-utm" title="<%= j[:utm].map { |k, v| "#{k}: #{v}" }.join(', ') %>"><%= j[:utm][:source] %></span>
+          <% end %>
+          <span class="ra-journey-steps">
+            <%= t("rails_analytics.journeys.step_count", count: j[:steps].size) %>
+          </span>
+          <time class="ra-journey-steps"><%= j[:started_at].strftime(fmt) %></time>
+        </header>
+
+        <div class="ra-journey-path">
+          <% j[:steps].each_with_index do |step, i| %>
+            <% if i > 0 %><span class="ra-journey-arrow" aria-hidden="true">→</span><% end %>
+            <span class="ra-journey-step ra-journey-step--<%= step[:kind] %>" tabindex="0">
+              <span class="ra-journey-step-label"><%= step[:label] %></span>
+              <span class="ra-journey-step-detail" role="tooltip">
+                <span class="ra-journey-step-time"><%= step[:time].strftime(fmt) if step[:time] %></span>
+                <% if step[:detail].present? %><span><%= step[:detail] %></span><% end %>
+              </span>
+            </span>
+          <% end %>
+        </div>
+      </article>
+    <% end %>
+
+    <div class="ra-pagination">
+      <% if @page > 1 %>
+        <%= link_to t("rails_analytics.pagination.previous"), rails_analytics.journeys_path(page: @page - 1, event: @event_name) %>
+      <% end %>
+      <span class="current"><%= @page %></span>
+      <% if @journeys[:data].length == @journeys[:per_page] %>
+        <%= link_to t("rails_analytics.pagination.next"), rails_analytics.journeys_path(page: @page + 1, event: @event_name) %>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="ra-empty"><%= t("rails_analytics.empty") %></p>
+  <% end %>
+</section>

data/config/locales/rails_analytics.en.yml

@@ -5,6 +5,7 @@ en:
       overview: "Overview"
       events: "Events"
       visits: "Visits"
+      journeys: "Journeys"
     footer: "Aggregated and anonymous data — 6 month retention"
     kpi:
       visits: "Visits"
@@ -38,4 +39,25 @@ en:
       filter: "Filter"
     pagination:
       previous: "Previous"
-      next: "Next"
+      next: "Next"
+    journeys:
+      view: "journeys"
+      title: "Journeys by session"
+      datetime_format: "%m/%d %H:%M"
+      origin: "Origin"
+      step_count:
+        one: "1 step"
+        other: "%{count} steps"
+      steps:
+        scroll: "Scroll %{mark}%"
+        form: "Form %{form}"
+        email: "Email"
+        time_on_page: "%{seconds}s on page"
+      devices:
+        desktop: "Desktop"
+        mobile: "Mobile"
+        tablet: "Tablet"
+        unknown: "Unknown"
+      details:
+        viewport: "Screen %{value}"
+        language: "Language %{value}"

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

@@ -5,6 +5,7 @@ pt-BR:
       overview: "Visão geral"
       events: "Eventos"
       visits: "Visitas"
+      journeys: "Trajetórias"
     footer: "Dados agregados e anônimos — retenção 6 meses"
     kpi:
       visits: "Visitas"
@@ -38,4 +39,25 @@ pt-BR:
       filter: "Filtrar"
     pagination:
       previous: "Anterior"
-      next: "Próximo"
+      next: "Próximo"
+    journeys:
+      view: "trajetórias"
+      title: "Trajetórias por sessão"
+      datetime_format: "%d/%m %H:%M"
+      origin: "Origem"
+      step_count:
+        one: "1 passo"
+        other: "%{count} passos"
+      steps:
+        scroll: "Scroll %{mark}%"
+        form: "Form %{form}"
+        email: "E-mail"
+        time_on_page: "%{seconds}s na página"
+      devices:
+        desktop: "Desktop"
+        mobile: "Mobile"
+        tablet: "Tablet"
+        unknown: "Desconhecido"
+      details:
+        viewport: "Tela %{value}"
+        language: "Idioma %{value}"

data/config/routes.rb

@@ -8,4 +8,5 @@ RailsAnalytics::Engine.routes.draw do
   root to: "dashboards#overview"
   get "events" => "dashboards#events"
   get "visits" => "dashboards#visits"
+  get "journeys" => "journeys#index"
 end

data/lib/rails_analytics/stats.rb

@@ -139,6 +139,21 @@ module RailsAnalytics
       Visit.since(since)
     end
 
+    # Sessions with their events, newest first. Optional filter by event name.
+    def journeys(event: nil, page: 1, per_page: 10, since: default_since)
+      scope = base_scope(since)
+      if event.present?
+        scope = scope.joins(:events).merge(Event.named(event))
+      end
+      visits = scope.order(started_at: :desc)
+                    .offset((page - 1) * per_page)
+                    .limit(per_page)
+                    .includes(:events)
+
+      { data: visits.map { |visit| Journey.new(visit) },
+        total: scope.count, page: page, per_page: per_page }
+    end
+
     def default_since
       RailsAnalytics.config.since_default.ago
     end

data/lib/rails_analytics/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_analytics
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - br4zz4
@@ -40,16 +40,19 @@ files:
 - app/controllers/rails_analytics/analytics_controller.rb
 - app/controllers/rails_analytics/application_controller.rb
 - app/controllers/rails_analytics/dashboards_controller.rb
+- app/controllers/rails_analytics/journeys_controller.rb
 - app/helpers/rails_analytics/application_helper.rb
 - app/jobs/rails_analytics/retention_job.rb
 - app/models/rails_analytics/chart_builder.rb
 - app/models/rails_analytics/daily_salt.rb
 - app/models/rails_analytics/event.rb
+- app/models/rails_analytics/journey.rb
 - app/models/rails_analytics/visit.rb
 - app/views/layouts/rails_analytics.html.erb
 - app/views/rails_analytics/dashboards/events.html.erb
 - app/views/rails_analytics/dashboards/overview.html.erb
 - app/views/rails_analytics/dashboards/visits.html.erb
+- app/views/rails_analytics/journeys/index.html.erb
 - config/locales/rails_analytics.en.yml
 - config/locales/rails_analytics.pt-BR.yml
 - config/routes.rb