Add submitted_at column to consents

This adds a new column on consents which records when the consent was
submitted, which in most cases is the same as when the consent was
created, but in the case of manually matching a consent form with a
patient, it'll be when the consent form was first submitted.

Author: thomasleese

app/models/consent.rb

@@ -12,6 +12,7 @@
 #  reason_for_refusal  :integer
 #  response            :integer          not null
 #  route               :integer          not null
+#  submitted_at        :datetime         not null
 #  withdrawn_at        :datetime
 #  created_at          :datetime         not null
 #  updated_at          :datetime         not null

db/migrate/20250515173205_add_submitted_at_to_consents.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+class AddSubmittedAtToConsents < ActiveRecord::Migration[8.0]
+  def up
+    add_column :consents, :submitted_at, :datetime
+
+    Consent
+      .includes(:consent_form)
+      .find_each do |consent|
+        submitted_at = consent.consent_form&.recorded_at || consent.created_at
+        consent.update_column(:submitted_at, submitted_at)
+      end
+
+    change_column_null :consents, :submitted_at, false
+  end
+
+  def down
+    remove_column :consents, :submitted_at
+  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[8.0].define(version: 2025_04_29_140846) do
+ActiveRecord::Schema[8.0].define(version: 2025_05_15_173205) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "pg_catalog.plpgsql"
   enable_extension "pg_trgm"
@@ -237,6 +237,7 @@
     t.datetime "withdrawn_at"
     t.datetime "invalidated_at"
     t.boolean "notify_parents"
+    t.datetime "submitted_at", null: false
     t.index ["organisation_id"], name: "index_consents_on_organisation_id"
     t.index ["parent_id"], name: "index_consents_on_parent_id"
     t.index ["patient_id"], name: "index_consents_on_patient_id"

spec/factories/consents.rb

@@ -12,6 +12,7 @@
 #  reason_for_refusal  :integer
 #  response            :integer          not null
 #  route               :integer          not null
+#  submitted_at        :datetime         not null
 #  withdrawn_at        :datetime
 #  created_at          :datetime         not null
 #  updated_at          :datetime         not null

spec/models/consent_spec.rb

@@ -12,6 +12,7 @@
 #  reason_for_refusal  :integer
 #  response            :integer          not null
 #  route               :integer          not null
+#  submitted_at        :datetime         not null
 #  withdrawn_at        :datetime
 #  created_at          :datetime         not null
 #  updated_at          :datetime         not null