Add timeline structure

app/controllers/event_registrations_controller.rb

@@ -64,6 +64,11 @@ def edit
        stripe_session = Stripe::Checkout::Session.retrieve(@event_registration.checkout_session_id)
       @checkout_payment_status = stripe_session.payment_status
     end
+
+    @timeline_events = @event_registration.timeline_events
+      .includes(:actor, :subject)
+      .order(created_at: :desc)
+      .paginate(page: params[:page], per_page: 25)
   end
 
   def create

app/controllers/organizations_controller.rb

@@ -94,6 +94,12 @@ def new
 
   def edit
     authorize! @organization
+
+    if turbo_frame_request? && params[:section] == "timeline"
+      @timeline_events = @organization.timeline_events.includes(:actor, :subject).order(created_at: :desc).paginate(page: params[:page], per_page: 25)
+      return render partial: "organizations/sections/timeline", locals: { organization: @organization, timeline_events: @timeline_events }
+    end
+
     set_form_variables
   end
 

app/controllers/people_controller.rb

@@ -241,6 +241,12 @@ def edit
       affiliations: { organization: [ :logo_attachment, :addresses ] }
     ).find(params[:id]).decorate
     authorize! @person
+
+    if turbo_frame_request? && params[:section] == "timeline"
+      @timeline_events = @person.timeline_events.includes(:actor, :subject).order(created_at: :desc).paginate(page: params[:page], per_page: 25)
+      return render partial: "people/sections/timeline", locals: { person: @person, timeline_events: @timeline_events }
+    end
+
     @membership = membership_for(@person)
     set_form_variables
   end

app/models/address.rb

@@ -1,4 +1,15 @@
 class Address < ApplicationRecord
+  include Timelineable
+
+  def self.timeline_renderer_class
+    NestedRecordTimelineRenderer
+  end
+
+  ADDRESS_TIMELINE_ATTRIBUTES = %w[
+    street_address city state zip_code phone county country
+    address_type locality district
+  ].freeze
+
   LOCALITIES = [ "LA City", "LA County", "Southern CA", "Northern CA",
                 "Central CA", "Orange County", "Outside CA", "Outside USA", "Unknown" ]
   CONTACT_TYPES = [ nil, "work", "personal", "mailing", "unknown" ].freeze
@@ -32,4 +43,14 @@ class Address < ApplicationRecord
   def name
     "#{street_address}, #{city}, #{state} #{zip_code}"
   end
+
+  def timeline_label
+    "Address"
+  end
+
+  def timeline_changes
+    saved_changes
+      .slice(*ADDRESS_TIMELINE_ATTRIBUTES)
+      .transform_values { |(old_value, new_value)| [ old_value.to_s, new_value.to_s ] }
+  end
 end

app/models/affiliation.rb

@@ -1,5 +1,6 @@
 class Affiliation < ApplicationRecord
   include Communicable
+  include Timelineable
   # Standing title given to the "facilitator affiliation" we create on registration
   # and org linking. Matches the `facilitators` scope / `facilitator?` predicate
   # (both treat exactly "Facilitator" as canonical).
@@ -28,6 +29,10 @@ class Affiliation < ApplicationRecord
   def communications_email
     person&.preferred_email
   end
+
+  def self.timeline_renderer_class
+    AffiliationTimelineRenderer
+  end
   accepts_nested_attributes_for :comments, allow_destroy: true, reject_if: proc { |attrs| attrs["body"].blank? }
 
   # Validations
@@ -140,6 +145,10 @@ def name
     "#{person.name}" if person
   end
 
+  def timeline_label
+    "Affiliation: #{person&.name} at #{organization&.name}"
+  end
+
   private
 
   # The linked address must be one of this affiliation's organization's own

app/models/categorizable_item.rb

@@ -1,8 +1,18 @@
 class CategorizableItem < ApplicationRecord
+  include Timelineable
+
+  def self.timeline_renderer_class
+    NestedRecordTimelineRenderer
+  end
+
   belongs_to :categorizable, polymorphic: true
   belongs_to :category
 
   # Validations
   validates_presence_of :categorizable_type, :categorizable_id, :category_id
   validates :category_id, uniqueness: { scope: [ :categorizable_type, :categorizable_id ] }
+
+  def timeline_label
+    "category '#{category.name}'"
+  end
 end

app/models/comment.rb

@@ -1,4 +1,6 @@
 class Comment < ApplicationRecord
