How kumardhananjaya/talentiq-ai works
TalentIQ AI is a recruitment platform for managing candidates and jobs, parsing uploaded resumes, and ranking candidate–job fit. The main workflow runs from the recruiter’s frontend through REST services to backend routes; matching calculates skill, experience, and semantic scores and persists ranked results. Resume uploads follow a separate extraction-and-merge path. The README also describes analytics, recruiter-tuned matching, comparisons, and interview-question generation, but the provided tree does not show distinct implementations for all of them. Links reflect the excerpts, source index, or README; unsampled details are not inferred.
Main entry points: candidates.py Candidate routes · matching_service.py Hybrid matching · App.tsx Application routes · Dashboard.tsx Analytics dashboard
Components 22
Recruiter frontend
- Application routes
frontend/src/App.tsx - Analytics dashboard
frontend/src/pages/Dashboard.tsx - Candidate management
frontend/src/pages/Candidates.tsx - Jobs and matches
frontend/src/pages/Jobs.tsx - Candidate API client
frontend/src/services/candidateService.ts - Job API client
frontend/src/services/jobService.ts
Backend API
- Candidate routes
backend/app/api/candidates.py - Job routes
backend/app/api/jobs.py
Candidate services
- Candidate operations
backend/app/services/candidate_service.py - Resume extraction
backend/app/services/resume_parser.py - LLM extraction
backend/app/services/llm_resume_parser.py - Resume merge
backend/app/services/resume_merge_service.py
Matching engine
- Hybrid matching
backend/app/services/matching_service.py - Semantic scoring
backend/app/services/semantic_matching_service.py - Embedding generation
backend/app/services/embedding_service.py - Match persistence
backend/app/services/match_persistence_service.py
Persistence
- Database session
backend/app/database/database.py - Candidate records
backend/app/models/candidate.py - Job records
backend/app/models/job.py - Match records
backend/app/models/candidate_job_match.py
Other components
- Recruiter
- Google Gemini
Connections 26
- Recruiter → Application routes: uses
README.md - Application routes → Analytics dashboard: routes to
frontend/src/App.tsx - Application routes → Candidate management: routes to
frontend/src/App.tsx - Application routes → Jobs and matches: routes to
frontend/src/App.tsx - Analytics dashboard → Candidate API client: requests data
frontend/src/pages/Dashboard.tsx - Analytics dashboard → Job API client: requests data
frontend/src/pages/Dashboard.tsx - Candidate management → Candidate API client: manages candidates
frontend/src/pages/Candidates.tsx - Jobs and matches → Job API client: manages jobs
frontend/src/pages/Jobs.tsx - Candidate API client → Candidate routes: calls REST
frontend/src/services/candidateService.ts - Job API client → Job routes: calls REST
frontend/src/services/jobService.ts - Candidate routes → Candidate operations: delegates
backend/app/api/candidates.py - Candidate routes → Database session: gets session
backend/app/api/candidates.py - Candidate routes → Resume extraction: parses resume
backend/app/api/candidates.py - Candidate routes → LLM extraction: extracts entities
backend/app/api/candidates.py - Candidate routes → Resume merge: merges results
backend/app/api/candidates.py - LLM extraction → Google Gemini: requests extraction
backend/app/services/llm_resume_parser.py - Job routes → Database session: gets session
backend/app/api/jobs.py - Job routes → Hybrid matching: requests matches
backend/app/api/jobs.py - Candidate operations → Candidate records: reads and writes
backend/app/services/candidate_service.py - Candidate operations → Embedding generation: generates vectors
backend/app/services/candidate_service.py - Hybrid matching → Candidate records: reads candidates
backend/app/services/matching_service.py - Hybrid matching → Job records: uses job
backend/app/services/matching_service.py - Hybrid matching → Semantic scoring: calculates semantics
backend/app/services/matching_service.py - Hybrid matching → Match persistence: saves matches
backend/app/services/matching_service.py - Match persistence → Match records: writes matches
backend/app/services/match_persistence_service.py - Embedding generation → Google Gemini: optional integration