How adeel-parvaiz/qualifyr works
Qualifyr turns an offer into a ranked, evidence-backed company shortlist, with a web dashboard and optional human-approved outreach. Its lead-to-cash extension drafts proposals, creates PayPal invoices after approval, and uses payment outcomes to calibrate scoring. The README describes the major product stages; the pipeline excerpt confirms its processing sequence, while the source index supports several module relationships. Many subsystem implementations were not sampled, so their internal links are omitted rather than inferred.
Main entry points: pipeline.py Campaign pipeline · page.tsx Dashboard UI · service.py Payment workflow · main.py FastAPI
Components 24
Web product
- Dashboard UI
web/src/app/(app)/campaigns/page.tsx - Web API client
web/src/lib/api.ts - FastAPI
gtm_engine/api/main.py
Campaign setup
- Campaign config
gtm_engine/config/schema.py - Offer parser
gtm_engine/campaign/nl_parser.py - Campaign pipeline
gtm_engine/pipeline.py
Lead research
- Company discovery
gtm_engine/discovery - Offer targeting
gtm_engine/discovery/targeting.py - Website crawling
gtm_engine/scraping - Buyer qualification
gtm_engine/qualification - Buying intent
gtm_engine/intent - Contact enrichment
gtm_engine/enrichment - Lead validation
gtm_engine/validation - Lead scoring
gtm_engine/scoring/scoring.py - Lead data models
gtm_engine/models.py
Lead delivery
- Postgres storage
gtm_engine/storage/database.py - Lead exports
gtm_engine/export - Approval-gated outreach
gtm_engine/outreach
PayPal revenue
- PayPal routes
gtm_engine/api/paypal_routes.py - Payment workflow
gtm_engine/paypal/service.py - Payment records
gtm_engine/paypal/store.py - PayPal client
gtm_engine/paypal/client.py - Score calibration
gtm_engine/paypal/calibration.py
Other components
- Sales user
Connections 25
- Sales user → Dashboard UI: describes offer
README.md - Dashboard UI → Web API client: requests data
README.md - Web API client → FastAPI: calls API
README.md - FastAPI → Postgres storage: reads and writes
gtm_engine/api/main.py - Sales user → Offer parser: describes offer
README.md - Offer parser → Campaign config: builds targets
gtm_engine/campaign/nl_parser.py - Campaign pipeline → Company discovery: discovers companies
gtm_engine/pipeline.py - Campaign pipeline → Website crawling: crawls sites
gtm_engine/pipeline.py - Campaign pipeline → Buyer qualification: classifies buyers
gtm_engine/pipeline.py - Campaign pipeline → Contact enrichment: enriches leads
gtm_engine/pipeline.py - Campaign pipeline → Lead validation: validates leads
gtm_engine/pipeline.py - Campaign pipeline → Lead scoring: scores leads
gtm_engine/pipeline.py - Campaign pipeline → Postgres storage: stores results
README.md - Campaign pipeline → Offer targeting: derives targets
gtm_engine/pipeline.py - Offer targeting → Campaign config: loads settings
gtm_engine/discovery/targeting.py - Offer targeting → Buying intent: optional intent
- Postgres storage → Lead data models: stores leads
gtm_engine/storage/database.py - Dashboard UI → Lead exports: exports CSV
README.md - Dashboard UI → Approval-gated outreach: reviews drafts
README.md - FastAPI → PayPal routes: mounts routes
gtm_engine/api/paypal_routes.py - PayPal routes → Payment workflow: handles payments
gtm_engine/api/paypal_routes.py - Payment workflow → Payment records: records payment state
gtm_engine/paypal/service.py - Payment workflow → PayPal client: calls PayPal
gtm_engine/paypal/service.py - Payment workflow → Score calibration: calibrates scores
gtm_engine/paypal/service.py - PayPal client → PayPal routes: verifies webhooks
gtm_engine/api/paypal_routes.py