Add ReportTemplate model

Store future template in binary format in databse along with optional
configuration for the code using that template.

.rubocop.yml

@@ -106,3 +106,7 @@ RSpec/DescribeClass:
 RSpec/AnyInstance:
   Exclude:
     - 'spec/requests/submission_spec.rb'
+
+Rails/UniqueValidationWithoutIndex:
+  Exclude:
+    - 'app/models/report_template.rb'

app/models/report_template.rb

@@ -0,0 +1,22 @@
+# == Schema Information
+#
+# Table name: report_templates
+#
+#  id           :bigint           not null, primary key
+#  config       :jsonb
+#  file         :binary
+#  filename     :string
+#  report_class :string
+#  created_at   :datetime         not null
+#  updated_at   :datetime         not null
+#
+class ReportTemplate < ApplicationRecord
+  validates(:file, presence: true)
+  validates(:filename, presence: true)
+  validates(:report_class, presence: true, uniqueness: true)
+  validates(:config, presence: true)
+
+  validate do |record|
+    HomeOfficeReportConfigValidator.new(record).validate
+  end
+end

config/locales/en.yml

@@ -48,3 +48,15 @@ en:
       success: 'User was successfully removed.'
   omniauth_callbacks:
     no_account: 'You have not yet an account!'
+
+  activerecord:
+    errors:
+      models:
+        report_template:
+          attributes:
+            file:
+              invalid: "File parsing error"
+            config:
+              missing_header_mappings: "config.header_mappings must be present"
+              missing_worksheet_name: "config.worksheet_name must be present"
+              invalid_worksheet_name: "config.worksheet_name not present in file"

db/migrate/20231004134346_create_report_templates.rb

@@ -0,0 +1,14 @@
+class CreateReportTemplates < ActiveRecord::Migration[7.0]
+  def change
+    create_table :report_templates do |t|
+      t.string :report_class
+      t.string :filename
+      t.binary :file
+      t.jsonb :config
+
+      t.timestamps
+    end
+
+    add_index :report_templates, :report_class
+  end
+end

spec/factories/report_templates.rb

@@ -0,0 +1,39 @@
+# == Schema Information
+#
+# Table name: report_templates
+#
+#  id           :bigint           not null, primary key
+#  config       :jsonb
+#  file         :binary
+#  filename     :string
+#  report_class :string
+#  created_at   :datetime         not null
+#  updated_at   :datetime         not null
+#
+FactoryBot.define do
+  factory :report_template do
+    file { StringIO.new("") }
+    filename { "file.xlsx" }
+    report_class { "SomeClass" }
+    config do
+      {
+        "some" => true,
+      }
+    end
+
+    factory :home_office_report_template do
+      file { Rails.root.join("spec/fixtures/test_homeoffice_template.xlsx").read }
+      filename { "test_homeoffice_template.xlsx" }
+      report_class { "Reports::HomeOffice" }
+      config do
+        {
+          "worksheet_name" => "Data",
+          "header_mappings" => {
+            "Column A" => %w[urn],
+            "bar" => %w[applicants.given_name applicants.family_name],
+          },
+        }
+      end
+    end
+  end
+end

spec/models/report_template_spec.rb

@@ -0,0 +1,42 @@
+# == Schema Information
+#
+# Table name: report_templates
+#
+#  id           :bigint           not null, primary key
+#  config       :jsonb
+#  file         :binary
+#  filename     :string
+#  report_class :string
+#  created_at   :datetime         not null
+#  updated_at   :datetime         not null
+#
+require "rails_helper"
+
+RSpec.describe ReportTemplate do
+  describe "validations" do
+    context "common report template validation" do
+      subject(:report_template) { build(:report_template) }
+
+      it { expect(report_template).to validate_presence_of(:file) }
+      it { expect(report_template).to validate_presence_of(:filename) }
+      it { expect(report_template).to validate_presence_of(:report_class) }
+      it { expect(report_template).to validate_uniqueness_of(:report_class) }
+      it { expect(report_template).to validate_presence_of(:config) }
+    end
+
+    context "homeoffice report validation" do
+      subject(:report_template) { build(:home_office_report_template) }
+
+      let(:validator) { HomeOfficeReportConfigValidator.new(report_template) }
+
+      before do
+        allow(HomeOfficeReportConfigValidator).to receive(:new).and_return(validator)
+        report_template.valid?
+      end
+
+      it { expect(report_template).to be_valid }
+
+      it { expect(HomeOfficeReportConfigValidator).to have_received(:new).with(report_template) }
+    end
+  end
+end