How thanmaykh/ai-hrms works
Enterprise HRMS serves employees, recruiters, and administrators through role-based dashboards and APIs. The main hiring workflow is job setup and publication, candidate application, AI resume evaluation, and recruiter review with human override and audit records. Separate product branches cover employee administration, attendance, leave, payroll and payslips, performance reviews, responsible-AI controls, chatbot assistance, and reporting. Source excerpts establish the cited calls; other major README capabilities remain as subsystem nodes where implementation details were not sampled.
Main entry points: db.ts Application database · auth.ts Session identity · route.ts AI resume screening · llm.ts LLM engine
Components 27
Hiring & AI screening
- Job management
src/app/api/jobs/route.ts - Applications
src/app/api/applications/route.ts - Resume upload
src/components/recruitment/ResumeUploader.tsx - Resume parsing
src/app/api/ai/parse-resume-pdf/route.ts - AI resume screening
src/app/api/ai/analyze-resume/route.ts - LLM engine
src/lib/ai/llm.ts - Recruiter review
src/app/api/ai-reviews/route.ts
Workforce operations
- Employee records
src/app/api/employees/route.ts - Shift attendance
src/app/api/attendance/route.ts - Leave workflows
src/app/api/leaves/route.ts - Payroll & payslips
src/app/api/payroll/[id]/pdf/route.ts - Performance matrix
src/app/api/performance/route.ts - CSV reports
src/app/api/reports/export/route.ts
Responsible AI
- AI governance
src/lib/ai/governance.ts - Data quality checks
src/lib/ai/data-quality.ts - Responsible-AI controls
src/app/api/responsible-ai/route.ts
User experience
- HR chatbot
src/app/api/ai/chatbot/route.ts - Role dashboards
src/app/(dashboard)/layout.tsx - Header & navigation
src/components/common/Header.tsx - Command palette
src/components/common/CommandPalette.tsx - Notification bell
src/components/common/NotificationBell.tsx
Identity & data
- Session identity
src/lib/auth.ts - Application database
src/lib/db.ts
Other components
- HRMS users
- OpenAI service
- Gemini service
- OpenRouter service
Connections 44
- HRMS users → Role dashboards: use dashboards
- HRMS users → Job management: manage openings
- HRMS users → Applications: submit application
- Job management → Application database: reads and writes
src/app/api/jobs/route.ts - Job management → Session identity: checks session
src/app/api/jobs/route.ts - Applications → Session identity: checks session
src/app/api/applications/route.ts - Applications → Data quality checks: checks resume
src/app/api/applications/route.ts - Applications → Application database: stores application
src/app/api/applications/route.ts - Resume upload → Resume parsing: uploads resume
- HRMS users → AI resume screening: request screening
- AI resume screening → Session identity: checks session
src/app/api/ai/analyze-resume/route.ts - AI resume screening → Data quality checks: checks input
src/app/api/ai/analyze-resume/route.ts - AI resume screening → LLM engine: requests analysis
src/app/api/ai/analyze-resume/route.ts - AI resume screening → AI governance: calculates confidence
src/app/api/ai/analyze-resume/route.ts - AI resume screening → Application database: persists analysis
src/app/api/ai/analyze-resume/route.ts - LLM engine → OpenAI service: calls provider
src/lib/ai/llm.ts - LLM engine → Gemini service: calls provider
src/lib/ai/llm.ts - LLM engine → OpenRouter service: calls provider
src/lib/ai/llm.ts - HRMS users → Recruiter review: review candidates
- Recruiter review → Session identity: checks reviewer
src/app/api/ai-reviews/route.ts - Recruiter review → Application database: records decision
src/app/api/ai-reviews/route.ts - Recruiter review → AI governance: logs review
src/app/api/ai-reviews/route.ts - AI governance → Application database: writes audit
src/lib/ai/governance.ts - Responsible-AI controls → AI governance: reads settings
src/app/api/responsible-ai/route.ts - HRMS users → Employee records: administer staff
- HRMS users → Shift attendance: clock shifts
- HRMS users → Leave workflows: request leave
- HRMS users → Payroll & payslips: view payslips
- HRMS users → Performance matrix: evaluate talent
- HRMS users → CSV reports: export reports
- Employee records → Session identity: checks session
src/app/api/employees/route.ts - Employee records → Application database: reads and writes
src/app/api/employees/route.ts - Shift attendance → Application database: reads and writes
src/app/api/attendance/route.ts - Leave workflows → Application database: reads and writes
src/app/api/leaves/route.ts - Payroll & payslips → Application database: reads payroll
src/app/api/payroll/[id]/pdf/route.ts - Performance matrix → Application database: stores reviews
src/app/api/performance/route.ts - CSV reports → Application database: reads report data
src/app/api/reports/export/route.ts - HRMS users → HR chatbot: ask HR questions
- HR chatbot → LLM engine: requests response
src/app/api/ai/chatbot/route.ts - HR chatbot → Application database: queries HR data
src/app/api/ai/chatbot/route.ts - Header & navigation → Command palette: renders
src/components/common/Header.tsx - Header & navigation → Notification bell: renders
src/components/common/Header.tsx - HRMS users → Session identity: sign in
- Session identity → Application database: loads profile
src/lib/auth.ts