# mano-ppl/mano-erp architecture

> Architecture diagram of the GitHub repository mano-ppl/mano-erp, 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-erp
- Repository: https://github.com/mano-ppl/mano-erp

## Overview

MANO ERP is a project-execution and engineering-management system for construction and infrastructure work. Users enter through a responsive, authenticated web interface, select projects, and work across execution areas such as schedules, drawings, field reporting, quality, contracts, and materials. The backend exposes domain services and an AI agent, with MySQL as the application store. README-described capabilities are included even where their implementation was not sampled; those links cite the README rather than implying source-level calls.

Main entry points: [`frontend/src/pages/ProjectDetails/Dashboard.jsx`](https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/pages/ProjectDetails/Dashboard.jsx) (Project dashboard), [`backend/src/modules/projects/core/projectService.js`](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/projects/core/projectService.js) (Project workspace), [`backend/src/config/database.js`](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/config/database.js) (MySQL database), [`frontend/src/App.jsx`](https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/App.jsx) (Responsive app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Responsive app<br/>[App.jsx]"]
  node_auth["Authentication<br/>[authService.js]"]
end

subgraph group_execution["Project execution"]
  node_projects["Project workspace<br/>[projectService.js]"]
  node_dashboard["Project dashboard<br/>[Dashboard.jsx]"]
  node_tasks["Schedule and tasks<br/>[Tasks.jsx]"]
  node_wip["WIP valuation"]
  node_drawings["Drawings and CAD"]
  node_planning["Engineering planning"]
  node_fieldreports["Field reporting"]
  node_quality["Quality and safety<br/>[qualityService.js]"]
  node_contracts["Contracts and billing"]
  node_materials["Material supply"]
  node_documents["Project documents"]
end

subgraph group_operations["Business operations"]
  node_clients["Client records<br/>[clientService.js]"]
  node_vendors["Vendor records<br/>[vendorService.js]"]
  node_resources["Resource inventory<br/>[resourceService.js]"]
end

subgraph group_intelligence["AI and knowledge"]
  node_agent["ERP agent<br/>[agentRuntime.js]"]
  node_knowledge["Knowledge graph"]
end

subgraph group_platform["Backend platform"]
  node_mysql[("MySQL database<br/>[database.js]")]
end

node_user(("Project user"))

node_user -->|"uses"| node_app
node_app -.->|"secures access"| node_auth
node_app -.->|"opens projects"| node_projects
node_projects -->|"summarizes"| node_dashboard
node_dashboard -->|"tracks schedule"| node_tasks
node_dashboard -->|"shows valuation"| node_wip
node_dashboard -->|"opens drawings"| node_drawings
node_dashboard -->|"supports planning"| node_planning
node_dashboard -->|"monitors governance"| node_quality
node_dashboard -->|"tracks billing"| node_contracts
node_dashboard -->|"tracks supply"| node_materials
node_fieldreports -->|"requests summaries"| node_agent
node_projects -.->|"manages records"| node_documents
node_projects -.->|"links clients"| node_clients
node_projects -->|"assigns vendors"| node_vendors
node_materials -->|"plans demand"| node_resources
node_agent -.->|"uses context"| node_knowledge
node_projects -.->|"persists data"| node_mysql
node_clients -->|"reads and writes"| node_mysql
node_resources -->|"reads and writes"| node_mysql
node_knowledge -->|"reads and writes"| node_mysql

click node_app "https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/auth/authService.js"
click node_projects "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/projects/core/projectService.js"
click node_dashboard "https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/pages/ProjectDetails/Dashboard.jsx"
click node_tasks "https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/pages/ProjectDetails/Tasks.jsx"
click node_wip "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/mobile/pages/ProjectDetails/WIP"
click node_drawings "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Drawings"
click node_planning "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Planning"
click node_fieldreports "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/mobile/pages/ProjectDetails/Reports"
click node_quality "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/projects/quality/qualityService.js"
click node_contracts "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Contracts"
click node_materials "https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/MaterialManagement"
click node_documents "https://github.com/mano-ppl/mano-erp/tree/main/backend/src/modules/documents"
click node_clients "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/clients/clientService.js"
click node_vendors "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/vendors/vendorService.js"
click node_resources "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/inventory/resourceService.js"
click node_agent "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/agent/agentRuntime.js"
click node_knowledge "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/knowledge/knowledgeGraphService.js"
click node_mysql "https://github.com/mano-ppl/mano-erp/blob/main/backend/src/config/database.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_app,node_auth,node_user toneBlue
class node_projects,node_dashboard,node_tasks,node_wip,node_drawings,node_planning,node_fieldreports,node_quality,node_contracts,node_materials,node_documents toneAmber
class node_clients,node_vendors,node_resources toneMint
class node_agent,node_knowledge toneRose
class node_mysql toneIndigo
```

## Components

### Web experience

- [Responsive app](https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/auth/authService.js): `backend/src/modules/auth/authService.js`

### Project execution

- [Project workspace](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/projects/core/projectService.js): `backend/src/modules/projects/core/projectService.js`
- [Project dashboard](https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/pages/ProjectDetails/Dashboard.jsx): `frontend/src/pages/ProjectDetails/Dashboard.jsx`
- [Schedule and tasks](https://github.com/mano-ppl/mano-erp/blob/main/frontend/src/pages/ProjectDetails/Tasks.jsx): `frontend/src/pages/ProjectDetails/Tasks.jsx`
- [WIP valuation](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/mobile/pages/ProjectDetails/WIP): `frontend/src/mobile/pages/ProjectDetails/WIP`
- [Drawings and CAD](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Drawings): `frontend/src/pages/ProjectDetails/Drawings`
- [Engineering planning](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Planning): `frontend/src/pages/ProjectDetails/Planning`
- [Field reporting](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/mobile/pages/ProjectDetails/Reports): `frontend/src/mobile/pages/ProjectDetails/Reports`
- [Quality and safety](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/projects/quality/qualityService.js): `backend/src/modules/projects/quality/qualityService.js`
- [Contracts and billing](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/Contracts): `frontend/src/pages/ProjectDetails/Contracts`
- [Material supply](https://github.com/mano-ppl/mano-erp/tree/main/frontend/src/pages/ProjectDetails/MaterialManagement): `frontend/src/pages/ProjectDetails/MaterialManagement`
- [Project documents](https://github.com/mano-ppl/mano-erp/tree/main/backend/src/modules/documents): `backend/src/modules/documents`

### Business operations

- [Client records](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/clients/clientService.js): `backend/src/modules/clients/clientService.js`
- [Vendor records](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/vendors/vendorService.js): `backend/src/modules/vendors/vendorService.js`
- [Resource inventory](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/inventory/resourceService.js): `backend/src/modules/inventory/resourceService.js`

### AI and knowledge

- [ERP agent](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/agent/agentRuntime.js): `backend/src/modules/agent/agentRuntime.js`
- [Knowledge graph](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/modules/knowledge/knowledgeGraphService.js): `backend/src/modules/knowledge/knowledgeGraphService.js`

### Backend platform

- [MySQL database](https://github.com/mano-ppl/mano-erp/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Other components

- **Project user**

## Connections

- Project user → Responsive app: uses (evidence: `frontend/src/App.jsx`)
- Responsive app → Authentication: secures access
- Responsive app → Project workspace: opens projects
- Project workspace → Project dashboard: summarizes
- Project dashboard → Schedule and tasks: tracks schedule
- Project dashboard → WIP valuation: shows valuation
- Project dashboard → Drawings and CAD: opens drawings
- Project dashboard → Engineering planning: supports planning
- Project dashboard → Quality and safety: monitors governance
- Project dashboard → Contracts and billing: tracks billing
- Project dashboard → Material supply: tracks supply
- Field reporting → ERP agent: requests summaries
- Project workspace → Project documents: manages records
- Project workspace → Client records: links clients
- Project workspace → Vendor records: assigns vendors
- Material supply → Resource inventory: plans demand
- ERP agent → Knowledge graph: uses context
- Project workspace → MySQL database: persists data
- Client records → MySQL database: reads and writes (evidence: `backend/src/modules/clients/clientService.js`)
- Resource inventory → MySQL database: reads and writes (evidence: `backend/src/modules/inventory/resourceService.js`)
- Knowledge graph → MySQL database: reads and writes (evidence: `backend/src/modules/knowledge/knowledgeGraphService.js`)
