# pathak26parth/odoo-hackathon-2026-grand-finale architecture

> Architecture diagram of the GitHub repository pathak26parth/odoo-hackathon-2026-grand-finale, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pathak26parth/odoo-hackathon-2026-grand-finale
- Repository: https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale

## Overview

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: [`backend/src/routes`](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/tree/main/backend/src/routes) (REST routes), [`backend/src/config/db.js`](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/config/db.js) (PeoplePay360 records), [`frontend/src/App.jsx`](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/App.jsx) (React application), [`backend/src/services/authService.js`](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/authService.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_spa["React application<br/>[App.jsx]"]
  node_session["Session and RBAC<br/>[AuthContext.jsx]"]
  node_ui["HR and self-service screens"]
  node_webapi["API client and services<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_routes["REST routes"]
  node_auth["Authentication<br/>[authService.js]"]
  node_notifications["Notifications"]
end

subgraph group_workforce["Workforce operations"]
  node_workforceops["Employee and contract records"]
  node_schedules["Work schedules"]
  node_timeoff["Time-off management<br/>[timeOffService.js]"]
  node_attendance["Attendance operations"]
  node_dashboard["Dashboards and reports"]
end

subgraph group_payroll["Payroll operations"]
  node_payrolladmin["Salary rules and structures"]
  node_payrun["Payruns and payslips<br/>[payrollService.js]"]
end

subgraph group_integrations["Data and integrations"]
  node_mysql[("PeoplePay360 records<br/>[db.js]")]
  node_biometric["Face biometrics service<br/>[service.py]"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_cloud["Cloud image storage"]
end

node_employee(("Employee or HR user"))
node_mailservice["SMTP mail service"]
node_cloudservice["Cloudinary"]

node_employee -->|"uses"| node_spa
node_spa -->|"provides session"| node_session
node_spa -->|"routes to"| node_ui
node_ui -.->|"requests data"| node_webapi
node_session -->|"auth requests"| node_webapi
node_webapi -->|"REST requests"| node_routes
node_routes -.->|"dispatches auth"| node_auth
node_routes -->|"dispatches"| node_workforceops
node_routes -->|"dispatches"| node_attendance
node_routes -.->|"dispatches"| node_schedules
node_routes -.->|"dispatches"| node_timeoff
node_routes -.->|"dispatches"| node_payrolladmin
node_routes -.->|"dispatches"| node_payrun
node_routes -.->|"dispatches"| node_dashboard
node_routes -.->|"dispatches"| node_notifications
node_workforceops -->|"queries"| node_mysql
node_attendance -->|"queries"| node_mysql
node_attendance -->|"verifies face"| node_biometric
node_payrolladmin -.->|"stores rules"| node_mysql
node_payrun -.->|"stores payruns"| node_mysql
node_dashboard -->|"aggregates data"| node_mysql
node_auth -->|"queries"| node_mysql
node_auth -->|"sends invitations"| node_email
node_email -.->|"delivers mail"| node_mailservice
node_workforceops -->|"stores images"| node_cloud
node_cloud -.->|"uploads media"| node_cloudservice
node_notifications -.->|"stores notifications"| node_mysql

click node_spa "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/App.jsx"
click node_session "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/context/AuthContext.jsx"
click node_ui "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/tree/main/frontend/src/pages"
click node_webapi "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/services/api.js"
click node_routes "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/tree/main/backend/src/routes"
click node_auth "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/authService.js"
click node_workforceops "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/employeeController.js"
click node_schedules "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/scheduleController.js"
click node_timeoff "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/timeOffService.js"
click node_attendance "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/attendanceController.js"
click node_payrolladmin "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/payrollAdminService.js"
click node_payrun "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/payrollService.js"
click node_dashboard "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/dashboardController.js"
click node_notifications "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/notificationController.js"
click node_mysql "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/config/db.js"
click node_biometric "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/AI/face/service.py"
click node_email "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/emailService.js"
click node_cloud "https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/cloudinaryService.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_spa,node_session,node_ui,node_webapi,node_employee toneBlue
class node_routes,node_auth,node_notifications toneAmber
class node_workforceops,node_schedules,node_timeoff,node_attendance,node_dashboard toneMint
class node_payrolladmin,node_payrun toneRose
class node_mysql,node_biometric,node_email,node_cloud,node_mailservice,node_cloudservice toneIndigo
```

## Components

### Web application

- [React application](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session and RBAC](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [HR and self-service screens](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client and services](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [REST routes](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/tree/main/backend/src/routes): `backend/src/routes`
- [Authentication](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Notifications](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/notificationController.js): `backend/src/controllers/notificationController.js`

### Workforce operations

- [Employee and contract records](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/employeeController.js): `backend/src/controllers/employeeController.js`
- [Work schedules](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/scheduleController.js): `backend/src/controllers/scheduleController.js`
- [Time-off management](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/timeOffService.js): `backend/src/services/timeOffService.js`
- [Attendance operations](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/attendanceController.js): `backend/src/controllers/attendanceController.js`
- [Dashboards and reports](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/controllers/dashboardController.js): `backend/src/controllers/dashboardController.js`

### Payroll operations

- [Salary rules and structures](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/payrollAdminService.js): `backend/src/services/payrollAdminService.js`
- [Payruns and payslips](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/payrollService.js): `backend/src/services/payrollService.js`

### Data and integrations

- [PeoplePay360 records](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [Face biometrics service](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/AI/face/service.py): `AI/face/service.py`
- [Email delivery](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/emailService.js): `backend/src/services/emailService.js`
- [Cloud image storage](https://github.com/pathak26parth/odoo-hackathon-2026-grand-finale/blob/main/backend/src/services/cloudinaryService.js): `backend/src/services/cloudinaryService.js`

### Other components

- **Employee or HR user**
- **SMTP mail service**
- **Cloudinary**

## Connections

- Employee or HR user → React application: uses
- React application → Session and RBAC: provides session (evidence: `frontend/src/App.jsx`)
- React application → HR and self-service screens: routes to (evidence: `frontend/src/App.jsx`)
- HR and self-service screens → API client and services: requests data
- Session and RBAC → API client and services: auth requests (evidence: `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 (evidence: `backend/src/routes/employeeRoutes.js`)
- REST routes → Attendance operations: dispatches (evidence: `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 (evidence: `backend/src/controllers/employeeController.js`)
- Attendance operations → PeoplePay360 records: queries (evidence: `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 (evidence: `backend/src/controllers/dashboardController.js`)
- Authentication → PeoplePay360 records: queries (evidence: `backend/src/services/authService.js`)
- Authentication → Email delivery: sends invitations (evidence: `backend/src/services/authService.js`)
- Email delivery → SMTP mail service: delivers mail
- Employee and contract records → Cloud image storage: stores images (evidence: `backend/src/controllers/employeeController.js`)
- Cloud image storage → Cloudinary: uploads media
- Notifications → PeoplePay360 records: stores notifications
