Flutter Application

Flutter Data Capture Application#

The Botswana AMR platform includes a Flutter/Dart application for capturing AMR culture and susceptibility data at the point of care.

Architecture#

The Flutter app captures structured data and stores it as FHIR resources on a FHIR R4 server:

┌─────────────────────────┐
│   Flutter App            │
│   ├── Data entry forms   │
│   ├── Dart model classes │
│   └── fhir_r4 package   │
└─────────┬───────────────┘
          │ FHIR REST API
          ▼
┌─────────────────────────┐
│   FHIR R4 Server        │
│   (e.g., FHIR ANT)      │
│   ├── Resource storage   │
│   └── $export-whonet     │
└─────────────────────────┘

Model Classes#

The app includes builder classes that construct FHIR resources from form data:

Model	FHIR Resource	Key Fields
`BotswanaAMRPatientBuilder`	Patient	Name, DOB, gender, Omang (national ID)
`BotswanaAMREncounterBuilder`	Encounter	Ward type, admission date, facility, location
`BotswanaAMRSpecimenBuilder`	Specimen	Specimen type, collection date, body site
`BotswanaAMROrganismObservationBuilder`	Observation	Organism (SNOMED CT), isolate number, hasMember links
`BotswanaAMRSusceptibilityObservationBuilder`	Observation	Antibiotic (LOINC), S/I/R, MIC/zone diameter, AST method
`BotswanaAMRSpecialTestObservationBuilder`	Observation	ESBL, carbapenemase, MRSA detection results
`BotswanaAMRGramStainObservationBuilder`	Observation	Gram stain morphology
`BotswanaAMRDiagnosticReportBuilder`	DiagnosticReport	Ties all observations, specimen, encounter together

Each builder class has a buildResource() method that returns a fully conformant FHIR resource using the fhir_r4 package.

ValueSets in Dart#

Pre-generated Dart files provide ValueSet coding constants for dropdowns and validation:

Organism codes (SNOMED CT + local)
Antibiotic susceptibility panel codes (LOINC)
Specimen types, body sites
S/I/R interpretation codes
AST methods (disk diffusion, MIC, Etest, automated)
Ward types (inpatient, outpatient, emergency, ICU)

Packages#

The repository contains two Dart packages:

Package	Path	Purpose
`bw_amr_ig`	`flutter/`	Data capture models and ValueSets for the Flutter app
`bw_amr_export`	`export/`	WHONET/GLASS flat-file exporter (server-side or CLI)

The export package is intentionally separate — it's used server-side or from a web interface where someone can log in, run the export, and produce a file for WHONET or GLASS upload. See WHONET Export for usage details.

Installation#

# For the data capture app
dependencies:
  bw_amr_ig:
    git:
      url: https://github.com/Dokotela/bw-amr-ig.git
      path: flutter

# For export functionality (server/CLI/web)
dependencies:
  bw_amr_export:
    git:
      url: https://github.com/Dokotela/bw-amr-ig.git
      path: export