How ashwani-labs/pixel-mart works
PixelMart is a React storefront and admin console backed by Spring Boot services. The main customer journey runs from browsing catalog items through cart and checkout to an order; authentication supports customer/admin access, while catalog, order, and notification services own distinct business stages. The README documents gateway routing, service responsibilities, and service-owned MySQL schemas. Sampled code confirms selected authentication, checkout, review, and media-storage calls; other feature links are omitted or marked unverified rather than inferred from module names.
Main entry points: JwtGatewayFilter.java Spring Cloud Gateway · CheckoutService.java Checkout and orders · OrderConfirmationController.java Notification API · AuthService.java Identity and tokens
Components 22
Storefront
- React storefront
pixelmart-frontend/src/main.tsx
API Gateway
- Spring Cloud Gateway
pixelmart-backend/gateway/src/main/java/com/pixelmart/gateway/filter/JwtGatewayFilter.java
Identity
- Authentication API
pixelmart-backend/auth-service/src/main/java/com/pixelmart/auth/controller/AuthController.java - Identity and tokens
pixelmart-backend/auth-service/src/main/java/com/pixelmart/auth/service/AuthService.java - Guest sessions
pixelmart-backend/auth-service/src/main/java/com/pixelmart/auth/service/GuestAuthService.java - Refresh-token lifecycle
pixelmart-backend/auth-service/src/main/java/com/pixelmart/auth/security/RefreshTokenService.java
Catalog and Orders
- Catalog API
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/controller/PublicCatalogController.java - Product catalog
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ProductService.java - Offers and pricing
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/OfferService.java - Reviews and moderation
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ReviewService.java - Review images
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ReviewImageService.java - Media storage
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/storage/StorageService.java - Cart and checkout API
pixelmart-backend/order-service/src/main/java/com/pixelmart/order/controller/CheckoutController.java - Checkout and orders
pixelmart-backend/order-service/src/main/java/com/pixelmart/order/service/CheckoutService.java - Catalog client
pixelmart-backend/order-service/src/main/java/com/pixelmart/order/client/CatalogClient.java
Notifications
- Notification API
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/controller/OrderConfirmationController.java - Order email outbox
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/service/OrderConfirmationEmailService.java - WhatsApp status outbox
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/service/OrderStatusWhatsAppService.java
Other components
- Shopper or admin
- Service-owned MySQL schemas
- SMTP provider
- AWS S3
Connections 24
- Shopper or admin → React storefront: uses
README.md - React storefront → Spring Cloud Gateway: proxies /api
README.md - Spring Cloud Gateway → Authentication API: routes auth
README.md - Spring Cloud Gateway → Catalog API: routes catalog
README.md - Spring Cloud Gateway → Cart and checkout API: routes orders
README.md - Spring Cloud Gateway → Notification API: routes internal
README.md - Authentication API → Identity and tokens: delegates
- Identity and tokens → Refresh-token lifecycle: issues and revokes
pixelmart-backend/auth-service/src/main/java/com/pixelmart/auth/service/AuthService.java - Catalog API → Product catalog: serves catalog
- Catalog API → Reviews and moderation: serves reviews
- Reviews and moderation → Review images: uploads images
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ReviewService.java - Review images → Media storage: stores and loads
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ReviewImageService.java - Reviews and moderation → Cart and checkout API: checks delivered purchase
pixelmart-backend/catalog-service/src/main/java/com/pixelmart/catalog/service/ReviewService.java - Cart and checkout API → Checkout and orders: delegates
pixelmart-backend/order-service/src/main/java/com/pixelmart/order/controller/CheckoutController.java - Checkout and orders → Catalog client: reserves stock
pixelmart-backend/order-service/src/main/java/com/pixelmart/order/service/CheckoutService.java - Checkout and orders → Notification API: requests confirmation
- Notification API → Order email outbox: dispatches email
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/controller/OrderConfirmationController.java - Notification API → WhatsApp status outbox: queues status
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/controller/OrderConfirmationController.java - Order email outbox → SMTP provider: sends when configured
pixelmart-backend/notification-service/src/main/java/com/pixelmart/notification/service/OrderConfirmationEmailService.java - Identity and tokens → Service-owned MySQL schemas: persists identity
README.md - Product catalog → Service-owned MySQL schemas: persists catalog
README.md - Checkout and orders → Service-owned MySQL schemas: persists orders
README.md - Order email outbox → Service-owned MySQL schemas: persists outbox
README.md - Media storage → AWS S3: optional backend
README.md