# suhanipandita/client_enquiry_management architecture

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

- Interactive diagram: https://gitdiagram.com/suhanipandita/client_enquiry_management
- Repository: https://github.com/suhanipandita/client_enquiry_management

## Overview

Client Enquiry Management is a web app for tracking inbound client enquiries and preparing quotations. Users open the enquiries page to search, filter, add, or edit enquiries; the server associates an enquiry with a client and persists it. The quotations page supports quotation creation and management, including line items, totals, and status. The backend also exposes client and employee operations backed by MySQL. The README is only a title, so capability detail comes from the sampled source and SOURCE INDEX; some API-to-server wiring is not shown and is left out.

Main entry points: [`client/src/pages/QuotationsPage.jsx`](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/pages/QuotationsPage.jsx) (Quotations page), [`server/db.js`](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/db.js) (MySQL pool), [`server/index.js`](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/index.js) (HTTP server), [`client/src/App.jsx`](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/App.jsx) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app["App routing<br/>[App.jsx]"]
  node_layout["Page layout<br/>[Layout.jsx]"]
end

subgraph group_clientdata["Client and enquiries"]
  node_enquiry_page["Enquiries page<br/>[EnquiriesPage.jsx]"]
  node_enquiry_form["Enquiry form<br/>[EnquiryForm.jsx]"]
  node_enquiry_table["Enquiry table<br/>[EnquiryTable.jsx]"]
  node_status_badge["Status badge<br/>[StatusBadge.jsx]"]
  node_enquiry_api["Enquiry API<br/>[enquiryApi.js]"]
  node_employee_api["Employee API<br/>[employeeApi.js]"]
end

subgraph group_quotes["Quotations"]
  node_quotation_page["Quotations page<br/>[QuotationsPage.jsx]"]
  node_quotation_form["Quotation form<br/>[QuotationForm.jsx]"]
  node_quotation_api["Quotation API<br/>[quotationApi.js]"]
  node_stat_card["Statistics card<br/>[StatCard.jsx]"]
end

subgraph group_server["Server and persistence"]
  node_server_entry["HTTP server<br/>[index.js]"]
  node_enquiry_routes["Enquiry routes<br/>[enquiryRoutes.js]"]
  node_quotation_routes["Quotation routes<br/>[quotationRoutes.js]"]
  node_client_routes["Client routes<br/>[clientRoutes.js]"]
  node_employee_routes["Employee routes<br/>[employeeRoutes.js]"]
  node_enquiry_controller["Enquiry operations"]
  node_quotation_controller["Quotation operations"]
  node_client_controller["Client operations"]
  node_employee_controller["Employee operations"]
  node_db_pool["MySQL pool<br/>[db.js]"]
end

