Add LocationExport model

Jira-Issue: MAV-1521

Author: MartinVanIJcken

app/models/export.rb

@@ -29,7 +29,7 @@
 #  fk_rails_...  (user_id => users.id)
 #
 class Export < ApplicationRecord
-  delegated_type :exportable, types: [], dependent: :destroy
+  delegated_type :exportable, types: %w[LocationPatientsExport], dependent: :destroy
 
   belongs_to :team
   belongs_to :user

app/models/location_patients_export.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: location_patients_exports
+#
+#  id            :bigint           not null, primary key
+#  academic_year :integer          not null
+#  filter_params :jsonb            not null
+#  created_at    :datetime         not null
+#  updated_at    :datetime         not null
+#  location_id   :bigint           not null
+#
+# Foreign Keys
+#
+#  fk_rails_...  (location_id => locations.id)
+#
+class LocationPatientsExport < ApplicationRecord
+  belongs_to :location
+  has_one :export, as: :exportable, touch: true
+  delegate :team, to: :export, allow_nil: true
+
+  def file_type = :xlsx
+
+  def type_label = "Offline session"
+
+  def name
+    "#{location.name} offline session"
+  end
+
+  def filename
+    "#{name} - exported on #{Date.current.to_fs(:long)}.xlsx"
+  end
+
+  def generate_file
+    filter =
+      PatientFilter.new(team:, academic_year:, **filter_params.symbolize_keys)
+    patients, programmes =
+      location.school? ? school_patients(filter) : clinic_patients(filter)
+    Reports::OfflineExporter.from_patients(
+      patients,
+      team:,
+      programmes:,
+      academic_year:
+    )
+  end
+
+  private
+
+  def school_patients(filter)
+    scope =
+      Patient
+        .joins(:patient_locations)
+        .where(patient_locations: { location:, academic_year: })
+        .where(school: location)
+        .includes_statuses
+    [filter.apply(scope), location.programmes]
+  end
+
+  def clinic_patients(filter)
+    [filter.apply(Patient.includes_statuses), team.programmes]
+  end
+end

db/migrate/20260329120000_create_location_patients_exports.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateLocationPatientsExports < ActiveRecord::Migration[8.1]
+  def change
+    create_table :location_patients_exports do |t|
+      t.integer :academic_year, null: false
+      t.jsonb :filter_params, null: false, default: {}
+      t.references :location, null: false, foreign_key: true, index: false
+
+      t.timestamps
+    end
+  end
+end

db/schema.rb

@@ -525,6 +525,14 @@
     t.index ["value"], name: "index_local_authority_postcodes_on_value", unique: true
   end
 
+  create_table "location_patients_exports", force: :cascade do |t|
+    t.integer "academic_year", null: false
+    t.datetime "created_at", null: false
+    t.jsonb "filter_params", default: {}, null: false
+    t.bigint "location_id", null: false
+    t.datetime "updated_at", null: false
+  end
+
   create_table "location_programme_year_groups", force: :cascade do |t|
     t.bigint "location_year_group_id", null: false
     t.enum "programme_type", null: false, enum_type: "programme_type"
@@ -1167,6 +1175,7 @@
   add_foreign_key "important_notices", "teams"
   add_foreign_key "important_notices", "users", column: "dismissed_by_user_id"
   add_foreign_key "important_notices", "vaccination_records"
+  add_foreign_key "location_patients_exports", "locations"
   add_foreign_key "location_programme_year_groups", "location_year_groups", on_delete: :cascade
   add_foreign_key "location_year_groups", "locations", on_delete: :cascade
   add_foreign_key "notes", "patients"

spec/factories/location_patients_exports.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: location_patients_exports
+#
+#  id            :bigint           not null, primary key
+#  academic_year :integer          not null
+#  filter_params :jsonb            not null
+#  created_at    :datetime         not null
+#  updated_at    :datetime         not null
+#  location_id   :bigint           not null
+#
+# Foreign Keys
+#
+#  fk_rails_...  (location_id => locations.id)
+#
+FactoryBot.define do
+  factory :location_patients_export do
+    academic_year { AcademicYear.current }
+    filter_params { {} }
+    association :location, factory: :generic_clinic
+  end
+end

spec/models/location_patients_export_spec.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# == Schema Information
+#
+# Table name: location_patients_exports
+#
+#  id            :bigint           not null, primary key
+#  academic_year :integer          not null
+#  filter_params :jsonb            not null
+#  created_at    :datetime         not null
+#  updated_at    :datetime         not null
+#  location_id   :bigint           not null
+#
+# Foreign Keys
+#
+#  fk_rails_...  (location_id => locations.id)
+#
+describe LocationPatientsExport do
+  subject(:export) { create(:location_patients_export) }
+
+  describe "associations" do
+    it { should belong_to(:location) }
+  end
+
+  describe "#name" do
+    subject(:name) { export.name }
+
+    context "when location is a clinic" do
+      it { should eq("Community clinic offline session") }
+    end
+
+    context "when location is a school" do
+      let(:export) do
+        create(:location_patients_export, location: create(:gias_school))
+      end
+
+      it { should eq("#{export.location.name} offline session") }
+    end
+  end
+
+  describe "#filename" do
+    subject(:filename) { export.filename }
+
+    it "returns a filename with name and export date" do
+      date_str = export.created_at.to_date.to_fs(:long)
+
+      expect(filename).to match(/#{date_str}/)
+    end
+  end
+end