# suvarnajewellers12-boop/suvarnagold architecture

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

- Interactive diagram: https://gitdiagram.com/suvarnajewellers12-boop/suvarnagold
- Repository: https://github.com/suvarnajewellers12-boop/suvarnagold

## Overview

Suvarna appears to be a jewelry-store operations application, with staff and administrators using a routed web interface for billing, inventory, customer orders, gold operations, schemes, and reporting. The visible entry flow is browser navigation through the frontend router into role-specific pages; those pages represent the business work, while a separate Next.js backend exposes corresponding API domains. The excerpts do not show frontend-to-backend requests, so those links are intentionally omitted. The README is empty, and several backend modules are represented only by their tree paths.

Main entry points: [`frontend/src/App.tsx`](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/App.tsx) (Web application), [`frontend/src/components/context/AccessibilityContext.tsx`](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/components/context/AccessibilityContext.tsx) (Accessibility settings), [`frontend/src/hooks/useSpeech.tsx`](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useSpeech.tsx) (Speech controls), [`frontend/src/hooks/useKeyboardShortcuts.ts`](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useKeyboardShortcuts.ts) (Keyboard navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_frontend["Web application<br/>[App.tsx]"]
  node_accessibility["Accessibility settings"]
  node_speech["Speech controls<br/>[useSpeech.tsx]"]
  node_shortcuts["Keyboard navigation"]
end

subgraph group_operations["Store operations"]
  node_login["Login<br/>[Login.tsx]"]
  node_dashboard["Dashboard and rates<br/>[Dashboard.tsx]"]
  node_billing["Billing<br/>[Billing.tsx]"]
  node_customers["Customer records<br/>[Customers.tsx]"]
  node_orders["Customer orders<br/>[CustomerOrder.tsx]"]
  node_estimation["Estimation terminal"]
  node_credit["Credit notes<br/>[CreditNote.tsx]"]
  node_coupons["Coupon management"]
  node_schemes["Savings schemes<br/>[CreateScheme.tsx]"]
end

subgraph group_catalog["Inventory and gold"]
  node_products["Product inventory<br/>[Products.tsx]"]
  node_goldjob["Gold job work"]
  node_goldpurchase["Gold purchasing"]
end

subgraph group_admin["Administration"]
  node_adminmanagement["Admin management"]
  node_staff["Staff management<br/>[staff.tsx]"]
  node_reports["Reports<br/>[Reports.tsx]"]
  node_adminbilling["Admin billing<br/>[AdminBilling.tsx]"]
  node_admincredit["Admin credit notes"]
  node_admincustomers["Admin customers<br/>[AdminCustomer.tsx]"]
  node_adminorders["Admin orders"]
  node_adminreports["Admin reports<br/>[AdminReports.tsx]"]
  node_adminproducts["Admin products<br/>[AdminProducts.tsx]"]
  node_adminschemes["Admin schemes"]
  node_admincoupon["Admin coupons<br/>[AdminSettings.tsx]"]
end

subgraph group_backend["Backend API domains"]
  node_authapi["Authentication API"]
  node_customerapi["Customer API"]
  node_productapi["Product API"]
  node_goldapi["Gold operations API"]
  node_paymentapi["Payments API"]
  node_schemeapi["Schemes API"]
end

node_user(("Store user"))

node_user -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_login
node_frontend -->|"routes to"| node_dashboard
node_frontend -->|"routes to"| node_orders
node_frontend -->|"routes to"| node_adminorders
node_frontend -->|"routes to"| node_adminbilling
node_frontend -->|"routes to"| node_admincredit
node_frontend -->|"routes to"| node_adminproducts
node_frontend -->|"routes to"| node_adminreports
node_frontend -->|"routes to"| node_adminschemes
node_frontend -->|"provides context"| node_accessibility
node_frontend -->|"announces routes"| node_speech
node_frontend -->|"enables navigation"| node_shortcuts
node_speech -->|"reads setting"| node_accessibility
node_shortcuts -->|"reads setting"| node_accessibility

click node_frontend "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/App.tsx"
click node_accessibility "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/components/context/AccessibilityContext.tsx"
click node_speech "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useSpeech.tsx"
click node_shortcuts "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useKeyboardShortcuts.ts"
click node_login "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Login.tsx"
click node_dashboard "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Dashboard.tsx"
click node_billing "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Billing.tsx"
click node_customers "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Customers.tsx"
click node_orders "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CustomerOrder.tsx"
click node_estimation "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/EstimationTerminal.tsx"
click node_credit "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CreditNote.tsx"
click node_coupons "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CouponManagement.tsx"
click node_schemes "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CreateScheme.tsx"
click node_products "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Products.tsx"
click node_goldjob "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/GoldJobWorkPage.tsx"
click node_goldpurchase "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/GoldPurchasePage.tsx"
click node_adminmanagement "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/AdminManagement.tsx"
click node_staff "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/staff.tsx"
click node_reports "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Reports.tsx"
click node_adminbilling "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminBilling.tsx"
click node_admincredit "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCreditnote.tsx"
click node_admincustomers "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCustomer.tsx"
click node_adminorders "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCustomerorder.tsx"
click node_adminreports "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminReports.tsx"
click node_adminproducts "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminProducts.tsx"
click node_adminschemes "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCreateSchemes.tsx"
click node_admincoupon "https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminSettings.tsx"
click node_authapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/auth"
click node_customerapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/customers"
click node_productapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/products"
click node_goldapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/gold"
click node_paymentapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/payment"
click node_schemeapi "https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/schemes"

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,node_accessibility,node_speech,node_shortcuts,node_user toneBlue
class node_login,node_dashboard,node_billing,node_customers,node_orders,node_estimation,node_credit,node_coupons,node_schemes toneAmber
class node_products,node_goldjob,node_goldpurchase toneMint
class node_adminmanagement,node_staff,node_reports,node_adminbilling,node_admincredit,node_admincustomers,node_adminorders,node_adminreports,node_adminproducts,node_adminschemes,node_admincoupon toneRose
class node_authapi,node_customerapi,node_productapi,node_goldapi,node_paymentapi,node_schemeapi toneIndigo
```

## Components

### Application shell

- [Web application](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Accessibility settings](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/components/context/AccessibilityContext.tsx): `frontend/src/components/context/AccessibilityContext.tsx`
- [Speech controls](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useSpeech.tsx): `frontend/src/hooks/useSpeech.tsx`
- [Keyboard navigation](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/hooks/useKeyboardShortcuts.ts): `frontend/src/hooks/useKeyboardShortcuts.ts`

### Store operations

- [Login](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Dashboard and rates](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Billing](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Billing.tsx): `frontend/src/pages/Billing.tsx`
- [Customer records](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Customers.tsx): `frontend/src/pages/Customers.tsx`
- [Customer orders](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CustomerOrder.tsx): `frontend/src/pages/CustomerOrder.tsx`
- [Estimation terminal](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/EstimationTerminal.tsx): `frontend/src/pages/EstimationTerminal.tsx`
- [Credit notes](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CreditNote.tsx): `frontend/src/pages/CreditNote.tsx`
- [Coupon management](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CouponManagement.tsx): `frontend/src/pages/CouponManagement.tsx`
- [Savings schemes](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/CreateScheme.tsx): `frontend/src/pages/CreateScheme.tsx`

### Inventory and gold

- [Product inventory](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Products.tsx): `frontend/src/pages/Products.tsx`
- [Gold job work](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/GoldJobWorkPage.tsx): `frontend/src/pages/GoldJobWorkPage.tsx`
- [Gold purchasing](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/GoldPurchasePage.tsx): `frontend/src/pages/GoldPurchasePage.tsx`

### Administration

- [Admin management](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/AdminManagement.tsx): `frontend/src/pages/AdminManagement.tsx`
- [Staff management](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/staff.tsx): `frontend/src/pages/staff.tsx`
- [Reports](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/Reports.tsx): `frontend/src/pages/Reports.tsx`
- [Admin billing](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminBilling.tsx): `frontend/src/pages/admin/AdminBilling.tsx`
- [Admin credit notes](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCreditnote.tsx): `frontend/src/pages/admin/AdminCreditnote.tsx`
- [Admin customers](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCustomer.tsx): `frontend/src/pages/admin/AdminCustomer.tsx`
- [Admin orders](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCustomerorder.tsx): `frontend/src/pages/admin/AdminCustomerorder.tsx`
- [Admin reports](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminReports.tsx): `frontend/src/pages/admin/AdminReports.tsx`
- [Admin products](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminProducts.tsx): `frontend/src/pages/admin/AdminProducts.tsx`
- [Admin schemes](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminCreateSchemes.tsx): `frontend/src/pages/admin/AdminCreateSchemes.tsx`
- [Admin coupons](https://github.com/suvarnajewellers12-boop/suvarnagold/blob/main/frontend/src/pages/admin/AdminSettings.tsx): `frontend/src/pages/admin/AdminSettings.tsx`

### Backend API domains

- [Authentication API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/auth): `suvarna-backend/app/api/auth`
- [Customer API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/customers): `suvarna-backend/app/api/customers`
- [Product API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/products): `suvarna-backend/app/api/products`
- [Gold operations API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/gold): `suvarna-backend/app/api/gold`
- [Payments API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/payment): `suvarna-backend/app/api/payment`
- [Schemes API](https://github.com/suvarnajewellers12-boop/suvarnagold/tree/main/suvarna-backend/app/api/schemes): `suvarna-backend/app/api/schemes`

### Other components

- **Store user**

## Connections

- Store user → Web application: uses
- Web application → Login: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Dashboard and rates: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Customer orders: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin orders: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin billing: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin credit notes: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin products: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin reports: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Admin schemes: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Accessibility settings: provides context (evidence: `frontend/src/App.tsx`)
- Web application → Speech controls: announces routes (evidence: `frontend/src/App.tsx`)
- Web application → Keyboard navigation: enables navigation (evidence: `frontend/src/App.tsx`)
- Speech controls → Accessibility settings: reads setting (evidence: `frontend/src/hooks/useSpeech.tsx`)
- Keyboard navigation → Accessibility settings: reads setting (evidence: `frontend/src/hooks/useKeyboardShortcuts.ts`)
