@ampath/esm-reports-app 1.0.0-next.7 → 1.0.0-next.71

package/src/reports/moh-731/linelist/moh-731-linelist-sections.ts

@@ -0,0 +1,472 @@
+import { type LinelistColumn } from '../../../common/linelist-table';
+import { getMoh366PatientList } from '../../../resources/moh-731.resource';
+import { type PatientListPage, type PatientListParams } from '../../../resources/patient-list-page';
+
+/** How one family of MOH 731 figures is listed: where the rows come from and how they are shown */
+export interface Moh731LinelistSection {
+  /** Shown above the table, e.g. `HIV Testing Services` */
+  title: string;
+  fetchPatientList: (params: PatientListParams) => Promise<PatientListPage>;
+  columns: LinelistColumn[];
+}
+
+const formatDate = (value: unknown) => (value ? new Date(String(value)).toLocaleDateString('en-GB') : '');
+
+/* Columns every section starts from. Each section lists its own columns below,
+   so a column added to one section does not appear in the others. The table
+   numbers the rows itself. */
+const cccNumber: LinelistColumn = { header: 'CCC Number', field: 'ccc_number', text: true };
+const name: LinelistColumn = { header: 'Name', field: 'person_name' };
+const nupi: LinelistColumn = { header: 'NUPI', field: 'upi_number', text: true };
+const sex: LinelistColumn = { header: 'Sex', field: 'gender' };
+const age: LinelistColumn = { header: 'Age', field: 'age' };
+const phoneNumber: LinelistColumn = { header: 'Phone Number', field: 'phone_number', text: true };
+
+/**
+ * The linelist definition behind each part of the MOH 731 sheet.
+ *
+ * To add a column to a linelist, add it to that section's `columns`. To point a
+ * section at its own query, give it its own `fetchPatientList`. Which figures
+ * open which section is set in `moh-731-indicators.ts`.
+ */
+export const MOH_731_LINELIST_SECTIONS = {
+  /* 1.1 HIV Tests, 1.2 HIV Positive Results, 2.1 Maternal HIV Testing, 2.2 HIV
+     Positive Results and 2.3 Start HAART at ANC, L&D and PNC, 2.4 HBV Screening and
+     2.5 AGYW (HV01-01 to HV01-18, HV01-47/48, HV02-02 to HV02-28 except the
+     known-positive figures).
+     Both are counted from one dataset of tested clients in the ETL
+     (service/moh-731/ver-2023/hiv-tests), so these are its columns, and every
+     figure lists exactly the tests it counted. */
+  hivTests: {
+    title: 'HIV Testing Services',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'Test Date', value: (row) => formatDate(row.test_date), sortValue: (row) => row.test_date },
+      /* Shown by default on the PNC figures (showColumns in moh-731-indicators.ts) */
+      {
+        header: 'Delivery Date',
+        value: (row) => formatDate(row.delivery_date),
+        sortValue: (row) => row.delivery_date,
+        hidden: true,
+      },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age_at_test' },
+      { header: 'Service', field: 'service' },
+      { header: 'Test Type', field: 'test_type' },
+      { header: 'Setting', field: 'hts_setting' },
+      { header: 'Population Type', field: 'population_type' },
+      { header: 'Final Result', field: 'final_result' },
+      /* HBV screening in the period; available from the Columns menu */
+      { header: 'Screened HBV', field: 'screened_hbv', hidden: true },
+      { header: 'HBV Result', field: 'hbv_result', hidden: true },
+      {
+        header: 'HBV Test Date',
+        value: (row) => formatDate(row.hbv_test_date),
+        sortValue: (row) => row.hbv_test_date,
+        hidden: true,
+      },
+      { header: 'HBV Recorded On', field: 'hbv_encounter_types', hidden: true },
+      { header: 'Initiated in Care', field: 'initiated_in_care' },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.arv_first_regimen_start_date),
+        sortValue: (row) => row.arv_first_regimen_start_date,
+      },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      { header: 'Typology', field: 'typology', hidden: true },
+      { header: 'Infant Prophylaxis Dispensed', field: 'infant_prophylaxis_dispensed', hidden: true },
+      { header: 'Infant Prophylaxis Regimen', field: 'infant_prophylaxis_regimen', hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  /* 1.3 No. Initiated on PrEP, 1.4 No. on PrEP Diagnosed with STI and 1.5 No.
+     Seroconverted while on PrEP (HV01-19 to HV01-46). Fields are the columns of
+     the PrEP visits dataset in the ETL (service/moh-731/ver-2023/prep), which
+     both counts these figures and lists the visits behind them. */
+  prepVisits: {
+    title: 'Pre-Exposure Prophylaxis',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'Visit Date', value: (row) => formatDate(row.visit_date), sortValue: (row) => row.visit_date },
+      { header: 'Visit', field: 'visit' },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age' },
+      { header: 'Population', field: 'population_category' },
+      {
+        header: 'PrEP Start Date',
+        value: (row) => formatDate(row.prep_start_date),
+        sortValue: (row) => row.prep_start_date,
+      },
+      { header: 'Transfer In', field: 'transfer_in' },
+      { header: 'PrEP Status', field: 'prep_status' },
+      { header: 'PrEP Type', field: 'prep_type' },
+      { header: 'Regimen', field: 'regimen', wrap: true },
+      { header: 'HIV Test', field: 'hiv_test' },
+      { header: 'STI', field: 'has_sti' },
+      { header: 'STI Signs', field: 'sti_signs', wrap: true },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      { header: 'Population Recorded', field: 'population_recorded', hidden: true },
+      { header: 'Pregnant / Breastfeeding', value: (row) => (Number(row.is_pbfw) === 1 ? 'Yes' : 'No'), hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  /* 2.1 Known Positive at 1st ANC (HV02-01) and 2.3 On HAART at 1st ANC (HV02-14).
+     Fields are the columns of the
+     known-positive ANC dataset in the ETL (service/moh-731/ver-2023/known-positive-anc),
+     which counts the figure and lists the visits behind it. */
+  ancKnownPositives: {
+    title: 'Elimination of Mother-to-Child Transmission (EMTCT)',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'ANC Date', value: (row) => formatDate(row.anc_date), sortValue: (row) => row.anc_date },
+      { header: 'Visit', field: 'visit' },
+      { header: 'ANC Visit No.', field: 'anc_visit_number' },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Age', field: 'age_at_anc' },
+      { header: 'HIV Status', field: 'hiv_status' },
+      { header: 'Initiated in Care', field: 'initiated_in_care' },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.arv_first_regimen_start_date),
+        sortValue: (row) => row.arv_first_regimen_start_date,
+      },
+      { header: 'Infant Prophylaxis Dispensed', field: 'infant_prophylaxis_dispensed' },
+      { header: 'Infant Prophylaxis Regimen', field: 'infant_prophylaxis_regimen' },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      { header: 'Known Positive Source', field: 'known_positive_source', hidden: true },
+      { header: 'Screened HBV', field: 'screened_hbv', hidden: true },
+      { header: 'HBV Result', field: 'hbv_result', hidden: true },
+      {
+        header: 'HBV Test Date',
+        value: (row) => formatDate(row.hbv_test_date),
+        sortValue: (row) => row.hbv_test_date,
+        hidden: true,
+      },
+      { header: 'HBV Recorded On', field: 'hbv_encounter_types', hidden: true },
+      { header: 'Sex', field: 'gender', hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  /* 2.6 Infant Prophylaxis (HV02-29 to HV02-31). Fields are the columns of the
+     HIV-positive mothers dataset in the ETL (service/moh-731/ver-2023/infant-prophylaxis):
+     women newly positive at an ANC, L&D or PNC test and women known positive at ANC. */
+  /* 2.4 HBV Screening at ANC (HV02-19, HV02-20). Fields are the columns of the
+     ANC HBV dataset in the ETL (service/moh-731/ver-2023/hbv-screening): ANC visits
+     that are an ANC test or a known-positive visit, with the client's HBV screening. */
+  ancHbv: {
+    title: 'Elimination of Mother-to-Child Transmission (EMTCT)',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'ANC Date', value: (row) => formatDate(row.anc_date), sortValue: (row) => row.anc_date },
+      { header: 'Visit', field: 'visit' },
+      { header: 'ANC Visit No.', field: 'anc_visit_number' },
+      { header: 'Group', field: 'anc_group' },
+      { header: 'HIV Result', field: 'hiv_result' },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Age', field: 'age_at_anc' },
+      { header: 'Screened HBV', field: 'screened_hbv' },
+      { header: 'HBV Result', field: 'hbv_result' },
+      {
+        header: 'HBV Test Date',
+        value: (row) => formatDate(row.hbv_test_date),
+        sortValue: (row) => row.hbv_test_date,
+      },
+      { header: 'HBV Recorded On', field: 'hbv_encounter_types' },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  hivPositiveMothers: {
+    title: 'Elimination of Mother-to-Child Transmission (EMTCT)',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'Visit Date', value: (row) => formatDate(row.visit_date), sortValue: (row) => row.visit_date },
+      /* Shown by default on the PNC figure (showColumns in moh-731-indicators.ts) */
+      {
+        header: 'Delivery Date',
+        value: (row) => formatDate(row.delivery_date),
+        sortValue: (row) => row.delivery_date,
+        hidden: true,
+      },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Age', field: 'age' },
+      { header: 'Service', field: 'service' },
+      { header: 'HIV Status', field: 'hiv_status' },
+      { header: 'ANC Visit No.', field: 'anc_visit_number' },
+      { header: 'Infant Prophylaxis Given', field: 'infant_prophylaxis_dispensed' },
+      { header: 'Prophylaxis Regimen', field: 'infant_prophylaxis_regimen' },
+      { header: 'Initiated in Care', field: 'initiated_in_care' },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.arv_first_regimen_start_date),
+        sortValue: (row) => row.arv_first_regimen_start_date,
+      },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  /* 2.7 Infant Feeding (HV02-32 to HV02-34). Fields are the columns of the HEI
+     feeding dataset in the ETL (service/moh-731/ver-2023/infant-feeding): HEI
+     follow-ups seen before the end of the period whose return-to-clinic date is
+     on or after its start. */
+  infantFeeding: {
+    title: 'Elimination of Mother-to-Child Transmission (EMTCT)',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      {
+        header: 'Visit Date',
+        value: (row) => formatDate(row.encounter_datetime),
+        sortValue: (row) => row.encounter_datetime,
+      },
+      { header: 'RTC Date', value: (row) => formatDate(row.rtc_date), sortValue: (row) => row.rtc_date },
+      { header: 'Name', field: 'full_name' },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age (Months)', field: 'age_months' },
+      { header: 'Feeding Method', field: 'feeding_methods', wrap: true },
+      { header: 'Feeding Category', field: 'feeding_category' },
+      { header: 'MOH 731 Code', field: 'moh731_code' },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+      /* Available from the Columns menu */
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+      { header: 'Encounter ID', field: 'encounter_id', hidden: true },
+    ],
+  },
+  /* 3.1 Starting ART and 3.2 Currently on ART (HV03-01 to HV03-028). Fields are
+     the columns of the ART monthly dataset in the ETL (service/moh-731/ver-2023/art),
+     read from the HIV monthly report dataset for the month. */
+  artMonthly: {
+    title: 'HIV and TB Treatment',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'Name', field: 'full_name' },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age' },
+      { header: 'ART Status', field: 'art_status' },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.arv_first_regimen_start_date),
+        sortValue: (row) => row.arv_first_regimen_start_date,
+      },
+      { header: 'Current Regimen', field: 'cur_arv_meds', wrap: true },
+      { header: 'ARV Line', field: 'cur_arv_line' },
+      {
+        header: 'Last Visit',
+        value: (row) => formatDate(row.last_visit_date),
+        sortValue: (row) => row.last_visit_date,
+      },
+      { header: 'RTC Date', value: (row) => formatDate(row.rtc_date), sortValue: (row) => row.rtc_date },
+      { header: 'Location', field: 'location' },
+      /* Available from the Columns menu */
+      {
+        header: 'Enrollment Date',
+        value: (row) => formatDate(row.enrollment_date),
+        sortValue: (row) => row.enrollment_date,
+        hidden: true,
+      },
+      { header: 'Transfer In This Month', field: 'transfer_in', hidden: true },
+      { header: 'Pregnant', field: 'pregnant', hidden: true },
+      { header: 'Latest VL', field: 'vl_1', hidden: true },
+      {
+        header: 'Latest VL Date',
+        value: (row) => formatDate(row.vl_1_date),
+        sortValue: (row) => row.vl_1_date,
+        hidden: true,
+      },
+      {
+        header: 'Date of Birth',
+        value: (row) => formatDate(row.birthdate),
+        sortValue: (row) => row.birthdate,
+        hidden: true,
+      },
+    ],
+  },
+  /* 3.3 TB Screening, 3.4 Starting TPT and 3.5 Differentiated Service Delivery
+     (HV03-029 to HV03-036). Fields are the columns of the TB, TPT and DSD datasets in
+     the ETL (service/moh-731/ver-2023/tb-tpt-dsd); each figure lists one row per client. */
+  tbDsd: {
+    title: 'HIV and TB Treatment',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      { header: 'Name', field: 'full_name' },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age' },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.arv_first_regimen_start_date),
+        sortValue: (row) => row.arv_first_regimen_start_date,
+      },
+      {
+        header: 'TB Screening Date',
+        value: (row) => formatDate(row.tb_screening_date),
+        sortValue: (row) => row.tb_screening_date,
+      },
+      { header: 'TB Screening Result', field: 'tb_screening_result' },
+      {
+        header: 'TPT Start Date',
+        value: (row) => formatDate(row.ipt_start_date),
+        sortValue: (row) => row.ipt_start_date,
+      },
+      { header: 'DSD Status', field: 'dsd_status' },
+      { header: 'DSD Model', field: 'dsd_model' },
+      {
+        header: 'DSD Recorded',
+        value: (row) => formatDate(row.dsd_obs_date),
+        sortValue: (row) => row.dsd_obs_date,
+      },
+      {
+        header: 'Last Visit',
+        value: (row) => formatDate(row.last_visit_date),
+        sortValue: (row) => row.last_visit_date,
+      },
+      { header: 'Location', field: 'location' },
+    ],
+  },
+  art: {
+    title: 'HIV Treatment',
+    fetchPatientList: getMoh366PatientList,
+    columns: [cccNumber, name, nupi, sex, age, phoneNumber],
+  },
+  tb: {
+    title: 'TB Screening, TPT and HIV in TB Clinic',
+    fetchPatientList: getMoh366PatientList,
+    columns: [cccNumber, name, nupi, sex, age, phoneNumber],
+  },
+  /* 3.6 Nutrition and HIV (HV03-037 to HV03-060): one row per client, their
+     latest SAM / MAM status in the period, from the ETL's nutrition dataset
+     (service/moh-731/ver-2023/nutrition) */
+  nutrition: {
+    title: 'Nutrition and HIV',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      {
+        header: 'Visit Date',
+        value: (row) => formatDate(row.encounter_date),
+        sortValue: (row) => row.encounter_date,
+      },
+      { header: 'Name', field: 'full_name' },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age' },
+      { header: 'Age (Months)', field: 'age_months', hidden: true },
+      { header: 'SAM / MAM', field: 'sam_mam' },
+      { header: 'Food Given', field: 'food_given' },
+      { header: 'Pregnant / Lactating', field: 'pregnant_lactating' },
+      { header: 'Current ARV Regimen', field: 'current_arv_regimen' },
+      { header: 'ARV Line', field: 'cur_arv_line', hidden: true },
+      {
+        header: 'ART Start Date',
+        value: (row) => formatDate(row.art_start_date),
+        sortValue: (row) => row.art_start_date,
+      },
+      { header: 'RTC Date', value: (row) => formatDate(row.rtc_date), sortValue: (row) => row.rtc_date },
+      { header: 'HIV Clinic', field: 'hiv_clinic', hidden: true },
+      { header: 'Encounter Type', field: 'encounter_type', hidden: true },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by', hidden: true },
+    ],
+  },
+  /* 5. Post Exposure Prophylaxis (HV05-01 to HV05-04): one row per exposure, from
+     the ETL's PEP dataset (service/moh-731/ver-2023/pep) */
+  pep: {
+    title: 'Post Exposure Prophylaxis',
+    fetchPatientList: getMoh366PatientList,
+    columns: [
+      {
+        header: 'Exposure Date',
+        value: (row) => formatDate(row.exposure_date),
+        sortValue: (row) => row.exposure_date,
+      },
+      { header: 'Name', field: 'full_name' },
+      { header: 'CCC Number', field: 'ccc_number', text: true },
+      { header: 'NUPI', field: 'nupi', text: true },
+      { header: 'AMRS Number', field: 'amrs_number', text: true },
+      { header: 'Sex', field: 'gender' },
+      { header: 'Age', field: 'age' },
+      { header: 'Exposure Type', field: 'exposure_type' },
+      { header: 'PEP Given', field: 'pep_given_status' },
+      { header: 'Location', field: 'location' },
+      { header: 'Entered By', field: 'entered_by' },
+    ],
+  },
+} satisfies Record<string, Moh731LinelistSection>;
+
+export type Moh731SectionId = keyof typeof MOH_731_LINELIST_SECTIONS;

