# vaibhavpandey-1221/employee_management_portal architecture

> Architecture diagram of the GitHub repository vaibhavpandey-1221/employee_management_portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhavpandey-1221/employee_management_portal
- Repository: https://github.com/vaibhavpandey-1221/employee_management_portal

## Overview

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/server.js`](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/server.js) (Express API), [`client/src/App.jsx`](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/App.jsx) (Portal routing), [`client/src/api/axios.js`](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/api/axios.js) (HTTP client), [`server/models/Employee.js`](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Employee.js) (Employee records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Portal client"]
  node_app["Portal routing<br/>[App.jsx]"]
  node_authui["Sign-in and session<br/>[AuthContext.jsx]"]
  node_dashboardui["Dashboard<br/>[Dashboard.jsx]"]
  node_employeesui["Employee directory<br/>[Employees.jsx]"]
  node_attendanceui["Attendance<br/>[Attendance.jsx]"]
  node_leaveui["Leave<br/>[Leave.jsx]"]
  node_payslipui["Payslips<br/>[Payslips.jsx]"]
  node_performanceui["Performance reviews<br/>[Performance.jsx]"]
  node_settingsui["Profile settings<br/>[Settings.jsx]"]
  node_printui["Payslip printing<br/>[PrintPayslip.jsx]"]
  node_apihelper["HTTP client<br/>[axios.js]"]
end

subgraph group_api["API and access"]
  node_server["Express API<br/>[server.js]"]
  node_authmw["Access control<br/>[auth.js]"]
end

subgraph group_domain["EMS workflows"]
  node_authflow["Authentication<br/>[authController.js]"]
  node_employees["Employee management"]
  node_attendance["Attendance operations"]
  node_leave["Leave applications<br/>[leaveController.js]"]
  node_payroll["Payslip operations"]
  node_performance["Performance reviews"]
  node_dashboard["Dashboard summaries"]
  node_profile["Profile operations"]
end

subgraph group_data["Persistence and automation"]
  node_userstore[("User records<br/>[User.js]")]
  node_employeestore[("Employee records<br/>[Employee.js]")]
  node_attendancestore[("Attendance records<br/>[Attendance.js]")]
  node_leavestore[("Leave records")]
  node_payslipstore[("Payslip records<br/>[Payslip.js]")]
  node_reviewstore[("Review records")]
  node_dbconnect["Database connection<br/>[db.js]"]
  node_jobs["Scheduled reminders<br/>[index.js]"]
  node_email["Email delivery<br/>[nodemailer.js]"]
end

node_user(("Employee or admin"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_dashboardui
node_app -->|"routes to"| node_employeesui
node_app -->|"routes to"| node_attendanceui
node_app -->|"routes to"| node_leaveui
node_app -->|"routes to"| node_payslipui
node_app -->|"routes to"| node_performanceui
node_app -->|"routes to"| node_settingsui
node_app -->|"routes to"| node_printui
node_authui -->|"requests session"| node_apihelper
node_authui -.->|"auth API"| node_server
node_dashboardui -.->|"loads data"| node_apihelper
node_employeesui -->|"requests employees"| node_apihelper
node_attendanceui -->|"requests attendance"| node_apihelper
node_leaveui -.->|"requests leave"| node_apihelper
node_payslipui -.->|"requests payslips"| node_apihelper
node_performanceui -->|"requests reviews"| node_apihelper
node_settingsui -.->|"requests profile"| node_apihelper
node_printui -.->|"loads payslip"| node_apihelper
node_apihelper -.->|"HTTP requests"| node_server
node_server -->|"routes guarded requests"| node_authmw
node_server -->|"mounts auth routes"| node_authflow
node_server -->|"mounts employee routes"| node_employees
node_server -->|"mounts attendance routes"| node_attendance
node_server -->|"mounts leave routes"| node_leave
node_server -->|"mounts payslip routes"| node_payroll
node_server -->|"mounts review routes"| node_performance
node_server -->|"mounts dashboard routes"| node_dashboard
node_server -->|"mounts profile routes"| node_profile
node_authflow -->|"reads and writes"| node_userstore
node_employees -->|"reads and writes"| node_employeestore
node_employees -->|"creates and updates"| node_userstore
node_attendance -->|"uses records"| node_attendancestore
node_attendance -->|"uses employee"| node_employeestore
node_leave -->|"reads and writes"| node_leavestore
node_leave -->|"looks up employee"| node_employeestore
node_leave -->|"sends event"| node_jobs
node_payroll -->|"uses records"| node_payslipstore
node_payroll -->|"uses employee"| node_employeestore
node_performance -->|"uses records"| node_reviewstore
node_performance -->|"uses employee"| node_employeestore
node_dashboard -->|"queries"| node_attendancestore
node_dashboard -->|"queries"| node_employeestore
node_dashboard -->|"queries"| node_leavestore
node_dashboard -->|"queries"| node_payslipstore
node_profile -.->|"uses user"| node_userstore
node_server -->|"connects database"| node_dbconnect

click node_app "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/App.jsx"
click node_authui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/context/AuthContext.jsx"
click node_dashboardui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Dashboard.jsx"
click node_employeesui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Employees.jsx"
click node_attendanceui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Attendance.jsx"
click node_leaveui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Leave.jsx"
click node_payslipui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Payslips.jsx"
click node_performanceui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Performance.jsx"
click node_settingsui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Settings.jsx"
click node_printui "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/PrintPayslip.jsx"
click node_apihelper "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/api/axios.js"
click node_server "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/server.js"
click node_authmw "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/middleware/auth.js"
click node_authflow "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/authController.js"
click node_employees "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/employeeController.js"
click node_attendance "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/attendanceController.js"
click node_leave "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/leaveController.js"
click node_payroll "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/payslipController.js"
click node_performance "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/performanceController.js"
click node_dashboard "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/dashboardController.js"
click node_profile "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/profileController.js"
click node_userstore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/User.js"
click node_employeestore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Employee.js"
click node_attendancestore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Attendance.js"
click node_leavestore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/LeaveApplication.js"
click node_payslipstore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Payslip.js"
click node_reviewstore "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/PerformanceReview.js"
click node_dbconnect "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/config/db.js"
click node_jobs "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/inngest/index.js"
click node_email "https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/config/nodemailer.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_authui,node_dashboardui,node_employeesui,node_attendanceui,node_leaveui,node_payslipui,node_performanceui,node_settingsui,node_printui,node_apihelper toneBlue
class node_server,node_authmw toneAmber
class node_authflow,node_employees,node_attendance,node_leave,node_payroll,node_performance,node_dashboard,node_profile toneMint
class node_userstore,node_employeestore,node_attendancestore,node_leavestore,node_payslipstore,node_reviewstore,node_dbconnect,node_jobs,node_email toneRose
class node_user toneIndigo
```

