How shreeya-pareek/opportunity-radar works
Opportunity Radar collects listings from JSON files and configured Greenhouse boards, normalizes them, and stores them in SQLite with duplicate-aware updates. Users can search through the CLI or browse and filter through a web UI backed by the API; both read the same store. The README documents these capabilities, while the excerpts show the main calls among CLI, adapters, model, store, API, and browser code. Some UI and Greenhouse details are documented rather than fully shown in source excerpts.
Main entry points: cli.py Radar CLI · store.py Store and search · sources.py JSON source adapter · api.py HTTP API
Components 15
Collection
- Radar CLI
src/opportunity_radar/cli.py - Board configuration
data/greenhouse_employers.json - Employer config loader
src/opportunity_radar/sources.py - JSON source adapter
src/opportunity_radar/sources.py - Greenhouse adapter
src/opportunity_radar/sources.py
Opportunity Data
- Opportunity model
src/opportunity_radar/models.py
Persistence and Search
- Store and search
src/opportunity_radar/store.py - SQLite database
Discovery Interfaces
- HTTP API
src/opportunity_radar/api.py - Web interface
src/opportunity_radar/static/index.html - Browser search client
src/opportunity_radar/static/js/app.js
Other components
- Opportunity seeker
- JSON publisher feed
- Greenhouse boards
- Browser user
Connections 17
- Radar CLI → Employer config loader: loads config
src/opportunity_radar/cli.py - Employer config loader → Board configuration: reads boards
README.md - Radar CLI → JSON source adapter: fetches listings
src/opportunity_radar/cli.py - JSON source adapter → JSON publisher feed: reads JSON
README.md - Radar CLI → Greenhouse adapter: fetches boards
src/opportunity_radar/cli.py - Greenhouse adapter → Greenhouse boards: requests listings
README.md - JSON source adapter → Opportunity model: normalizes records
src/opportunity_radar/sources.py - Greenhouse adapter → Opportunity model: normalizes records
src/opportunity_radar/sources.py - Radar CLI → Store and search: upserts and searches
src/opportunity_radar/cli.py - Store and search → Opportunity model: stores fields
src/opportunity_radar/store.py - Store and search → SQLite database: reads and writes
README.md - Browser user → Web interface: opens interface
README.md - Web interface → Browser search client: loads client
README.md - Browser search client → HTTP API: requests listings
src/opportunity_radar/static/js/app.js - HTTP API → Store and search: searches and retrieves
src/opportunity_radar/api.py - HTTP API → Web interface: serves homepage
src/opportunity_radar/api.py - Opportunity seeker → Radar CLI: runs commands
README.md