node_user(("User"))
node_mysql[("MySQL database")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"routes to"| node_enquiry_page
node_app -->|"routes to"| node_quotation_page
node_enquiry_page -->|"renders"| node_enquiry_form
node_enquiry_page -->|"renders"| node_status_badge
node_enquiry_page -->|"calls"| node_enquiry_api
node_enquiry_form -->|"uses"| node_employee_api
node_quotation_page -->|"renders"| node_quotation_form
node_quotation_page -->|"calls"| node_quotation_api
node_quotation_page -->|"renders"| node_stat_card
node_quotation_page -->|"renders"| node_status_badge
node_quotation_form -->|"loads enquiries"| node_enquiry_api
node_server_entry -->|"mounts"| node_enquiry_routes
node_server_entry -->|"mounts"| node_quotation_routes
node_server_entry -->|"mounts"| node_client_routes
node_server_entry -->|"mounts"| node_employee_routes
node_enquiry_routes -->|"dispatches"| node_enquiry_controller
node_quotation_routes -->|"dispatches"| node_quotation_controller
node_client_routes -->|"dispatches"| node_client_controller
node_employee_routes -->|"dispatches"| node_employee_controller
node_enquiry_controller -->|"finds or creates client"| node_client_controller
node_enquiry_controller -->|"queries"| node_db_pool
node_quotation_controller -->|"queries"| node_db_pool
node_client_controller -->|"queries"| node_db_pool
node_employee_controller -->|"queries"| node_db_pool
node_db_pool -->|"connects"| node_mysql

click node_app "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/App.jsx"
click node_layout "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/Layout.jsx"
click node_enquiry_page "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/pages/EnquiriesPage.jsx"
click node_enquiry_form "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/EnquiryForm.jsx"
click node_enquiry_table "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/EnquiryTable.jsx"
click node_status_badge "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/StatusBadge.jsx"
click node_enquiry_api "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/enquiryApi.js"
click node_employee_api "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/employeeApi.js"
click node_quotation_page "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/pages/QuotationsPage.jsx"
click node_quotation_form "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/QuotationForm.jsx"
click node_quotation_api "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/quotationApi.js"
click node_stat_card "https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/StatCard.jsx"
click node_server_entry "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/index.js"
click node_enquiry_routes "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/enquiryRoutes.js"
click node_quotation_routes "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/quotationRoutes.js"
click node_client_routes "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/clientRoutes.js"
click node_employee_routes "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/employeeRoutes.js"
click node_enquiry_controller "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/enquiryController.js"
click node_quotation_controller "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/quotationController.js"
click node_client_controller "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/clientController.js"
click node_employee_controller "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/employeeController.js"
click node_db_pool "https://github.com/suhanipandita/client_enquiry_management/blob/main/server/db.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_layout,node_user toneBlue
class node_enquiry_page,node_enquiry_form,node_enquiry_table,node_status_badge,node_enquiry_api,node_employee_api,node_mysql toneAmber
class node_quotation_page,node_quotation_form,node_quotation_api,node_stat_card toneMint
class node_server_entry,node_enquiry_routes,node_quotation_routes,node_client_routes,node_employee_routes,node_enquiry_controller,node_quotation_controller,node_client_controller,node_employee_controller,node_db_pool toneRose
```

## Components

### Web interface

- [App routing](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Page layout](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/Layout.jsx): `client/src/components/Layout.jsx`

### Client and enquiries

- [Enquiries page](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/pages/EnquiriesPage.jsx): `client/src/pages/EnquiriesPage.jsx`
- [Enquiry form](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/EnquiryForm.jsx): `client/src/components/EnquiryForm.jsx`
- [Enquiry table](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/EnquiryTable.jsx): `client/src/components/EnquiryTable.jsx`
- [Status badge](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/StatusBadge.jsx): `client/src/components/StatusBadge.jsx`
- [Enquiry API](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/enquiryApi.js): `client/src/api/enquiryApi.js`
- [Employee API](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/employeeApi.js): `client/src/api/employeeApi.js`

### Quotations

- [Quotations page](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/pages/QuotationsPage.jsx): `client/src/pages/QuotationsPage.jsx`
- [Quotation form](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/QuotationForm.jsx): `client/src/components/QuotationForm.jsx`
- [Quotation API](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/api/quotationApi.js): `client/src/api/quotationApi.js`
- [Statistics card](https://github.com/suhanipandita/client_enquiry_management/blob/main/client/src/components/StatCard.jsx): `client/src/components/StatCard.jsx`

### Server and persistence

- [HTTP server](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/index.js): `server/index.js`
- [Enquiry routes](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/enquiryRoutes.js): `server/routes/enquiryRoutes.js`
- [Quotation routes](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/quotationRoutes.js): `server/routes/quotationRoutes.js`
- [Client routes](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/clientRoutes.js): `server/routes/clientRoutes.js`
- [Employee routes](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/routes/employeeRoutes.js): `server/routes/employeeRoutes.js`
- [Enquiry operations](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/enquiryController.js): `server/controllers/enquiryController.js`
- [Quotation operations](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/quotationController.js): `server/controllers/quotationController.js`
- [Client operations](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/clientController.js): `server/controllers/clientController.js`
- [Employee operations](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/controllers/employeeController.js): `server/controllers/employeeController.js`
- [MySQL pool](https://github.com/suhanipandita/client_enquiry_management/blob/main/server/db.js): `server/db.js`

### Other components

- **User**
- **MySQL database**

## Connections

- User → App routing: uses (evidence: `client/src/App.jsx`)
- App routing → Page layout: renders (evidence: `client/src/App.jsx`)
- App routing → Enquiries page: routes to (evidence: `client/src/App.jsx`)
- App routing → Quotations page: routes to (evidence: `client/src/App.jsx`)
- Enquiries page → Enquiry form: renders (evidence: `client/src/pages/EnquiriesPage.jsx`)
- Enquiries page → Status badge: renders (evidence: `client/src/pages/EnquiriesPage.jsx`)
- Enquiries page → Enquiry API: calls (evidence: `client/src/pages/EnquiriesPage.jsx`)
- Enquiry form → Employee API: uses (evidence: `client/src/components/EnquiryForm.jsx`)
- Quotations page → Quotation form: renders (evidence: `client/src/pages/QuotationsPage.jsx`)
- Quotations page → Quotation API: calls (evidence: `client/src/pages/QuotationsPage.jsx`)
- Quotations page → Statistics card: renders (evidence: `client/src/pages/QuotationsPage.jsx`)
- Quotations page → Status badge: renders (evidence: `client/src/pages/QuotationsPage.jsx`)
- Quotation form → Enquiry API: loads enquiries (evidence: `client/src/components/QuotationForm.jsx`)
- HTTP server → Enquiry routes: mounts (evidence: `server/index.js`)
- HTTP server → Quotation routes: mounts (evidence: `server/index.js`)
- HTTP server → Client routes: mounts (evidence: `server/index.js`)
- HTTP server → Employee routes: mounts (evidence: `server/index.js`)
- Enquiry routes → Enquiry operations: dispatches (evidence: `server/routes/enquiryRoutes.js`)
- Quotation routes → Quotation operations: dispatches (evidence: `server/routes/quotationRoutes.js`)
- Client routes → Client operations: dispatches (evidence: `server/routes/clientRoutes.js`)
- Employee routes → Employee operations: dispatches (evidence: `server/routes/employeeRoutes.js`)
- Enquiry operations → Client operations: finds or creates client (evidence: `server/controllers/enquiryController.js`)
- Enquiry operations → MySQL pool: queries (evidence: `server/controllers/enquiryController.js`)
- Quotation operations → MySQL pool: queries (evidence: `server/controllers/quotationController.js`)
- Client operations → MySQL pool: queries (evidence: `server/controllers/clientController.js`)
- Employee operations → MySQL pool: queries (evidence: `server/controllers/employeeController.js`)
- MySQL pool → MySQL database: connects (evidence: `server/db.js`)
