How gamal-elagamy/t-3-rose-app works
Rose App is a multilingual e-commerce storefront with customer account, shopping, checkout, and admin capabilities. The principal customer workflow is browsing and searching products, managing a cart, and proceeding through checkout; accounts, addresses, orders, wishlists, and notifications support that experience. Admin pages cover catalog management and statistics. Sampled API routes and feature modules show selected product, category, occasion, cart-product, review, and statistics relationships. Other branches are represented from the file tree; their internal wiring was not sampled.
Main entry points: products.api.ts Product data API · products.hook.ts Product query hook · use-add-review.ts Review mutation hook · get-cart-products.ts Cart product lookup
Components 31
Storefront
- Home discovery
src/features/home - Product browsing
src/features/products - Product search
src/shared/components/search-box.tsx - Product query hook
src/features/products/hooks/products.hook.ts - Review submission
src/features/products/components/product/product-reviews/form-review.tsx - Review mutation hook
src/features/products/hooks/use-add-review.ts
Shopping
- Cart management
src/features/cart - Cart product lookup
src/features/cart/actions/get-cart-products.ts - Checkout and payment
src/features/checkout - Order history
src/features/order - Wishlist
src/features/wish-list
Customer accounts
- Account settings
src/features/account-settings - Address management
src/features/address - Authentication
src/features/auth - Notifications
src/features/header/components/authenticated-state/notifications
Catalog and admin
- Product data API
src/features/products/apis/products.api.ts - Categories
src/features/categories/apis/categories.api.ts - Occasions
src/features/occasions/apis/occasions.api.ts - Review API client
src/features/products/apis/add-review.api.ts - Catalog administration
src/features/(admin)/cat-occ-pages - Admin dashboard
src/features/admin - Chart data API
src/features/admin/apis/get-charts.api.ts - Admin server API
src/features/admin/apis/admin.server.api.ts
Application platform
- Products route
src/app/api/products/route.ts - Categories route
src/app/api/categories/route.ts - Occasions route
src/app/api/occasions/route.ts - Cart products route
src/app/api/cart-products/route.ts - Statistics route
src/features/admin/statistics/route.ts - Language routing
src/i18n/routing.ts - Theme provider
src/shared/providers/theme.provider.tsx
Other components
- Shopper
Connections 13
- Shopper → Home discovery: browses
- Shopper → Product browsing: shops
- Product search → Product query hook: queries
src/shared/components/search-box.tsx - Product query hook → Product data API: fetches products
src/features/products/hooks/products.hook.ts - Products route → Product data API: calls
src/app/api/products/route.ts - Categories route → Categories: calls
src/app/api/categories/route.ts - Occasions route → Occasions: calls
src/app/api/occasions/route.ts - Cart products route → Cart product lookup: calls
src/app/api/cart-products/route.ts - Cart product lookup → Product data API: uses product data
src/features/cart/actions/get-cart-products.ts - Review submission → Review mutation hook: submits review
src/features/products/components/product/product-reviews/form-review.tsx - Review mutation hook → Review API client: calls
src/features/products/hooks/use-add-review.ts - Statistics route → Chart data API: calls
src/features/admin/statistics/route.ts - Chart data API → Admin server API: uses
src/features/admin/apis/get-charts.api.ts