# tonblognet/trappola architecture

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

## Overview

TRAPPOLA is a clothing-brand web shop: visitors browse products, manage a browser-side cart, and submit an order; in API mode the server rechecks price and availability and stores the order in PostgreSQL. A React app routes requests to storefront pages, with a separate admin experience for catalog, inventory, images, settings, and order management. The README also describes a demo content studio and static demo catalog. Relationships reflect shown calls and imports; client/server links not established by excerpts are marked unverified.

Main entry points: [`src/App.tsx`](https://github.com/tonblognet/trappola/blob/main/src/App.tsx) (App Router), [`server/routes/admin.ts`](https://github.com/tonblognet/trappola/blob/main/server/routes/admin.ts) (Admin Routes), [`server/routes/public.ts`](https://github.com/tonblognet/trappola/blob/main/server/routes/public.ts) (Public Routes), [`src/lib/catalog.ts`](https://github.com/tonblognet/trappola/blob/main/src/lib/catalog.ts) (Catalog Logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App Router<br/>[App.tsx]"]
  node_route_state["Route State<br/>[useRouter.ts]"]
  node_catalog_page["Catalog Page<br/>[CatalogPage.tsx]"]
  node_product_page["Product Page<br/>[ProductPage.tsx]"]
  node_checkout_page["Checkout Page<br/>[CheckoutPage.tsx]"]
  node_content_pages["Content Pages<br/>[ContentPages.tsx]"]
  node_product_visual["Product Visual<br/>[ProductVisual.tsx]"]
end

subgraph group_browser_state["Browser State"]
  node_catalog_state["Catalog Logic<br/>[catalog.ts]"]
  node_cart_state["Cart Logic<br/>[cart.ts]"]
  node_order_state["Demo Orders<br/>[orders.ts]"]
  node_browser_storage["Browser Storage<br/>[storage.ts]"]
  node_studio["Content Studio<br/>[StudioPage.tsx]"]
end

subgraph group_admin["Administration"]
  node_admin_page["Admin Console<br/>[AdminPage.tsx]"]
  node_admin_client["Admin API Client<br/>[adminApi.ts]"]
end

subgraph group_backend["API and Data"]
  node_api_client["Public API Client<br/>[api.ts]"]
  node_api_app["HTTP App<br/>[app.ts]"]
  node_public_routes["Public Routes<br/>[public.ts]"]
  node_admin_routes["Admin Routes<br/>[admin.ts]"]
  node_catalog_service["Catalog Service<br/>[catalog.ts]"]
  node_order_service["Order Service<br/>[orders.ts]"]
  node_security["Session Security<br/>[security.ts]"]
  node_database[("PostgreSQL<br/>[db.ts]")]
  node_uploads["Image Uploads<br/>[admin.ts]"]
end

node_shopper(("Shopper"))

node_shopper -->|"browses"| node_app
node_app -->|"tracks routes"| node_route_state
node_app -->|"renders"| node_catalog_page
node_app -->|"renders"| node_product_page
node_app -->|"renders"| node_checkout_page
node_app -->|"renders"| node_content_pages
node_app -->|"loads catalog"| node_catalog_state
node_app -->|"updates cart"| node_cart_state
node_app -->|"creates demo order"| node_order_state
node_app -->|"persists cart"| node_browser_storage
node_app -->|"fetches products"| node_api_client
node_app -->|"submits order"| node_api_client
node_app -->|"renders demo studio"| node_studio
node_catalog_page -->|"renders"| node_product_visual
node_product_page -->|"renders"| node_product_visual
node_checkout_page -->|"uses cart"| node_cart_state
node_catalog_state -->|"reads and writes"| node_browser_storage
node_order_state -->|"reads and writes"| node_browser_storage
node_studio -->|"edits catalog"| node_catalog_state
node_app -->|"renders admin"| node_admin_page
node_admin_page -->|"requests admin data"| node_admin_client
node_api_client -.->|"calls API"| node_public_routes
node_admin_client -.->|"calls admin API"| node_admin_routes
node_api_app -->|"mounts"| node_public_routes
node_api_app -->|"mounts"| node_admin_routes
node_public_routes -->|"reads catalog"| node_catalog_service
node_public_routes -->|"handles orders"| node_order_service
node_admin_routes -->|"manages products"| node_catalog_service
node_admin_routes -->|"manages orders"| node_order_service
node_admin_routes -->|"authenticates"| node_security
node_catalog_service -->|"queries"| node_database
node_order_service -->|"queries"| node_database
node_admin_routes -->|"queries"| node_database
node_admin_routes -->|"stores images"| node_uploads

click node_app "https://github.com/tonblognet/trappola/blob/main/src/App.tsx"
click node_route_state "https://github.com/tonblognet/trappola/blob/main/src/hooks/useRouter.ts"
click node_catalog_page "https://github.com/tonblognet/trappola/blob/main/src/pages/CatalogPage.tsx"
click node_product_page "https://github.com/tonblognet/trappola/blob/main/src/pages/ProductPage.tsx"
click node_checkout_page "https://github.com/tonblognet/trappola/blob/main/src/pages/CheckoutPage.tsx"
click node_content_pages "https://github.com/tonblognet/trappola/blob/main/src/pages/ContentPages.tsx"
click node_product_visual "https://github.com/tonblognet/trappola/blob/main/src/components/ProductVisual.tsx"
click node_catalog_state "https://github.com/tonblognet/trappola/blob/main/src/lib/catalog.ts"
click node_cart_state "https://github.com/tonblognet/trappola/blob/main/src/lib/cart.ts"
click node_order_state "https://github.com/tonblognet/trappola/blob/main/src/lib/orders.ts"
click node_browser_storage "https://github.com/tonblognet/trappola/blob/main/src/lib/storage.ts"
click node_studio "https://github.com/tonblognet/trappola/blob/main/src/pages/StudioPage.tsx"
click node_admin_page "https://github.com/tonblognet/trappola/blob/main/src/pages/AdminPage.tsx"
click node_admin_client "https://github.com/tonblognet/trappola/blob/main/src/lib/adminApi.ts"
click node_api_client "https://github.com/tonblognet/trappola/blob/main/src/lib/api.ts"
click node_api_app "https://github.com/tonblognet/trappola/blob/main/server/app.ts"
click node_public_routes "https://github.com/tonblognet/trappola/blob/main/server/routes/public.ts"
click node_admin_routes "https://github.com/tonblognet/trappola/blob/main/server/routes/admin.ts"
click node_catalog_service "https://github.com/tonblognet/trappola/blob/main/server/catalog.ts"
click node_order_service "https://github.com/tonblognet/trappola/blob/main/server/orders.ts"
click node_security "https://github.com/tonblognet/trappola/blob/main/server/security.ts"
click node_database "https://github.com/tonblognet/trappola/blob/main/server/db.ts"
click node_uploads "https://github.com/tonblognet/trappola/blob/main/server/routes/admin.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_app,node_route_state,node_catalog_page,node_product_page,node_checkout_page,node_content_pages,node_product_visual toneBlue
class node_catalog_state,node_cart_state,node_order_state,node_browser_storage,node_studio toneAmber
class node_admin_page,node_admin_client toneMint
class node_api_client,node_api_app,node_public_routes,node_admin_routes,node_catalog_service,node_order_service,node_security,node_database,node_uploads toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/tonblognet/trappola/blob/main/src/App.tsx): `src/App.tsx`
- [Route State](https://github.com/tonblognet/trappola/blob/main/src/hooks/useRouter.ts): `src/hooks/useRouter.ts`
- [Catalog Page](https://github.com/tonblognet/trappola/blob/main/src/pages/CatalogPage.tsx): `src/pages/CatalogPage.tsx`
- [Product Page](https://github.com/tonblognet/trappola/blob/main/src/pages/ProductPage.tsx): `src/pages/ProductPage.tsx`
- [Checkout Page](https://github.com/tonblognet/trappola/blob/main/src/pages/CheckoutPage.tsx): `src/pages/CheckoutPage.tsx`
- [Content Pages](https://github.com/tonblognet/trappola/blob/main/src/pages/ContentPages.tsx): `src/pages/ContentPages.tsx`
- [Product Visual](https://github.com/tonblognet/trappola/blob/main/src/components/ProductVisual.tsx): `src/components/ProductVisual.tsx`

### Browser State

- [Catalog Logic](https://github.com/tonblognet/trappola/blob/main/src/lib/catalog.ts): `src/lib/catalog.ts`
- [Cart Logic](https://github.com/tonblognet/trappola/blob/main/src/lib/cart.ts): `src/lib/cart.ts`
- [Demo Orders](https://github.com/tonblognet/trappola/blob/main/src/lib/orders.ts): `src/lib/orders.ts`
- [Browser Storage](https://github.com/tonblognet/trappola/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Content Studio](https://github.com/tonblognet/trappola/blob/main/src/pages/StudioPage.tsx): `src/pages/StudioPage.tsx`

### Administration

- [Admin Console](https://github.com/tonblognet/trappola/blob/main/src/pages/AdminPage.tsx): `src/pages/AdminPage.tsx`
- [Admin API Client](https://github.com/tonblognet/trappola/blob/main/src/lib/adminApi.ts): `src/lib/adminApi.ts`

### API and Data

- [Public API Client](https://github.com/tonblognet/trappola/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [HTTP App](https://github.com/tonblognet/trappola/blob/main/server/app.ts): `server/app.ts`
- [Public Routes](https://github.com/tonblognet/trappola/blob/main/server/routes/public.ts): `server/routes/public.ts`
- [Admin Routes](https://github.com/tonblognet/trappola/blob/main/server/routes/admin.ts): `server/routes/admin.ts`
- [Catalog Service](https://github.com/tonblognet/trappola/blob/main/server/catalog.ts): `server/catalog.ts`
- [Order Service](https://github.com/tonblognet/trappola/blob/main/server/orders.ts): `server/orders.ts`
- [Session Security](https://github.com/tonblognet/trappola/blob/main/server/security.ts): `server/security.ts`
- [PostgreSQL](https://github.com/tonblognet/trappola/blob/main/server/db.ts): `server/db.ts`
- [Image Uploads](https://github.com/tonblognet/trappola/blob/main/server/routes/admin.ts): `server/routes/admin.ts`

### Other components

- **Shopper**

## Connections

- Shopper → App Router: browses (evidence: `README.md`)
- App Router → Route State: tracks routes (evidence: `src/App.tsx`)
- App Router → Catalog Page: renders (evidence: `src/App.tsx`)
- App Router → Product Page: renders (evidence: `src/App.tsx`)
- App Router → Checkout Page: renders (evidence: `src/App.tsx`)
- App Router → Content Pages: renders (evidence: `src/App.tsx`)
- App Router → Catalog Logic: loads catalog (evidence: `src/App.tsx`)
- App Router → Cart Logic: updates cart (evidence: `src/App.tsx`)
- App Router → Demo Orders: creates demo order (evidence: `src/App.tsx`)
- App Router → Browser Storage: persists cart (evidence: `src/App.tsx`)
- App Router → Public API Client: fetches products (evidence: `src/App.tsx`)
- App Router → Public API Client: submits order (evidence: `src/App.tsx`)
- App Router → Content Studio: renders demo studio (evidence: `src/App.tsx`)
- Catalog Page → Product Visual: renders (evidence: `src/pages/CatalogPage.tsx`)
- Product Page → Product Visual: renders (evidence: `src/pages/ProductPage.tsx`)
- Checkout Page → Cart Logic: uses cart (evidence: `src/pages/CheckoutPage.tsx`)
- Catalog Logic → Browser Storage: reads and writes (evidence: `src/lib/catalog.ts`)
- Demo Orders → Browser Storage: reads and writes (evidence: `src/lib/orders.ts`)
- Content Studio → Catalog Logic: edits catalog (evidence: `src/pages/StudioPage.tsx`)
- App Router → Admin Console: renders admin (evidence: `src/App.tsx`)
- Admin Console → Admin API Client: requests admin data (evidence: `src/pages/AdminPage.tsx`)
- Public API Client → Public Routes: calls API
- Admin API Client → Admin Routes: calls admin API
- HTTP App → Public Routes: mounts (evidence: `server/app.ts`)
- HTTP App → Admin Routes: mounts (evidence: `server/app.ts`)
- Public Routes → Catalog Service: reads catalog (evidence: `server/routes/public.ts`)
- Public Routes → Order Service: handles orders (evidence: `server/routes/public.ts`)
- Admin Routes → Catalog Service: manages products (evidence: `server/routes/admin.ts`)
- Admin Routes → Order Service: manages orders (evidence: `server/routes/admin.ts`)
- Admin Routes → Session Security: authenticates (evidence: `server/routes/admin.ts`)
- Catalog Service → PostgreSQL: queries (evidence: `server/catalog.ts`)
- Order Service → PostgreSQL: queries (evidence: `server/orders.ts`)
- Admin Routes → PostgreSQL: queries (evidence: `server/routes/admin.ts`)
- Admin Routes → Image Uploads: stores images (evidence: `server/routes/admin.ts`)
