How rammache/jbf works
Jabour Phone is a React storefront and Express/Prisma commerce backend. Customers browse products, build a cart, apply a coupon and place an order; the API verifies and persists the order and sends notifications. Administrators sign in to manage catalog, orders, coupons and store operations. The graph preserves documented review, newsletter, localization and administration capabilities. Several route and page implementations were not sampled, so their documented roles are shown without inventing internal calls; dashed links mark relationships not verified in excerpts.
Main entry points: App.tsx Route application · api.ts API routes · orderController.ts Order processing · CartContext.tsx Cart state
Components 34
Storefront experience
- Route application
frontend/src/App.tsx - Home and catalog
frontend/src/pages/Home.tsx - Product search
frontend/src/pages/Shop.tsx - Product detail
frontend/src/pages/ProductDetail.tsx - Cart state
frontend/src/context/CartContext.tsx - Checkout
frontend/src/components/CheckoutModal.tsx - Order tracking
frontend/src/pages/OrderTracking.tsx - Language and settings
frontend/src/context/LanguageContext.tsx - API client
frontend/src/api/client.ts
Commerce API
- Express app
backend/src/server.ts - API routes
backend/src/routes/api.ts - Product catalog
backend/src/controllers/productController.ts - Categories
backend/src/controllers/categoryController.ts - Order processing
backend/src/controllers/orderController.ts - Coupon rules
backend/src/controllers/couponController.ts - Product reviews
backend/src/controllers/reviewController.ts - Newsletter
backend/src/controllers/newsletterController.ts - Order notifications
backend/src/services/emailService.ts
Admin operations
- Admin API routes
backend/src/routes/admin.ts - Catalog administration
backend/src/controllers/adminProductController.ts - Order administration
backend/src/controllers/adminOrderController.ts - Admin authentication
backend/src/controllers/authController.ts - Admin pages
frontend/src/pages/admin/AdminProducts.tsx - Admin session
frontend/src/context/AuthContext.tsx
Shared platform
- Prisma client
backend/src/prisma.ts - PostgreSQL
- Cart and order types
frontend/src/types/index.ts - Translation catalog
frontend/src/i18n/translations.ts - Category state
frontend/src/context/CategoryContext.tsx - Store settings
frontend/src/context/SettingsContext.tsx - Product slug rules
backend/src/utils/slug.ts - Money conversion
backend/src/utils/decimal.ts
Other components
- Shopper
- Administrator
Connections 44
- Shopper → Route application: opens storefront
- Route application → Home and catalog: routes to
frontend/src/App.tsx - Route application → Product search: routes to
frontend/src/App.tsx - Route application → Product detail: routes to
frontend/src/App.tsx - Route application → Order tracking: routes to
frontend/src/App.tsx - Home and catalog → Product catalog: loads products
- Product search → Product catalog: queries catalog
- Home and catalog → Category state: uses categories
frontend/src/pages/Home.tsx - Product detail → Cart state: adds items
frontend/src/pages/ProductDetail.tsx - Cart state → Checkout: provides basket
- Cart state → Cart and order types: stores items
frontend/src/context/CartContext.tsx - Cart state → Coupon rules: validates coupon
frontend/src/context/CartContext.tsx - Checkout → API client: submits order
- API client → Express app: calls REST API
- Express app → API routes: mounts routes
backend/src/server.ts - API routes → Product catalog: routes requests
backend/src/routes/api.ts - API routes → Categories: routes requests
backend/src/routes/api.ts - API routes → Order processing: routes requests
backend/src/routes/api.ts - API routes → Coupon rules: routes requests
backend/src/routes/api.ts - API routes → Product reviews: routes requests
backend/src/routes/api.ts - API routes → Newsletter: routes requests
backend/src/routes/api.ts - Order processing → Prisma client: reads and writes
backend/src/controllers/orderController.ts - Prisma client → PostgreSQL: persists records
- Order processing → Order notifications: sends notifications
backend/src/controllers/orderController.ts - Order processing → Coupon rules: calculates discount
backend/src/controllers/orderController.ts - Order processing → Money conversion: converts amounts
backend/src/controllers/orderController.ts - Administrator → Route application: opens administration
- Route application → Admin pages: routes protected pages
frontend/src/App.tsx - Admin pages → API client: uses API
frontend/src/pages/admin/AdminProducts.tsx - Admin pages → Category state: uses categories
frontend/src/pages/admin/AdminProducts.tsx - Admin pages → Store settings: uses settings
frontend/src/pages/admin/AdminProducts.tsx - Admin session → API client: uses API
- Admin API routes → Catalog administration: routes requests
- Admin API routes → Order administration: routes requests
- Admin API routes → Admin authentication: routes requests
- Catalog administration → Prisma client: reads and writes
backend/src/controllers/adminProductController.ts - Catalog administration → Product slug rules: generates handles
backend/src/controllers/adminProductController.ts - Catalog administration → Money conversion: converts amounts
backend/src/controllers/adminProductController.ts - Product reviews → Prisma client: reads and writes
backend/src/controllers/reviewController.ts - Language and settings → Translation catalog: loads translations
frontend/src/context/LanguageContext.tsx - Store settings → Language and settings: uses language
frontend/src/context/SettingsContext.tsx - Route application → Language and settings: provides language
frontend/src/App.tsx - Route application → Store settings: provides settings
frontend/src/App.tsx - Route application → Category state: provides categories
frontend/src/App.tsx