How opensupplyhub/open-supply-hub works
Open Supply Hub identifies and maintains production facilities through public search, contributor submissions, claims and moderation, candidate review, and partner-data ingestion. The README documents the principal list workflow: upload, parse, approve, geocode, then match; partner spreadsheets have a separate processing path. The graph also includes the React interface, facility data/search, candidate handling, and ContriBot’s list automation. Several backend subsystems are represented at their existing directory paths because their implementation files were not sampled; edges are limited to README statements and indexed or excerpted references.
Main entry points: handler.py Process facility lists · facility.py Facility records · batch_process.py List processing command · partner_data_file_upload Partner upload processing
Components 21
User interface
- React application
src/react/src/App.jsx - Route handling
src/react/src/Routes.jsx - Candidate review
src/react/src/components/Candidate/CandidateReviewPage.jsx
Facility platform
- Django API
src/django/api - Facility records
src/django/api/models/facility/facility.py - Facility index
src/django/api/models/facility/facility_index.py - Facility search
src/django/api/models/facility/facility_manager.py - Processing filters
src/django/api/services
Data ingestion
- List processing command
src/django/api/management/commands/batch_process.py - Partner upload processing
src/django/api/partner_data_file_upload - Satellite detections
src/django/api/management/commands/ingest_satellite_detections.py
List automation
- Fetch facility lists
src/contribot/fetch_lists/handler.py - Process facility lists
src/contribot/process_list/handler.py - List state repository
src/contribot/lib/lists_repository.py - Upload file storage
src/contribot/lib/s3_storage.py - OS Hub API client
src/contribot/lib/os_hub_api.py
Deduplication
- Dedupe service
src/dedupe-hub/api/app/main.py - Facility matcher
src/dedupe-hub/api/app/matching/facilities_matcher.py
Other components
- Contributors and moderators
- Kafka
- Earth Index
Connections 18
- Contributors and moderators → React application: uses
README.md - React application → Route handling: renders routes
src/react/src/App.jsx - Contributors and moderators → List processing command: uploads and approves
README.md - List processing command → List processing command: parses, geocodes, matches
README.md - Contributors and moderators → Partner upload processing: submits spreadsheet
README.md - Partner upload processing → Partner upload processing: processes upload
README.md - Django API → Facility records: serves facility data
src/django/api/models/facility/facility_manager.py - Facility search → Processing filters: builds filter
src/django/api/models/facility/facility_manager.py - Facility search → Facility index: queries
src/django/api/models/facility/facility_manager.py - Facility records → Facility index: references
src/django/api/models/facility/facility.py - Satellite detections → Earth Index: fetches detections
src/django/api/management/commands/ingest_satellite_detections.py - Satellite detections → Facility records: creates candidates
src/django/api/management/commands/ingest_satellite_detections.py - Fetch facility lists → List state repository: reads and updates
src/contribot/fetch_lists/handler.py - Process facility lists → List state repository: updates state
src/contribot/process_list/handler.py - Process facility lists → Upload file storage: downloads uploads
src/contribot/process_list/handler.py - Process facility lists → OS Hub API client: calls API
src/contribot/process_list/handler.py - Dedupe service → Facility matcher: initializes matcher
src/dedupe-hub/api/app/main.py - Dedupe service → Kafka: consumes and publishes
src/dedupe-hub/api/app/main.py