# veeraharikumaran2007-sudo/arceus-gear architecture

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

- Interactive diagram: https://gitdiagram.com/veeraharikumaran2007-sudo/arceus-gear
- Repository: https://github.com/veeraharikumaran2007-sudo/arceus-gear

## Overview

ARCEUS GEAR is a gaming-hardware ecommerce store. The customer path is product discovery and detail review, cart, simulated checkout, then order history; administrators manage catalog, orders, and users, while INFY AI supports catalog questions and comparisons. The client coordinates these experiences and switches between backend and Firebase/offline catalog behavior. Edges reflect explicit imports, calls, route registration, or README capabilities; unsampled features are included without asserting unshown internal wiring.

Main entry points: [`client/src/App.tsx`](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/App.tsx) (Store Experience), [`server/src/index.ts`](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/index.ts) (HTTP API), [`server/src/db.ts`](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/db.ts) (Prisma Client), [`client/src/services/api.ts`](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/services/api.ts) (API and Fallbacks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Storefront"]
  node_app["Store Experience<br/>[App.tsx]"]
  node_discovery["Product Discovery<br/>[App.tsx]"]
  node_product_detail["Product Details"]
  node_product_card["Product Cards<br/>[ProductCard.tsx]"]
  node_cart_ui["Cart Drawer<br/>[CartDrawer.tsx]"]
  node_checkout["Simulated Checkout"]
  node_orders_ui["Order History"]
  node_admin_ui["Admin Dashboard<br/>[AdminDashboard.tsx]"]
  node_auth_ui["Sign-in<br/>[AuthModal.tsx]"]
  node_ai_ui["AI Assistant<br/>[InfyAiDrawer.tsx]"]
  node_compare_ui["Product Comparison<br/>[CompareModal.tsx]"]
end

subgraph group_state["Client State"]
  node_auth_state["Authentication State<br/>[AuthContext.tsx]"]
  node_cart_state["Cart State<br/>[CartContext.tsx]"]
  node_compare_state["Comparison State<br/>[CompareContext.tsx]"]
  node_api_client["API and Fallbacks<br/>[api.ts]"]
end

subgraph group_backend["Commerce API"]
  node_server_entry["HTTP API<br/>[index.ts]"]
  node_auth_routes["Account Routes<br/>[auth.routes.ts]"]
  node_product_routes["Product Routes<br/>[product.routes.ts]"]
  node_category_routes["Category Routes<br/>[category.routes.ts]"]
  node_order_routes["Order Routes<br/>[order.routes.ts]"]
  node_admin_routes["Admin Routes<br/>[admin.routes.ts]"]
  node_auth_middleware["JWT Access Control<br/>[auth.ts]"]
end

subgraph group_data["Catalog and Persistence"]
  node_firebase[("Firebase Services<br/>[config.ts]")]
  node_local_catalog["Embedded Catalog<br/>[catalog.ts]"]
  node_prisma["Prisma Client<br/>[db.ts]"]
  node_database[("SQLite Database")]
end

subgraph group_ai["AI Assistance"]
  node_ai_routes["INFY AI and Compare<br/>[ai.routes.ts]"]
  node_gemini["Gemini API"]
  node_openrouter["OpenRouter API"]
end

node_shopper(("Shopper"))
node_admin_user(("Administrator"))

node_shopper -->|"browses"| node_app
node_admin_user -->|"opens"| node_app
node_app -->|"renders"| node_discovery
node_app -->|"renders"| node_product_card
node_app -->|"renders"| node_product_detail
node_app -->|"renders"| node_cart_ui
node_app -->|"renders"| node_checkout
node_app -->|"renders"| node_orders_ui
node_app -->|"renders"| node_admin_ui
node_app -.->|"renders"| node_ai_ui
node_app -->|"renders"| node_compare_ui
node_app -.->|"renders"| node_auth_ui
node_product_card -->|"adds items"| node_cart_state
node_product_card -->|"selects products"| node_compare_state
node_product_detail -->|"adds items"| node_cart_state
node_product_detail -->|"selects products"| node_compare_state
node_cart_ui -->|"uses"| node_cart_state
node_checkout -->|"reads cart"| node_cart_state
node_checkout -->|"submits order"| node_api_client
node_orders_ui -->|"loads orders"| node_firebase
node_admin_ui -->|"manages store"| node_api_client
node_auth_ui -.->|"authenticates"| node_auth_state
node_auth_state -->|"calls account API"| node_api_client
node_auth_state -->|"uses Google sign-in"| node_firebase
node_api_client -->|"loads catalog and saves orders"| node_firebase
node_api_client -->|"falls back to"| node_local_catalog
node_api_client -->|"requests API"| node_server_entry
node_server_entry -->|"registers"| node_auth_routes
node_server_entry -->|"registers"| node_product_routes
node_server_entry -->|"registers"| node_category_routes
node_server_entry -->|"registers"| node_order_routes
node_server_entry -->|"registers"| node_admin_routes
node_server_entry -->|"registers"| node_ai_routes
node_auth_routes -->|"uses"| node_auth_middleware
node_product_routes -->|"uses"| node_auth_middleware
node_category_routes -->|"uses"| node_auth_middleware
node_order_routes -->|"uses"| node_auth_middleware
node_admin_routes -->|"uses"| node_auth_middleware
node_auth_middleware -->|"checks users"| node_prisma
node_auth_routes -->|"queries"| node_prisma
node_product_routes -->|"queries"| node_prisma
node_category_routes -->|"queries"| node_prisma
node_order_routes -->|"queries"| node_prisma
node_admin_routes -->|"queries"| node_prisma
node_ai_routes -->|"reads catalog"| node_prisma
node_prisma -.->|"persists data"| node_database
node_ai_ui -->|"asks questions"| node_api_client
node_compare_ui -->|"reads selection"| node_compare_state

click node_app "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/App.tsx"
click node_discovery "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/App.tsx"
click node_product_detail "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/ProductDetailModal.tsx"
click node_product_card "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/ProductCard.tsx"
click node_cart_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/CartDrawer.tsx"
click node_checkout "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/SimulatedCheckoutModal.tsx"
click node_orders_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/OrderHistoryModal.tsx"
click node_admin_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/AdminDashboard.tsx"
click node_auth_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/AuthModal.tsx"
click node_auth_state "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/AuthContext.tsx"
click node_cart_state "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/CartContext.tsx"
click node_compare_state "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/CompareContext.tsx"
click node_api_client "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/services/api.ts"
click node_firebase "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/firebase/config.ts"
click node_local_catalog "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/data/catalog.ts"
click node_server_entry "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/index.ts"
click node_auth_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/auth.routes.ts"
click node_product_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/product.routes.ts"
click node_category_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/category.routes.ts"
click node_order_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/order.routes.ts"
click node_admin_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/admin.routes.ts"
click node_auth_middleware "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/middleware/auth.ts"
click node_prisma "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/db.ts"
click node_ai_routes "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/ai.routes.ts"
click node_ai_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/InfyAiDrawer.tsx"
click node_compare_ui "https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/CompareModal.tsx"

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_discovery,node_product_detail,node_product_card,node_cart_ui,node_checkout,node_orders_ui,node_admin_ui,node_auth_ui,node_ai_ui,node_compare_ui toneBlue
class node_auth_state,node_cart_state,node_compare_state,node_api_client toneAmber
class node_server_entry,node_auth_routes,node_product_routes,node_category_routes,node_order_routes,node_admin_routes,node_auth_middleware toneMint
class node_firebase,node_local_catalog,node_prisma,node_database toneRose
class node_ai_routes,node_gemini,node_openrouter,node_shopper,node_admin_user toneIndigo
```

## Components

### Storefront

- [Store Experience](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Product Discovery](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Product Details](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/ProductDetailModal.tsx): `client/src/components/ProductDetailModal.tsx`
- [Product Cards](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/ProductCard.tsx): `client/src/components/ProductCard.tsx`
- [Cart Drawer](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/CartDrawer.tsx): `client/src/components/CartDrawer.tsx`
- [Simulated Checkout](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/SimulatedCheckoutModal.tsx): `client/src/components/SimulatedCheckoutModal.tsx`
- [Order History](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/OrderHistoryModal.tsx): `client/src/components/OrderHistoryModal.tsx`
- [Admin Dashboard](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/AdminDashboard.tsx): `client/src/components/AdminDashboard.tsx`
- [Sign-in](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/AuthModal.tsx): `client/src/components/AuthModal.tsx`
- [AI Assistant](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/InfyAiDrawer.tsx): `client/src/components/InfyAiDrawer.tsx`
- [Product Comparison](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/components/CompareModal.tsx): `client/src/components/CompareModal.tsx`

### Client State

- [Authentication State](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/AuthContext.tsx): `client/src/context/AuthContext.tsx`
- [Cart State](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/CartContext.tsx): `client/src/context/CartContext.tsx`
- [Comparison State](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/context/CompareContext.tsx): `client/src/context/CompareContext.tsx`
- [API and Fallbacks](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/services/api.ts): `client/src/services/api.ts`

### Commerce API

- [HTTP API](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/index.ts): `server/src/index.ts`
- [Account Routes](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/auth.routes.ts): `server/src/routes/auth.routes.ts`
- [Product Routes](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/product.routes.ts): `server/src/routes/product.routes.ts`
- [Category Routes](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/category.routes.ts): `server/src/routes/category.routes.ts`
- [Order Routes](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/order.routes.ts): `server/src/routes/order.routes.ts`
- [Admin Routes](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/admin.routes.ts): `server/src/routes/admin.routes.ts`
- [JWT Access Control](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/middleware/auth.ts): `server/src/middleware/auth.ts`

### Catalog and Persistence

- [Firebase Services](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/firebase/config.ts): `client/src/firebase/config.ts`
- [Embedded Catalog](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/client/src/data/catalog.ts): `client/src/data/catalog.ts`
- [Prisma Client](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/db.ts): `server/src/db.ts`
- **SQLite Database**

### AI Assistance

- [INFY AI and Compare](https://github.com/veeraharikumaran2007-sudo/arceus-gear/blob/main/server/src/routes/ai.routes.ts): `server/src/routes/ai.routes.ts`
- **Gemini API**
- **OpenRouter API**

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Store Experience: browses (evidence: `client/src/App.tsx`)
- Administrator → Store Experience: opens (evidence: `client/src/App.tsx`)
- Store Experience → Product Discovery: renders (evidence: `client/src/App.tsx`)
- Store Experience → Product Cards: renders (evidence: `client/src/App.tsx`)
- Store Experience → Product Details: renders (evidence: `client/src/App.tsx`)
- Store Experience → Cart Drawer: renders (evidence: `client/src/App.tsx`)
- Store Experience → Simulated Checkout: renders (evidence: `client/src/App.tsx`)
- Store Experience → Order History: renders (evidence: `client/src/App.tsx`)
- Store Experience → Admin Dashboard: renders (evidence: `client/src/App.tsx`)
- Store Experience → AI Assistant: renders
- Store Experience → Product Comparison: renders (evidence: `client/src/App.tsx`)
- Store Experience → Sign-in: renders (evidence: `client/src/App.tsx`)
- Product Cards → Cart State: adds items (evidence: `client/src/components/ProductCard.tsx`)
- Product Cards → Comparison State: selects products (evidence: `client/src/components/ProductCard.tsx`)
- Product Details → Cart State: adds items (evidence: `client/src/components/ProductDetailModal.tsx`)
- Product Details → Comparison State: selects products (evidence: `client/src/components/ProductDetailModal.tsx`)
- Cart Drawer → Cart State: uses (evidence: `client/src/components/CartDrawer.tsx`)
- Simulated Checkout → Cart State: reads cart (evidence: `client/src/components/SimulatedCheckoutModal.tsx`)
- Simulated Checkout → API and Fallbacks: submits order (evidence: `client/src/components/SimulatedCheckoutModal.tsx`)
- Order History → Firebase Services: loads orders (evidence: `client/src/components/OrderHistoryModal.tsx`)
- Admin Dashboard → API and Fallbacks: manages store (evidence: `client/src/components/AdminDashboard.tsx`)
- Sign-in → Authentication State: authenticates (evidence: `client/src/components/AuthModal.tsx`)
- Authentication State → API and Fallbacks: calls account API (evidence: `client/src/context/AuthContext.tsx`)
- Authentication State → Firebase Services: uses Google sign-in (evidence: `client/src/context/AuthContext.tsx`)
- API and Fallbacks → Firebase Services: loads catalog and saves orders (evidence: `client/src/services/api.ts`)
- API and Fallbacks → Embedded Catalog: falls back to (evidence: `client/src/services/api.ts`)
- API and Fallbacks → HTTP API: requests API (evidence: `client/src/services/api.ts`)
- HTTP API → Account Routes: registers (evidence: `server/src/index.ts`)
- HTTP API → Product Routes: registers (evidence: `server/src/index.ts`)
- HTTP API → Category Routes: registers (evidence: `server/src/index.ts`)
- HTTP API → Order Routes: registers (evidence: `server/src/index.ts`)
- HTTP API → Admin Routes: registers (evidence: `server/src/index.ts`)
- HTTP API → INFY AI and Compare: registers (evidence: `server/src/index.ts`)
- Account Routes → JWT Access Control: uses (evidence: `server/src/routes/auth.routes.ts`)
- Product Routes → JWT Access Control: uses (evidence: `server/src/routes/product.routes.ts`)
- Category Routes → JWT Access Control: uses (evidence: `server/src/routes/category.routes.ts`)
- Order Routes → JWT Access Control: uses (evidence: `server/src/routes/order.routes.ts`)
- Admin Routes → JWT Access Control: uses (evidence: `server/src/routes/admin.routes.ts`)
- JWT Access Control → Prisma Client: checks users (evidence: `server/src/middleware/auth.ts`)
- Account Routes → Prisma Client: queries (evidence: `server/src/routes/auth.routes.ts`)
- Product Routes → Prisma Client: queries (evidence: `server/src/routes/product.routes.ts`)
- Category Routes → Prisma Client: queries (evidence: `server/src/routes/category.routes.ts`)
- Order Routes → Prisma Client: queries (evidence: `server/src/routes/order.routes.ts`)
- Admin Routes → Prisma Client: queries (evidence: `server/src/routes/admin.routes.ts`)
- INFY AI and Compare → Prisma Client: reads catalog (evidence: `server/src/routes/ai.routes.ts`)
- Prisma Client → SQLite Database: persists data
- AI Assistant → API and Fallbacks: asks questions
- Product Comparison → Comparison State: reads selection (evidence: `client/src/components/CompareModal.tsx`)
