How vaibhavpandey-1221/employee_management_portal works
This is an employee-management portal with a React client and Express/Mongoose server. Users sign in, reach role-specific dashboards, and manage employee records, attendance, leave, payslips, performance, and profile settings through API-backed pages. Server routes apply authentication and dispatch to domain controllers, which use MongoDB models; Inngest handles scheduled attendance and leave reminders. The README only identifies the product as an EMS portal, so feature details and most client-to-API links rely on source-index references; unverified links are dashed.
Main entry points: server.js Express API · App.jsx Portal routing · axios.js HTTP client · Employee.js Employee records
Components 31
Portal client
- Portal routing
client/src/App.jsx - Sign-in and session
client/src/context/AuthContext.jsx - Dashboard
client/src/pages/Dashboard.jsx - Employee directory
client/src/pages/Employees.jsx - Attendance
client/src/pages/Attendance.jsx - Leave
client/src/pages/Leave.jsx - Payslips
client/src/pages/Payslips.jsx - Performance reviews
client/src/pages/Performance.jsx - Profile settings
client/src/pages/Settings.jsx - Payslip printing
client/src/pages/PrintPayslip.jsx - HTTP client
client/src/api/axios.js
API and access
- Express API
server/server.js - Access control
server/middleware/auth.js
EMS workflows
- Authentication
server/controllers/authController.js - Employee management
server/controllers/employeeController.js - Attendance operations
server/controllers/attendanceController.js - Leave applications
server/controllers/leaveController.js - Payslip operations
server/controllers/payslipController.js - Performance reviews
server/controllers/performanceController.js - Dashboard summaries
server/controllers/dashboardController.js - Profile operations
server/controllers/profileController.js
Persistence and automation
- User records
server/models/User.js - Employee records
server/models/Employee.js - Attendance records
server/models/Attendance.js - Leave records
server/models/LeaveApplication.js - Payslip records
server/models/Payslip.js - Review records
server/models/PerformanceReview.js - Database connection
server/config/db.js - Scheduled reminders
server/inngest/index.js - Email delivery
server/config/nodemailer.js
Other components
- Employee or admin
Connections 48
- Employee or admin → Portal routing: uses
client/src/App.jsx - Portal routing → Sign-in and session: routes to
client/src/App.jsx - Portal routing → Dashboard: routes to
client/src/App.jsx - Portal routing → Employee directory: routes to
client/src/App.jsx - Portal routing → Attendance: routes to
client/src/App.jsx - Portal routing → Leave: routes to
client/src/App.jsx - Portal routing → Payslips: routes to
client/src/App.jsx - Portal routing → Performance reviews: routes to
client/src/App.jsx - Portal routing → Profile settings: routes to
client/src/App.jsx - Portal routing → Payslip printing: routes to
client/src/App.jsx - Sign-in and session → HTTP client: requests session
client/src/context/AuthContext.jsx - Sign-in and session → Express API: auth API
- Dashboard → HTTP client: loads data
client/src/pages/Dashboard.jsx - Employee directory → HTTP client: requests employees
client/src/pages/Employees.jsx - Attendance → HTTP client: requests attendance
client/src/pages/Attendance.jsx - Leave → HTTP client: requests leave
- Payslips → HTTP client: requests payslips
- Performance reviews → HTTP client: requests reviews
client/src/pages/Performance.jsx - Profile settings → HTTP client: requests profile
- Payslip printing → HTTP client: loads payslip
- HTTP client → Express API: HTTP requests
- Express API → Access control: routes guarded requests
- Express API → Authentication: mounts auth routes
server/server.js - Express API → Employee management: mounts employee routes
server/server.js - Express API → Attendance operations: mounts attendance routes
server/server.js - Express API → Leave applications: mounts leave routes
server/server.js - Express API → Payslip operations: mounts payslip routes
server/server.js - Express API → Performance reviews: mounts review routes
server/server.js - Express API → Dashboard summaries: mounts dashboard routes
server/server.js - Express API → Profile operations: mounts profile routes
server/server.js - Authentication → User records: reads and writes
server/controllers/authController.js - Employee management → Employee records: reads and writes
server/controllers/employeeController.js - Employee management → User records: creates and updates
server/controllers/employeeController.js - Attendance operations → Attendance records: uses records
server/controllers/attendanceController.js - Attendance operations → Employee records: uses employee
server/controllers/attendanceController.js - Leave applications → Leave records: reads and writes
server/controllers/leaveController.js - Leave applications → Employee records: looks up employee
server/controllers/leaveController.js - Leave applications → Scheduled reminders: sends event
server/controllers/leaveController.js - Payslip operations → Payslip records: uses records
server/controllers/payslipController.js - Payslip operations → Employee records: uses employee
server/controllers/payslipController.js - Performance reviews → Review records: uses records
server/controllers/performanceController.js - Performance reviews → Employee records: uses employee
server/controllers/performanceController.js - Dashboard summaries → Attendance records: queries
server/controllers/dashboardController.js - Dashboard summaries → Employee records: queries
server/controllers/dashboardController.js - Dashboard summaries → Leave records: queries
server/controllers/dashboardController.js - Dashboard summaries → Payslip records: queries
server/controllers/dashboardController.js - Profile operations → User records: uses user
- Express API → Database connection: connects database
server/server.js