Add VaccinationRecordsExport model

Jira-Issue: MAV-1521

Author: MartinVanIJcken

app/models/export.rb

@@ -30,7 +30,11 @@
 #
 class Export < ApplicationRecord
   delegated_type :exportable,
-                 types: %w[LocationPatientsExport SessionPatientsExport],
+                 types: %w[
+                   LocationPatientsExport
+                   SessionPatientsExport
+                   VaccinationRecordsExport
+                 ],
                  dependent: :destroy
 
   belongs_to :team

app/models/vaccination_records_export.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: vaccination_records_exports
+#
+#  id             :bigint           not null, primary key
+#  academic_year  :integer          not null
+#  date_from      :date
+#  date_to        :date
+#  file_format    :string           not null
+#  programme_type :string           not null
+#  created_at     :datetime         not null
+#  updated_at     :datetime         not null
+#
+class VaccinationRecordsExport < ApplicationRecord
+  include BelongsToProgramme
+
+  has_one :export, as: :exportable, touch: true
+  delegate :team, to: :export, allow_nil: true
+
+  def file_type = :csv
+
+  def type_label = "Vaccination records"
+
+  def name
+    base = "#{programme.name} vaccination records"
+    return base unless date_from || date_to
+
+    "#{base} (#{date_from_str} to #{date_to_str})"
+  end
+
+  def filename
+    "#{programme.name} - #{file_format} - #{date_from_str} - #{date_to_str}.csv"
+  end
+
+  def generate_file
+    exporter_class = {
+      "careplus" => Reports::ManualCareplusExporter,
+      "mavis" => Reports::ProgrammeVaccinationsExporter,
+      "systm_one" => Reports::SystmOneExporter
+    }.fetch(file_format)
+
+    exporter_class.call(
+      team:,
+      programme:,
+      academic_year:,
+      start_date: date_from,
+      end_date: date_to
+    )
+  end
+
+  private
+
+  def date_from_str = date_from&.to_fs(:long) || "earliest"
+
+  def date_to_str = date_to&.to_fs(:long) || "latest"
+end

db/migrate/20260330100000_create_vaccination_records_exports.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateVaccinationRecordsExports < ActiveRecord::Migration[8.1]
+  def change
+    create_table :vaccination_records_exports do |t|
+      t.integer :academic_year, null: false
+      t.date :date_from
+      t.date :date_to
+      t.string :file_format, null: false
+      t.string :programme_type, null: false
+
+      t.timestamps
+    end
+  end
+end

db/schema.rb

@@ -1091,6 +1091,16 @@
     t.index ["vaccine_id"], name: "index_vaccination_records_on_vaccine_id"
   end
 
+  create_table "vaccination_records_exports", force: :cascade do |t|
+    t.integer "academic_year", null: false
+    t.datetime "created_at", null: false
+    t.date "date_from"
+    t.date "date_to"
+    t.string "file_format", null: false
+    t.string "programme_type", null: false
+    t.datetime "updated_at", null: false
+  end
+
   create_table "vaccines", force: :cascade do |t|
     t.text "brand", null: false
     t.boolean "contains_gelatine", null: false

spec/factories/vaccination_records_exports.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: vaccination_records_exports
+#
+#  id             :bigint           not null, primary key
+#  academic_year  :integer          not null
+#  date_from      :date
+#  date_to        :date
+#  file_format    :string           not null
+#  programme_type :string           not null
+#  created_at     :datetime         not null
+#  updated_at     :datetime         not null
+#
+FactoryBot.define do
+  factory :vaccination_records_export do
+    programme_type { Programme::TYPES.sample }
+    academic_year { AcademicYear.current }
+    file_format { "mavis" }
+  end
+end

spec/models/vaccination_records_export_spec.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: vaccination_records_exports
+#
+#  id             :bigint           not null, primary key
+#  academic_year  :integer          not null
+#  date_from      :date
+#  date_to        :date
+#  file_format    :string           not null
+#  programme_type :string           not null
+#  created_at     :datetime         not null
+#  updated_at     :datetime         not null
+#
+describe VaccinationRecordsExport do
+  subject(:export) do
+    create(
+      :vaccination_records_export,
+      programme_type: "flu",
+      academic_year: 2024,
+      file_format: "mavis"
+    )
+  end
+
+  it { should be_valid }
+
+  describe "#name" do
+    subject(:name) { export.name }
+
+    it { should eq("#{Programme.flu.name} vaccination records") }
+
+    context "when date_from and date_to are set" do
+      let(:export) do
+        create(
+          :vaccination_records_export,
+          programme_type: "flu",
+          academic_year: 2024,
+          file_format: "mavis",
+          date_from: Date.new(2024, 9, 1),
+          date_to: Date.new(2025, 7, 31)
+        )
+      end
+
+      it { should include("vaccination records") }
+      it { should include("September 2024") }
+    end
+  end
+
+  describe "#filename" do
+    subject { export.filename }
+
+    it { should include(Programme.flu.name) }
+    it { should end_with(".csv") }
+  end
+end