Skip to main content

Source Adapters

Source adapters isolate country-specific discovery and parsing from the shared dataset writer.

The first adapter is es_aemps.

Adapter contract​

An adapter provides:

  • country
  • authority
  • build()

The build() method returns normalized recall records and a build report. Internally, adapters may split this into discovery, fetch, parse, and normalize steps.

Adding a country​

To add a new source:

  1. Create a new adapter under src/recallrx/adapters/.
  2. Normalize records into the shared RecallRecord model.
  3. Add the adapter to the source registry.
  4. Add fixtures and tests for source-specific parsing.
  5. Add country metadata and UI labels only if the country should be enabled in the public app.

The shared JSON paths are already country-aware:

data/countries/es/
data/countries/us/
data/countries/uk/