How aritra39514/quickkart works
QuickKart is a campus-hostel commerce and delivery system with role-based student, vendor, delivery-agent, and admin workflows. Students browse products, manage a cart, place and track orders; vendors manage products and order status; delivery agents handle assignments and OTP-confirmed delivery; admins manage users, orders, and inventory. The README documents Kafka-driven order events, load-aware delivery assignment, Redis product caching, MongoDB persistence, and Prometheus metrics. Several frontend and backend subsystems are represented by their listed source paths; only relationships shown in excerpts or documented in the README are connected.
Main entry points: axios.js API client · OrderService.java Order lifecycle · App.jsx Role-based routes · CartService.java Cart management
Components 32
React client
- Role-based routes
frontend/src/App.jsx - Auth state
frontend/src/context/AuthContext.jsx - API client
frontend/src/api/axios.js - Student shopping
frontend/src/pages/student/Home.jsx - Cart and orders
frontend/src/pages/student/Cart.jsx - Vendor operations
frontend/src/pages/admin/InventoryManagement.jsx - Delivery dashboard
frontend/src/pages/delivery/DeliveryDashboard.jsx - Admin operations
frontend/src/pages/admin/AdminDashboard.jsx
REST API
- Auth endpoints
backend/src/main/java/com/quickkart/controller/AuthController.java - Cart endpoints
backend/src/main/java/com/quickkart/controller/CartController.java - Product endpoints
backend/src/main/java/com/quickkart/controller/ProductController.java - Order endpoints
backend/src/main/java/com/quickkart/controller/OrderController.java - Vendor endpoints
backend/src/main/java/com/quickkart/controller/VendorController.java - Delivery endpoints
backend/src/main/java/com/quickkart/controller/DeliveryController.java - Admin endpoints
backend/src/main/java/com/quickkart/controller/AdminController.java
Commerce domain
- Cart management
backend/src/main/java/com/quickkart/service/CartService.java - Product catalog
backend/src/main/java/com/quickkart/service/ProductService.java - Order lifecycle
backend/src/main/java/com/quickkart/service/OrderService.java - Admin management
backend/src/main/java/com/quickkart/service/AdminService.java
Events and delivery
- Order event publisher
backend/src/main/java/com/quickkart/messaging/OrderEventPublisher.java - Order event consumer
backend/src/main/java/com/quickkart/messaging/OrderEventConsumer.java - Agent scheduler
backend/src/main/java/com/quickkart/scheduler/DeliveryScheduler.java
Identity and data
- Authentication
backend/src/main/java/com/quickkart/service/AuthService.java - Order records
backend/src/main/java/com/quickkart/model/Order.java - Product records
backend/src/main/java/com/quickkart/model/Product.java - User records
backend/src/main/java/com/quickkart/model/User.java - Cart records
backend/src/main/java/com/quickkart/model/Cart.java - Prometheus metrics
backend/src/main/java/com/quickkart/config/QuickKartMetrics.java
Other components
- Campus users
- MongoDB
- Kafka
- Redis cache
Connections 43
- Campus users → Role-based routes: use
README.md - Role-based routes → Auth state: provides auth
frontend/src/App.jsx - Role-based routes → Student shopping: routes
frontend/src/App.jsx - Role-based routes → Cart and orders: routes
frontend/src/App.jsx - Role-based routes → Delivery dashboard: routes
frontend/src/App.jsx - Role-based routes → Admin operations: routes
frontend/src/App.jsx - Student shopping → API client: imports
frontend/src/pages/student/Home.jsx - Delivery dashboard → API client: calls
frontend/src/pages/delivery/DeliveryDashboard.jsx - Vendor operations → API client: calls
frontend/src/pages/admin/InventoryManagement.jsx - Role-based routes → API client: fetches cart
frontend/src/App.jsx - API client → Auth endpoints: REST requests
README.md - API client → Cart endpoints: REST requests
README.md - API client → Product endpoints: REST requests
README.md - API client → Order endpoints: REST requests
README.md - API client → Vendor endpoints: REST requests
README.md - API client → Delivery endpoints: REST requests
README.md - API client → Admin endpoints: REST requests
README.md - Auth endpoints → Authentication: delegates
backend/src/main/java/com/quickkart/controller/AuthController.java - Cart endpoints → Cart management: delegates
backend/src/main/java/com/quickkart/controller/CartController.java - Vendor endpoints → Product catalog: delegates
backend/src/main/java/com/quickkart/controller/VendorController.java - Vendor endpoints → Order lifecycle: delegates
backend/src/main/java/com/quickkart/controller/VendorController.java - Admin endpoints → Admin management: delegates
backend/src/main/java/com/quickkart/controller/AdminController.java - Admin endpoints → Order lifecycle: delegates
backend/src/main/java/com/quickkart/controller/AdminController.java - Delivery endpoints → Order lifecycle: delegates
backend/src/main/java/com/quickkart/controller/DeliveryController.java - Order endpoints → Order lifecycle: delegates
- Authentication → User records: reads and writes
backend/src/main/java/com/quickkart/service/AuthService.java - Cart management → Cart records: reads and writes
backend/src/main/java/com/quickkart/service/CartService.java - Cart management → Product records: reads
backend/src/main/java/com/quickkart/service/CartService.java - Cart management → User records: reads
backend/src/main/java/com/quickkart/service/CartService.java - Product catalog → Product records: reads and writes
backend/src/main/java/com/quickkart/service/ProductService.java - Order lifecycle → Order records: persists orders
backend/src/main/java/com/quickkart/service/OrderService.java - Order lifecycle → Cart management: clears cart
backend/src/main/java/com/quickkart/service/OrderService.java - Order lifecycle → Order event publisher: publishes events
backend/src/main/java/com/quickkart/service/OrderService.java - Order lifecycle → Prometheus metrics: records placement
backend/src/main/java/com/quickkart/service/OrderService.java - Order event publisher → Kafka: publishes
README.md - Kafka → Order event consumer: delivers events
README.md - Order event consumer → Agent scheduler: routes confirmed
README.md - Order records → MongoDB: stored in
README.md - Product records → MongoDB: stored in
README.md - User records → MongoDB: stored in
README.md - Cart records → MongoDB: stored in
README.md - Product catalog → Redis cache: caches products
README.md - Prometheus metrics → Campus users: exposes telemetry
README.md