Add users.policies_acknowledged_at

So we can track when users last acked the policies, and prompt them to do so when we introduce/update them

Signed-off-by: Samuel Giddins <segiddins@segiddins.me>

Author: segiddins

app/avo/resources/user.rb

@@ -39,6 +39,8 @@ def fields # rubocop:disable Metrics
     field :mail_fails, as: :number
     field :blocked_email, as: :text
 
+    field :policies_acknowledged_at, as: :date_time
+
     tabs style: :pills do
       tab "Auth" do
         field :encrypted_password, as: :password, visible: -> { false }

app/models/events/user_event.rb

@@ -44,4 +44,6 @@ class Events::UserEvent < ApplicationRecord
   end
 
   PASSWORD_CHANGED = define_event "user:password:changed"
+
+  POLICIES_ACKNOWLEDGED = define_event "user:policies:acknowledged"
 end

app/models/user.rb

@@ -17,6 +17,7 @@ class User < ApplicationRecord
   after_update :record_email_update_event, if: :email_was_updated?
   after_update :record_email_verified_event, if: -> { saved_change_to_email? && email_confirmed? }
   after_update :record_password_update_event, if: :saved_change_to_encrypted_password?
+  after_update :record_policies_acknowledged_event, if: :saved_change_to_policies_acknowledged_at?
   before_discard :yank_gems
   before_discard :expire_all_api_keys
   before_discard :destroy_associations_for_discard
@@ -375,4 +376,8 @@ def record_password_update_event
   def unique_with_org_handle
     errors.add(:handle, "has already been taken") if handle && Organization.where("lower(handle) = lower(?)", handle).any?
   end
+
+  def record_policies_acknowledged_event
+    record_event!(Events::UserEvent::POLICIES_ACKNOWLEDGED)
+  end
 end

db/migrate/20250312181402_add_policies_acknowledged_at_to_users.rb

@@ -0,0 +1,5 @@
+class AddPoliciesAcknowledgedAtToUsers < ActiveRecord::Migration[8.0]
+  def change
+    add_column :users, :policies_acknowledged_at, :datetime
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.2].define(version: 2024_11_04_065953) do
+ActiveRecord::Schema[8.0].define(version: 2025_03_12_181402) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "hstore"
   enable_extension "pgcrypto"
@@ -557,6 +557,7 @@
     t.string "mfa_hashed_recovery_codes", default: [], array: true
     t.boolean "public_email", default: false, null: false
     t.datetime "deleted_at"
+    t.datetime "policies_acknowledged_at"
     t.index "lower((email)::text) varchar_pattern_ops", name: "index_users_on_lower_email"
     t.index ["email"], name: "index_users_on_email"
     t.index ["handle"], name: "index_users_on_handle"