How musharafam/payroll-employee-management-system works
This is a Sri Lankan payroll and HR management system: users authenticate, enter a role-protected dashboard, and use it for employee, attendance, payroll, and related HR tasks. The documented attendance workflow uploads NGTimereport spreadsheets for parsing and hour calculations; payroll supports configurable rules and salary processing, while PDF payslips are planned. The graph preserves major frontend and backend capabilities. Several backend handler connections are documented only at a product level, so their internal call and persistence relationships are not asserted.
Main entry points: App.tsx Route access · routes.go HTTP routes · Login.tsx Login · Dashboard.tsx Dashboard shell
Components 32
Frontend experience
- Login
frontend/src/pages/Login.tsx - Route access
frontend/src/App.tsx - Dashboard shell
frontend/src/pages/Dashboard.tsx - API hook
frontend/src/hooks/useApi.ts - API client and types
frontend/src/lib/api.ts
Backend API
- Attendance parsers
backend/parsers/ngtimereport.go - HTTP routes
backend/routes/routes.go - User sync API
backend/handlers/auth.go
HR operations
- Employee management
frontend/src/components/AdminEmployees.tsx - Attendance management
frontend/src/components/AdminAttendance.tsx - Leave requests
frontend/src/components/AdminLeaveRequests.tsx - Holiday management
frontend/src/components/AdminHolidays.tsx - Exit management
frontend/src/components/AdminExitManagement.tsx - Performance reviews
frontend/src/components/AdminPerformanceReviews.tsx - Disciplinary records
frontend/src/components/DisciplinaryModal.tsx - Advance loans
backend/handlers/advance_loan.go - Attendance API
backend/handlers/attendance.go - Leave API
backend/handlers/leave.go - Exit API
backend/handlers/exit.go - Performance API
backend/handlers/performance.go
Payroll operations
- Payroll workspace
frontend/src/components/AdminPayroll.tsx - Payroll settings
frontend/src/components/AdminSettings.tsx - Payroll overview
frontend/src/components/ManagerOverview.tsx - Payslip PDF
frontend/src/lib/pdf.ts - Payroll calculation API
backend/handlers/payroll.go - Payroll rules API
backend/handlers/payroll_settings.go
Identity and storage
- Token middleware
backend/middleware/auth.go - Asgardeo verification
backend/services/asgardeo.go - GORM database
backend/database/database.go
Other components
- Employee or admin
- Asgardeo identity
- PostgreSQL
Connections 30
- Employee or admin → Login: signs in
frontend/src/pages/Login.tsx - Login → Asgardeo identity: starts SSO
frontend/src/pages/Login.tsx - Login → Route access: navigates
frontend/src/pages/Login.tsx - Route access → Dashboard shell: routes to
frontend/src/App.tsx - Route access → Employee management: routes to
frontend/src/App.tsx - Route access → Attendance management: routes to
frontend/src/App.tsx - Route access → Payroll workspace: routes to
frontend/src/App.tsx - Route access → Leave requests: routes to
frontend/src/App.tsx - Route access → Holiday management: routes to
frontend/src/App.tsx - Route access → Exit management: routes to
frontend/src/App.tsx - Route access → Performance reviews: routes to
frontend/src/App.tsx - Route access → Payroll settings: routes to
frontend/src/App.tsx - Route access → Payroll overview: routes to
frontend/src/App.tsx - Dashboard shell → API hook: requests through
frontend/src/pages/Dashboard.tsx - API hook → API client and types: creates client
frontend/src/hooks/useApi.ts - Dashboard shell → User sync API: syncs user
frontend/src/pages/Dashboard.tsx - API client and types → HTTP routes: calls REST API
README.md - HTTP routes → User sync API: routes requests
- HTTP routes → Attendance API: routes requests
- HTTP routes → Payroll calculation API: routes requests
- HTTP routes → Payroll rules API: routes requests
- Token middleware → Asgardeo verification: verifies tokens
- Attendance API → Attendance parsers: parses upload
- Attendance management → Attendance parsers: uploads timecards
README.md - Employee management → Employee or admin: manages records
README.md - Payroll workspace → Payroll calculation API: requests calculation
- Payroll settings → Payroll rules API: configures rules
README.md - Payroll workspace → Payslip PDF: downloads payslips
- Payroll overview → Payroll calculation API: summarizes payroll
- GORM database → PostgreSQL: connects to
README.md