How honey-singh716/ai-powered-resume-matching-job-aggregation-platform works
AI Resume Matcher serves candidates and recruiters through a FastAPI-backed job marketplace. Candidates register, submit resumes for structured profile extraction and embedding, receive semantic recommendations, and apply; recruiters post jobs and review AI-ranked applicants or search talent. Job ingestion and career chat extend that workflow, while an admin interface provides operational oversight. The graph follows documented capabilities and indexed references; several route, scheduler, matching, and admin implementations were not excerpted, so uncertain links are omitted.
Main entry points: main.py FastAPI app · resume_routes.py Resume and profile API · job_service.py Job and recommendations · database.py Relational and vector store
Components 32
Product entrypoints
- SPA
frontend/app.js - FastAPI app
main.py
Identity and profiles
- Auth routes
route/auth_route.py - User routes
route/user_route.py - Authentication
services/auth_service.py - Account service
services/user_services.py - Resume and profile API
route/resume_routes.py - Candidate profiles
services/candidate_service.py - Profile management
services/profile_service.py
Jobs and matching
- Embedding engine
services/embedding_service.py - Job API
route/job_routes.py - Job and recommendations
services/job_service.py - Job aggregation
services/job_fetch_service.py - Matching API
route/match_routes.py - Match scoring
services/match_service.py
Applications and AI
- Resume parsing and chat
services/ai_service.py - Application API
route/application_routes.py - Application handling
services/application_service.py - Career chat API
route/ai_routes.py
Platform operations
- Admin API
admin/routes/admin_routes.py - Admin services
admin/services - Candidate repository
repositories/candidate_repo.py - Job repository
repositories/job_repo.py - User repository
repositories/user_repo_ext.py - Application repository
repositories/application_repo.py - Relational and vector store
database.py - Recommendation cache
services/redis_service.py
Other components
- Candidate
- Recruiter
- Administrator
- Groq LLM
- Job source APIs
Connections 45
- Candidate → SPA: uses
- Recruiter → SPA: uses
- Administrator → SPA: uses
- SPA → FastAPI app: calls REST
- FastAPI app → Auth routes: registers
main.py - FastAPI app → User routes: registers
main.py - FastAPI app → Resume and profile API: registers
main.py - FastAPI app → Job API: registers
main.py - FastAPI app → Matching API: registers
main.py - FastAPI app → Application API: registers
main.py - FastAPI app → Career chat API: registers
main.py - FastAPI app → Admin API: registers
main.py - Auth routes → Authentication: authenticates
- User routes → Account service: delegates
- Account service → Authentication: uses
services/user_services.py - Authentication → User repository: looks up users
services/auth_service.py - Resume and profile API → Authentication: authenticates
route/resume_routes.py - Resume and profile API → Resume parsing and chat: parses resume
route/resume_routes.py - Resume and profile API → Candidate profiles: saves profile
route/resume_routes.py - Resume and profile API → Profile management: updates profile
route/resume_routes.py - Resume and profile API → Candidate repository: searches candidates
route/resume_routes.py - Candidate profiles → Embedding engine: generates vectors
- Candidate profiles → Candidate repository: persists profile
- Profile management → Candidate repository: accesses candidates
services/profile_service.py - Job API → Job and recommendations: delegates
route/job_routes.py - Job and recommendations → Job repository: queries jobs
services/job_service.py - Job and recommendations → Candidate repository: loads candidates
services/job_service.py - Job and recommendations → Embedding engine: generates scores
services/job_service.py - Job and recommendations → Recommendation cache: caches results
services/job_service.py - Job aggregation → Job repository: stores aggregated jobs
services/job_fetch_service.py - Job aggregation → Embedding engine: embeds jobs
services/job_fetch_service.py - Job source APIs → Job aggregation: provides listings
- Matching API → Match scoring: delegates
route/match_routes.py - Match scoring → Embedding engine: scores similarity
- Application API → Application handling: delegates
route/application_routes.py - Application API → Authentication: authenticates
route/application_routes.py - Application handling → Application repository: manages applications
- Career chat API → Resume parsing and chat: requests chat
route/ai_routes.py - Resume parsing and chat → Groq LLM: calls LLM
- Admin API → Admin services: dispatches
admin/routes/admin_routes.py - Admin services → Relational and vector store: queries records
- Relational and vector store → Candidate repository: backs persistence
repositories/candidate_repo.py - Relational and vector store → Job repository: backs persistence
repositories/job_repo.py - Relational and vector store → User repository: backs persistence
repositories/user_repo_ext.py - Relational and vector store → Application repository: backs persistence