How piruthvin/employee-referral-optimization-agent works
This is an employee-referral and recruitment operations platform: employees authenticate and submit candidate referrals, while recruiters review them, schedule interviews, and track outcomes. The frontend routes role-specific users and sends authenticated API requests to a FastAPI backend. Backend services handle resume parsing and job matching, persist recruitment records in Zoho Recruit, and integrate with Microsoft Graph for email and interview coordination; iGentic provides chat and AI capabilities. Analytics and job discovery are additional product branches. Some connections are documented in the README or source index rather than fully shown in excerpts.
Main entry points: main.py FastAPI application · zoho_service.py Zoho integration · client.ts API client · App.tsx App routing
Components 34
Web application
- App routing
frontend/src/App.tsx - Login page
frontend/src/pages/LoginPage.tsx - Employee dashboard
frontend/src/pages/employee/EmployeeDashboard.tsx - Recruiter dashboard
frontend/src/pages/recruiter/RecruiterDashboard.tsx - Approval detail
frontend/src/pages/recruiter/ApprovalDetailPage.tsx - Chat page
frontend/src/pages/chat/ChatPage.tsx - Auth state
frontend/src/store/authStore.ts - API client
frontend/src/api/client.ts
API and identity
- FastAPI application
backend/app/main.py - Authentication API
backend/app/api/v1/auth.py - JWT and OTP security
backend/app/core/security.py - Auth dependencies
backend/app/core/dependencies.py
Referral lifecycle
- Referral API
backend/app/api/v1/referral.py - Referral intake
backend/app/services/referral_service.py - Resume parsing
backend/app/services/resume_parser_service.py - Python parser
backend/app/services/resume_parser_python.py - Job matching
backend/app/services/job_match_service.py
Recruitment operations
- Approval API
backend/app/api/v1/approvals.py - Approval workflow
backend/app/services/approval_service.py - Interview API
backend/app/api/v1/interview.py - Interview scheduling
backend/app/services/interview_service.py - Analytics API
backend/app/api/v1/analytics.py - Funnel analytics
backend/app/services/analytics_service.py - Jobs API
backend/app/api/v1/jobs.py
External services
- Zoho Recruit
- Zoho integration
backend/app/services/zoho_service.py - Zoho user directory
backend/app/services/zoho_users_service.py - Zoho OAuth
backend/app/infrastructure/zoho_auth.py - Microsoft Graph
- Email service
backend/app/services/email_service.py - iGentic agents
- iGentic client
backend/app/services/igentic_client.py
Other components
- Employee
- Recruiter
Connections 48
- Employee → Login page: signs in
README.md - Login page → Auth state: sets session
- App routing → Login page: routes to
frontend/src/App.tsx - App routing → Employee dashboard: routes to
frontend/src/App.tsx - App routing → Recruiter dashboard: routes to
frontend/src/App.tsx - App routing → Approval detail: routes to
frontend/src/App.tsx - App routing → Chat page: routes to
frontend/src/App.tsx - Employee dashboard → API client: requests data
frontend/src/pages/employee/EmployeeDashboard.tsx - Recruiter dashboard → API client: requests data
frontend/src/pages/recruiter/RecruiterDashboard.tsx - Approval detail → API client: requests actions
frontend/src/pages/recruiter/ApprovalDetailPage.tsx - Chat page → API client: requests chat
- Auth state → API client: provides token
frontend/src/api/client.ts - API client → FastAPI application: sends HTTPS requests
README.md - FastAPI application → Authentication API: mounts routes
backend/app/main.py - FastAPI application → Referral API: mounts routes
backend/app/main.py - FastAPI application → Approval API: mounts routes
backend/app/main.py - FastAPI application → Interview API: mounts routes
backend/app/main.py - FastAPI application → Analytics API: mounts routes
backend/app/main.py - FastAPI application → Jobs API: mounts routes
backend/app/main.py - Authentication API → JWT and OTP security: uses tokens
backend/app/api/v1/auth.py - Authentication API → Zoho user directory: verifies user
backend/app/api/v1/auth.py - Authentication API → Email service: sends OTP
backend/app/api/v1/auth.py - Auth dependencies → JWT and OTP security: validates JWT
backend/app/core/dependencies.py - Auth dependencies → Zoho user directory: looks up user
backend/app/core/dependencies.py - Referral API → Referral intake: handles intake
backend/app/api/v1/referral.py - Referral API → Zoho integration: reads and writes
backend/app/api/v1/referral.py - Referral intake → Resume parsing: parses resume
- Referral intake → Job matching: scores candidate
- Resume parsing → iGentic client: parses with agent
backend/app/services/resume_parser_service.py - Resume parsing → Python parser: uses fallback
backend/app/services/resume_parser_service.py - Job matching → iGentic client: requests agent match
backend/app/services/job_match_service.py - Job matching → Python parser: uses profile parser
backend/app/services/job_match_service.py - Approval API → Approval workflow: handles review
backend/app/api/v1/approvals.py - Approval workflow → Zoho integration: updates candidate
backend/app/services/approval_service.py - Approval workflow → Email service: sends notices
backend/app/services/approval_service.py - Interview API → Interview scheduling: schedules interview
backend/app/api/v1/interview.py - Interview scheduling → Microsoft Graph: creates Teams meeting
README.md - Interview scheduling → Zoho integration: updates candidate
- Analytics API → Funnel analytics: calculates metrics
backend/app/api/v1/analytics.py - Funnel analytics → Zoho integration: reads candidates
- Jobs API → Job matching: matches candidates
- Zoho integration → Zoho OAuth: gets access token
backend/app/services/zoho_service.py - Zoho user directory → Zoho OAuth: gets access token
backend/app/services/zoho_users_service.py - Zoho integration → Zoho Recruit: reads and writes
README.md - Zoho user directory → Zoho Recruit: queries users
README.md - Email service → Microsoft Graph: sends email
README.md - iGentic client → iGentic agents: calls agent executor
backend/app/services/igentic_client.py - Recruiter → Recruiter dashboard: reviews referrals
README.md