# abrar-0609/project_contract_labour_management architecture

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

- Interactive diagram: https://gitdiagram.com/abrar-0609/project_contract_labour_management
- Repository: https://github.com/abrar-0609/project_contract_labour_management

## Overview

This is a role-based contract-labour management web application: admins manage contractors and projects, contractors manage workers and daily operations, and workers view their own work and payroll. The principal workflow moves from contractor/project setup through worker assignment, attendance and leave, to contractor and worker payments. The graph combines documented capabilities with sampled frontend routing and backend service/repository references; several controller-to-service links and unsampled modules are shown only where the README supports them.

Main entry points: [`frontend/src/pages/Login.jsx`](https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/pages/Login.jsx) (Login page), [`backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java`](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java) (Worker payments), [`frontend/src/App.jsx`](https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/App.jsx) (Role routes), [`backend/src/main/java/com/contractlabour/management/service/AssignmentService.java`](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/AssignmentService.java) (Worker assignments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and routing"]
  node_web_routes["Role routes<br/>[App.jsx]"]
  node_login_ui["Login page<br/>[Login.jsx]"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
end

subgraph group_setup["Workforce setup"]
  node_contractor_setup["Contractor management"]
  node_project_setup["Project management"]
  node_worker_setup["Worker management<br/>[WorkerService.java]"]
  node_assignment["Worker assignments"]
end

subgraph group_operations["Work operations"]
  node_attendance["Attendance"]
  node_leave["Leave requests"]
end

subgraph group_payments["Payments"]
  node_worker_payroll["Worker payments"]
  node_contractor_payments["Contractor payments"]
  node_cashfree_api["Cashfree payment API"]
  node_cashfree_service["Cashfree integration"]
end

subgraph group_data["Persistence"]
  node_worker_store[("Worker records")]
  node_assignment_store[("Assignment records")]
  node_attendance_store[("Attendance records")]
  node_leave_store[("Leave records")]
  node_payment_store[("Worker payment records")]
end

node_admin(("Admin"))
node_contractor(("Contractor"))
node_worker(("Worker"))
node_cashfree["Cashfree gateway"]

node_admin -->|"signs in"| node_login_ui
node_contractor -->|"signs in"| node_login_ui
node_worker -->|"signs in"| node_login_ui
node_login_ui -.->|"authenticates"| node_auth_api
node_auth_api -->|"validates credentials"| node_auth_service
node_web_routes -->|"routes to"| node_login_ui
node_admin -->|"manages contractors"| node_contractor_setup
node_admin -->|"manages projects"| node_project_setup
node_contractor -->|"manages workers"| node_worker_setup
node_contractor -->|"assigns workers"| node_assignment
node_assignment -->|"reads and writes"| node_assignment_store
node_assignment -->|"reads workers"| node_worker_store
node_contractor -->|"marks attendance"| node_attendance
node_attendance -.->|"records attendance"| node_attendance_store
node_worker -->|"requests leave"| node_leave
node_contractor -->|"reviews leave"| node_leave
node_leave -->|"reads and writes"| node_leave_store
node_worker -->|"views payroll"| node_worker_payroll
node_contractor -->|"pays workers"| node_worker_payroll
node_worker_payroll -->|"reads and writes"| node_payment_store
node_admin -->|"pays contractors"| node_contractor_payments
node_contractor -.->|"initiates payment"| node_cashfree_api
node_cashfree_api -->|"delegates payment"| node_cashfree_service
node_cashfree_service -.->|"creates gateway orders"| node_cashfree
node_cashfree_api -->|"updates payment"| node_worker_payroll
node_web_routes -.->|"routes to"| node_contractor_setup
node_web_routes -.->|"routes to"| node_project_setup

click node_web_routes "https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/App.jsx"
click node_login_ui "https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/pages/Login.jsx"
click node_auth_api "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/AuthController.java"
click node_auth_service "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/AuthService.java"
click node_contractor_setup "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ContractorController.java"
click node_project_setup "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ProjectController.java"
click node_worker_setup "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/WorkerService.java"
click node_assignment "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/AssignmentService.java"
click node_attendance "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/AttendanceController.java"
click node_leave "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/LeaveRequestService.java"
click node_worker_payroll "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java"
click node_contractor_payments "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ContractorPaymentController.java"
click node_cashfree_api "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/CashfreePaymentController.java"
click node_cashfree_service "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/CashfreePaymentService.java"
click node_worker_store "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/WorkerRepository.java"
click node_assignment_store "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/AssignmentRepository.java"
click node_attendance_store "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/AttendanceRepository.java"
click node_leave_store "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/LeaveRequestRepository.java"
click node_payment_store "https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/WorkerPaymentRepository.java"

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_web_routes,node_login_ui,node_auth_api,node_auth_service toneBlue
class node_contractor_setup,node_project_setup,node_worker_setup,node_assignment toneAmber
class node_attendance,node_leave toneMint
class node_worker_payroll,node_contractor_payments,node_cashfree_api,node_cashfree_service,node_worker toneRose
class node_worker_store,node_assignment_store,node_attendance_store,node_leave_store,node_payment_store,node_admin,node_contractor,node_cashfree toneIndigo
```

## Components

### Access and routing

- [Role routes](https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login page](https://github.com/abrar-0609/project_contract_labour_management/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Authentication API](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/AuthController.java): `backend/src/main/java/com/contractlabour/management/controller/AuthController.java`
- [Authentication](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/AuthService.java): `backend/src/main/java/com/contractlabour/management/service/AuthService.java`

### Workforce setup

- [Contractor management](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ContractorController.java): `backend/src/main/java/com/contractlabour/management/controller/ContractorController.java`
- [Project management](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ProjectController.java): `backend/src/main/java/com/contractlabour/management/controller/ProjectController.java`
- [Worker management](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/WorkerService.java): `backend/src/main/java/com/contractlabour/management/service/WorkerService.java`
- [Worker assignments](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/AssignmentService.java): `backend/src/main/java/com/contractlabour/management/service/AssignmentService.java`

### Work operations

- [Attendance](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/AttendanceController.java): `backend/src/main/java/com/contractlabour/management/controller/AttendanceController.java`
- [Leave requests](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/LeaveRequestService.java): `backend/src/main/java/com/contractlabour/management/service/LeaveRequestService.java`

### Payments

- [Worker payments](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java): `backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java`
- [Contractor payments](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/ContractorPaymentController.java): `backend/src/main/java/com/contractlabour/management/controller/ContractorPaymentController.java`
- [Cashfree payment API](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/controller/CashfreePaymentController.java): `backend/src/main/java/com/contractlabour/management/controller/CashfreePaymentController.java`
- [Cashfree integration](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/service/CashfreePaymentService.java): `backend/src/main/java/com/contractlabour/management/service/CashfreePaymentService.java`

### Persistence

- [Worker records](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/WorkerRepository.java): `backend/src/main/java/com/contractlabour/management/repository/WorkerRepository.java`
- [Assignment records](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/AssignmentRepository.java): `backend/src/main/java/com/contractlabour/management/repository/AssignmentRepository.java`
- [Attendance records](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/AttendanceRepository.java): `backend/src/main/java/com/contractlabour/management/repository/AttendanceRepository.java`
- [Leave records](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/LeaveRequestRepository.java): `backend/src/main/java/com/contractlabour/management/repository/LeaveRequestRepository.java`
- [Worker payment records](https://github.com/abrar-0609/project_contract_labour_management/blob/main/backend/src/main/java/com/contractlabour/management/repository/WorkerPaymentRepository.java): `backend/src/main/java/com/contractlabour/management/repository/WorkerPaymentRepository.java`

### Other components

- **Admin**
- **Contractor**
- **Worker**
- **Cashfree gateway**

## Connections

- Admin → Login page: signs in
- Contractor → Login page: signs in
- Worker → Login page: signs in
- Login page → Authentication API: authenticates
- Authentication API → Authentication: validates credentials (evidence: `backend/src/main/java/com/contractlabour/management/controller/AuthController.java`)
- Role routes → Login page: routes to (evidence: `frontend/src/App.jsx`)
- Admin → Contractor management: manages contractors
- Admin → Project management: manages projects
- Contractor → Worker management: manages workers
- Contractor → Worker assignments: assigns workers
- Worker assignments → Assignment records: reads and writes (evidence: `backend/src/main/java/com/contractlabour/management/service/AssignmentService.java`)
- Worker assignments → Worker records: reads workers (evidence: `backend/src/main/java/com/contractlabour/management/service/AssignmentService.java`)
- Contractor → Attendance: marks attendance
- Attendance → Attendance records: records attendance
- Worker → Leave requests: requests leave
- Contractor → Leave requests: reviews leave
- Leave requests → Leave records: reads and writes (evidence: `backend/src/main/java/com/contractlabour/management/service/LeaveRequestService.java`)
- Worker → Worker payments: views payroll
- Contractor → Worker payments: pays workers
- Worker payments → Worker payment records: reads and writes (evidence: `backend/src/main/java/com/contractlabour/management/service/WorkerPaymentService.java`)
- Admin → Contractor payments: pays contractors
- Contractor → Cashfree payment API: initiates payment
- Cashfree payment API → Cashfree integration: delegates payment (evidence: `backend/src/main/java/com/contractlabour/management/controller/CashfreePaymentController.java`)
- Cashfree integration → Cashfree gateway: creates gateway orders
- Cashfree payment API → Worker payments: updates payment (evidence: `backend/src/main/java/com/contractlabour/management/controller/CashfreePaymentController.java`)
- Role routes → Contractor management: routes to
- Role routes → Project management: routes to
