How rojinagautam/fresh_cart_web_project works
FreshCart is a full-stack commerce application with customer shopping, account, and support features plus an administration interface. The principal workflow is browsing products and deals, managing a cart or wishlist, placing an order, and handling payment; reviews provide a separate post-purchase-style product capability. The backend exposes these domains through an Express API and MongoDB-backed repositories. The README is empty, and most domain handlers were not sampled, so uncertain frontend-to-backend and internal links are shown as dashed and unverified rather than asserted.
Main entry points: actions Frontend actions · app.ts Express API · review.service.ts Review service · api Frontend API clients
Components 28
Storefront
- Shopping UI
frontend/app/(homepage) - Account UI
frontend/app/(auth) - Product reviews
frontend/app/(homepage)/categories/_components/ProductReviews.tsx - Chat widget
frontend/app/_components/chat - Frontend API clients
frontend/lib/api - Frontend actions
frontend/lib/actions - Auth storage
frontend/lib/auth-storage.ts
Administration
- Admin console
frontend/app/admin
API and services
- Express API
backend/src/app.ts - Account handlers
backend/src/controllers/user.controller.ts - Commerce handlers
backend/src/controllers - Review handler
backend/src/controllers/review.controller.ts - Domain services
backend/src/services - Cart service
backend/src/services/cart.service.ts - User service
backend/src/services/user.service.ts - Review service
backend/src/services/review.service.ts - Authentication
backend/src/middleware/auth.middleware.ts
Persistence
- Domain repositories
backend/src/repositories - Product repository
backend/src/repositories/product.repository.ts - User repository
backend/src/repositories/user.repository.ts - Review repository
backend/src/repositories/review.repository.ts - MongoDB
backend/src/database/mongodb.ts - Domain models
backend/src/models - Product model
backend/src/models/product.model.ts - Review model
backend/src/models/review.model.ts
Integrations
- Payment provider
- Email delivery
Other components
- Shopper
Connections 27
- Shopper → Shopping UI: uses
- Shopping UI → Frontend actions: invokes
- Account UI → Frontend actions: invokes
frontend/app/(auth)/verify-email/useVerifyEmailViewModel.ts - Product reviews → Frontend actions: submits reviews
- Chat widget → Frontend actions: sends messages
frontend/app/_components/chat/useChatViewModel.ts - Admin console → Frontend actions: requests admin data
frontend/app/admin/page.tsx - Frontend actions → Frontend API clients: calls clients
frontend/lib/actions/auth-action.ts - Frontend API clients → Express API: HTTP requests
- Frontend API clients → Auth storage: uses auth state
frontend/lib/auth-storage.ts - Express API → Commerce handlers: mounts domain routes
backend/src/app.ts - Express API → Account handlers: mounts auth routes
backend/src/app.ts - Express API → Review handler: mounts review routes
backend/src/app.ts - Commerce handlers → Domain services: delegates
backend/src/controllers/review.controller.ts - Account handlers → User service: calls
backend/src/controllers/user.controller.ts - Review handler → Review service: calls
backend/src/controllers/review.controller.ts - Review service → Review repository: reads and writes
backend/src/services/review.service.ts - Review service → Product repository: checks products
backend/src/services/review.service.ts - Review service → Product model: raises domain errors
- Cart service → Domain repositories: persists cart data
- User service → User repository: persists accounts
- Authentication → User repository: loads user
backend/src/middleware/auth.middleware.ts - Review repository → Review model: queries
backend/src/repositories/review.repository.ts - Review repository → Product model: updates rating cache
backend/src/repositories/review.repository.ts - Product repository → Product model: queries
backend/src/repositories/product.repository.ts - Domain repositories → MongoDB: stores domain data
- Domain services → Payment provider: processes payments
- Domain services → Email delivery: sends account email