## Components

### Portal client

- [Portal routing](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in and session](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Employee directory](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Employees.jsx): `client/src/pages/Employees.jsx`
- [Attendance](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Attendance.jsx): `client/src/pages/Attendance.jsx`
- [Leave](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Leave.jsx): `client/src/pages/Leave.jsx`
- [Payslips](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Payslips.jsx): `client/src/pages/Payslips.jsx`
- [Performance reviews](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Performance.jsx): `client/src/pages/Performance.jsx`
- [Profile settings](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/Settings.jsx): `client/src/pages/Settings.jsx`
- [Payslip printing](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/pages/PrintPayslip.jsx): `client/src/pages/PrintPayslip.jsx`
- [HTTP client](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/client/src/api/axios.js): `client/src/api/axios.js`

### API and access

- [Express API](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/server.js): `server/server.js`
- [Access control](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/middleware/auth.js): `server/middleware/auth.js`

### EMS workflows

- [Authentication](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Employee management](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/employeeController.js): `server/controllers/employeeController.js`
- [Attendance operations](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/attendanceController.js): `server/controllers/attendanceController.js`
- [Leave applications](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/leaveController.js): `server/controllers/leaveController.js`
- [Payslip operations](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/payslipController.js): `server/controllers/payslipController.js`
- [Performance reviews](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/performanceController.js): `server/controllers/performanceController.js`
- [Dashboard summaries](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/dashboardController.js): `server/controllers/dashboardController.js`
- [Profile operations](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/controllers/profileController.js): `server/controllers/profileController.js`

