How omarmousa1/employee-management works
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: server.js HTTP server · dashboardController.js Dashboard data · App.js Role routing · reportController.js PDF reports
Components 22
Web client
- Role routing
frontend/src/App.js - Login and activation
frontend/src/pages/auth - Admin workspace
frontend/src/pages/admin - Employee workspace
frontend/src/pages/employee - Auth state
frontend/src/context/AuthContext.js - API client
frontend/src/api/axios.js
API and access
- HTTP server
backend/server.js - Auth routes
backend/routes/authRoutes.js - Authentication
backend/controllers/authController.js - Access control
backend/middleware/auth.js
People administration
- Employee management
backend/controllers/employeeController.js - Department management
backend/controllers/departmentController.js - Email delivery
backend/services/emailService.js
Work and requests
- Tasks and requests
backend/controllers - Dashboard data
backend/controllers/dashboardController.js - PDF reports
backend/controllers/reportController.js
Persistence and reporting
- User records
backend/models/User.js - Department records
backend/models/Department.js - Leave records
backend/models/LeaveRequest.js - Loan records
backend/models/LoanRequest.js - Task records
backend/models/Task.js
Other components
- User
Connections 37
- User → Role routing: uses
frontend/src/App.js - Role routing → Login and activation: routes to
frontend/src/App.js - Role routing → Admin workspace: routes to
frontend/src/App.js - Role routing → Employee workspace: routes to
frontend/src/App.js - Role routing → Auth state: checks identity
frontend/src/App.js - Auth state → API client: requests identity
frontend/src/context/AuthContext.js - Auth state → Authentication: calls auth API
frontend/src/context/AuthContext.js - Admin workspace → API client: calls task API
frontend/src/pages/admin/Tasks.js - Employee workspace → API client: uses API client
frontend/src/pages/employee/Tasks.js - Login and activation → API client: uses API client
frontend/src/pages/auth/Activate.js - API client → HTTP server: sends requests
frontend/src/api/axios.js - HTTP server → Auth routes: mounts routes
backend/server.js - HTTP server → Employee management: mounts employee routes
backend/server.js - HTTP server → Department management: mounts department routes
backend/server.js - HTTP server → Tasks and requests: mounts task and request routes
backend/server.js - HTTP server → Dashboard data: mounts dashboard routes
backend/server.js - HTTP server → PDF reports: mounts report routes
backend/server.js - Auth routes → Authentication: dispatches to
backend/routes/authRoutes.js - Auth routes → Access control: protects routes
backend/routes/authRoutes.js - Access control → User records: loads user
backend/middleware/auth.js - Access control → Authentication: verifies token
backend/middleware/auth.js - Employee management → User records: reads and writes
backend/controllers/employeeController.js - Employee management → Email delivery: sends activation
backend/controllers/employeeController.js - Department management → Department records: reads and writes
backend/controllers/departmentController.js - Department management → User records: uses employee data
backend/controllers/departmentController.js - Tasks and requests → Task records: manages tasks
backend/controllers/taskController.js - Tasks and requests → Leave records: manages leave
backend/controllers/leaveController.js - Tasks and requests → Loan records: manages loans
backend/controllers/loanController.js - Dashboard data → User records: reads
backend/controllers/dashboardController.js - Dashboard data → Department records: reads
backend/controllers/dashboardController.js - Dashboard data → Task records: reads
backend/controllers/dashboardController.js - Dashboard data → Leave records: reads
backend/controllers/dashboardController.js - Dashboard data → Loan records: reads
backend/controllers/dashboardController.js - PDF reports → User records: reads
backend/controllers/reportController.js - PDF reports → Leave records: reads
backend/controllers/reportController.js - PDF reports → Loan records: reads
backend/controllers/reportController.js - PDF reports → Task records: reads
backend/controllers/reportController.js