Add gender column to CarePlus export

As requested by local CHIS providers.

Jira-Issue: MAV-3439

Author: mikejamesthompson

app/lib/reports/careplus_exporter.rb

@@ -26,6 +26,13 @@ def self.call(...) = new(...).call
 
   private
 
+  GENDER_CODE_MAPPINGS = {
+    female: "F",
+    male: "M",
+    not_known: "U",
+    not_specified: "I"
+  }.with_indifferent_access.freeze
+
   attr_reader :team, :programme, :academic_year, :start_date, :end_date
 
   def headers
@@ -50,7 +57,8 @@ def headers
       *vaccine_columns(2),
       *vaccine_columns(3),
       *vaccine_columns(4),
-      *vaccine_columns(5)
+      *vaccine_columns(5),
+      "Gender"
     ]
   end
 
@@ -150,14 +158,15 @@ def rows(patient:, vaccination_records:)
               *vaccine_fields(records, 1),
               *vaccine_fields(records, 2),
               *vaccine_fields(records, 3),
-              *vaccine_fields(records, 4)
+              *vaccine_fields(records, 4),
+              GENDER_CODE_MAPPINGS[patient.gender_code]
             ]
           end
       end
   end
 
   def blank_vaccine_fields
-    ["", "", "", "", "", ""]
+    ["", "", "", "", "", "", ""]
   end
 
   def vaccine_fields(vaccination_records, index)

spec/lib/reports/careplus_exporter_spec.rb

@@ -55,7 +55,8 @@
         "Staff Code",
         "Attended",
         "Reason Not Attended",
-        "Suspension End Date"
+        "Suspension End Date",
+        "Gender"
       )
 
       (1..5).each do |i|
@@ -388,4 +389,45 @@
 
     include_examples "generates a report"
   end
+
+  context "gender mapping" do
+    let(:programme) { Programme.hpv }
+    let(:programmes) { [programme] }
+    let(:team) { create(:team, programmes:) }
+    let(:location) { create(:school) }
+    let(:session) { create(:session, team:, programmes:, location:) }
+    let(:parsed_csv) { CSV.parse(csv) }
+    let(:headers) { parsed_csv.first }
+    let(:data_rows) { parsed_csv[1..] }
+
+    {
+      female: "F",
+      male: "M",
+      not_known: "U",
+      not_specified: "I"
+    }.each do |gender, expected_code|
+      context "when the patient gender is #{gender}" do
+        it "maps gender to #{expected_code}" do
+          patient =
+            create(
+              :patient,
+              :consent_given_triage_not_needed,
+              programmes:,
+              session:,
+              gender_code: gender
+            )
+          create(
+            :vaccination_record,
+            programme:,
+            patient:,
+            session:,
+            performed_at: 2.weeks.ago
+          )
+
+          gender_index = headers.index("Gender")
+          expect(data_rows.first[gender_index]).to eq(expected_code)
+        end
+      end
+    end
+  end
 end