How pathak26parth/odoo-hackathon-2026-grand-finale works
PeoplePay360 is an HR and payroll platform whose user workflow runs from role-based access in the React application through REST operations in the Express backend to workforce records and operational results in MySQL. Major domain stages include employee and contract management, schedules and time off, biometric attendance, and payroll and payslip delivery; dashboards and notifications provide supporting operations. The README documents the three-tier design and biometric service integration. Some domain implementation paths are included from the tree, but their internal call chains were not sampled, so those links are not asserted.
Main entry points: routes REST routes · db.js PeoplePay360 records · App.jsx React application · authService.js Authentication
Components 21
Web application
- React application
frontend/src/App.jsx - Session and RBAC
frontend/src/context/AuthContext.jsx - HR and self-service screens
frontend/src/pages - API client and services
frontend/src/services/api.js
Backend API
- REST routes
backend/src/routes - Authentication
backend/src/services/authService.js - Notifications
backend/src/controllers/notificationController.js
Workforce operations
- Employee and contract records
backend/src/controllers/employeeController.js - Work schedules
backend/src/controllers/scheduleController.js - Time-off management
backend/src/services/timeOffService.js - Attendance operations
backend/src/controllers/attendanceController.js - Dashboards and reports
backend/src/controllers/dashboardController.js
Payroll operations
- Salary rules and structures
backend/src/services/payrollAdminService.js - Payruns and payslips
backend/src/services/payrollService.js
Data and integrations
- PeoplePay360 records
backend/src/config/db.js - Face biometrics service
AI/face/service.py - Email delivery
backend/src/services/emailService.js - Cloud image storage
backend/src/services/cloudinaryService.js
Other components
- Employee or HR user
- SMTP mail service
- Cloudinary
Connections 27
- Employee or HR user → React application: uses
- React application → Session and RBAC: provides session
frontend/src/App.jsx - React application → HR and self-service screens: routes to
frontend/src/App.jsx - HR and self-service screens → API client and services: requests data
- Session and RBAC → API client and services: auth requests
frontend/src/context/AuthContext.jsx - API client and services → REST routes: REST requests
- REST routes → Authentication: dispatches auth
- REST routes → Employee and contract records: dispatches
backend/src/routes/employeeRoutes.js - REST routes → Attendance operations: dispatches
backend/src/routes/attendanceRoutes.js - REST routes → Work schedules: dispatches
- REST routes → Time-off management: dispatches
- REST routes → Salary rules and structures: dispatches
- REST routes → Payruns and payslips: dispatches
- REST routes → Dashboards and reports: dispatches
- REST routes → Notifications: dispatches
- Employee and contract records → PeoplePay360 records: queries
backend/src/controllers/employeeController.js - Attendance operations → PeoplePay360 records: queries
backend/src/controllers/attendanceController.js - Attendance operations → Face biometrics service: verifies face
- Salary rules and structures → PeoplePay360 records: stores rules
- Payruns and payslips → PeoplePay360 records: stores payruns
- Dashboards and reports → PeoplePay360 records: aggregates data
backend/src/controllers/dashboardController.js - Authentication → PeoplePay360 records: queries
backend/src/services/authService.js - Authentication → Email delivery: sends invitations
backend/src/services/authService.js - Email delivery → SMTP mail service: delivers mail
- Employee and contract records → Cloud image storage: stores images
backend/src/controllers/employeeController.js - Cloud image storage → Cloudinary: uploads media
- Notifications → PeoplePay360 records: stores notifications