Blame

9d97a4 Meenakshi 2025-10-13 11:23:50 1
# SRS
1dbc74 Meenakshi 2025-10-13 11:29:14 2
# AI-Powered Recruitment Automation System
3
**Version:** V1.0
4
**Date:** 09 Oct 2025
5
6
---
7
8
### Document Revision History
9
10
| Version No | Date | Description | Author | Approver |
11
|-------------|------|--------------|---------|-----------|
12
| V1.0 | 09 Oct 2025 | Initial Draft | Meenakshi Singh | Dayanand Waghmare |
13
14
---
15
16
## Table of Contents
17
1. Introduction
18
2. Business Goals
19
3. Business Requirements
20
4. System Requirements
21
5. Non-Functional Requirements
22
6. Technology Stack
23
7. Flow Diagram
24
25
---
26
27
## 1. Introduction
28
The purpose of this system is to automate the recruitment process from collecting resumes to ranking candidates, making hiring faster, accurate, and less manual. Using AI, NLP, and semantic search, HR teams can focus on the right candidates rather than manually screening hundreds of resumes.
29
30
---
31
32
## 2. Business Goals
33
- Reduce time-to-hire by automating resume collection and processing.
34
- Increase accuracy of candidate-job fit using AI-powered ranking.
35
- Enable HR to easily view, filter, and manage candidates through a dashboard.
36
- Keep all candidate data structured and searchable, while avoiding duplicates.
37
38
---
39
40
## 3. Business Requirements
41
42
### Job Management
43
- HR can create, update, or close jobs.
44
- Each job has a title, description, start & end date, and minimum match score.
45
- The system automatically generates an embedding of the job description for matching candidates.
46
47
### Resume Collection
48
- The system fetches resumes from Gmail automatically every 4 hours.
49
- Only new resumes are processed (deduplication using hash).
50
- Resumes can be PDF or DOCX.
51
52
### Resume Processing
53
- Extract candidate info: Name, Email, Phone, Skills, Experience, Education.
54
- Calculate total years of experience.
55
- Store data in structured JSON format in the database.
56
57
### Candidate Ranking
58
- Find candidates most similar to a job using AI embeddings.
59
- AI re-ranks the top candidates using GPT for precision.
60
- HR sees top candidates along with match score and AI reasoning.
61
62
### Dashboard & Interaction
63
- HR can view candidates by status: New Job creation, Contacted, Active Job, Interviewed, Rejected, Candidate List, Job List, Open Roles, Hired.
64
- HR can update status.
65
- Metrics: total candidates, average match score, top skills.
66
67
### Duplicate Handling
68
- System automatically skips resumes that are already processed (deduplication).
69
6a4ca8 Meenakshi 2025-10-14 12:26:41 70
### Future Scope : Notifications & Logs
1dbc74 Meenakshi 2025-10-13 11:29:14 71
- Logs errors for debugging.
72
- Retry failed processes automatically.
73
74
---
75
76
## 4. System Requirements
77
78
### Job Module
79
- Create, read, update, delete jobs.
80
- Generate job embeddings automatically.
81
82
### Gmail Integration Module
83
- Authenticate with Gmail API securely.
84
- Fetch emails with resumes attached.
85
86
### Resume Parser Module
87
- Extract structured candidate data.
88
- Support both rule-based parsing and optional AI-based parsing.
89
90
### Embedding Module
91
- Generate embeddings for resumes and job descriptions.
92
- Store vectors in PostgreSQL using pgvector for semantic search.
93
94
### Ranking Module
95
- Stage 1: Find top candidates using vector similarity.
96
- Stage 2: AI re-rank top candidates using GPT-4o-mini.
97
- Combine vector and AI scores for final ranking.
98
99
### Candidate Management Module
100
- Update candidate status.
101
- Add notes.
102
- Log communications.
103
104
### Dashboard Module
105
- View jobs, candidates, pipeline stats, and AI reasoning.
106
- Export candidates in CSV.
107
108
### Error Handling
109
- Retry failed API calls 3 times with exponential backoff.
110
- Continue processing other resumes even if some fail.
111
112
---
1440fc Meenakshi 2025-10-13 11:30:47 113
114
[HireGenius_SRSV1.0.docx](./HireGenius_SRSV1.0.docx)