+  include Timelineable
+
   belongs_to :commentable, polymorphic: true
   belongs_to :created_by, class_name: "User", optional: true
   belongs_to :updated_by, class_name: "User", optional: true
@@ -94,4 +96,28 @@ def self.parse_date(value)
   rescue ArgumentError
     nil
   end
+
+  def timeline_label
+    return "Comment" unless commentable.present?
+    "Comment on #{commentable.timeline_label}"
+  end
+
+  def self.timeline_renderer_class
+    CommentTimelineRenderer
+  end
+
+  private
+
+  def timeline_changes
+    super.except("commentable_id", "commentable_type")
+  end
+
+  def record_timeline_event(action)
+    return unless action == "created"
+
+    targets = TimelineServices::Router.targets_for(self)
+    return if targets.empty?
+
+    TimelineServices::RecordEvent.call(subject: self, action: action, snapshot: { "changes" => timeline_changes })
+  end
 end

app/models/concerns/has_timeline.rb

@@ -0,0 +1,8 @@
+module HasTimeline
+  extend ActiveSupport::Concern
+
+  included do
+    has_many :timeline_entries, as: :owner, dependent: :destroy
+    has_many :timeline_events, through: :timeline_entries
+  end
+end

app/models/concerns/timelineable.rb

@@ -0,0 +1,42 @@
+module Timelineable
+  extend ActiveSupport::Concern
+
+  SENSITIVE_ATTRIBUTE_PATTERN = /password|token|secret|key|digest|salt|otp/i
+
+  included do
+    after_create -> { record_timeline_event("created") }
+    after_update -> { record_timeline_event("updated") if timeline_changes.any? }
+    # before_destroy, not after: dependent associations (e.g. a scholarship's
+    # allocation) are already gone by after_destroy, and routing needs them.
+    before_destroy -> { record_timeline_event("destroyed") }
+
+    def self.timeline_renderer_class
+      ApplicationTimelineRenderer
+    end
+  end
+
+  def record_timeline_event(action)
+    TimelineServices::RecordEvent.call(
+      subject: self,
+      action: action,
+      snapshot: { "changes" => timeline_changes },
+      also_log: timeline_also_log
+    )
+  end
+
+  def timeline_also_log
+    []
+  end
+
+  def timeline_changes
+    saved_changes.except("id", "created_at", "updated_at", "created_by_id", "updated_by_id", "slug")
+                 .reject { |attribute, _| attribute.match?(SENSITIVE_ATTRIBUTE_PATTERN) }
+                 .transform_values { |(old_value, new_value)| [ old_value.to_s, new_value.to_s ] }
+  end
+
+  def timeline_label
+    model_name.human
+  end
+
+  private
+end

app/models/contact_method.rb

@@ -1,4 +1,10 @@
 class ContactMethod < ApplicationRecord
+  include Timelineable
+
+  def self.timeline_renderer_class
+    NestedRecordTimelineRenderer
+  end
+
   CONTACT_TYPES = [ nil, "work", "personal" ].freeze
 
   belongs_to :contactable, polymorphic: true
@@ -12,4 +18,8 @@ class ContactMethod < ApplicationRecord
 
   validates :value, presence: true, length: { maximum: 255 }
   validates :kind, presence: true
+
+  def timeline_label
+    kind.humanize
+  end
 end

app/models/continuing_education_registration.rb

@@ -2,6 +2,7 @@ class ContinuingEducationRegistration < ApplicationRecord
   include Registerable
   include Certifiable
   include Communicable
+  include Timelineable
 
   # AWBW's continuing-education accreditation, referenced by the CE callout copy
   # and the completion certificate's CE clause. Kept here as the single source of
@@ -188,6 +189,15 @@ def payment_status_label
     "Due"
   end
 
+  def timeline_label
+    return "CE Registration" unless event_registration&.registrant.present?
+    "CE Registration: #{event_registration.registrant.timeline_label}"
+  end
+
+  def self.timeline_renderer_class
+    ContinuingEducationRegistrationTimelineRenderer
+  end
+
   private
 
   # Snapshot the hours offered and total cost from the event when they aren't set

app/models/event_registration.rb

@@ -3,6 +3,8 @@ class EventRegistration < ApplicationRecord
   include Registerable
   include Certifiable
   include Communicable
+  include HasTimeline
+  include Timelineable
 
   # Sentinel for the roster's Payment method filter that matches buddy-system
   # registrations (someone_else_will_pay), which isn't an expected_payment_method
