# varun-reddy-2105/ems_3.0 architecture

> Architecture diagram of the GitHub repository varun-reddy-2105/ems_3.0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/varun-reddy-2105/ems_3.0
- Repository: https://github.com/varun-reddy-2105/ems_3.0

## Overview

ISAR EMS is an employee-management application with employee and administrator experiences. Employees sign in, record attendance, manage tasks and leave, and request punch corrections; administrators review attendance, employees, leave, corrections, tasks, settings, and analytics. The React app routes role-protected screens to an Express API, whose route modules implement domain operations and use MongoDB models. Several frontend screens and backend routes are indexed but not excerpted, so their connections are shown only where route registration or indexed references establish them; unsampled HTTP behavior is not inferred.

Main entry points: [`frontend/src/App.js`](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/App.js) (Role routing), [`ems-backend/server.js`](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/server.js) (Express API), [`ems-backend/models/Staff.js`](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/models/Staff.js) (Staff records), [`ems-backend/routes/attendance.js`](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/attendance.js) (Attendance and punch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Role routing<br/>[App.js]"]
  node_login["Sign in<br/>[LoginPage.js]"]
  node_employee_home["Employee home<br/>[employeehome.js]"]
  node_employee_dashboard["Employee dashboard"]
  node_leave_ui["Leave requests<br/>[LeaveSection.js]"]
  node_task_ui["Task tracking<br/>[TaskSection.js]"]
  node_correction_ui["Correction request"]
  node_admin_home["Admin home<br/>[adminhome.js]"]
  node_admin_dashboard["Admin dashboard<br/>[AdminDashboard.js]"]
  node_admin_attendance_ui["Attendance summary"]
  node_admin_correction_ui["Correction review"]
  node_admin_settings_ui["Admin settings"]
  node_admin_leave_ui["Leave management"]
  node_admin_tasks_ui["Task overview"]
  node_analytics_ui["Analytics"]
end

subgraph group_identity["Identity and access"]
  node_auth_fetch["Authenticated fetch<br/>[authFetch.js]"]
  node_api_server["Express API<br/>[server.js]"]
  node_auth_routes["Login and recovery<br/>[auth.js]"]
  node_auth_middleware["Token verification<br/>[authenticate.js]"]
end

subgraph group_workforce["Workforce operations"]
  node_attendance_routes["Attendance and punch<br/>[attendance.js]"]
  node_leave_routes["Leave processing<br/>[leave.js]"]
  node_correction_routes["Punch corrections<br/>[punchCorrection.js]"]
  node_task_routes["Task processing<br/>[task.js]"]
  node_profile_routes["Staff profiles<br/>[profile.js]"]
  node_employees_routes["Employee directory<br/>[employees.js]"]
  node_working_hours["Working hours<br/>[workingHours.js]"]
end

subgraph group_administration["Administration"]
  node_office_ip["Office IP policy<br/>[checkOfficeIP.js]"]
  node_ip_routes["IP configuration<br/>[ipCheck.js]"]
  node_settings_routes["Admin settings<br/>[adminSettings.js]"]
  node_analytics_routes["Admin analytics<br/>[adminAnalytics.js]"]
end

subgraph group_persistence["Data models"]
  node_staff_model[("Staff records<br/>[Staff.js]")]
  node_attendance_model[("Attendance records<br/>[Attendance.js]")]
end

node_employee(("Employee"))
node_administrator(("Administrator"))

node_employee -->|"signs in"| node_login
node_administrator -->|"signs in"| node_login
node_login -->|"enters routes"| node_app
node_app -->|"routes employee"| node_employee_dashboard
node_app -->|"routes employee"| node_employee_home
node_app -->|"routes employee"| node_leave_ui
node_app -->|"routes employee"| node_task_ui
node_app -->|"routes employee"| node_correction_ui
node_app -->|"routes admin"| node_admin_dashboard
node_app -->|"routes admin"| node_admin_home
node_app -->|"routes admin"| node_admin_attendance_ui
node_app -->|"routes admin"| node_admin_correction_ui
node_app -->|"routes admin"| node_admin_settings_ui
node_app -->|"routes admin"| node_admin_leave_ui
node_app -->|"routes admin"| node_admin_tasks_ui
node_app -->|"routes admin"| node_analytics_ui
node_task_ui -->|"uses"| node_auth_fetch
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_attendance_routes
node_api_server -->|"mounts"| node_working_hours
node_api_server -->|"mounts"| node_employees_routes
node_api_server -->|"mounts"| node_leave_routes
node_api_server -->|"mounts"| node_profile_routes
node_api_server -->|"mounts"| node_task_routes
node_api_server -->|"mounts"| node_analytics_routes
node_api_server -->|"mounts"| node_settings_routes
node_api_server -->|"mounts"| node_ip_routes
node_api_server -->|"mounts"| node_correction_routes
node_auth_routes -->|"reads and updates"| node_staff_model
node_auth_middleware -->|"loads user"| node_staff_model
node_attendance_routes -->|"authenticates"| node_auth_middleware
node_attendance_routes -->|"checks punch IP"| node_office_ip
node_attendance_routes -->|"reads and writes"| node_attendance_model
node_attendance_routes -->|"queries staff"| node_staff_model
node_leave_routes -->|"uses staff"| node_staff_model
node_correction_routes -->|"uses attendance"| node_attendance_model
node_correction_routes -->|"uses staff"| node_staff_model
node_task_routes -->|"uses staff"| node_staff_model
node_working_hours -->|"queries attendance"| node_attendance_model
node_ip_routes -.->|"reads settings"| node_settings_routes

click node_app "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/App.js"
click node_login "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LoginPage.js"
click node_employee_home "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/employeehome.js"
click node_employee_dashboard "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/EmployeeDashboard.js"
click node_leave_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LeaveSection.js"
click node_task_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/TaskSection.js"
click node_correction_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/EmployeeCorrectionRequest.js"
click node_admin_home "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/adminhome.js"
click node_admin_dashboard "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminDashboard.js"
click node_admin_attendance_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminAttendanceSummary.js"
click node_admin_correction_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminCorrectionPanel.js"
click node_admin_settings_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminSettingsSection.js"
click node_admin_leave_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LeaveManagementSection.js"
click node_admin_tasks_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/TaskOverviewSection.js"
click node_analytics_ui "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AnalyticsSection.js"
click node_auth_fetch "https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/utils/authFetch.js"
click node_api_server "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/server.js"
click node_auth_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/auth.js"
click node_auth_middleware "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/middleware/authenticate.js"
click node_attendance_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/attendance.js"
click node_leave_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/leave.js"
click node_correction_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/punchCorrection.js"
click node_task_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/task.js"
click node_profile_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/profile.js"
click node_employees_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/employees.js"
click node_working_hours "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/workingHours.js"
click node_office_ip "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/middleware/checkOfficeIP.js"
click node_ip_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/ipCheck.js"
click node_settings_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/adminSettings.js"
click node_analytics_routes "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/adminAnalytics.js"
click node_staff_model "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/models/Staff.js"
click node_attendance_model "https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/models/Attendance.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_login,node_employee_home,node_employee_dashboard,node_leave_ui,node_task_ui,node_correction_ui,node_admin_home,node_admin_dashboard,node_admin_attendance_ui,node_admin_correction_ui,node_admin_settings_ui,node_admin_leave_ui,node_admin_tasks_ui,node_analytics_ui toneBlue
class node_auth_fetch,node_api_server,node_auth_routes,node_auth_middleware toneAmber
class node_attendance_routes,node_leave_routes,node_correction_routes,node_task_routes,node_profile_routes,node_employees_routes,node_working_hours toneMint
class node_office_ip,node_ip_routes,node_settings_routes,node_analytics_routes toneRose
class node_staff_model,node_attendance_model,node_employee,node_administrator toneIndigo
```

## Components

### Web application

- [Role routing](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Sign in](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LoginPage.js): `frontend/src/Components/loginpage/loginpage/LoginPage.js`
- [Employee home](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/employeehome.js): `frontend/src/Components/loginpage/loginpage/employeehome.js`
- [Employee dashboard](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/EmployeeDashboard.js): `frontend/src/Components/loginpage/loginpage/EmployeeDashboard.js`
- [Leave requests](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LeaveSection.js): `frontend/src/Components/loginpage/loginpage/LeaveSection.js`
- [Task tracking](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/TaskSection.js): `frontend/src/Components/loginpage/loginpage/TaskSection.js`
- [Correction request](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/EmployeeCorrectionRequest.js): `frontend/src/Components/loginpage/loginpage/EmployeeCorrectionRequest.js`
- [Admin home](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/adminhome.js): `frontend/src/Components/loginpage/loginpage/adminhome.js`
- [Admin dashboard](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminDashboard.js): `frontend/src/Components/loginpage/loginpage/AdminDashboard.js`
- [Attendance summary](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminAttendanceSummary.js): `frontend/src/Components/loginpage/loginpage/AdminAttendanceSummary.js`
- [Correction review](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminCorrectionPanel.js): `frontend/src/Components/loginpage/loginpage/AdminCorrectionPanel.js`
- [Admin settings](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AdminSettingsSection.js): `frontend/src/Components/loginpage/loginpage/AdminSettingsSection.js`
- [Leave management](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/LeaveManagementSection.js): `frontend/src/Components/loginpage/loginpage/LeaveManagementSection.js`
- [Task overview](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/TaskOverviewSection.js): `frontend/src/Components/loginpage/loginpage/TaskOverviewSection.js`
- [Analytics](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/AnalyticsSection.js): `frontend/src/Components/loginpage/loginpage/AnalyticsSection.js`

### Identity and access

- [Authenticated fetch](https://github.com/varun-reddy-2105/ems_3.0/blob/main/frontend/src/Components/loginpage/loginpage/utils/authFetch.js): `frontend/src/Components/loginpage/loginpage/utils/authFetch.js`
- [Express API](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/server.js): `ems-backend/server.js`
- [Login and recovery](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/auth.js): `ems-backend/routes/auth.js`
- [Token verification](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/middleware/authenticate.js): `ems-backend/middleware/authenticate.js`

### Workforce operations

- [Attendance and punch](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/attendance.js): `ems-backend/routes/attendance.js`
- [Leave processing](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/leave.js): `ems-backend/routes/leave.js`
- [Punch corrections](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/punchCorrection.js): `ems-backend/routes/punchCorrection.js`
- [Task processing](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/task.js): `ems-backend/routes/task.js`
- [Staff profiles](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/profile.js): `ems-backend/routes/profile.js`
- [Employee directory](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/employees.js): `ems-backend/routes/employees.js`
- [Working hours](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/workingHours.js): `ems-backend/routes/workingHours.js`

### Administration

- [Office IP policy](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/middleware/checkOfficeIP.js): `ems-backend/middleware/checkOfficeIP.js`
- [IP configuration](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/ipCheck.js): `ems-backend/routes/ipCheck.js`
- [Admin settings](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/adminSettings.js): `ems-backend/routes/adminSettings.js`
- [Admin analytics](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/routes/adminAnalytics.js): `ems-backend/routes/adminAnalytics.js`

### Data models

- [Staff records](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/models/Staff.js): `ems-backend/models/Staff.js`
- [Attendance records](https://github.com/varun-reddy-2105/ems_3.0/blob/main/ems-backend/models/Attendance.js): `ems-backend/models/Attendance.js`

### Other components

- **Employee**
- **Administrator**

## Connections

- Employee → Sign in: signs in
- Administrator → Sign in: signs in
- Sign in → Role routing: enters routes (evidence: `frontend/src/App.js`)
- Role routing → Employee dashboard: routes employee (evidence: `frontend/src/App.js`)
- Role routing → Employee home: routes employee (evidence: `frontend/src/App.js`)
- Role routing → Leave requests: routes employee (evidence: `frontend/src/App.js`)
- Role routing → Task tracking: routes employee (evidence: `frontend/src/App.js`)
- Role routing → Correction request: routes employee (evidence: `frontend/src/App.js`)
- Role routing → Admin dashboard: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Admin home: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Attendance summary: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Correction review: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Admin settings: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Leave management: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Task overview: routes admin (evidence: `frontend/src/App.js`)
- Role routing → Analytics: routes admin (evidence: `frontend/src/App.js`)
- Task tracking → Authenticated fetch: uses (evidence: `frontend/src/Components/loginpage/loginpage/TaskSection.js`)
- Express API → Login and recovery: mounts (evidence: `ems-backend/server.js`)
- Express API → Attendance and punch: mounts (evidence: `ems-backend/server.js`)
- Express API → Working hours: mounts (evidence: `ems-backend/server.js`)
- Express API → Employee directory: mounts (evidence: `ems-backend/server.js`)
- Express API → Leave processing: mounts (evidence: `ems-backend/server.js`)
- Express API → Staff profiles: mounts (evidence: `ems-backend/server.js`)
- Express API → Task processing: mounts (evidence: `ems-backend/server.js`)
- Express API → Admin analytics: mounts (evidence: `ems-backend/server.js`)
- Express API → Admin settings: mounts (evidence: `ems-backend/server.js`)
- Express API → IP configuration: mounts (evidence: `ems-backend/server.js`)
- Express API → Punch corrections: mounts (evidence: `ems-backend/server.js`)
- Login and recovery → Staff records: reads and updates (evidence: `ems-backend/routes/auth.js`)
- Token verification → Staff records: loads user (evidence: `ems-backend/middleware/authenticate.js`)
- Attendance and punch → Token verification: authenticates (evidence: `ems-backend/routes/attendance.js`)
- Attendance and punch → Office IP policy: checks punch IP (evidence: `ems-backend/routes/attendance.js`)
- Attendance and punch → Attendance records: reads and writes (evidence: `ems-backend/routes/attendance.js`)
- Attendance and punch → Staff records: queries staff (evidence: `ems-backend/routes/attendance.js`)
- Leave processing → Staff records: uses staff (evidence: `ems-backend/routes/leave.js`)
- Punch corrections → Attendance records: uses attendance (evidence: `ems-backend/routes/punchCorrection.js`)
- Punch corrections → Staff records: uses staff (evidence: `ems-backend/routes/punchCorrection.js`)
- Task processing → Staff records: uses staff (evidence: `ems-backend/routes/task.js`)
- Working hours → Attendance records: queries attendance (evidence: `ems-backend/routes/workingHours.js`)
- IP configuration → Admin settings: reads settings
