How knreddy03/cartflow works
Cart Flow is a storefront and commerce API: shoppers browse a catalog, authenticate, manage a cart, and turn it into an order; the backend also supports account and catalog management. The frontend route map and backend application registration are visible, as are selected service and persistence interactions. Feature-page data wiring and most endpoint-to-service calls are not sampled, so those links are omitted rather than inferred.
Main entry points: router.tsx Page routes · service.py Service wiring · main.py FastAPI app · order_service.py Order service
Components 21
Storefront
- React entry
frontend/src/main.tsx - Page routes
frontend/src/routes/router.tsx - Catalog pages
frontend/src/features/product/pages/ProductListingPage.tsx - Category pages
frontend/src/features/category/pages/CategoryPage.tsx - Home page
frontend/src/features/home/pages/Home.tsx - Auth pages
frontend/src/features/auth/pages/Login.tsx - Profile page
frontend/src/features/profile/pages/Profile.tsx
Backend API
- FastAPI app
backend/app/main.py - Auth routes
backend/app/api/v1/auth.py - Catalog routes
backend/app/api/v1/product.py - Cart routes
backend/app/api/v1/cart.py - Order routes
backend/app/api/v1/order.py
Commerce services
- Auth service
backend/app/services/auth_service.py - Order service
backend/app/services/order_service.py - Catalog services
backend/app/services/product_service.py - Cart service
backend/app/services/cart_service.py - Service wiring
backend/app/dependencies/service.py
Persistence
- Product repository
backend/app/repositories/product_repository.py - SQL database
backend/app/db/database.py - Domain models
backend/app/models/order.py
Other components
- Shopper
Connections 20
- Shopper → React entry: uses
- React entry → Page routes: loads
- Page routes → Home page: routes
- Page routes → Category pages: routes
- Page routes → Catalog pages: routes
- Page routes → Auth pages: routes
- Page routes → Profile page: routes
- FastAPI app → Auth routes: registers
- FastAPI app → Catalog routes: registers
- FastAPI app → Cart routes: registers
- FastAPI app → Order routes: registers
- Service wiring → Auth service: constructs
- Service wiring → Order service: constructs
- Service wiring → Cart service: constructs
- Service wiring → Catalog services: constructs
- Service wiring → Product repository: constructs
- Order service → Product repository: reads
- Order service → SQL database: commits
- Order service → Domain models: creates
- Auth service → SQL database: commits