How zeekygeekfreelance/nmpl_ecom works
NMPL Ecom is a role-based ecommerce platform with a Next.js storefront and administration client backed by an Express/Apollo API. The main customer journey is browsing and filtering products, adding items to a cart, checking out, paying, and viewing orders; dealers and administrators have separate account and management workflows. The tree also documents catalog, inventory, analytics, reporting, and payment operations. Edges are limited to relationships evidenced by README statements or shown imports/calls; unsampled server wiring is not inferred.
Main entry points: app.ts REST and GraphQL API · ShopPageClient.tsx Product browsing · page.tsx Catalog management · index.tsx Storefront
Components 24
Client experience
- Storefront
src/client/app/(public)/(home)/index.tsx - Product browsing
src/client/app/(public)/shop/ShopPageClient.tsx - Product filters
src/client/app/(public)/shop/ProductFilters.tsx - Product cards
src/client/app/(public)/product/ProductCard.tsx - Product details
src/client/app/(public)/product/[slug]/ProductDetailsClient.tsx - Accounts and roles
src/server/src/modules/auth/auth.service.ts - Customer orders
src/client/app/(private)/(user)/orders/page.tsx - Client data layer
src/client/app/lib/apolloClient.ts
Commerce operations
- Shopping cart
src/client/app/(public)/cart/page.tsx - Checkout
src/server/src/modules/checkout/checkout.service.ts - Payments
src/server/src/modules/payment/comprehensivePayment.service.ts - Orders
src/server/src/modules/order/order.service.ts - Transactions
src/server/src/modules/transaction/transaction.service.ts
Management and insights
- Dealer workflows
src/client/app/(private)/dashboard/dealers/page.tsx - Catalog management
src/client/app/(private)/dashboard/products/page.tsx - Inventory and restock
src/client/app/(private)/dashboard/inventory/page.tsx - Analytics
src/server/src/modules/analytics/analytics.service.ts - Reports and exports
src/server/src/modules/reports/reports.service.ts
API and infrastructure
- REST and GraphQL API
src/server/src/app.ts - PostgreSQL
src/server/src/infra/database/database.config.ts - Redis cache
src/server/src/infra/cache/redis.ts
Other components
- Shopper
- Razorpay
- Cloudinary
Connections 22
- Shopper → Storefront: browses
README.md - Storefront → Product browsing: opens catalog
- Product browsing → Product filters: renders
src/client/app/(public)/shop/ShopPageClient.tsx - Product browsing → Product cards: renders
src/client/app/(public)/shop/ShopPageClient.tsx - Shopper → Shopping cart: adds products
- Shopping cart → Checkout: starts checkout
- Checkout → Payments: processes payment
- Payments → Razorpay: creates payment
- Shopper → Accounts and roles: registers or signs in
- Shopper → Customer orders: views orders
- Dealer workflows → Accounts and roles: requests dealer access
src/server/src/modules/auth/auth.service.ts - Catalog management → REST and GraphQL API: manages catalog
- Inventory and restock → REST and GraphQL API: manages stock
- Analytics → REST and GraphQL API: serves analytics
- Reports and exports → REST and GraphQL API: serves reports
- Transactions → REST and GraphQL API: serves transactions
- Product browsing → Client data layer: loads data
- Client data layer → REST and GraphQL API: calls API
README.md - REST and GraphQL API → PostgreSQL: uses database
README.md - REST and GraphQL API → Redis cache: uses cache
README.md - Catalog management → Cloudinary: uploads images
- Orders → PostgreSQL: persists orders