# honeycomb1909/quickit-hub architecture

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

- Interactive diagram: https://gitdiagram.com/honeycomb1909/quickit-hub
- Repository: https://github.com/honeycomb1909/quickit-hub

## Overview

QUICKit is a grocery ordering and delivery application with customer, admin, and delivery-agent experiences. The visible workflow starts at role-based sign-in, branches to browsing and checkout or operational screens, and uses a shared API backed by product, user, and order storage. The sampled server code confirms API-to-storage behavior and order stock/credit updates. Several page implementations and client hooks were not excerpted, so their API connections are left unverified rather than presented as observed calls.

Main entry points: [`server/routes.ts`](https://github.com/honeycomb1909/quickit-hub/blob/main/server/routes.ts) (API Handlers), [`client/src/App.tsx`](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/App.tsx) (App Router), [`client/src/pages/Auth.tsx`](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Auth.tsx) (Sign-in and Roles), [`server/storage.ts`](https://github.com/honeycomb1909/quickit-hub/blob/main/server/storage.ts) (Database Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer and Staff App"]
  node_entry["App Router<br/>[App.tsx]"]
  node_auth["Sign-in and Roles<br/>[Auth.tsx]"]
  node_authhooks["Auth API Hooks<br/>[use-auth-api.ts]"]
  node_authstate["Auth State<br/>[auth.tsx]"]
  node_store["Product Store<br/>[Store.tsx]"]
  node_cart["Cart State<br/>[cart.tsx]"]
  node_cartdrawer["Cart Drawer<br/>[CartDrawer.tsx]"]
  node_checkout["Checkout<br/>[Checkout.tsx]"]
  node_admin["Inventory and Orders<br/>[Admin.tsx]"]
  node_delivery["Delivery Operations<br/>[Delivery.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_query["Query Client<br/>[queryClient.ts]"]
  node_credit["Credit Status Hook"]
  node_ordershook["Orders Hook<br/>[use-orders.ts]"]
  node_products["Products Hook<br/>[use-products.ts]"]
  node_notfound["Not Found<br/>[not-found.tsx]"]
end

subgraph group_api["API and Contracts"]
  node_server["HTTP Server<br/>[index.ts]"]
  node_routes["API Handlers<br/>[routes.ts]"]
  node_contracts["API Contracts<br/>[routes.ts]"]
end

subgraph group_data["Persistence"]
  node_storage["Database Storage<br/>[storage.ts]"]
  node_db[("PostgreSQL Connection<br/>[db.ts]")]
  node_schema["Domain Schema<br/>[schema.ts]"]
end

node_user(("Shopper or Staff"))

node_user -->|"opens app"| node_entry
node_entry -->|"routes to"| node_auth
node_entry -->|"routes to"| node_store
node_entry -->|"routes to"| node_checkout
node_entry -->|"routes to"| node_admin
node_entry -->|"routes to"| node_delivery
node_entry -->|"falls back"| node_notfound
node_entry -->|"provides"| node_query
node_auth -->|"uses"| node_authhooks
node_auth -->|"uses"| node_authstate
node_server -->|"registers routes"| node_routes
node_routes -->|"calls"| node_storage
node_routes -->|"uses API paths"| node_contracts
node_storage -->|"queries"| node_db
node_storage -->|"uses tables"| node_schema
node_auth -.->|"submits credentials"| node_routes
node_store -.->|"requests products"| node_routes
node_checkout -.->|"submits orders"| node_routes
node_admin -.->|"manages inventory and orders"| node_routes
node_delivery -.->|"updates delivery status"| node_routes
node_cart -.->|"renders cart"| node_cartdrawer
node_products -.->|"requests product data"| node_routes
node_ordershook -.->|"requests order data"| node_routes
node_credit -.->|"requests credit status"| node_routes

click node_entry "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/App.tsx"
click node_auth "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Auth.tsx"
click node_authhooks "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-auth-api.ts"
click node_authstate "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/auth.tsx"
click node_store "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Store.tsx"
click node_cart "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/cart.tsx"
click node_cartdrawer "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/components/cart/CartDrawer.tsx"
click node_checkout "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Checkout.tsx"
click node_admin "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Admin.tsx"
click node_delivery "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Delivery.tsx"
click node_navbar "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/components/layout/Navbar.tsx"
click node_query "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/queryClient.ts"
click node_credit "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-credit-status.ts"
click node_ordershook "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-orders.ts"
click node_products "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-products.ts"
click node_notfound "https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/not-found.tsx"
click node_server "https://github.com/honeycomb1909/quickit-hub/blob/main/server/index.ts"
click node_routes "https://github.com/honeycomb1909/quickit-hub/blob/main/server/routes.ts"
click node_contracts "https://github.com/honeycomb1909/quickit-hub/blob/main/shared/routes.ts"
click node_storage "https://github.com/honeycomb1909/quickit-hub/blob/main/server/storage.ts"
click node_db "https://github.com/honeycomb1909/quickit-hub/blob/main/server/db.ts"
click node_schema "https://github.com/honeycomb1909/quickit-hub/blob/main/shared/schema.ts"

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_entry,node_auth,node_authhooks,node_authstate,node_store,node_cart,node_cartdrawer,node_checkout,node_admin,node_delivery,node_navbar,node_query,node_credit,node_ordershook,node_products,node_notfound toneBlue
class node_server,node_routes,node_contracts toneAmber
class node_storage,node_db,node_schema toneMint
class node_user toneIndigo
```

## Components

### Customer and Staff App

- [App Router](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Sign-in and Roles](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Auth.tsx): `client/src/pages/Auth.tsx`
- [Auth API Hooks](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-auth-api.ts): `client/src/hooks/use-auth-api.ts`
- [Auth State](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/auth.tsx): `client/src/lib/auth.tsx`
- [Product Store](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Store.tsx): `client/src/pages/Store.tsx`
- [Cart State](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/cart.tsx): `client/src/lib/cart.tsx`
- [Cart Drawer](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/components/cart/CartDrawer.tsx): `client/src/components/cart/CartDrawer.tsx`
- [Checkout](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Checkout.tsx): `client/src/pages/Checkout.tsx`
- [Inventory and Orders](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Admin.tsx): `client/src/pages/Admin.tsx`
- [Delivery Operations](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/Delivery.tsx): `client/src/pages/Delivery.tsx`
- [Navigation](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/components/layout/Navbar.tsx): `client/src/components/layout/Navbar.tsx`
- [Query Client](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/lib/queryClient.ts): `client/src/lib/queryClient.ts`
- [Credit Status Hook](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-credit-status.ts): `client/src/hooks/use-credit-status.ts`
- [Orders Hook](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-orders.ts): `client/src/hooks/use-orders.ts`
- [Products Hook](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/hooks/use-products.ts): `client/src/hooks/use-products.ts`
- [Not Found](https://github.com/honeycomb1909/quickit-hub/blob/main/client/src/pages/not-found.tsx): `client/src/pages/not-found.tsx`

### API and Contracts

- [HTTP Server](https://github.com/honeycomb1909/quickit-hub/blob/main/server/index.ts): `server/index.ts`
- [API Handlers](https://github.com/honeycomb1909/quickit-hub/blob/main/server/routes.ts): `server/routes.ts`
- [API Contracts](https://github.com/honeycomb1909/quickit-hub/blob/main/shared/routes.ts): `shared/routes.ts`

### Persistence

- [Database Storage](https://github.com/honeycomb1909/quickit-hub/blob/main/server/storage.ts): `server/storage.ts`
- [PostgreSQL Connection](https://github.com/honeycomb1909/quickit-hub/blob/main/server/db.ts): `server/db.ts`
- [Domain Schema](https://github.com/honeycomb1909/quickit-hub/blob/main/shared/schema.ts): `shared/schema.ts`

### Other components

- **Shopper or Staff**

## Connections

- Shopper or Staff → App Router: opens app
- App Router → Sign-in and Roles: routes to (evidence: `client/src/App.tsx`)
- App Router → Product Store: routes to (evidence: `client/src/App.tsx`)
- App Router → Checkout: routes to (evidence: `client/src/App.tsx`)
- App Router → Inventory and Orders: routes to (evidence: `client/src/App.tsx`)
- App Router → Delivery Operations: routes to (evidence: `client/src/App.tsx`)
- App Router → Not Found: falls back (evidence: `client/src/App.tsx`)
- App Router → Query Client: provides (evidence: `client/src/App.tsx`)
- Sign-in and Roles → Auth API Hooks: uses (evidence: `client/src/pages/Auth.tsx`)
- Sign-in and Roles → Auth State: uses (evidence: `client/src/pages/Auth.tsx`)
- HTTP Server → API Handlers: registers routes (evidence: `server/index.ts`)
- API Handlers → Database Storage: calls (evidence: `server/routes.ts`)
- API Handlers → API Contracts: uses API paths (evidence: `server/routes.ts`)
- Database Storage → PostgreSQL Connection: queries (evidence: `server/storage.ts`)
- Database Storage → Domain Schema: uses tables (evidence: `server/storage.ts`)
- Sign-in and Roles → API Handlers: submits credentials
- Product Store → API Handlers: requests products
- Checkout → API Handlers: submits orders
- Inventory and Orders → API Handlers: manages inventory and orders
- Delivery Operations → API Handlers: updates delivery status
- Cart State → Cart Drawer: renders cart
- Products Hook → API Handlers: requests product data
- Orders Hook → API Handlers: requests order data
- Credit Status Hook → API Handlers: requests credit status