package/src/reports/moh-731/linelist/moh-731-linelist.component.tsx

@@ -0,0 +1,102 @@
+import React, { useMemo } from 'react';
+import { useSearchParams } from 'react-router-dom';
+
+import { LinelistTable, useAllRows } from '../../../common/linelist-table';
+import { RegisterLayout, useLocationName } from '../../../common/report-register';
+import { MOH_731_INDICATORS } from './moh-731-indicators';
+import { MOH_731_LINELIST_SECTIONS } from './moh-731-linelist-sections';
+
+const GENDERS: Record<string, string> = { M: 'Male', F: 'Female' };
+
+/**
+ * The linelist behind one figure on the MOH 731 sheet, or behind a total of
+ * several figures on the Summary tab.
+ *
+ * The link carries the figure's code (or, for a total, its figures' codes with
+ * a label) and the report period; each code is looked up in `MOH_731_INDICATORS`
+ * for what to list, and the section it belongs to decides where the rows come
+ * from and which columns they are shown in. A total lists its figures' rows one
+ * after another -- its figures never overlap, so each client appears once.
+ */
+const Moh731Linelist: React.FC = () => {
+  const [searchParams] = useSearchParams();
+
+  const code = searchParams.get('code') ?? '';
+  const totalCodes = (searchParams.get('codes') ?? '').split(',').filter(Boolean);
+  const totalLabel = searchParams.get('label') ?? '';
+  const totalBlock = searchParams.get('block') ?? '';
+  const startDate = searchParams.get('startDate');
+  const endDate = searchParams.get('endDate');
+  const locationUuids = searchParams.get('locationUuids');
+
+  const locationName = useLocationName(locationUuids);
+
+  const isTotal = totalCodes.length > 0;
+  const parts = (isTotal ? totalCodes : [code]).map((partCode) => MOH_731_INDICATORS[partCode]);
+  /* every figure of a total comes from the same section, so it is listed in one table */
+  const figure = parts.every((part) => part && part.section === parts[0].section) ? parts[0] : undefined;
+  const section = figure ? MOH_731_LINELIST_SECTIONS[figure.section] : undefined;
+
+  const { rows, isLoading } = useAllRows(
+    section
+      ? parts.map(
+          (part) =>
+            ({ startIndex, limit }) =>
+              section.fetchPatientList({
+                locationUuids,
+                startDate,
+                endDate,
+                indicator: part.indicator,
+                gender: part.gender ?? '',
+                startIndex,
+                limit,
+              }),
+        )
+      : () => Promise.resolve({ results: [], total: 0, isTotalExact: true }),
+    [code, totalCodes.join(','), startDate, endDate, locationUuids],
+  );
+
+  /* A figure can start some of its section's hidden columns visible. It keeps
+     its own saved layout, so a layout saved on the section's other figures
+     does not hide them again. */
+  const showColumns = figure?.showColumns;
+  const columns = useMemo(
+    () =>
+      (section?.columns ?? []).map((column) =>
+        showColumns?.includes(column.header) ? { ...column, hidden: false } : column,
+      ),
+    [section, showColumns],
+  );
+  const layoutKey = `moh-731:${figure?.section}${showColumns ? `:${showColumns.join(',')}` : ''}`;
+
+  const sex = figure?.gender ? ` (${GENDERS[figure.gender]})` : '';
+  const heading = !figure
+    ? `Unknown MOH 731 figure ${isTotal ? totalCodes.join(', ') : code}`
+    : isTotal
+      ? `${totalLabel} linelist`
+      : `${figure.label}${sex} ${code} linelist`;
+  const block = isTotal ? totalBlock : figure?.block;
+
+  return (
+    <RegisterLayout
+      parentLabel="MOH-731 Report"
+      parentPath="/moh-731"
+      title={figure ? `${section.title} · ${block}` : 'MOH 731 Linelist'}
+      heading={heading}
+      location={locationName}
+      isLoading={isLoading}
+      isEmpty={rows.length === 0}
+    >
+      {section && (
+        <LinelistTable
+          rows={rows}
+          columns={columns}
+          layoutKey={layoutKey}
+          exportName={`${heading} ${startDate ?? ''} ${endDate ?? ''}`}
+        />
+      )}
+    </RegisterLayout>
+  );
+};
+
+export default Moh731Linelist;

