Add search query metrics (#948)

## Summary
- add SearchQuery model for tracking queries and result counts
- enqueue TrackSearchQueryJob from new controller endpoint
- record metrics via migration, routes, translations, and schema updates

## Testing
- `bundle exec rubocop`
- `bundle exec brakeman -q -w2`
- `bundle exec bundler-audit --update`
-
`DATABASE_URL=postgres://postgres:postgres@localhost/community_engine_test
bin/ci`

------
https://chatgpt.com/codex/tasks/task_e_68927bf5b70c83219ef3866a53847d82

Author: rsmithlal

app/controllers/better_together/metrics/search_queries_controller.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module BetterTogether
+  module Metrics
+    class SearchQueriesController < ApplicationController # rubocop:todo Style/Documentation
+      def create
+        query = params[:query]
+        results_count = params[:results_count]
+        locale = I18n.locale.to_s
+
+        if query.blank? || results_count.blank?
+          render json: { error: I18n.t('metrics.search_queries.invalid_parameters') },
+                 status: :unprocessable_entity and return
+        end
+
+        BetterTogether::Metrics::TrackSearchQueryJob.perform_later(query, results_count.to_i, locale)
+
+        render json: { success: true }, status: :ok
+      end
+    end
+  end
+end

app/jobs/better_together/metrics/track_search_query_job.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BetterTogether
+  module Metrics
+    class TrackSearchQueryJob < MetricsJob # rubocop:todo Style/Documentation
+      def perform(query, results_count, locale)
+        BetterTogether::Metrics::SearchQuery.create!(
+          query: query,
+          results_count: results_count,
+          locale: locale,
+          searched_at: Time.current
+        )
+      end
+    end
+  end
+end

app/models/better_together/metrics/search_query.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module BetterTogether
+  module Metrics
+    class SearchQuery < ApplicationRecord # rubocop:todo Style/Documentation
+      validates :query, presence: true
+      validates :results_count, presence: true, numericality: { greater_than_or_equal_to: 0 }
+      validates :locale, presence: true, inclusion: { in: I18n.available_locales.map(&:to_s) }
+      validates :searched_at, presence: true
+    end
+  end
+end

config/locales/en.yml

@@ -1337,6 +1337,8 @@ en:
   metrics:
     shares:
       invalid_parameters: Invalid parameters
+    search_queries:
+      invalid_parameters: Invalid parameters for search tracking.
   navbar:
     accept_invitation: Accept invitation
     conversations: Conversations

config/locales/es.yml

@@ -1331,6 +1331,8 @@ es:
   metrics:
     shares:
       invalid_parameters: Parámetros inválidos
+    search_queries:
+      invalid_parameters: Parámetros inválidos para el seguimiento de búsqueda.
   navbar:
     accept_invitation: Aceptar invitación
     conversations: Conversaciones

config/locales/fr.yml

@@ -1357,6 +1357,8 @@ fr:
   metrics:
     shares:
       invalid_parameters: Paramètres non valides
+    search_queries:
+      invalid_parameters: Paramètres non valides pour le suivi de la recherche.
   navbar:
     accept_invitation: Accepter l'invitation
     conversations: Conversations

config/routes.rb

@@ -163,6 +163,7 @@
         resources :link_clicks, only: [:create]
         resources :page_views, only: [:create]
         resources :shares, only: [:create]
+        resources :search_queries, only: [:create]
       end
 
       resources :wizards, only: [:show] do

db/community-engine-db.dbml

@@ -414,6 +414,17 @@ Table "better_together_metrics_shares" {
   "shareable_id" uuid
 }
 
+Table "better_together_metrics_search_queries" {
+  "id" varchar
+  "lock_version" integer
+  "created_at" datetime
+  "updated_at" datetime
+  "locale" string
+  "query" string
+  "results_count" integer
+  "searched_at" datetime
+}
+
 Table "better_together_navigation_areas" {
   "id" varchar
   "lock_version" integer

db/migrate/20250704200000_create_better_together_metrics_search_queries.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class CreateBetterTogetherMetricsSearchQueries < ActiveRecord::Migration[7.1] # rubocop:todo Style/Documentation
+  def change
+    create_bt_table :search_queries, prefix: :better_together_metrics do |t|
+      t.bt_locale
+      t.string :query, null: false
+      t.integer :results_count, null: false
+      t.datetime :searched_at, null: false
+    end
+  end
+end

spec/dummy/db/schema.rb

@@ -419,9 +419,9 @@
     t.string "locale", limit: 5, default: "en", null: false
     t.string "privacy", limit: 50, default: "private", null: false
     t.boolean "protected", default: false, null: false
-    t.geography "center", limit: {srid: 4326, type: "st_point", geographic: true}
+    t.geography "center", limit: { srid: 4326, type: "st_point", geographic: true }
     t.integer "zoom", default: 13, null: false
-    t.geography "viewport", limit: {srid: 4326, type: "st_polygon", geographic: true}
+    t.geography "viewport", limit: { srid: 4326, type: "st_polygon", geographic: true }
     t.jsonb "metadata", default: {}, null: false
     t.string "mappable_type"
     t.uuid "mappable_id"
@@ -743,6 +743,17 @@
     t.index ["shareable_type", "shareable_id"], name: "index_better_together_metrics_shares_on_shareable"
   end
 
+  create_table "better_together_metrics_search_queries", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.integer "lock_version", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.string "locale", limit: 5, default: "en", null: false
+    t.string "query", null: false
+    t.integer "results_count", null: false
+    t.datetime "searched_at", null: false
+    t.index ["locale"], name: "by_better_together_metrics_search_queries_locale"
+  end
+
   create_table "better_together_navigation_areas", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
     t.integer "lock_version", default: 0, null: false
     t.datetime "created_at", null: false