How piruthvin/email_based_candidate_screening works
This is an email-driven candidate-screening backend. The main workflow syncs or receives candidate mail, parses and deduplicates candidate data, stores resumes and applications, queues scoring against active job profiles, and exposes search, ranking, dossiers, and reports to recruiter tools. The graph combines sampled call sites and SOURCE INDEX references with README-documented capabilities; several tool endpoints and ingestion details are not fully sampled, so their internal relationships are shown only where documented.
Main entry points: ingest_worker.py Ingestion Worker · scoring_pipeline.py Scoring Pipeline · main.py FastAPI Application · tool_service.py Recruiter Operations
Components 26
Mail Ingestion
- Mailbox Sync
backend/app/services/graph_sync_service.py - Ingestion Worker
backend/app/workers/ingest_worker.py - Mail Parser
backend/app/services/nvite_parser.py - Resume Processing
backend/app/services/resume_service.py - Candidate Deduplication
backend/app/services/dedupe_service.py
Candidate Scoring
- Scoring Jobs
backend/app/db/models.py - Scoring Worker
backend/app/workers/scoring_worker.py - Scoring Pipeline
backend/app/services/scoring_pipeline.py - Details Scorer
backend/app/services/details_scorer.py - Scoring Agent Client
backend/app/services/scoring_agent_client.py - Evidence Grounding
backend/app/services/evidence_grounding.py
Recruiter Tools
- Tool API
backend/app/api/v1/tools.py - Tool Schemas
backend/app/schemas/tools.py - Recruiter Operations
backend/app/services/tool_service.py - Excel Reports
backend/app/services/report_service.py - Report Download
backend/app/api/v1/reports.py
Backend Platform
- PostgreSQL
- Database Access
backend/app/core/database.py - Data Models
backend/app/db/models.py - Application Config
backend/app/core/config.py - FastAPI Application
backend/app/main.py
Other components
- Candidate Email
- Microsoft 365
- nVitae Mail
- iGentic Scoring Agent
- Recruiter
Connections 30
- Microsoft 365 → Mailbox Sync: provides mailbox data
README.md - Mailbox Sync → Ingestion Worker: queues mail
README.md - Candidate Email → nVitae Mail: arrives as
README.md - nVitae Mail → Ingestion Worker: enters processing
README.md - Ingestion Worker → Mail Parser: parses mail
backend/app/workers/ingest_worker.py - Ingestion Worker → Candidate Deduplication: checks duplicates
backend/app/workers/ingest_worker.py - Ingestion Worker → Resume Processing: processes resume
README.md - Ingestion Worker → Scoring Jobs: queues scoring
README.md - Scoring Jobs → Scoring Worker: polled by
README.md - Scoring Worker → Scoring Pipeline: runs scoring
backend/app/workers/scoring_worker.py - Scoring Pipeline → Details Scorer: scores candidate details
backend/app/services/scoring_pipeline.py - Scoring Pipeline → Scoring Agent Client: requests resume evaluation
backend/app/services/scoring_pipeline.py - Scoring Agent Client → iGentic Scoring Agent: invokes
README.md - Scoring Pipeline → Evidence Grounding: validates evidence
backend/app/services/scoring_pipeline.py - Recruiter → Tool API: uses tools
README.md - Tool API → Recruiter Operations: dispatches operations
backend/app/api/v1/tools.py - Tool API → Tool Schemas: validates payloads
backend/app/api/v1/tools.py - Recruiter Operations → Mailbox Sync: starts mailbox sync
backend/app/services/tool_service.py - Recruiter Operations → Excel Reports: generates reports
backend/app/services/tool_service.py - Recruiter Operations → Data Models: queries screening data
backend/app/services/tool_service.py - Excel Reports → Report Download: provides download
README.md - FastAPI Application → Tool API: registers routes
backend/app/main.py - FastAPI Application → Report Download: registers routes
backend/app/main.py - FastAPI Application → Ingestion Worker: starts worker
backend/app/main.py - FastAPI Application → Scoring Worker: starts worker
backend/app/main.py - Database Access → Application Config: loads database settings
backend/app/core/database.py - Scoring Pipeline → Data Models: reads and writes scores
backend/app/services/scoring_pipeline.py - Ingestion Worker → Data Models: stores candidate records
backend/app/workers/ingest_worker.py - Mailbox Sync → Data Models: stores synced mail
backend/app/services/graph_sync_service.py - Database Access → PostgreSQL: connects to
README.md