Add Unknown Local Authority fallback to reporting view

When a patient has no school LA and no postcode-derived LA, the view now
returns 'UNKNOWN' for the code and 'Unknown Local Authority' for the
display name instead of empty strings.

Author: mikejamesthompson

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[8.1].define(version: 2026_02_02_124516) do
+ActiveRecord::Schema[8.1].define(version: 2026_02_04_073325) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "pg_catalog.plpgsql"
   enable_extension "pg_trgm"
@@ -1356,8 +1356,8 @@
               ELSE NULL::text
           END AS patient_gender,
       ((pps.academic_year - pat.birth_academic_year) - 5) AS patient_year_group,
-      COALESCE(la.mhclg_code, pat.local_authority_mhclg_code, ''::character varying) AS patient_local_authority_code,
-      COALESCE(la.official_name, pat_la.official_name, ''::character varying) AS patient_local_authority_official_name,
+      COALESCE(la.mhclg_code, pat.local_authority_mhclg_code, 'UNKNOWN'::character varying) AS patient_local_authority_code,
+      COALESCE(la.official_name, pat_la.official_name, 'Unknown Local Authority'::character varying) AS patient_local_authority_official_name,
       COALESCE(la.mhclg_code, ''::character varying) AS patient_school_local_authority_code,
           CASE
               WHEN (school.urn IS NOT NULL) THEN school.urn

db/views/reporting_api_totals_v07.sql

@@ -26,9 +26,11 @@ SELECT
   pps.academic_year
     - pat.birth_academic_year - 5       AS patient_year_group,   -- Filter: ?year_group=8,9
   COALESCE(la.mhclg_code,
-    pat.local_authority_mhclg_code, '') AS patient_local_authority_code,
+    pat.local_authority_mhclg_code,
+    'UNKNOWN')                          AS patient_local_authority_code,
   COALESCE(la.official_name,
-    pat_la.official_name, '')           AS patient_local_authority_official_name,
+    pat_la.official_name,
+    'Unknown Local Authority')          AS patient_local_authority_official_name,
   COALESCE(la.mhclg_code, '')           AS patient_school_local_authority_code,
 
   -- School info (for CSV grouping by school)

spec/controllers/api/reporting/totals_controller_spec.rb

@@ -339,6 +339,50 @@
         "Test Authority 202"
       )
     end
+
+    it "returns Unknown Local Authority for patients without school or postcode LA" do
+      team = Team.last
+      programme = Programme.hpv
+      team.programmes << programme
+      session = create(:session, team:, programmes: [programme])
+
+      # Patient with school that has LA
+      school =
+        create(:school, name: "Known School", gias_local_authority_code: 201)
+      create(:patient, session:, school:)
+
+      # Home-educated patient without postcode LA lookup
+      create(
+        :patient,
+        session:,
+        school: nil,
+        home_educated: true,
+        local_authority_mhclg_code: nil
+      )
+
+      # Unknown school patient without postcode LA lookup
+      create(
+        :patient,
+        session:,
+        school: nil,
+        home_educated: false,
+        local_authority_mhclg_code: nil
+      )
+
+      refresh_reporting_views!
+
+      request.headers["Accept"] = "text/csv"
+      get :index, params: { group: "local_authority" }, format: :csv
+
+      expect(response).to have_http_status(:ok)
+
+      csv = CSV.parse(response.body, headers: true)
+      local_authorities = csv.map { it["Local Authority"] }
+      expect(local_authorities).to contain_exactly(
+        "Test Authority 201",
+        "Unknown Local Authority"
+      )
+    end
   end
 
   describe "Dashboard acceptance criteria" do