How bedaant/job works
Apply Scout is a personal job-search automation product: users build a fact-checked profile and campaign, the service discovers and ranks jobs, prepares truthful ATS-tailored documents, and the ApplyScout extension fills and submits applications in the user's browser. The web app and API also support application review/tracking, saved answers, live events and digests. Referral outreach is explicitly planned but not built, so it is shown as a documented future capability. Source excerpts establish selected calls; other links cite README-described relationships, not unsampled implementation details.
Main entry points: main.py REST API · app Web workspace · driver.ts ApplyScout extension · jobs.py Background jobs
Components 20
Profile & campaign
- Web workspace
apps/web/app - Resume facts
apps/api/parsing - Search campaign
apps/api/campaigns.py
Job discovery & match
- Job connectors
apps/api/connectors - Job ingestion
apps/api/connectors/pipeline.py - Job matching
apps/api/matching/service.py
Preparation & apply
- Resume tailoring
apps/api/tailoring/engine.py - ATS documents
apps/api/documents - Form planning
apps/api/formplans.py - Saved answers
apps/api/answer_bank.py - ApplyScout extension
apps/extension/src/background/driver.ts - Referral outreach
API & operations
- REST API
apps/api/main.py - Authentication
apps/api/auth/router.py - Application database
apps/api/models.py - Live events
apps/api/events/outbox.py - Daily digest
apps/api/digest.py - Background jobs
apps/api/workers/jobs.py
Other components
- Job seeker
- Employer application
Connections 28
- Job seeker → Web workspace: uses
- Web workspace → REST API: calls REST
- Job seeker → Web workspace: submits resume
- REST API → Resume facts: parses resume
apps/api/main.py - Web workspace → REST API: edits facts
- Web workspace → REST API: configures campaign
- REST API → Authentication: routes auth
apps/api/main.py - REST API → Application database: reads/writes
apps/api/main.py - Background jobs → Job connectors: fetches jobs
apps/api/workers/jobs.py - Background jobs → Job ingestion: upserts jobs
apps/api/workers/jobs.py - Job ingestion → Application database: stores jobs
apps/api/connectors/pipeline.py - Background jobs → Job matching: builds matches
apps/api/workers/jobs.py - Job matching → Application database: reads/writes matches
apps/api/matching/service.py - Job matching → Live events: announces matches
apps/api/matching/service.py - Web workspace → REST API: reviews matches
- REST API → Resume tailoring: requests tailoring
apps/api/main.py - Resume tailoring → ATS documents: creates ATS resume
- Resume tailoring → Application database: stores tailored output
- Background jobs → Form planning: plans forms
apps/api/workers/jobs.py - ApplyScout extension → REST API: gets apply queue
- ApplyScout extension → Form planning: uses plan
- ApplyScout extension → Saved answers: uses saved answers
- ApplyScout extension → Employer application: fills and submits
- Employer application → REST API: confirms submission
- Web workspace → REST API: tracks applications
- REST API → Live events: writes events
apps/api/events/outbox.py - REST API → Daily digest: supports digest
apps/api/main.py - REST API → Referral outreach: planned after apply