@@ -1114,6 +1116,19 @@ def remote_search_label
     }
   end
 
+  def timeline_label
+    return "Event Registration" unless event.present?
+    "Event Registration: #{event.name}"
+  end
+
+  def self.timeline_renderer_class
+    EventRegistrationTimelineRenderer
+  end
+
+  def timeline_also_log
+    [ registrant ].compact
+  end
+
   private
 
   def generate_slug

app/models/form_submission.rb

@@ -1,4 +1,6 @@
 class FormSubmission < ApplicationRecord
+  include Timelineable
+
   belongs_to :person
   belongs_to :form
   belongs_to :event, optional: true
@@ -332,6 +334,10 @@ def title
     "#{form&.display_name} submission ##{id}"
   end
 
+  def timeline_label
+    "Form Submission: #{form.name}"
+  end
+
   private
 
   def answer_text(raw_value)

app/models/notification.rb

@@ -1,4 +1,6 @@
 class Notification < ApplicationRecord
+  include Timelineable
+
   belongs_to :sender, class_name: "User", optional: true
   belongs_to :noticeable, polymorphic: true, optional: true
   belongs_to :parent_notification, class_name: "Notification", optional: true
@@ -179,6 +181,34 @@ def timeline_activity_name
     TIMELINE_NAMES_BY_DIRECTION.fetch(direction)
   end
 
+  def timeline_label
+    subject_text = custom_subject.presence || email_subject.presence
+    label = "#{channel.titleize} #{direction.humanize}"
+    label += ": #{subject_text}" if subject_text.present?
+    label
+  end
+
+  def self.timeline_renderer_class
+    NotificationTimelineRenderer
+  end
+
+  def record_timeline_event(action)
+    return unless action == "created"
+    return unless noticeable.present?
+
+    TimelineServices::RecordEvent.call(
+      subject: self,
+      action: action,
+      snapshot: { "changes" => timeline_changes },
+      also_log: timeline_also_log
+    )
+  end
+
+  def timeline_also_log
+    return [] unless noticeable.is_a?(EventRegistration)
+    [ noticeable.registrant ].compact
+  end
+
   # Scopes
   scope :email, ->(email) { where("notifications.recipient_email LIKE ?", "%#{email}%") }
   scope :participant_name, ->(name) { joins(:people)

app/models/organization.rb

@@ -1,6 +1,6 @@
 class Organization < ApplicationRecord
   include RemoteSearchable, TagFilterable, Trendable, WindowsTypeFilterable, SectorsTaggable, AgeGroupTaggable # Publishable
-  include Communicable
+  include Communicable, HasTimeline, Timelineable
   belongs_to :organization_status
   belongs_to :organization_obligation, optional: true
   belongs_to :location, optional: true # TODO - remove Location if unused
@@ -19,6 +19,10 @@ class Organization < ApplicationRecord
   def communications_email
     email
   end
+
+  def timeline_label
+    "Organization: #{name}"
+  end
   has_many :reports
   has_many :workshop_logs
   has_many :grants, as: :funder, dependent: :destroy

app/models/person.rb

@@ -1,6 +1,6 @@
 class Person < ApplicationRecord
-  include RemoteSearchable, TagFilterable, Trendable, WindowsTypeFilterable, SectorsTaggable, AgeGroupTaggable, StaffTaggable
-  include Communicable
+  include Communicable, HasTimeline, RemoteSearchable, TagFilterable, Timelineable, Trendable, WindowsTypeFilterable, SectorsTaggable, AgeGroupTaggable, StaffTaggable
+
 
   pay_customer default_payment_processor: :stripe
 
@@ -513,6 +513,10 @@ def age_range_items_ordered
     age_range_categorizable_items.sort_by { |item| [ item.category&.position || 0, item.category&.name.to_s ] }
   end
 
+  def timeline_label
+    name
+  end
+
   private
 
   # Count the in-memory set (not a DB query): nested attributes build the items in

app/models/professional_license.rb

@@ -1,4 +1,10 @@
 class ProfessionalLicense < ApplicationRecord
+  include Timelineable
+
+  def self.timeline_renderer_class
+    NestedRecordTimelineRenderer
+  end
+
   has_paper_trail
 
   belongs_to :person
@@ -71,6 +77,10 @@ def used_for_ce?
     continuing_education_registrations.exists?
   end
 
+  def timeline_label
+    model_name.human
+  end
+
   private
 
   def prevent_destroy_with_ce