How somvanshitechnologies/somvanshi_hrms works
Somvanshi HRMS is a full-stack employee-lifecycle platform: users enter through the React application, authenticate and pass role-based access checks, then use HR modules for hiring, onboarding, work, growth, pay, and exit. The backend mounts bounded modules behind a central API router; modules use Prisma for persistence, while selected workflows emit audit records and notifications. The README documents the broader module capabilities, but most domain implementations and frontend-to-API calls were not sampled, so those relationships are cited as documentation rather than inspected source.
Main entry points: routes.ts API router · db.ts Prisma gateway · performance.routes.ts Performance · exit.routes.ts Exit and settlement
Components 22
User experience
- HR application
frontend/src/app/router.tsx - API router
backend/src/routes.ts
Identity and access
- Authentication
backend/src/modules/auth/auth.service.ts - Token service
backend/src/modules/auth/token.service.ts - Auth guard
backend/src/middleware/auth.middleware.ts - Permission checks
backend/src/middleware/rbac.middleware.ts - Role catalog
backend/src/shared/permissions.ts
People lifecycle
- Recruitment
backend/src/modules/recruitment - Onboarding
backend/src/modules/onboarding - Employee records
backend/src/modules/employees/employees.routes.ts - Profile self-service
backend/src/modules/profile
Work and growth
- Attendance
backend/src/modules/attendance/attendance.service.ts - Leave
backend/src/modules/leave - Payroll
backend/src/modules/payroll - Performance
backend/src/modules/performance/performance.routes.ts - Exit and settlement
backend/src/modules/exit/exit.routes.ts
Platform services
- MySQL database
- Prisma gateway
backend/src/config/db.ts - Audit trail
backend/src/modules/audit/audit.service.ts - Notifications
backend/src/modules/notifications/notifications.service.ts - SomAI assistant
backend/src/modules/ai
Other components
- HR user
Connections 28
- HR user → HR application: uses
README.md - HR application → API router: requests HR services
README.md - API router → Authentication: mounts routes
backend/src/routes.ts - API router → Recruitment: mounts routes
backend/src/routes.ts - API router → Onboarding: mounts routes
backend/src/routes.ts - API router → Employee records: mounts routes
backend/src/routes.ts - API router → Profile self-service: mounts routes
backend/src/routes.ts - API router → Attendance: mounts routes
backend/src/routes.ts - API router → Leave: mounts routes
backend/src/routes.ts - API router → Payroll: mounts routes
backend/src/routes.ts - API router → Performance: mounts routes
backend/src/routes.ts - API router → Exit and settlement: mounts routes
backend/src/routes.ts - API router → SomAI assistant: mounts routes
backend/src/routes.ts - Authentication → Token service: issues tokens
backend/src/modules/auth/auth.service.ts - Auth guard → Token service: verifies tokens
backend/src/middleware/auth.middleware.ts - Permission checks → Role catalog: uses permission types
backend/src/middleware/rbac.middleware.ts - Employee records → Prisma gateway: reads and writes
backend/src/modules/employees/employees.routes.ts - Performance → Audit trail: records changes
backend/src/modules/performance/performance.routes.ts - Performance → Notifications: notifies reviewers
backend/src/modules/performance/performance.routes.ts - Exit and settlement → Audit trail: records changes
backend/src/modules/exit/exit.routes.ts - Exit and settlement → Notifications: notifies participants
backend/src/modules/exit/exit.routes.ts - Prisma gateway → MySQL database: persists records
backend/src/config/db.ts - Recruitment → Prisma gateway: persists hiring data
README.md - Onboarding → Prisma gateway: persists joining data
README.md - Attendance → Prisma gateway: persists time data
README.md - Leave → Prisma gateway: persists leave data
README.md - Payroll → Prisma gateway: persists payroll data
README.md - SomAI assistant → HR user: assists user
README.md