# mano-ppl/mano-hrm-web architecture

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

- Interactive diagram: https://gitdiagram.com/mano-ppl/mano-hrm-web
- Repository: https://github.com/mano-ppl/mano-hrm-web

## Overview

Mano is a multi-tenant workforce management platform. Employees authenticate, record location-validated attendance and checkpoints, and submit corrections; administrators monitor attendance and manage shifts, geofences, leave, payroll, and reports. The graph also preserves documented collaboration, AI, billing, recruitment, and document-generation capabilities. Evidence is limited to the supplied excerpts, source-index references, and README; unsampled subsystem internals and links are not inferred.

Main entry points: [`backend/src/modules/attendance/attendanceController.js`](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/attendance/attendanceController.js) (Attendance Processing), [`backend/src/app.js`](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/app.js) (HTTP Backend), [`frontend/src/App.jsx`](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/App.jsx) (Web Application), [`frontend/src/services/api.js`](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/services/api.js) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_frontend["Web Application<br/>[App.jsx]"]
  node_api["API Client<br/>[api.js]"]
  node_attendance_ui["Attendance Portal<br/>[Attendance.jsx]"]
  node_monitor_ui["Live Monitor"]
end

subgraph group_workforce["Workforce Operations"]
  node_auth["Authentication<br/>[authService.js]"]
  node_attendance["Attendance Processing"]
  node_attendance_jobs["Attendance Jobs"]
  node_shifts["Shifts &amp; Geofencing<br/>[shiftService.js]"]
  node_corrections["Attendance Corrections"]
  node_leave["Leave &amp; Holidays<br/>[leaveService.js]"]
  node_labour["Labour Management<br/>[labourService.js]"]
end

subgraph group_administration["Administration"]
  node_payroll["Payroll"]
  node_reports["Reports &amp; Exports<br/>[reportsServices.js]"]
  node_recruitment["Recruitment Portal"]
  node_document_studio["HR Document Studio"]
  node_billing["Subscription &amp; Billing<br/>[paymentService.js]"]
end

subgraph group_intelligence["Intelligence &amp; Collaboration"]
  node_dar["Daily Activity Reports<br/>[DARLLMService.js]"]
  node_chat["Chat &amp; Collaboration<br/>[chatController.js]"]
  node_website_rag["Website RAG"]
  node_ai_summary["Attendance AI Summary<br/>[main.py]"]
end

subgraph group_platform["Platform Services"]
  node_database[("Relational Databases<br/>[database.js]")]
  node_storage["S3 File Storage<br/>[s3Service.js]"]
  node_realtime["Realtime Delivery<br/>[index.js]"]
  node_backend["HTTP Backend<br/>[app.js]"]
end

node_employee(("Employee"))
node_admin(("Administrator"))

node_employee -->|"uses"| node_frontend
node_admin -->|"uses"| node_frontend
node_frontend -->|"requests"| node_api
node_api -.->|"calls"| node_backend
node_frontend -->|"routes to"| node_attendance_ui
node_attendance_ui -->|"requests"| node_api
node_backend -.->|"serves"| node_auth
node_backend -.->|"serves"| node_attendance
node_attendance -->|"dispatches"| node_attendance_jobs
node_attendance -->|"reads/writes"| node_database
node_attendance -->|"uses policies"| node_shifts
node_admin -->|"monitors"| node_monitor_ui
node_monitor_ui -->|"requests"| node_api
node_attendance -->|"supports requests"| node_corrections
node_admin -->|"configures"| node_shifts
node_employee -->|"requests leave"| node_leave
node_admin -->|"manages"| node_labour
node_admin -->|"runs"| node_payroll
node_admin -->|"reviews"| node_reports
node_attendance -->|"uses reporting data"| node_reports
node_employee -->|"records activities"| node_dar
node_employee -->|"collaborates"| node_chat
node_chat -->|"reads/writes"| node_database
node_chat -->|"signs attachments"| node_storage
node_admin -->|"manages applicants"| node_recruitment
node_admin -->|"generates documents"| node_document_studio
node_admin -->|"manages plans"| node_billing
node_attendance -->|"requests summary"| node_ai_summary
node_employee -->|"asks questions"| node_website_rag
node_backend -->|"initializes"| node_realtime