package/src/reports/moh-731/linelist/use-open-moh-731-linelist.ts

@@ -0,0 +1,50 @@
+import { useCallback } from 'react';
+import { useNavigate } from 'react-router-dom';
+
+/** A linelist made of several figures, e.g. a total on the Summary tab */
+export interface Moh731LinelistTotal {
+  /** The figures it is made of, by code; they must not overlap */
+  codes: string[];
+  /** Heading, e.g. `Total tests` */
+  label: string;
+  /** The sub-section it totals, e.g. `1.1 HIV Tests` */
+  block: string;
+}
+
+/**
+ * Opens the linelist behind a figure on the MOH 731 sheet, by the code printed
+ * beside it (e.g. `HV01-03`), or behind a total made of several figures. What a
+ * code lists is defined in `moh-731-indicators.ts`. `view` is the report tab it
+ * was opened from, and `section` the Summary section tab, so the breadcrumb
+ * returns to them.
+ */
+export function useOpenMoh731Linelist(
+  startDate: string,
+  endDate: string,
+  locationUuids: string,
+  view?: 'summary',
+  section?: string,
+) {
+  const navigate = useNavigate();
+
+  return useCallback(
+    (figure: string | Moh731LinelistTotal) => {
+      const params = new URLSearchParams({ startDate, endDate, locationUuids, from: 'moh-731' });
+      if (typeof figure === 'string') {
+        params.set('code', figure);
+      } else {
+        params.set('codes', figure.codes.join(','));
+        params.set('label', figure.label);
+        params.set('block', figure.block);
+      }
+      if (view) {
+        params.set('view', view);
+      }
+      if (section) {
+        params.set('section', section);
+      }
+      navigate(`/moh-731-linelist?${params}`);
+    },
+    [navigate, startDate, endDate, locationUuids, view, section],
+  );
+}