feat: add School Roll Number field for Ireland schools Add optional school_roll_number field with alphanumeric validation, following the same pattern as UK URN and US district fields. Includes database migration, API endpoints, admin dashboard integration, and comprehensive test coverage.

Author: Mohamed-RPF

app/controllers/api/schools_controller.rb

@@ -56,6 +56,7 @@ def school_params
         :reference,
         :district_name,
         :district_nces_id,
+        :school_roll_number,
         :address_line_1,
         :address_line_2,
         :municipality,

app/dashboards/school_dashboard.rb

@@ -28,6 +28,7 @@ class SchoolDashboard < Administrate::BaseDashboard
     reference: Field::String,
     district_name: Field::String,
     district_nces_id: Field::String,
+    school_roll_number: Field::String,
     verified_at: Field::DateTime,
     rejected_at: Field::DateTime,
     created_at: Field::DateTime,
@@ -62,6 +63,7 @@ class SchoolDashboard < Administrate::BaseDashboard
     reference
     district_name
     district_nces_id
+    school_roll_number
     website
     address_line_1
     address_line_2
@@ -86,6 +88,7 @@ class SchoolDashboard < Administrate::BaseDashboard
     reference
     district_name
     district_nces_id
+    school_roll_number
     website
     address_line_1
     address_line_2

app/models/school.rb

@@ -18,6 +18,10 @@ class School < ApplicationRecord
   validates :country_code, presence: true, inclusion: { in: ISO3166::Country.codes }
   validates :reference, uniqueness: { case_sensitive: false, allow_nil: true }, presence: false
   validates :district_nces_id, uniqueness: { case_sensitive: false, allow_nil: true }, presence: false
+  validates :school_roll_number,
+            uniqueness: { case_sensitive: false, allow_nil: true },
+            presence: false,
+            format: { with: /\A[0-9]+[A-Z]+\z/, allow_nil: true, message: 'must be alphanumeric (e.g., 01572D)' }
   validates :creator_id, presence: true, uniqueness: true
   validates :creator_agree_authority, presence: true, acceptance: true
   validates :creator_agree_terms_and_conditions, presence: true, acceptance: true
@@ -34,6 +38,7 @@ class School < ApplicationRecord
 
   before_validation :normalize_reference
   before_validation :normalize_district_fields
+  before_validation :normalize_school_roll_number
 
   before_save :format_uk_postal_code, if: :should_format_uk_postal_code?
 
@@ -102,6 +107,11 @@ def normalize_district_fields
     self.district_nces_id = nil if district_nces_id.blank?
   end
 
+  # Ensure the school_roll_number is nil, not an empty string
+  def normalize_school_roll_number
+    self.school_roll_number = nil if school_roll_number.blank?
+  end
+
   def verified_at_cannot_be_changed
     errors.add(:verified_at, 'cannot be changed after verification') if verified_at_was.present? && verified_at_changed?
   end

app/views/api/schools/_school.json.jbuilder

@@ -8,6 +8,7 @@ json.call(
   :reference,
   :district_name,
   :district_nces_id,
+  :school_roll_number,
   :address_line_1,
   :address_line_2,
   :municipality,

db/migrate/20251128102719_add_school_roll_number_to_schools.rb

@@ -0,0 +1,7 @@
+class AddSchoolRollNumberToSchools < ActiveRecord::Migration[7.2]
+  def change
+    add_column :schools, :school_roll_number, :string
+
+    add_index :schools, :school_roll_number, unique: true
+  end
+end

db/schema.rb

@@ -7,6 +7,7 @@
     address_line_1 { 'Address Line 1' }
     municipality { 'Greater London' }
     country_code { 'GB' }
+    school_roll_number { nil }
     creator_id { SecureRandom.uuid }
     creator_agree_authority { true }
     creator_agree_terms_and_conditions { true }

spec/factories/school.rb

@@ -147,6 +147,55 @@
       expect(duplicate_school).not_to be_valid
     end
 
+    it 'does not require a school_roll_number' do
+      create(:school, id: SecureRandom.uuid, school_roll_number: nil)
+
+      school.school_roll_number = nil
+      expect(school).to be_valid
+    end
+
+    it 'requires school_roll_number to be unique if provided' do
+      school.school_roll_number = '01572D'
+      school.save!
+
+      duplicate_school = build(:school, school_roll_number: '01572d')
+      expect(duplicate_school).not_to be_valid
+    end
+
+    it 'accepts a valid alphanumeric school_roll_number' do
+      school.school_roll_number = '01572D'
+      expect(school).to be_valid
+    end
+
+    it 'accepts a school_roll_number with multiple letters' do
+      school.school_roll_number = '12345ABC'
+      expect(school).to be_valid
+    end
+
+    it 'rejects a school_roll_number with only numbers' do
+      school.school_roll_number = '01572'
+      expect(school).not_to be_valid
+      expect(school.errors[:school_roll_number]).to include('must be alphanumeric (e.g., 01572D)')
+    end
+
+    it 'rejects a school_roll_number with only letters' do
+      school.school_roll_number = 'ABCDE'
+      expect(school).not_to be_valid
+      expect(school.errors[:school_roll_number]).to include('must be alphanumeric (e.g., 01572D)')
+    end
+
+    it 'rejects a school_roll_number with special characters' do
+      school.school_roll_number = '01572-D'
+      expect(school).not_to be_valid
+      expect(school.errors[:school_roll_number]).to include('must be alphanumeric (e.g., 01572D)')
+    end
+
+    it 'normalizes blank school_roll_number to nil' do
+      school.school_roll_number = '  '
+      school.save
+      expect(school.school_roll_number).to be_nil
+    end
+
     it 'requires an address_line_1' do
       school.address_line_1 = ' '
       expect(school).not_to be_valid