How eklakh-ai-engineer/ai-job-agent works
AI Job Agent is currently a FastAPI backend foundation, not the fully autonomous career agent described as future scope. The main user flow is a client calling versioned API routes for account access, job browsing/search, candidate documents, evaluation, and application tracking; application submission is guarded and human-controlled. The graph includes major implemented service areas and the embedding/search path. Several subsystems are represented from the source index or README rather than inspected excerpts, so their internal links are omitted where call ownership is not established.
Main entry points: router.py V1 routes · browser_automation_service.py Guarded submission · embedding_service.py Embedding service · deps.py Auth dependencies
Components 34
API and identity
- API application
backend/app/main.py - V1 routes
backend/app/api/v1/router.py - Authentication routes
backend/app/api/v1/auth.py - User routes
backend/app/api/v1/users.py - Auth dependencies
backend/app/api/deps.py
Career workflows
- Job routes
backend/app/api/v1/jobs.py - Job records
backend/app/models/job.py - Candidate knowledge API
backend/app/api/v1/candidate_kb.py - Candidate knowledge
backend/app/services/candidate_kb_service.py - Document API
backend/app/api/v1/documents.py - Document service
backend/app/services/document_service.py - Document storage
backend/app/services/document_storage.py - Application API
backend/app/api/v1/applications.py - Application workflow
backend/app/services/application_service.py - Guarded submission
backend/app/services/browser_automation_service.py - ATS adapters and agents
backend/app/agents
Search and evaluation
- Semantic search API
backend/app/api/v1/semantic_search.py - Semantic search
backend/app/services/semantic_search_service.py - Embedding service
backend/app/services/embedding_service.py - Embedding providers
backend/app/core/embeddings.py - Embedding tasks
backend/app/tasks/embeddings.py - Evaluation API
backend/app/api/v1/evaluation.py - Evaluation service
backend/app/services/evaluation_service.py - Evaluation engine
backend/evaluation/evaluator.py - Evaluation schemas
backend/evaluation/models.py - Candidate models
backend/evaluation/candidate_models.py - Candidate loader
backend/evaluation/candidate_loader.py
Services and persistence
- Database sessions
backend/app/core/database.py - Runtime configuration
backend/app/core/config.py - Task queue setup
backend/app/core/celery_app.py - Application tasks
backend/app/tasks/applications.py - Notifications
backend/app/services/notification_service.py
Other components
- Client
- Embedding API provider
Connections 39
- Client → API application: sends requests
README.md - API application → V1 routes: mounts routes
backend/app/main.py - V1 routes → Authentication routes: registers
backend/app/api/v1/router.py - V1 routes → User routes: registers
backend/app/api/v1/router.py - V1 routes → Job routes: registers
backend/app/api/v1/router.py - V1 routes → Candidate knowledge API: registers
backend/app/api/v1/router.py - V1 routes → Document API: registers
backend/app/api/v1/router.py - V1 routes → Application API: registers
backend/app/api/v1/router.py - V1 routes → Semantic search API: registers
backend/app/api/v1/router.py - V1 routes → Evaluation API: registers
backend/app/api/v1/router.py - Authentication routes → Auth dependencies: uses auth dependencies
backend/app/api/v1/auth.py - Auth dependencies → Database sessions: gets sessions
backend/app/api/deps.py - Auth dependencies → Runtime configuration: reads settings
backend/app/api/deps.py - Job routes → Job records: serves job data
- Candidate knowledge API → Candidate knowledge: delegates to
backend/app/api/v1/candidate_kb.py - Document API → Candidate knowledge: uses candidate data
backend/app/api/v1/documents.py - Document API → Document service: delegates to
backend/app/api/v1/documents.py - Document service → Document storage: uses storage
- Application API → Application workflow: manages applications
backend/app/api/v1/applications.py - Application API → Guarded submission: requests submission
backend/app/api/v1/applications.py - Guarded submission → Candidate knowledge: loads candidate data
backend/app/services/browser_automation_service.py - Guarded submission → ATS adapters and agents: uses ATS automation
backend/app/services/browser_automation_service.py - Application workflow → Notifications: notifies changes
backend/app/services/application_service.py - Semantic search API → Semantic search: delegates search
backend/app/api/v1/semantic_search.py - Semantic search → Embedding service: creates query vectors
backend/app/services/semantic_search_service.py - Embedding service → Embedding providers: requests embeddings
backend/app/services/embedding_service.py - Embedding providers → Embedding API provider: calls provider API
backend/app/core/embeddings.py - Semantic search → Job records: queries ranked jobs
backend/app/services/semantic_search_service.py - Embedding service → Job records: writes vectors
backend/app/services/embedding_service.py - Embedding tasks → Embedding service: runs embedding work
backend/app/tasks/embeddings.py - Evaluation API → Evaluation service: delegates evaluation
backend/app/api/v1/evaluation.py - Evaluation service → Evaluation engine: uses evaluator
- Evaluation engine → Evaluation schemas: uses schemas
backend/evaluation/evaluator.py - Evaluation engine → Candidate models: uses candidate types
backend/evaluation/evaluator.py - Candidate loader → Candidate models: builds candidate data
backend/evaluation/candidate_loader.py - Task queue setup → Runtime configuration: reads settings
backend/app/core/celery_app.py - Application tasks → Task queue setup: registers tasks
backend/app/tasks/applications.py - Application tasks → Guarded submission: runs submissions
backend/app/tasks/applications.py - Database sessions → Runtime configuration: gets database settings
backend/app/core/database.py