How mettlebyte-technologies/workhub works
This is a workforce-management application with a React frontend and a TypeScript backend. Users authenticate and reach role/onboarding-guarded screens, then manage employees, leave and attendance, projects and work logs, and payroll and finance. Backend controllers delegate to domain services; indexed references show several services using repositories, while payroll also generates downloadable exports. Frontend-to-backend HTTP wiring and server route registration were not shown, so those links are marked unverified rather than asserted.
Main entry points: app Product screens · employee.service.ts Employee service · App.tsx Route guards · payroll.controller.ts Payroll controller
Components 28
Web application
- Route guards
frontend/src/App.tsx - Product screens
frontend/src/app - Auth state
frontend/src/hooks/use-auth.ts
Identity and workforce
- Auth controller
backend/src/modules/auth/auth.service.ts - Auth repository
backend/src/modules/auth/auth.repository.ts - Employee controller
backend/src/modules/employees/employee.controller.ts - Employee service
backend/src/modules/employees/employee.service.ts - Employee repository
backend/src/modules/employees/employee.repository.ts - File service
backend/src/modules/files/file.service.ts
Time and projects
- Attendance service
backend/src/modules/attendance/attendance.service.ts - Holiday controller
backend/src/modules/holidays/holiday.controller.ts - Holiday service
backend/src/modules/holidays/holiday.service.ts - Holiday repository
backend/src/modules/holidays/holiday.repository.ts - Leave controller
backend/src/modules/leaves/leave.controller.ts - Leave service
backend/src/modules/leaves/leave.service.ts - Leave adjustments
backend/src/modules/leave-adjustment/leave-adjustment.service.ts - Project controller
backend/src/modules/projects/project.controller.ts - Project service
backend/src/modules/projects/project.service.ts - Task service
backend/src/modules/tasks/task.service.ts - Work-log service
backend/src/modules/work-logs/work-log.service.ts
Payroll and finance
- Payroll controller
backend/src/modules/payroll/payroll.controller.ts - Payroll service
backend/src/modules/payroll/payroll.service.ts - Excel builder
backend/src/shared/file-generation/excel-builder.service.ts - Finance controller
backend/src/modules/finance/finance.controller.ts - Finance service
backend/src/modules/finance/finance.service.ts - Payroll slips
backend/src/modules/payroll-slips/payroll-slip.service.ts - Salary components
backend/src/modules/salary-component/salary-component.service.ts
Other components
- Employee or admin
Connections 34
- Employee or admin → Route guards: uses
frontend/src/App.tsx - Route guards → Auth state: checks auth
frontend/src/App.tsx - Route guards → Product screens: routes to
frontend/src/App.tsx - Employee or admin → Product screens: manages workforce
- Product screens → Auth controller: requests auth
- Product screens → Employee controller: requests employee data
- Product screens → Attendance service: requests attendance
- Product screens → Holiday controller: requests holidays
- Product screens → Leave controller: requests leave
- Product screens → Leave adjustments: requests adjustments
- Product screens → Project controller: requests projects
- Product screens → Task service: requests tasks
- Product screens → Work-log service: requests work logs
- Product screens → Payroll controller: requests payroll
- Product screens → Finance controller: requests finance
- Product screens → Payroll slips: requests payslips
- Product screens → Salary components: requests components
- Auth controller → Auth repository: queries
backend/src/modules/auth/auth.service.ts - Employee controller → Employee service: delegates to
backend/src/modules/employees/employee.controller.ts - Employee service → Employee repository: uses
backend/src/modules/employees/employee.service.ts - Employee service → Auth repository: uses
backend/src/modules/employees/employee.service.ts - Employee service → File service: uses
backend/src/modules/employees/employee.service.ts - Attendance service → Employee service: uses
- Holiday controller → Holiday service: delegates to
backend/src/modules/holidays/holiday.controller.ts - Holiday service → Holiday repository: uses
backend/src/modules/holidays/holiday.service.ts - Leave controller → Leave service: delegates to
backend/src/modules/leaves/leave.controller.ts - Leave service → Employee service: uses
- Project controller → Project service: delegates to
backend/src/modules/projects/project.controller.ts - Task service → Project service: uses
- Work-log service → Project service: uses
- Payroll controller → Payroll service: delegates to
backend/src/modules/payroll/payroll.controller.ts - Payroll controller → Excel builder: builds exports
backend/src/modules/payroll/payroll.controller.ts - Finance controller → Finance service: delegates to
backend/src/modules/finance/finance.controller.ts - Finance service → Employee repository: uses
backend/src/modules/finance/finance.service.ts