### Persistence and automation

- [User records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/User.js): `server/models/User.js`
- [Employee records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Employee.js): `server/models/Employee.js`
- [Attendance records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Attendance.js): `server/models/Attendance.js`
- [Leave records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/LeaveApplication.js): `server/models/LeaveApplication.js`
- [Payslip records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/Payslip.js): `server/models/Payslip.js`
- [Review records](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/models/PerformanceReview.js): `server/models/PerformanceReview.js`
- [Database connection](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/config/db.js): `server/config/db.js`
- [Scheduled reminders](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/inngest/index.js): `server/inngest/index.js`
- [Email delivery](https://github.com/vaibhavpandey-1221/employee_management_portal/blob/main/server/config/nodemailer.js): `server/config/nodemailer.js`

### Other components

- **Employee or admin**

## Connections

- Employee or admin → Portal routing: uses (evidence: `client/src/App.jsx`)
- Portal routing → Sign-in and session: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Employee directory: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Attendance: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Leave: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Payslips: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Performance reviews: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Profile settings: routes to (evidence: `client/src/App.jsx`)
- Portal routing → Payslip printing: routes to (evidence: `client/src/App.jsx`)
- Sign-in and session → HTTP client: requests session (evidence: `client/src/context/AuthContext.jsx`)
- Sign-in and session → Express API: auth API
- Dashboard → HTTP client: loads data (evidence: `client/src/pages/Dashboard.jsx`)
- Employee directory → HTTP client: requests employees (evidence: `client/src/pages/Employees.jsx`)
- Attendance → HTTP client: requests attendance (evidence: `client/src/pages/Attendance.jsx`)
- Leave → HTTP client: requests leave
- Payslips → HTTP client: requests payslips
- Performance reviews → HTTP client: requests reviews (evidence: `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 (evidence: `server/server.js`)
- Express API → Employee management: mounts employee routes (evidence: `server/server.js`)
- Express API → Attendance operations: mounts attendance routes (evidence: `server/server.js`)
- Express API → Leave applications: mounts leave routes (evidence: `server/server.js`)
- Express API → Payslip operations: mounts payslip routes (evidence: `server/server.js`)
- Express API → Performance reviews: mounts review routes (evidence: `server/server.js`)
- Express API → Dashboard summaries: mounts dashboard routes (evidence: `server/server.js`)
- Express API → Profile operations: mounts profile routes (evidence: `server/server.js`)
- Authentication → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Employee management → Employee records: reads and writes (evidence: `server/controllers/employeeController.js`)
- Employee management → User records: creates and updates (evidence: `server/controllers/employeeController.js`)
- Attendance operations → Attendance records: uses records (evidence: `server/controllers/attendanceController.js`)
- Attendance operations → Employee records: uses employee (evidence: `server/controllers/attendanceController.js`)
- Leave applications → Leave records: reads and writes (evidence: `server/controllers/leaveController.js`)
- Leave applications → Employee records: looks up employee (evidence: `server/controllers/leaveController.js`)
- Leave applications → Scheduled reminders: sends event (evidence: `server/controllers/leaveController.js`)
- Payslip operations → Payslip records: uses records (evidence: `server/controllers/payslipController.js`)
- Payslip operations → Employee records: uses employee (evidence: `server/controllers/payslipController.js`)
- Performance reviews → Review records: uses records (evidence: `server/controllers/performanceController.js`)
- Performance reviews → Employee records: uses employee (evidence: `server/controllers/performanceController.js`)
- Dashboard summaries → Attendance records: queries (evidence: `server/controllers/dashboardController.js`)
- Dashboard summaries → Employee records: queries (evidence: `server/controllers/dashboardController.js`)
- Dashboard summaries → Leave records: queries (evidence: `server/controllers/dashboardController.js`)
- Dashboard summaries → Payslip records: queries (evidence: `server/controllers/dashboardController.js`)
- Profile operations → User records: uses user
- Express API → Database connection: connects database (evidence: `server/server.js`)
