# nayem-ahmedz/garments-production-tracking-system-client architecture

> Architecture diagram of the GitHub repository nayem-ahmedz/garments-production-tracking-system-client, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nayem-ahmedz/garments-production-tracking-system-client
- Repository: https://github.com/nayem-ahmedz/garments-production-tracking-system-client

## Overview

Smart Garments is a role-based garment ordering and production-tracking frontend. Buyers browse products, book orders, and follow order status; managers handle products and order approvals/tracking; admins manage users, products, orders, and analytics. The router mounts these experiences, while shared authentication and role checks guard access and secure API requests. The README documents several capabilities whose implementation was not sampled; those are retained with documented, rather than source-verified, links. Backend internals are outside this repository.

Main entry points: [`src/hooks/useAxiosSecure.jsx`](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/hooks/useAxiosSecure.jsx) (Authenticated API Client), [`src/routes/routes.jsx`](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/routes/routes.jsx) (Application Router), [`src/layout/dashboard/Dashboard.jsx`](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/layout/dashboard/Dashboard.jsx) (Dashboard Shell), [`src/context/AuthProvider.jsx`](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/context/AuthProvider.jsx) (Firebase Auth State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Public Experience"]
  node_router["Application Router<br/>[routes.jsx]"]
  node_public_site["Public Site<br/>[Root.jsx]"]
  node_home["Home &amp; Feedback"]
  node_catalog["Product Catalog<br/>[AllProducts.jsx]"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth_pages["Sign In &amp; Register"]
  node_auth_provider["Firebase Auth State<br/>[AuthProvider.jsx]"]
  node_private_access["Private Route Guard<br/>[PrivateRoutes.jsx]"]
  node_role_access["Role Guards<br/>[useRole.jsx]"]
end

subgraph group_buyer["Buyer Workflow"]
  node_booking["Order Booking<br/>[Booking.jsx]"]
  node_buyer_orders["Buyer Orders<br/>[MyOrders.jsx]"]
  node_tracking["Order Tracking<br/>[TrackOrders.jsx]"]
end

subgraph group_manager["Manager Workflow"]
  node_manager_products["Product Management"]
  node_manager_orders["Order Approval &amp; Tracking"]
end

subgraph group_admin["Administration"]
  node_admin_users["User Management<br/>[ManageUsers.jsx]"]
  node_admin_products["Product Administration<br/>[AllProducts.jsx]"]
  node_admin_orders["Order Administration<br/>[AllOrders.jsx]"]
  node_analytics["Business Analytics<br/>[AdminDashboard.jsx]"]
end

subgraph group_shared["Shared Runtime"]
  node_secure_api["Authenticated API Client<br/>[useAxiosSecure.jsx]"]
  node_dashboard_shell["Dashboard Shell<br/>[Dashboard.jsx]"]
  node_image_upload["Image Upload Helper<br/>[uploadToImageBB.js]"]
end

node_visitor(("Visitor / User"))
node_firebase["Firebase Authentication"]
node_backend["Backend API"]
node_image_host["ImageBB"]

node_visitor -->|"opens app"| node_router
node_router -->|"mounts public routes"| node_public_site
node_router -->|"routes authentication"| node_auth_pages
node_router -->|"routes catalog"| node_catalog
node_router -->|"routes booking"| node_booking
node_router -->|"mounts dashboard"| node_dashboard_shell
node_public_site -->|"renders home"| node_home
node_auth_pages -->|"uses auth actions"| node_auth_provider
node_auth_provider -->|"authenticates users"| node_firebase
node_router -->|"guards private routes"| node_private_access
node_private_access -->|"checks session"| node_auth_provider
node_private_access -->|"applies role guard"| node_role_access
node_role_access -->|"fetches user role"| node_secure_api
node_secure_api -->|"sends authorized requests"| node_backend
node_secure_api -->|"gets user token"| node_auth_provider
node_booking -->|"submits booking requests"| node_secure_api
node_buyer_orders -->|"loads order data"| node_secure_api
node_tracking -.->|"reads tracking status"| node_backend
node_dashboard_shell -.->|"hosts manager tools"| node_manager_products
node_dashboard_shell -.->|"hosts manager tools"| node_manager_orders
node_dashboard_shell -->|"hosts admin tools"| node_admin_users
node_dashboard_shell -->|"hosts admin tools"| node_admin_products
node_dashboard_shell -->|"hosts admin tools"| node_admin_orders
node_dashboard_shell -.->|"provides analytics"| node_analytics
node_manager_products -.->|"manages product data"| node_secure_api
node_manager_products -->|"uploads product images"| node_image_upload
node_manager_orders -.->|"updates order workflow"| node_secure_api
node_admin_users -->|"manages user roles"| node_secure_api
node_admin_products -.->|"manages product data"| node_secure_api
node_admin_orders -.->|"manages order status"| node_secure_api
node_image_upload -.->|"uploads images"| node_image_host

click node_router "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/routes/routes.jsx"
click node_public_site "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/layout/public/Root.jsx"
click node_home "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/home"
click node_catalog "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/products/AllProducts.jsx"
click node_auth_pages "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/auth"
click node_auth_provider "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/context/AuthProvider.jsx"
click node_private_access "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/routes/PrivateRoutes.jsx"
click node_role_access "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/hooks/useRole.jsx"
click node_secure_api "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/hooks/useAxiosSecure.jsx"
click node_booking "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/products/Booking.jsx"
click node_buyer_orders "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/buyer/MyOrders.jsx"
click node_tracking "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/buyer/TrackOrders.jsx"
click node_manager_products "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/dashboard/managers"
click node_manager_orders "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/dashboard/managers"
click node_admin_users "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/ManageUsers.jsx"
click node_admin_products "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/AllProducts.jsx"
click node_admin_orders "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/AllOrders.jsx"
click node_analytics "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/AdminDashboard.jsx"
click node_dashboard_shell "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/layout/dashboard/Dashboard.jsx"
click node_image_upload "https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/components/utils/uploadToImageBB.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_router,node_public_site,node_home,node_catalog,node_visitor toneBlue
class node_auth_pages,node_auth_provider,node_private_access,node_role_access toneAmber
class node_booking,node_buyer_orders,node_tracking,node_backend toneMint
class node_manager_products,node_manager_orders toneRose
class node_admin_users,node_admin_products,node_admin_orders,node_analytics,node_firebase,node_image_host toneIndigo
class node_secure_api,node_dashboard_shell,node_image_upload toneTeal
```

## Components

### Public Experience

- [Application Router](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/routes/routes.jsx): `src/routes/routes.jsx`
- [Public Site](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/layout/public/Root.jsx): `src/layout/public/Root.jsx`
- [Home & Feedback](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/home): `src/pages/home`
- [Product Catalog](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/products/AllProducts.jsx): `src/pages/products/AllProducts.jsx`

### Identity & Access

- [Sign In & Register](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/auth): `src/pages/auth`
- [Firebase Auth State](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/context/AuthProvider.jsx): `src/context/AuthProvider.jsx`
- [Private Route Guard](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/routes/PrivateRoutes.jsx): `src/routes/PrivateRoutes.jsx`
- [Role Guards](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/hooks/useRole.jsx): `src/hooks/useRole.jsx`

### Buyer Workflow

- [Order Booking](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/products/Booking.jsx): `src/pages/products/Booking.jsx`
- [Buyer Orders](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/buyer/MyOrders.jsx): `src/pages/dashboard/buyer/MyOrders.jsx`
- [Order Tracking](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/buyer/TrackOrders.jsx): `src/pages/dashboard/buyer/TrackOrders.jsx`

### Manager Workflow

- [Product Management](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/dashboard/managers): `src/pages/dashboard/managers`
- [Order Approval & Tracking](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/tree/main/src/pages/dashboard/managers): `src/pages/dashboard/managers`

### Administration

- [User Management](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/ManageUsers.jsx): `src/pages/dashboard/admin/ManageUsers.jsx`
- [Product Administration](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/AllProducts.jsx): `src/pages/dashboard/admin/AllProducts.jsx`
- [Order Administration](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/admin/AllOrders.jsx): `src/pages/dashboard/admin/AllOrders.jsx`
- [Business Analytics](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/pages/dashboard/AdminDashboard.jsx): `src/pages/dashboard/AdminDashboard.jsx`

### Shared Runtime

- [Authenticated API Client](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/hooks/useAxiosSecure.jsx): `src/hooks/useAxiosSecure.jsx`
- [Dashboard Shell](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/layout/dashboard/Dashboard.jsx): `src/layout/dashboard/Dashboard.jsx`
- [Image Upload Helper](https://github.com/nayem-ahmedz/garments-production-tracking-system-client/blob/main/src/components/utils/uploadToImageBB.js): `src/components/utils/uploadToImageBB.js`

### Other components

- **Visitor / User**
- **Firebase Authentication**
- **Backend API**
- **ImageBB**

## Connections

- Visitor / User → Application Router: opens app
- Application Router → Public Site: mounts public routes (evidence: `src/routes/routes.jsx`)
- Application Router → Sign In & Register: routes authentication (evidence: `src/routes/routes.jsx`)
- Application Router → Product Catalog: routes catalog (evidence: `src/routes/routes.jsx`)
- Application Router → Order Booking: routes booking (evidence: `src/routes/routes.jsx`)
- Application Router → Dashboard Shell: mounts dashboard (evidence: `src/routes/routes.jsx`)
- Public Site → Home & Feedback: renders home (evidence: `src/routes/routes.jsx`)
- Sign In & Register → Firebase Auth State: uses auth actions (evidence: `src/pages/auth/Login.jsx`)
- Firebase Auth State → Firebase Authentication: authenticates users (evidence: `src/context/AuthProvider.jsx`)
- Application Router → Private Route Guard: guards private routes (evidence: `src/routes/routes.jsx`)
- Private Route Guard → Firebase Auth State: checks session (evidence: `src/routes/PrivateRoutes.jsx`)
- Private Route Guard → Role Guards: applies role guard
- Role Guards → Authenticated API Client: fetches user role (evidence: `src/hooks/useRole.jsx`)
- Authenticated API Client → Backend API: sends authorized requests (evidence: `src/hooks/useAxiosSecure.jsx`)
- Authenticated API Client → Firebase Auth State: gets user token (evidence: `src/hooks/useAxiosSecure.jsx`)
- Order Booking → Authenticated API Client: submits booking requests (evidence: `src/pages/products/Booking.jsx`)
- Buyer Orders → Authenticated API Client: loads order data (evidence: `src/pages/dashboard/buyer/MyOrders.jsx`)
- Order Tracking → Backend API: reads tracking status
- Dashboard Shell → Product Management: hosts manager tools
- Dashboard Shell → Order Approval & Tracking: hosts manager tools
- Dashboard Shell → User Management: hosts admin tools (evidence: `src/routes/routes.jsx`)
- Dashboard Shell → Product Administration: hosts admin tools (evidence: `src/routes/routes.jsx`)
- Dashboard Shell → Order Administration: hosts admin tools (evidence: `src/routes/routes.jsx`)
- Dashboard Shell → Business Analytics: provides analytics
- Product Management → Authenticated API Client: manages product data (evidence: `src/pages/dashboard/managers/AddProduct.jsx`)
- Product Management → Image Upload Helper: uploads product images (evidence: `src/pages/dashboard/managers/AddProduct.jsx`)
- Order Approval & Tracking → Authenticated API Client: updates order workflow (evidence: `src/pages/dashboard/managers/AddProduct.jsx`)
- User Management → Authenticated API Client: manages user roles (evidence: `src/pages/dashboard/admin/ManageUsers.jsx`)
- Product Administration → Authenticated API Client: manages product data
- Order Administration → Authenticated API Client: manages order status
- Image Upload Helper → ImageBB: uploads images
