# omvazire/trivaltor architecture

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

## Overview

Trivaltor Group is a trade-business website paired with an administrative lead-management platform. The user workflow runs from public product discovery and enquiry capture through API validation, backend handling, and MongoDB persistence; administrators authenticate to manage leads, reviews, and analytics. The README documents multi-language content, visitor tracking, purchase orders, container tracking, and reporting. Some of these implementations were not excerpted, so their connections are shown only where documented or left unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/omvazire/trivaltor/blob/main/frontend/src/App.jsx) (Page Routing), [`backend/src/controllers/AdminController.js`](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/AdminController.js) (Admin Analytics), [`backend/src/controllers/ReportController.js`](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/ReportController.js) (Monthly Reports), [`frontend/src/pages/AdminDashboard.jsx`](https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/AdminDashboard.jsx) (Lead & Review Desk)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Website"]
  node_frontend_routes["Page Routing<br/>[App.jsx]"]
  node_catalogue["Catalogue &amp; Home<br/>[Home.jsx]"]
  node_categories["Product Categories<br/>[categories.js]"]
  node_language["Language Content"]
  node_language_strings["Translations<br/>[translations.js]"]
end

subgraph group_lead["Lead Management"]
  node_lead_forms["Enquiry Forms<br/>[BuyerLead.jsx]"]
  node_popup["Popup Leads<br/>[LeadPopup.jsx]"]
  node_visitor_tracking["Visitor Tracking<br/>[VisitorTracker.jsx]"]
  node_lead_state["Lead State<br/>[LeadContext.jsx]"]
  node_review_state["Review State<br/>[ReviewContext.jsx]"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Lead &amp; Review Desk<br/>[AdminDashboard.jsx]"]
  node_admin_reports["Analytics &amp; Reports<br/>[AdminReports.jsx]"]
  node_purchase_orders["Purchase Orders"]
  node_container_tracking["Container Tracking"]
end

subgraph group_backend["Backend API"]
  node_http_api["Frontend API Client<br/>[api.js]"]
  node_api_app["API Application<br/>[app.js]"]
  node_enquiry_controller["Enquiry Handling"]
  node_enquiry_service["Enquiry Processing<br/>[enquiryService.js]"]
  node_admin_controller["Admin Analytics<br/>[AdminController.js]"]
  node_report_controller["Monthly Reports"]
  node_review_controller["Review Moderation"]
  node_auth_routes["Admin Authentication Routes<br/>[authRoutes.js]"]
  node_review_routes["Review Routes<br/>[reviewRoutes.js]"]
  node_enquiry_routes["Enquiry Routes<br/>[enquiryRoutes.js]"]
  node_commerce_routes["Order &amp; Container Routes"]
end

subgraph group_data["Persistence"]
  node_enquiry_store[("Enquiry Records<br/>[Enquiry.js]")]
  node_popup_store[("Popup Lead Records<br/>[PopupLead.js]")]
  node_review_store[("Review Records<br/>[Review.js]")]
  node_visitor_store[("Visitor Records<br/>[Visitor.js]")]
end

node_visitor(("Website Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_frontend_routes
node_frontend_routes -->|"routes to"| node_catalogue
node_catalogue -->|"uses catalogue"| node_categories
node_frontend_routes -->|"routes to"| node_lead_forms
node_frontend_routes -->|"routes to"| node_admin_dashboard
node_frontend_routes -->|"routes to"| node_admin_reports
node_language -->|"loads strings"| node_language_strings
node_visitor -.->|"submits lead"| node_popup
node_visitor -.->|"generates activity"| node_visitor_tracking
node_lead_forms -.->|"submits enquiry"| node_lead_state
node_popup -.->|"submits lead"| node_lead_state
node_lead_state -->|"calls API"| node_http_api
node_review_state -->|"calls API"| node_http_api
node_admin_dashboard -->|"uses lead state"| node_lead_state
node_admin_dashboard -->|"uses review state"| node_review_state
node_admin_user -.->|"manages records"| node_admin_dashboard
node_admin_user -.->|"views analytics"| node_admin_reports
node_http_api -.->|"sends requests"| node_api_app
node_api_app -->|"mounts routes"| node_enquiry_routes
node_api_app -->|"mounts routes"| node_review_routes
node_api_app -->|"mounts routes"| node_auth_routes
node_enquiry_routes -->|"routes requests"| node_enquiry_controller
node_review_routes -->|"routes requests"| node_review_controller
node_auth_routes -->|"routes analytics"| node_admin_controller
node_auth_routes -->|"routes reports"| node_report_controller
node_enquiry_controller -->|"delegates processing"| node_enquiry_service
node_enquiry_controller -->|"reads and writes"| node_enquiry_store
node_enquiry_service -->|"uses records"| node_enquiry_store
node_enquiry_service -->|"uses records"| node_popup_store
node_review_controller -->|"reads and writes"| node_review_store
node_admin_controller -->|"queries"| node_visitor_store
node_admin_controller -->|"queries"| node_popup_store
node_admin_controller -->|"queries"| node_enquiry_store
node_admin_controller -->|"queries"| node_review_store
node_report_controller -->|"aggregates"| node_visitor_store
node_report_controller -->|"counts"| node_popup_store
node_report_controller -->|"counts"| node_enquiry_store
node_report_controller -->|"aggregates"| node_review_store
node_admin_dashboard -->|"includes module"| node_purchase_orders
node_purchase_orders -->|"calls API"| node_http_api
node_http_api -.->|"uses endpoints"| node_commerce_routes
node_visitor -.->|"tracks shipment"| node_container_tracking

click node_frontend_routes "https://github.com/omvazire/trivaltor/blob/main/frontend/src/App.jsx"
click node_catalogue "https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/Home.jsx"
click node_categories "https://github.com/omvazire/trivaltor/blob/main/frontend/src/config/categories.js"
click node_language "https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/LanguageContext.jsx"
click node_language_strings "https://github.com/omvazire/trivaltor/blob/main/frontend/src/config/translations.js"
click node_lead_forms "https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/BuyerLead.jsx"
click node_popup "https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/LeadPopup.jsx"
click node_visitor_tracking "https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/VisitorTracker.jsx"
click node_lead_state "https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/LeadContext.jsx"
click node_review_state "https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/ReviewContext.jsx"
click node_admin_dashboard "https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_admin_reports "https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/AdminReports.jsx"
click node_purchase_orders "https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/PurchaseOrderModule.jsx"
click node_container_tracking "https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/ContainerTracking.jsx"
click node_http_api "https://github.com/omvazire/trivaltor/blob/main/frontend/src/services/api.js"
click node_api_app "https://github.com/omvazire/trivaltor/blob/main/backend/src/app.js"
click node_enquiry_controller "https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/EnquiryController.js"
click node_enquiry_service "https://github.com/omvazire/trivaltor/blob/main/backend/src/services/enquiryService.js"
click node_admin_controller "https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/AdminController.js"
click node_report_controller "https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/ReportController.js"
click node_review_controller "https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/ReviewController.js"
click node_auth_routes "https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/authRoutes.js"
click node_review_routes "https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/reviewRoutes.js"
click node_enquiry_routes "https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/enquiryRoutes.js"
click node_enquiry_store "https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Enquiry.js"
click node_popup_store "https://github.com/omvazire/trivaltor/blob/main/backend/src/models/PopupLead.js"
click node_review_store "https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Review.js"
click node_visitor_store "https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Visitor.js"
click node_commerce_routes "https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/purchaseOrderRoutes.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_routes,node_catalogue,node_categories,node_language,node_language_strings toneBlue
class node_lead_forms,node_popup,node_visitor_tracking,node_lead_state,node_review_state toneAmber
class node_admin_dashboard,node_admin_reports,node_purchase_orders,node_container_tracking toneMint
class node_http_api,node_api_app,node_enquiry_controller,node_enquiry_service,node_admin_controller,node_report_controller,node_review_controller,node_auth_routes,node_review_routes,node_enquiry_routes,node_commerce_routes toneRose
class node_enquiry_store,node_popup_store,node_review_store,node_visitor_store,node_visitor,node_admin_user toneIndigo
```

## Components

### Public Website

- [Page Routing](https://github.com/omvazire/trivaltor/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Catalogue & Home](https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Product Categories](https://github.com/omvazire/trivaltor/blob/main/frontend/src/config/categories.js): `frontend/src/config/categories.js`
- [Language Content](https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/LanguageContext.jsx): `frontend/src/context/LanguageContext.jsx`
- [Translations](https://github.com/omvazire/trivaltor/blob/main/frontend/src/config/translations.js): `frontend/src/config/translations.js`

### Lead Management

- [Enquiry Forms](https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/BuyerLead.jsx): `frontend/src/pages/BuyerLead.jsx`
- [Popup Leads](https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/LeadPopup.jsx): `frontend/src/components/LeadPopup.jsx`
- [Visitor Tracking](https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/VisitorTracker.jsx): `frontend/src/components/VisitorTracker.jsx`
- [Lead State](https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/LeadContext.jsx): `frontend/src/context/LeadContext.jsx`
- [Review State](https://github.com/omvazire/trivaltor/blob/main/frontend/src/context/ReviewContext.jsx): `frontend/src/context/ReviewContext.jsx`

### Administration

- [Lead & Review Desk](https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Analytics & Reports](https://github.com/omvazire/trivaltor/blob/main/frontend/src/pages/AdminReports.jsx): `frontend/src/pages/AdminReports.jsx`
- [Purchase Orders](https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/PurchaseOrderModule.jsx): `frontend/src/components/PurchaseOrderModule.jsx`
- [Container Tracking](https://github.com/omvazire/trivaltor/blob/main/frontend/src/components/ContainerTracking.jsx): `frontend/src/components/ContainerTracking.jsx`

### Backend API

- [Frontend API Client](https://github.com/omvazire/trivaltor/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [API Application](https://github.com/omvazire/trivaltor/blob/main/backend/src/app.js): `backend/src/app.js`
- [Enquiry Handling](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/EnquiryController.js): `backend/src/controllers/EnquiryController.js`
- [Enquiry Processing](https://github.com/omvazire/trivaltor/blob/main/backend/src/services/enquiryService.js): `backend/src/services/enquiryService.js`
- [Admin Analytics](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/AdminController.js): `backend/src/controllers/AdminController.js`
- [Monthly Reports](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/ReportController.js): `backend/src/controllers/ReportController.js`
- [Review Moderation](https://github.com/omvazire/trivaltor/blob/main/backend/src/controllers/ReviewController.js): `backend/src/controllers/ReviewController.js`
- [Admin Authentication Routes](https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Review Routes](https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/reviewRoutes.js): `backend/src/routes/reviewRoutes.js`
- [Enquiry Routes](https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/enquiryRoutes.js): `backend/src/routes/enquiryRoutes.js`
- [Order & Container Routes](https://github.com/omvazire/trivaltor/blob/main/backend/src/routes/purchaseOrderRoutes.js): `backend/src/routes/purchaseOrderRoutes.js`

### Persistence

- [Enquiry Records](https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Enquiry.js): `backend/src/models/Enquiry.js`
- [Popup Lead Records](https://github.com/omvazire/trivaltor/blob/main/backend/src/models/PopupLead.js): `backend/src/models/PopupLead.js`
- [Review Records](https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Review.js): `backend/src/models/Review.js`
- [Visitor Records](https://github.com/omvazire/trivaltor/blob/main/backend/src/models/Visitor.js): `backend/src/models/Visitor.js`

### Other components

- **Website Visitor**
- **Administrator**

## Connections

- Website Visitor → Page Routing: browses (evidence: `frontend/src/App.jsx`)
- Page Routing → Catalogue & Home: routes to (evidence: `frontend/src/App.jsx`)
- Catalogue & Home → Product Categories: uses catalogue (evidence: `frontend/src/pages/Home.jsx`)
- Page Routing → Enquiry Forms: routes to (evidence: `frontend/src/App.jsx`)
- Page Routing → Lead & Review Desk: routes to (evidence: `frontend/src/App.jsx`)
- Page Routing → Analytics & Reports: routes to (evidence: `frontend/src/App.jsx`)
- Language Content → Translations: loads strings (evidence: `frontend/src/context/LanguageContext.jsx`)
- Website Visitor → Popup Leads: submits lead (evidence: `README.md`)
- Website Visitor → Visitor Tracking: generates activity (evidence: `README.md`)
- Enquiry Forms → Lead State: submits enquiry (evidence: `README.md`)
- Popup Leads → Lead State: submits lead (evidence: `README.md`)
- Lead State → Frontend API Client: calls API (evidence: `frontend/src/context/LeadContext.jsx`)
- Review State → Frontend API Client: calls API (evidence: `frontend/src/context/ReviewContext.jsx`)
- Lead & Review Desk → Lead State: uses lead state (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Lead & Review Desk → Review State: uses review state (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Administrator → Lead & Review Desk: manages records (evidence: `README.md`)
- Administrator → Analytics & Reports: views analytics (evidence: `README.md`)
- Frontend API Client → API Application: sends requests (evidence: `README.md`)
- API Application → Enquiry Routes: mounts routes (evidence: `backend/src/app.js`)
- API Application → Review Routes: mounts routes (evidence: `backend/src/app.js`)
- API Application → Admin Authentication Routes: mounts routes (evidence: `backend/src/app.js`)
- Enquiry Routes → Enquiry Handling: routes requests (evidence: `backend/src/routes/enquiryRoutes.js`)
- Review Routes → Review Moderation: routes requests (evidence: `backend/src/routes/reviewRoutes.js`)
- Admin Authentication Routes → Admin Analytics: routes analytics (evidence: `backend/src/routes/authRoutes.js`)
- Admin Authentication Routes → Monthly Reports: routes reports (evidence: `backend/src/routes/authRoutes.js`)
- Enquiry Handling → Enquiry Processing: delegates processing (evidence: `backend/src/controllers/EnquiryController.js`)
- Enquiry Handling → Enquiry Records: reads and writes (evidence: `backend/src/controllers/EnquiryController.js`)
- Enquiry Processing → Enquiry Records: uses records (evidence: `backend/src/services/enquiryService.js`)
- Enquiry Processing → Popup Lead Records: uses records (evidence: `backend/src/services/enquiryService.js`)
- Review Moderation → Review Records: reads and writes (evidence: `backend/src/controllers/ReviewController.js`)
- Admin Analytics → Visitor Records: queries (evidence: `backend/src/controllers/AdminController.js`)
- Admin Analytics → Popup Lead Records: queries (evidence: `backend/src/controllers/AdminController.js`)
- Admin Analytics → Enquiry Records: queries (evidence: `backend/src/controllers/AdminController.js`)
- Admin Analytics → Review Records: queries (evidence: `backend/src/controllers/AdminController.js`)
- Monthly Reports → Visitor Records: aggregates (evidence: `backend/src/controllers/ReportController.js`)
- Monthly Reports → Popup Lead Records: counts (evidence: `backend/src/controllers/ReportController.js`)
- Monthly Reports → Enquiry Records: counts (evidence: `backend/src/controllers/ReportController.js`)
- Monthly Reports → Review Records: aggregates (evidence: `backend/src/controllers/ReportController.js`)
- Lead & Review Desk → Purchase Orders: includes module (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Purchase Orders → Frontend API Client: calls API (evidence: `frontend/src/components/PurchaseOrderModule.jsx`)
- Frontend API Client → Order & Container Routes: uses endpoints (evidence: `README.md`)
- Website Visitor → Container Tracking: tracks shipment (evidence: `README.md`)
