# idurar/idurar-erp-crm architecture

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

- Interactive diagram: https://gitdiagram.com/idurar/idurar-erp-crm
- Repository: https://github.com/idurar/idurar-erp-crm

## Overview

IDURAR is a self-hosted ERP/CRM for customer, invoice, payment, quote, and accounting workflows. The main user path is through the React application’s routed business pages; those pages use backend APIs for records and operations, with MongoDB as the backend’s configured datastore. Backend route mounting and frontend route declarations are visible, but the sampled evidence does not show most API-to-controller or UI-to-API calls, so those links are left unverified. README capabilities such as quotes and inventory are retained as subsystem nodes where the tree supports them.

Main entry points: [`backend/src/app.js`](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/app.js) (Express application), [`frontend/src/router/routes.jsx`](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/router/routes.jsx) (Page routing), [`backend/src/routes/appRoutes/appApi.js`](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/appRoutes/appApi.js) (ERP API routes), [`frontend/src/request/request.js`](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/request/request.js) (Request handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User application"]
  node_webapp["React application<br/>[IdurarOs.jsx]"]
  node_routes["Page routing<br/>[routes.jsx]"]
  node_http["Request handling<br/>[request.js]"]
  node_dashboard["Dashboard<br/>[index.jsx]"]
  node_settings_ui["Settings pages<br/>[Settings.jsx]"]
end

subgraph group_sales["Sales workflows"]
  node_customer_ui["Customer pages<br/>[index.jsx]"]
  node_invoice_ui["Invoice pages<br/>[index.jsx]"]
  node_payment_ui["Payment pages<br/>[index.jsx]"]
  node_quote_ui["Quote workflow"]
end

subgraph group_backend["API service"]
  node_backend_app["Express application<br/>[app.js]"]
  node_auth_routes["Authentication routes<br/>[coreAuth.js]"]
  node_core_routes["Core API routes<br/>[coreApi.js]"]
  node_erp_routes["ERP API routes<br/>[appApi.js]"]
  node_auth["Token validation<br/>[index.js]"]
  node_customer_api["Customer operations"]
  node_invoice_api["Invoice operations"]
  node_payment_api["Payment operations"]
  node_settings_api["Settings operations"]
  node_pdf["PDF generation<br/>[index.js]"]
  node_download["PDF download<br/>[downloadPdf.js]"]
  node_public_files["Public file serving"]
  node_server["Server startup<br/>[server.js]"]
end

subgraph group_platform["Platform services"]
  node_upload["File uploads"]
  node_models[("MongoDB models")]
end

node_user(("ERP user"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_webapp
node_webapp -->|"loads routes"| node_routes
node_routes -->|"routes to"| node_customer_ui
node_routes -->|"routes to"| node_invoice_ui
node_routes -->|"routes to"| node_payment_ui
node_routes -->|"routes to"| node_quote_ui
node_user -.->|"views"| node_dashboard
node_user -.->|"manages settings"| node_settings_ui
node_customer_ui -.->|"requests data"| node_http
node_invoice_ui -.->|"requests data"| node_http
node_payment_ui -.->|"requests data"| node_http
node_quote_ui -.->|"requests data"| node_http
node_webapp -.->|"calls API"| node_backend_app
node_server -->|"starts"| node_backend_app
node_backend_app -->|"mounts"| node_auth_routes
node_backend_app -->|"mounts"| node_core_routes
node_backend_app -->|"mounts"| node_erp_routes
node_backend_app -->|"validates tokens"| node_auth
node_backend_app -->|"mounts downloads"| node_download
node_backend_app -->|"mounts files"| node_public_files
node_erp_routes -.->|"dispatches to"| node_customer_api
node_erp_routes -.->|"dispatches to"| node_invoice_api
node_erp_routes -.->|"dispatches to"| node_payment_api
node_core_routes -.->|"dispatches to"| node_settings_api
node_invoice_api -.->|"creates PDFs"| node_pdf
node_download -.->|"renders document"| node_pdf
node_invoice_api -.->|"reads and writes"| node_models
node_customer_api -.->|"reads and writes"| node_models
node_payment_api -.->|"reads and writes"| node_models
node_settings_api -.->|"reads and writes"| node_models
node_server -->|"connects"| node_mongo
node_upload -.->|"serves uploaded files"| node_public_files

click node_webapp "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/apps/IdurarOs.jsx"
click node_routes "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/router/routes.jsx"
click node_http "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/request/request.js"
click node_customer_ui "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Customer/index.jsx"
click node_invoice_ui "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Invoice/index.jsx"
click node_payment_ui "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Payment/index.jsx"
click node_quote_ui "https://github.com/idurar/idurar-erp-crm/tree/master/frontend/src/modules/QuoteModule"
click node_dashboard "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/modules/DashboardModule/index.jsx"
click node_settings_ui "https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Settings/Settings.jsx"
click node_backend_app "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/app.js"
click node_auth_routes "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/coreAuth.js"
click node_core_routes "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/coreApi.js"
click node_erp_routes "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/appRoutes/appApi.js"
click node_auth "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/controllers/coreControllers/adminAuth/index.js"
click node_customer_api "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/clientController"
click node_invoice_api "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/invoiceController"
click node_payment_api "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/paymentController"
click node_settings_api "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/coreControllers/settingController"
click node_pdf "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/controllers/pdfController/index.js"
click node_download "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/handlers/downloadHandler/downloadPdf.js"
click node_upload "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/middlewares/uploadMiddleware"
click node_public_files "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/corePublicRouter.js"
click node_models "https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/models"
click node_server "https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/server.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_webapp,node_routes,node_http,node_dashboard,node_settings_ui,node_user toneBlue
class node_customer_ui,node_invoice_ui,node_payment_ui,node_quote_ui,node_mongo toneAmber
class node_backend_app,node_auth_routes,node_core_routes,node_erp_routes,node_auth,node_customer_api,node_invoice_api,node_payment_api,node_settings_api,node_pdf,node_download,node_public_files,node_server toneMint
class node_upload,node_models toneRose
```

## Components

### User application

- [React application](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/apps/IdurarOs.jsx): `frontend/src/apps/IdurarOs.jsx`
- [Page routing](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/router/routes.jsx): `frontend/src/router/routes.jsx`
- [Request handling](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/request/request.js): `frontend/src/request/request.js`
- [Dashboard](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/modules/DashboardModule/index.jsx): `frontend/src/modules/DashboardModule/index.jsx`
- [Settings pages](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Settings/Settings.jsx): `frontend/src/pages/Settings/Settings.jsx`

### Sales workflows

- [Customer pages](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Customer/index.jsx): `frontend/src/pages/Customer/index.jsx`
- [Invoice pages](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Invoice/index.jsx): `frontend/src/pages/Invoice/index.jsx`
- [Payment pages](https://github.com/idurar/idurar-erp-crm/blob/master/frontend/src/pages/Payment/index.jsx): `frontend/src/pages/Payment/index.jsx`
- [Quote workflow](https://github.com/idurar/idurar-erp-crm/tree/master/frontend/src/modules/QuoteModule): `frontend/src/modules/QuoteModule`

### API service

- [Express application](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/app.js): `backend/src/app.js`
- [Authentication routes](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/coreAuth.js): `backend/src/routes/coreRoutes/coreAuth.js`
- [Core API routes](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/coreApi.js): `backend/src/routes/coreRoutes/coreApi.js`
- [ERP API routes](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/appRoutes/appApi.js): `backend/src/routes/appRoutes/appApi.js`
- [Token validation](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/controllers/coreControllers/adminAuth/index.js): `backend/src/controllers/coreControllers/adminAuth/index.js`
- [Customer operations](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/clientController): `backend/src/controllers/appControllers/clientController`
- [Invoice operations](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/invoiceController): `backend/src/controllers/appControllers/invoiceController`
- [Payment operations](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/appControllers/paymentController): `backend/src/controllers/appControllers/paymentController`
- [Settings operations](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/controllers/coreControllers/settingController): `backend/src/controllers/coreControllers/settingController`
- [PDF generation](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/controllers/pdfController/index.js): `backend/src/controllers/pdfController/index.js`
- [PDF download](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/handlers/downloadHandler/downloadPdf.js): `backend/src/handlers/downloadHandler/downloadPdf.js`
- [Public file serving](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/routes/coreRoutes/corePublicRouter.js): `backend/src/routes/coreRoutes/corePublicRouter.js`
- [Server startup](https://github.com/idurar/idurar-erp-crm/blob/master/backend/src/server.js): `backend/src/server.js`

### Platform services

- [File uploads](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/middlewares/uploadMiddleware): `backend/src/middlewares/uploadMiddleware`
- [MongoDB models](https://github.com/idurar/idurar-erp-crm/tree/master/backend/src/models): `backend/src/models`

### Other components

- **ERP user**
- **MongoDB**

## Connections

- ERP user → React application: uses (evidence: `README.md`)
- React application → Page routing: loads routes
- Page routing → Customer pages: routes to (evidence: `frontend/src/router/routes.jsx`)
- Page routing → Invoice pages: routes to (evidence: `frontend/src/router/routes.jsx`)
- Page routing → Payment pages: routes to (evidence: `frontend/src/router/routes.jsx`)
- Page routing → Quote workflow: routes to (evidence: `frontend/src/router/routes.jsx`)
- ERP user → Dashboard: views
- ERP user → Settings pages: manages settings
- Customer pages → Request handling: requests data
- Invoice pages → Request handling: requests data
- Payment pages → Request handling: requests data
- Quote workflow → Request handling: requests data
- React application → Express application: calls API
- Server startup → Express application: starts (evidence: `backend/src/server.js`)
- Express application → Authentication routes: mounts (evidence: `backend/src/app.js`)
- Express application → Core API routes: mounts (evidence: `backend/src/app.js`)
- Express application → ERP API routes: mounts (evidence: `backend/src/app.js`)
- Express application → Token validation: validates tokens (evidence: `backend/src/app.js`)
- Express application → PDF download: mounts downloads (evidence: `backend/src/app.js`)
- Express application → Public file serving: mounts files (evidence: `backend/src/app.js`)
- ERP API routes → Customer operations: dispatches to
- ERP API routes → Invoice operations: dispatches to
- ERP API routes → Payment operations: dispatches to
- Core API routes → Settings operations: dispatches to
- Invoice operations → PDF generation: creates PDFs
- PDF download → PDF generation: renders document
- Invoice operations → MongoDB models: reads and writes
- Customer operations → MongoDB models: reads and writes
- Payment operations → MongoDB models: reads and writes
- Settings operations → MongoDB models: reads and writes
- Server startup → MongoDB: connects (evidence: `backend/src/server.js`)
- File uploads → Public file serving: serves uploaded files
