How krishnaprasath2006/job-applying-bot works
AI Job Assistant is a read-only, evidence-first job-fit system: a candidate maintains sourced profile facts and resume variants, supplies saved job-posting content, and receives an auditable fit verdict plus human-review work. The modern workflow runs through React, FastAPI, the Assistant service layer, and Python job-intelligence stages; safety policy blocks application submission. The README documents the tier boundaries and major capabilities. Source-index references support several internal links, but unsampled implementations and the truncated system-flow diagram limit finer call-level detail.
Main entry points: job_service.py Job service · app.py Assistant container · profile/service.py Verified profile · resumes/service.py Resume ingestion
Components 24
Presentation
- React interface
src/App.tsx
API boundary
- FastAPI routes
src/api/app.py - Assistant container
src/assistant/app.py
Candidate and job domain
- Verified profile
src/profile/service.py - Profile validation
src/profile/validator.py - Resume ingestion
src/resumes/service.py - Resume parsing
src/resumes/parser.py
Job intelligence
- Job service
src/assistant/job_service.py - Job discovery
src/jobs/discovery.py - Posting acquisition
src/jobs/acquisition.py - Posting analysis
src/jobs/analysis.py - Requirement extraction
src/jobs/requirements.py - Hard-requirement gate
src/jobs/hard_gate.py - Fit matching
src/jobs/matching.py - Auditable explanation
src/jobs/explain.py - Human review queue
src/jobs/review.py - AI provider registry
src/ai/registry.py - Semantic scoring
src/ai/embeddings.py
Persistence and safety
- Safety policy
src/safety/policies.py - SQLite database
src/database/connection.py - Domain repositories
src/database/repositories
Other components
- Job seeker
- Saved posting
- Local Ollama
Connections 28
- Job seeker → React interface: uses
README.md - React interface → FastAPI routes: requests data
README.md - FastAPI routes → Assistant container: constructs
src/api/app.py - Job seeker → Verified profile: records facts
README.md - Verified profile → Profile validation: validates
src/profile/service.py - Job seeker → Resume ingestion: adds resumes
README.md - Resume ingestion → Resume parsing: parses
src/resumes/service.py - Saved posting → Job service: ingests offline
src/assistant/job_service.py - Assistant container → Verified profile: provides service
README.md - Assistant container → Resume ingestion: provides service
README.md - Assistant container → Job service: provides service
README.md - Assistant container → Safety policy: enforces policy
README.md - Job service → Job discovery: runs discovery
src/assistant/job_service.py - Job service → Posting acquisition: acquires postings
src/assistant/job_service.py - Job service → Posting analysis: runs analysis
src/assistant/job_service.py - Posting analysis → Requirement extraction: extracts requirements
- Job service → Hard-requirement gate: evaluates gate
- Job service → Fit matching: computes fit
src/assistant/job_service.py - Job service → Auditable explanation: builds explanation
src/assistant/job_service.py - Job service → Human review queue: manages review
src/assistant/job_service.py - Fit matching → Semantic scoring: uses scorer
src/jobs/matching.py - Semantic scoring → AI provider registry: embeds text
src/ai/embeddings.py - AI provider registry → Local Ollama: selects provider
- Assistant container → SQLite database: initializes
src/assistant/app.py - Verified profile → Domain repositories: persists facts
src/profile/service.py - Resume ingestion → Domain repositories: stores resumes
src/resumes/service.py - Job service → Domain repositories: stores job data
src/assistant/job_service.py - Domain repositories → SQLite database: reads and writes
src/database/repositories/jobs.py