How amirxnofal/e-commerce works
This is an Express e-commerce REST API. A customer or seller request enters the app’s mounted routes and proceeds through the documented route–middleware–controller–service–model layers. The main commerce flow spans product discovery, cart operations, order creation and stock handling, then reviews; identity and administration are separate capabilities. The graph preserves the major README-documented features, but unsampled route wiring and several feature implementations are represented only at the subsystem level.
Main entry points: app.js Express app · auth.service.js Auth flows · user.service.js User management · products.service.js Product catalog
Components 21
API runtime
- Express app
src/app.js
Identity and users
- Auth flows
src/modules/auth/auth.service.js - User management
src/modules/users/user.service.js - User records
src/database/models/user.model.js
Catalog
- Product catalog
src/modules/products/products.service.js - Product image handling
src/modules/products/product.images.service.js - Product records
src/database/models/product.model.js - Category management
src/modules/categories/category.service.js - Category records
src/database/models/category.model.js
Commerce
- Cart operations
src/modules/cart/cart.service.js - Cart records
src/database/models/cart.model.js - Order lifecycle
src/modules/orders/order.service.js - Order records
src/database/models/order.model.js - Product reviews
src/modules/reviews/reviews.service.js - Review records
src/database/models/review.model.js
Platform services
- MongoDB
- Redis service
src/database/redis/redis.service.js - Cloudinary uploads
src/common/utils/cloudinary.utils.js - Email delivery
src/common/utils/send-email.utils.js - Google OAuth
Other components
- API caller
Connections 32
- API caller → Express app: sends request
- Express app → Auth flows: mounts auth routes
src/app.js - Express app → User management: mounts user routes
src/app.js - Express app → Product catalog: mounts product routes
src/app.js - Express app → Category management: mounts category routes
src/app.js - Express app → Cart operations: mounts cart routes
src/app.js - Express app → Order lifecycle: mounts order routes
src/app.js - Express app → Product reviews: mounts review routes
src/app.js - Auth flows → User records: reads and writes
src/modules/auth/auth.service.js - Auth flows → Redis service: stores OTP and revocations
src/modules/auth/auth.service.js - Auth flows → Email delivery: sends OTP
src/modules/auth/auth.service.js - Auth flows → Google OAuth: verifies identity
src/modules/auth/auth.service.js - Auth flows → Cloudinary uploads: uploads profile image
src/modules/auth/auth.service.js - User management → User records: reads and updates
src/modules/users/user.service.js - User management → Redis service: stores revocations
src/modules/users/user.service.js - User management → Email delivery: sends confirmation
src/modules/users/user.service.js - User management → Cloudinary uploads: uploads profile image
src/modules/users/user.service.js - Product catalog → Product records: reads and updates
src/modules/products/products.service.js - Product catalog → Category records: checks category
src/modules/products/products.service.js - Product catalog → Product image handling: delegates image updates
src/modules/products/products.service.js - Product catalog → Cloudinary uploads: uploads images
src/modules/products/products.service.js - Category management → Category records: reads and updates
src/modules/categories/category.service.js - Category management → Product records: reads category products
src/modules/categories/category.service.js - Category management → Cloudinary uploads: uploads category image
src/modules/categories/category.service.js - Cart operations → Product records: checks stock
src/modules/cart/cart.service.js - Cart operations → Cart records: reads and updates
src/modules/cart/cart.service.js - Order lifecycle → Order records: creates and updates
src/modules/orders/order.service.js - Order lifecycle → Cart records: reads and clears cart
src/modules/orders/order.service.js - Order lifecycle → Product records: reserves or restores stock
src/modules/orders/order.service.js - Product reviews → Product records: checks product
src/modules/reviews/reviews.service.js - Product reviews → Order records: checks purchase
src/modules/reviews/reviews.service.js - Product reviews → Review records: creates and reads reviews
src/modules/reviews/reviews.service.js