Workflows

Workflows live in apps/analytics/prefect/.prefect/workflows/ and are organized by category. Each flow file maps 1:1 to a Prefect deployment defined in prefect.yaml.

HMIS Ingestion

Each HMIS dataset ships as a pair of deployments — monthly (scheduled) and historical (manual backfill). All pull from aggregate.moh.gov.rw/ or the HMIS Tracker API.

Dataset	Path	Schedule
Malaria	`ingestions/hmis/malaria`	Monthly
TB	`ingestions/hmis/tb`	Monthly
Obstetric Delivery	`ingestions/hmis/obstetric`	Monthly
Postnatal Care	`ingestions/hmis/postnatal`	Monthly
Hospitalisation	`ingestions/hmis/hospitalisation`	Monthly
Maternal & Newborn Health	`ingestions/hmis/maternal`	Monthly
Family Planning (SISCOM HC-05)	`ingestions/hmis/family_planning`	Monthly
Ambulance	`ingestions/hmis/ambulance`	Monthly
Staffing	`ingestions/hmis/staffing`	Monthly
CRVS	`ingestions/hmis/crvs`	Monthly
Birth Registration	`ingestions/hmis/birth_registration`	Monthly
Organisation Hierarchy	`ingestions/hmis/org_hierarchy`	On demand

Group	Notes
Malaria
HIV (G01, G01a)	Two sub-groups
MCCH	Maternal, Child, and Community Health
Mental Health
NCDs / NTDs	Non-communicable / neglected tropical diseases
Immunization & Oxygen
Hepatitis
Obstetric Complications	Three dataset groups
Neurological Diseases

eFICHE & Other Sources

eFICHE

Path: ingestions/e_fiche/ — covers visits, lab tests, inventory, and facility mapping.

IDSR

Path: ingestions/IDSR/ — weekly epidemic diseases, weekly non-epidemic, and tracker (tracked entity, enrollment, and events).

HIV Tracker

Path: ingestions/hiv_tracker/ — unified enrollment and events ingestion. Runs weekly on Mondays.

Immunization

Path: ingestions/Immunization/ — events every 2 days, enrollment weekly on Mondays.

Cancer Registry

Path: ingestions/cancer_registry/ — full TEI ingestion.

Unified Tracker

The unified tracker ingestion framework at workflows/ingestions/unified/unified_tracker_ingestion.py is a parameterized pipeline that replaces legacy per-source pipelines. Currently covers HIV and IDSR trackers.

Parameter	Purpose
`tracker_name`	Human-readable label
`program_key`	DHIS2 program UID
`dataset_key`	Target table prefix
`run_type`	`monthly` / `weekly` / `historical`

Tables created by the unified framework are prefixed u_ during the transition period. Once validated, unified flows will replace the legacy per-source pipelines.

Reporting

Deployment	Schedule	Description
`weekly_idsr_bulletin_generation`	Mon 9:00 AM Africa/Kigali	IDSR epidemiological bulletin with charts and maps
`weekly_newsletter_generation`	Mon 8:00 AM Africa/Kigali	Rwanda Health Intelligence Newsletter (CRVS, IDSR, Maternal)
`html_dashboards/`	On demand	HTML report generation