How tonblognet/trappola works
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: App.tsx App Router · admin.ts Admin Routes · public.ts Public Routes · catalog.ts Catalog Logic
Components 24
Storefront
- App Router
src/App.tsx - Route State
src/hooks/useRouter.ts - Catalog Page
src/pages/CatalogPage.tsx - Product Page
src/pages/ProductPage.tsx - Checkout Page
src/pages/CheckoutPage.tsx - Content Pages
src/pages/ContentPages.tsx - Product Visual
src/components/ProductVisual.tsx
Browser State
- Catalog Logic
src/lib/catalog.ts - Cart Logic
src/lib/cart.ts - Demo Orders
src/lib/orders.ts - Browser Storage
src/lib/storage.ts - Content Studio
src/pages/StudioPage.tsx
Administration
- Admin Console
src/pages/AdminPage.tsx - Admin API Client
src/lib/adminApi.ts
API and Data
- Public API Client
src/lib/api.ts - HTTP App
server/app.ts - Public Routes
server/routes/public.ts - Admin Routes
server/routes/admin.ts - Catalog Service
server/catalog.ts - Order Service
server/orders.ts - Session Security
server/security.ts - PostgreSQL
server/db.ts - Image Uploads
server/routes/admin.ts
Other components
- Shopper
Connections 34
- Shopper → App Router: browses
README.md - App Router → Route State: tracks routes
src/App.tsx - App Router → Catalog Page: renders
src/App.tsx - App Router → Product Page: renders
src/App.tsx - App Router → Checkout Page: renders
src/App.tsx - App Router → Content Pages: renders
src/App.tsx - App Router → Catalog Logic: loads catalog
src/App.tsx - App Router → Cart Logic: updates cart
src/App.tsx - App Router → Demo Orders: creates demo order
src/App.tsx - App Router → Browser Storage: persists cart
src/App.tsx - App Router → Public API Client: fetches products
src/App.tsx - App Router → Public API Client: submits order
src/App.tsx - App Router → Content Studio: renders demo studio
src/App.tsx - Catalog Page → Product Visual: renders
src/pages/CatalogPage.tsx - Product Page → Product Visual: renders
src/pages/ProductPage.tsx - Checkout Page → Cart Logic: uses cart
src/pages/CheckoutPage.tsx - Catalog Logic → Browser Storage: reads and writes
src/lib/catalog.ts - Demo Orders → Browser Storage: reads and writes
src/lib/orders.ts - Content Studio → Catalog Logic: edits catalog
src/pages/StudioPage.tsx - App Router → Admin Console: renders admin
src/App.tsx - Admin Console → Admin API Client: requests admin data
src/pages/AdminPage.tsx - Public API Client → Public Routes: calls API
- Admin API Client → Admin Routes: calls admin API
- HTTP App → Public Routes: mounts
server/app.ts - HTTP App → Admin Routes: mounts
server/app.ts - Public Routes → Catalog Service: reads catalog
server/routes/public.ts - Public Routes → Order Service: handles orders
server/routes/public.ts - Admin Routes → Catalog Service: manages products
server/routes/admin.ts - Admin Routes → Order Service: manages orders
server/routes/admin.ts - Admin Routes → Session Security: authenticates
server/routes/admin.ts - Catalog Service → PostgreSQL: queries
server/catalog.ts - Order Service → PostgreSQL: queries
server/orders.ts - Admin Routes → PostgreSQL: queries
server/routes/admin.ts - Admin Routes → Image Uploads: stores images
server/routes/admin.ts