click node_frontend "https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/services/api.js"
click node_auth "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/auth/authService.js"
click node_attendance_ui "https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/pages/attendance/Attendance.jsx"
click node_attendance "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/attendance/attendanceController.js"
click node_attendance_jobs "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/attendance/attendanceJobProcessor.js"
click node_monitor_ui "https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/pages/attendance-monitoring/AttendanceMonitoring.jsx"
click node_shifts "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/shifts/shiftService.js"
click node_corrections "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/corrections/correctionsController.js"
click node_leave "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/leaves/leaveService.js"
click node_labour "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/labour/labourService.js"
click node_payroll "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/payroll/payrollController.js"
click node_reports "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/reports/reportsServices.js"
click node_dar "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/DAR/DARLLMService.js"
click node_chat "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/collaboration/chatController.js"
click node_website_rag "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/chatbot/websiteRagService.js"
click node_ai_summary "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/services/ai_summary/main.py"
click node_recruitment "https://github.com/mano-ppl/mano-hrm-web/tree/main/frontend/src/pages"
click node_document_studio "https://github.com/mano-ppl/mano-hrm-web/tree/main/frontend/src/pages"
click node_billing "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/payments/paymentService.js"
click node_database "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/config/database.js"
click node_storage "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/services/s3/s3Service.js"
click node_realtime "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/socket/index.js"
click node_backend "https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/app.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_frontend,node_api,node_attendance_ui,node_monitor_ui toneBlue
class node_auth,node_attendance,node_attendance_jobs,node_shifts,node_corrections,node_leave,node_labour toneAmber
class node_payroll,node_reports,node_recruitment,node_document_studio,node_billing toneMint
class node_dar,node_chat,node_website_rag,node_ai_summary toneRose
class node_database,node_storage,node_realtime,node_backend,node_employee,node_admin toneIndigo
```

## Components

### User Experience

- [Web Application](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API Client](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Attendance Portal](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/pages/attendance/Attendance.jsx): `frontend/src/pages/attendance/Attendance.jsx`
- [Live Monitor](https://github.com/mano-ppl/mano-hrm-web/blob/main/frontend/src/pages/attendance-monitoring/AttendanceMonitoring.jsx): `frontend/src/pages/attendance-monitoring/AttendanceMonitoring.jsx`

### Workforce Operations

- [Authentication](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/auth/authService.js): `backend/src/modules/auth/authService.js`
- [Attendance Processing](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/attendance/attendanceController.js): `backend/src/modules/attendance/attendanceController.js`
- [Attendance Jobs](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/attendance/attendanceJobProcessor.js): `backend/src/modules/attendance/attendanceJobProcessor.js`
- [Shifts & Geofencing](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/shifts/shiftService.js): `backend/src/modules/shifts/shiftService.js`
- [Attendance Corrections](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/corrections/correctionsController.js): `backend/src/modules/corrections/correctionsController.js`
- [Leave & Holidays](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/leaves/leaveService.js): `backend/src/modules/leaves/leaveService.js`
- [Labour Management](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/labour/labourService.js): `backend/src/modules/labour/labourService.js`

### Administration

- [Payroll](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/payroll/payrollController.js): `backend/src/modules/payroll/payrollController.js`
- [Reports & Exports](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/reports/reportsServices.js): `backend/src/modules/reports/reportsServices.js`
- [Recruitment Portal](https://github.com/mano-ppl/mano-hrm-web/tree/main/frontend/src/pages): `frontend/src/pages`
- [HR Document Studio](https://github.com/mano-ppl/mano-hrm-web/tree/main/frontend/src/pages): `frontend/src/pages`
- [Subscription & Billing](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/payments/paymentService.js): `backend/src/modules/payments/paymentService.js`

### Intelligence & Collaboration

- [Daily Activity Reports](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/DAR/DARLLMService.js): `backend/src/modules/DAR/DARLLMService.js`
- [Chat & Collaboration](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/collaboration/chatController.js): `backend/src/modules/collaboration/chatController.js`
- [Website RAG](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/modules/chatbot/websiteRagService.js): `backend/src/modules/chatbot/websiteRagService.js`
- [Attendance AI Summary](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/services/ai_summary/main.py): `backend/services/ai_summary/main.py`

### Platform Services

- [Relational Databases](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/config/database.js): `backend/src/config/database.js`
- [S3 File Storage](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/services/s3/s3Service.js): `backend/src/services/s3/s3Service.js`
- [Realtime Delivery](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/socket/index.js): `backend/src/socket/index.js`
- [HTTP Backend](https://github.com/mano-ppl/mano-hrm-web/blob/main/backend/src/app.js): `backend/src/app.js`

### Other components

- **Employee**
- **Administrator**

## Connections

- Employee → Web Application: uses
- Administrator → Web Application: uses
- Web Application → API Client: requests (evidence: `frontend/src/services/api.js`)
- API Client → HTTP Backend: calls
- Web Application → Attendance Portal: routes to (evidence: `frontend/src/App.jsx`)
- Attendance Portal → API Client: requests
- HTTP Backend → Authentication: serves
- HTTP Backend → Attendance Processing: serves
- Attendance Processing → Attendance Jobs: dispatches (evidence: `backend/src/modules/attendance/attendanceController.js`)
- Attendance Processing → Relational Databases: reads/writes (evidence: `backend/src/modules/attendance/attendanceController.js`)
- Attendance Processing → Shifts & Geofencing: uses policies (evidence: `backend/src/modules/attendance/attendanceController.js`)
- Administrator → Live Monitor: monitors
- Live Monitor → API Client: requests
- Attendance Processing → Attendance Corrections: supports requests
- Administrator → Shifts & Geofencing: configures
- Employee → Leave & Holidays: requests leave
- Administrator → Labour Management: manages
- Administrator → Payroll: runs
- Administrator → Reports & Exports: reviews
- Attendance Processing → Reports & Exports: uses reporting data (evidence: `backend/src/modules/attendance/attendanceController.js`)
- Employee → Daily Activity Reports: records activities
- Employee → Chat & Collaboration: collaborates
- Chat & Collaboration → Relational Databases: reads/writes (evidence: `backend/src/modules/collaboration/chatController.js`)
- Chat & Collaboration → S3 File Storage: signs attachments (evidence: `backend/src/modules/collaboration/chatController.js`)
- Administrator → Recruitment Portal: manages applicants
- Administrator → HR Document Studio: generates documents
- Administrator → Subscription & Billing: manages plans
- Attendance Processing → Attendance AI Summary: requests summary (evidence: `backend/src/modules/attendance/attendanceController.js`)
- Employee → Website RAG: asks questions
- HTTP Backend → Realtime Delivery: initializes (evidence: `backend/server.js`)
