# omarmousa1/employee-management architecture

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

- Interactive diagram: https://gitdiagram.com/omarmousa1/employee-management
- Repository: https://github.com/omarmousa1/employee-management

## Overview

This is a role-based employee management application. Admins manage employee accounts and departments, assign tasks, review leave and loan requests, and view dashboards and reports; employees activate accounts, maintain profiles, submit requests, and update task status. The frontend routes users into role-specific pages, which communicate with an Express API backed by MongoDB models. The task-management UI’s API calls are shown directly; several other page-to-API interactions and backend route/controller relationships are represented only where the source index or excerpts support them.

Main entry points: [`backend/server.js`](https://github.com/omarmousa1/employee-management/blob/main/backend/server.js) (HTTP server), [`backend/controllers/dashboardController.js`](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/dashboardController.js) (Dashboard data), [`frontend/src/App.js`](https://github.com/omarmousa1/employee-management/blob/main/frontend/src/App.js) (Role routing), [`backend/controllers/reportController.js`](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/reportController.js) (PDF reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Role routing<br/>[App.js]"]
  node_authui["Login and activation"]
  node_adminui["Admin workspace"]
  node_employeeui["Employee workspace"]
  node_authstate["Auth state<br/>[AuthContext.js]"]
  node_transport["API client<br/>[axios.js]"]
end

subgraph group_api["API and access"]
  node_server["HTTP server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_guard["Access control<br/>[auth.js]"]
end

subgraph group_people["People administration"]
  node_employees["Employee management"]
  node_departments["Department management"]
  node_email["Email delivery<br/>[emailService.js]"]
end

subgraph group_work["Work and requests"]
  node_workflows["Tasks and requests"]
  node_dashboard["Dashboard data"]
  node_reports["PDF reports"]
end

subgraph group_data["Persistence and reporting"]
  node_users[("User records<br/>[User.js]")]
  node_departmentsdata[("Department records<br/>[Department.js]")]
  node_leavesdata[("Leave records<br/>[LeaveRequest.js]")]
  node_loansdata[("Loan records<br/>[LoanRequest.js]")]
  node_tasksdata[("Task records<br/>[Task.js]")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_employeeui
node_app -->|"checks identity"| node_authstate
node_authstate -->|"requests identity"| node_transport
node_authstate -->|"calls auth API"| node_auth
node_adminui -->|"calls task API"| node_transport
node_employeeui -.->|"uses API client"| node_transport
node_authui -.->|"uses API client"| node_transport
node_transport -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts employee routes"| node_employees
node_server -->|"mounts department routes"| node_departments
node_server -->|"mounts task and request routes"| node_workflows
node_server -->|"mounts dashboard routes"| node_dashboard
node_server -->|"mounts report routes"| node_reports
node_authroutes -->|"dispatches to"| node_auth
node_authroutes -->|"protects routes"| node_guard
node_guard -->|"loads user"| node_users
node_guard -->|"verifies token"| node_auth
node_employees -->|"reads and writes"| node_users
node_employees -->|"sends activation"| node_email
node_departments -->|"reads and writes"| node_departmentsdata
node_departments -->|"uses employee data"| node_users
node_workflows -->|"manages tasks"| node_tasksdata
node_workflows -->|"manages leave"| node_leavesdata
node_workflows -->|"manages loans"| node_loansdata
node_dashboard -->|"reads"| node_users
node_dashboard -->|"reads"| node_departmentsdata
node_dashboard -->|"reads"| node_tasksdata
node_dashboard -->|"reads"| node_leavesdata
node_dashboard -->|"reads"| node_loansdata
node_reports -->|"reads"| node_users
node_reports -->|"reads"| node_leavesdata
node_reports -->|"reads"| node_loansdata
node_reports -->|"reads"| node_tasksdata

click node_app "https://github.com/omarmousa1/employee-management/blob/main/frontend/src/App.js"
click node_authui "https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/auth"
click node_adminui "https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/admin"
click node_employeeui "https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/employee"
click node_authstate "https://github.com/omarmousa1/employee-management/blob/main/frontend/src/context/AuthContext.js"
click node_transport "https://github.com/omarmousa1/employee-management/blob/main/frontend/src/api/axios.js"
click node_server "https://github.com/omarmousa1/employee-management/blob/main/backend/server.js"
click node_authroutes "https://github.com/omarmousa1/employee-management/blob/main/backend/routes/authRoutes.js"
click node_auth "https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/authController.js"
click node_guard "https://github.com/omarmousa1/employee-management/blob/main/backend/middleware/auth.js"
click node_employees "https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/employeeController.js"
click node_departments "https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/departmentController.js"
click node_workflows "https://github.com/omarmousa1/employee-management/tree/main/backend/controllers"
click node_dashboard "https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/dashboardController.js"
click node_reports "https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/reportController.js"
click node_users "https://github.com/omarmousa1/employee-management/blob/main/backend/models/User.js"
click node_departmentsdata "https://github.com/omarmousa1/employee-management/blob/main/backend/models/Department.js"
click node_leavesdata "https://github.com/omarmousa1/employee-management/blob/main/backend/models/LeaveRequest.js"
click node_loansdata "https://github.com/omarmousa1/employee-management/blob/main/backend/models/LoanRequest.js"
click node_tasksdata "https://github.com/omarmousa1/employee-management/blob/main/backend/models/Task.js"
click node_email "https://github.com/omarmousa1/employee-management/blob/main/backend/services/emailService.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_adminui,node_employeeui,node_authstate,node_transport,node_user toneBlue
class node_server,node_authroutes,node_auth,node_guard toneAmber
class node_employees,node_departments,node_email toneMint
class node_workflows,node_dashboard,node_reports toneRose
class node_users,node_departmentsdata,node_leavesdata,node_loansdata,node_tasksdata toneIndigo
```

## Components

### Web client

- [Role routing](https://github.com/omarmousa1/employee-management/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Login and activation](https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Admin workspace](https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Employee workspace](https://github.com/omarmousa1/employee-management/tree/main/frontend/src/pages/employee): `frontend/src/pages/employee`
- [Auth state](https://github.com/omarmousa1/employee-management/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [API client](https://github.com/omarmousa1/employee-management/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### API and access

- [HTTP server](https://github.com/omarmousa1/employee-management/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/omarmousa1/employee-management/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Access control](https://github.com/omarmousa1/employee-management/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### People administration

- [Employee management](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/employeeController.js): `backend/controllers/employeeController.js`
- [Department management](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/departmentController.js): `backend/controllers/departmentController.js`
- [Email delivery](https://github.com/omarmousa1/employee-management/blob/main/backend/services/emailService.js): `backend/services/emailService.js`

### Work and requests

- [Tasks and requests](https://github.com/omarmousa1/employee-management/tree/main/backend/controllers): `backend/controllers`
- [Dashboard data](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`
- [PDF reports](https://github.com/omarmousa1/employee-management/blob/main/backend/controllers/reportController.js): `backend/controllers/reportController.js`

### Persistence and reporting

- [User records](https://github.com/omarmousa1/employee-management/blob/main/backend/models/User.js): `backend/models/User.js`
- [Department records](https://github.com/omarmousa1/employee-management/blob/main/backend/models/Department.js): `backend/models/Department.js`
- [Leave records](https://github.com/omarmousa1/employee-management/blob/main/backend/models/LeaveRequest.js): `backend/models/LeaveRequest.js`
- [Loan records](https://github.com/omarmousa1/employee-management/blob/main/backend/models/LoanRequest.js): `backend/models/LoanRequest.js`
- [Task records](https://github.com/omarmousa1/employee-management/blob/main/backend/models/Task.js): `backend/models/Task.js`

### Other components

- **User**

## Connections

- User → Role routing: uses (evidence: `frontend/src/App.js`)
- Role routing → Login and activation: routes to (evidence: `frontend/src/App.js`)
- Role routing → Admin workspace: routes to (evidence: `frontend/src/App.js`)
- Role routing → Employee workspace: routes to (evidence: `frontend/src/App.js`)
- Role routing → Auth state: checks identity (evidence: `frontend/src/App.js`)
- Auth state → API client: requests identity (evidence: `frontend/src/context/AuthContext.js`)
- Auth state → Authentication: calls auth API (evidence: `frontend/src/context/AuthContext.js`)
- Admin workspace → API client: calls task API (evidence: `frontend/src/pages/admin/Tasks.js`)
- Employee workspace → API client: uses API client (evidence: `frontend/src/pages/employee/Tasks.js`)
- Login and activation → API client: uses API client (evidence: `frontend/src/pages/auth/Activate.js`)
- API client → HTTP server: sends requests (evidence: `frontend/src/api/axios.js`)
- HTTP server → Auth routes: mounts routes (evidence: `backend/server.js`)
- HTTP server → Employee management: mounts employee routes (evidence: `backend/server.js`)
- HTTP server → Department management: mounts department routes (evidence: `backend/server.js`)
- HTTP server → Tasks and requests: mounts task and request routes (evidence: `backend/server.js`)
- HTTP server → Dashboard data: mounts dashboard routes (evidence: `backend/server.js`)
- HTTP server → PDF reports: mounts report routes (evidence: `backend/server.js`)
- Auth routes → Authentication: dispatches to (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Access control: protects routes (evidence: `backend/routes/authRoutes.js`)
- Access control → User records: loads user (evidence: `backend/middleware/auth.js`)
- Access control → Authentication: verifies token (evidence: `backend/middleware/auth.js`)
- Employee management → User records: reads and writes (evidence: `backend/controllers/employeeController.js`)
- Employee management → Email delivery: sends activation (evidence: `backend/controllers/employeeController.js`)
- Department management → Department records: reads and writes (evidence: `backend/controllers/departmentController.js`)
- Department management → User records: uses employee data (evidence: `backend/controllers/departmentController.js`)
- Tasks and requests → Task records: manages tasks (evidence: `backend/controllers/taskController.js`)
- Tasks and requests → Leave records: manages leave (evidence: `backend/controllers/leaveController.js`)
- Tasks and requests → Loan records: manages loans (evidence: `backend/controllers/loanController.js`)
- Dashboard data → User records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Department records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Task records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Leave records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Loan records: reads (evidence: `backend/controllers/dashboardController.js`)
- PDF reports → User records: reads (evidence: `backend/controllers/reportController.js`)
- PDF reports → Leave records: reads (evidence: `backend/controllers/reportController.js`)
- PDF reports → Loan records: reads (evidence: `backend/controllers/reportController.js`)
- PDF reports → Task records: reads (evidence: `backend/controllers/reportController.js`)
