bfat-ux/nigeria-pharmacy-registry
Domain:
healthcaredigital infrastructureRecord type:
software
Creator:
bfa
Host:
# Nigeria Pharmacy Registry
An open registry of pharmacy and medicine vendor locations across Nigeria.
**Live at openhealthregistry.org**
## Current Status
- **6,891 pharmacies** across all 36 states + FCT
- **Sources**: GRID3 Nigeria, OpenStreetMap, Google Places
- **First SMS campaign**: 98 messages sent to Ogun State pharmacies (Feb 2026)
- **347 tests passing**
- **Stage**: Working prototype — deployed on a Raspberry Pi 5
## What This Does
1. **Ingests** pharmacy location data from multiple open sources
2. **Deduplicates** records using fuzzy name matching + geospatial proximity
3. **Progressively verifies** via SMS contact confirmation (L0 → L1)
4. **Exposes** a REST API + FHIR R4 endpoints + dashboard
## Validation Ladder
Records start untrusted and earn trust through evidence:
| Level | Label | How Earned | Count |
|-------|-------|------------|-------|
| L0 | Mapped | Ingested from data source | ~6,887 |
| L1 | Contact Confirmed | SMS/phone reply received | ~3 |
| L2 | Evidence Documented | GPS + photo from field visit | ~1 |
| L3 | Regulator Verified | PCN/NAFDAC cross-reference | 0 |
| L4 | High-Assurance | In-person audit (future) | 0 |
## Quick Start
### Prerequisites
- Docker (for the database) or PostgreSQL 17+ with PostGIS
- Python 3.10+
### Setup
```bash
# Start the database
docker compose up -d
# Install dependencies
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Run the API + dashboard
python serve.py
```
The dashboard is at `localhost`. The database is at
`localhost:5432` (user: `npr`, password: `npr_local_dev`, database: `npr_registry`).
### Run Tests
```bash
python -m pytest tests/ -q
```
## Technology Stack
| Layer | Technology |
|-------|-----------|
| Database | PostgreSQL + PostGIS |
| API | Python / FastAPI |
| Entity resolution | Python (rapidfuzz) |
| SMS | Africa's Talking |
| Hosting | Raspberry Pi 5 + nginx + Let's Encrypt |
## Documentation
- **METHODOLOGY.md** — How …