How quuuuj/mall works
This repository combines a B2C shopping platform (portal, operations console, and Spring REST backend) with a separate multi-agent customer-service API. The documented shopping journey runs from browsing and cart through order creation and simulated payment to administrative fulfillment and receipt. The backend also documents search, dashboard, Excel, and high-concurrency seckill capabilities. The README supplies architecture and workflow evidence; sampled code confirms selected API, search, and customer-service behavior, but most business implementations were not sampled.
Main entry points: views Storefront · portal Portal endpoints · admin Admin endpoints · main.py Chat API
Components 31
Customer portal
- Storefront
mall-portal/src/views - Portal API clients
mall-portal/src/api
Operations console
- Admin console
mall-admin/src/views - Admin API clients
mall-admin/src/api
Commerce backend
- Portal endpoints
mall-server/src/main/java/com/qiujie/controller/portal - Admin endpoints
mall-server/src/main/java/com/qiujie/controller/admin - Authentication
mall-server/src/main/java/com/qiujie/service/impl/AuthServiceImpl.java - Catalog services
mall-server/src/main/java/com/qiujie/service/impl/ProductViewServiceImpl.java - Cart services
mall-server/src/main/java/com/qiujie/service/impl/CartServiceImpl.java - Order services
mall-server/src/main/java/com/qiujie/service/impl/OrderServiceImpl.java - Product persistence
mall-server/src/main/java/com/qiujie/mapper - Order persistence
mall-server/src/main/java/com/qiujie/mapper/OrderMapper.java - Sales dashboard
mall-server/src/main/java/com/qiujie/service/impl/HomeServiceImpl.java - Commerce entities
mall-server/src/main/java/com/qiujie/entity - API responses
mall-server/src/main/java/com/qiujie/dto
Search and async
- Product search
mall-server/src/main/java/com/qiujie/service/impl/ProductSearchServiceImpl.java - Search index
mall-server/src/main/java/com/qiujie/document/ProductDocument.java - Index sync
mall-server/src/main/java/com/qiujie/service/EsSyncService.java - Seckill workflow
mall-server/src/main/java/com/qiujie/service/impl/SeckillServiceImpl.java - RabbitMQ queues
mall-server/src/main/java/com/qiujie/config/RabbitMQConfig.java - Seckill consumer
mall-server/src/main/java/com/qiujie/mq/SeckillMessageListener.java - Order timeout
mall-server/src/main/java/com/qiujie/mq/OrderTimeoutListener.java
AI customer support
- Chat client
- Chat API
mall-customer/api/main.py - Agent supervisor
mall-customer/agents/supervisor.py - Support agents
mall-customer/agents - Conversation memory
mall-customer/memory/long_term.py - MCP tools
mall-customer/mcp/mcp_server.py - Agent tracing
mall-customer/tracing/otel_config.py
Other components
- Shopper
- Administrator
Connections 40
- Shopper → Storefront: uses
- Storefront → Portal API clients: requests
mall-portal/src/views/Search.vue - Portal API clients → Portal endpoints: calls REST
- Portal endpoints → Authentication: authenticates
- Portal endpoints → Catalog services: serves browsing
- Portal endpoints → Cart services: serves cart
- Portal endpoints → Order services: creates orders
mall-server/src/main/java/com/qiujie/controller/portal/OrderController.java - Shopper → Storefront: browses products
- Storefront → Storefront: adds to cart
- Storefront → Storefront: confirms order
- Storefront → Storefront: simulates payment
- Administrator → Admin console: operates
- Admin console → Admin API clients: requests
- Admin API clients → Admin endpoints: calls REST
- Admin endpoints → Order services: manages orders
- Admin endpoints → Sales dashboard: loads dashboard
- Order services → Order persistence: persists orders
- Catalog services → Product persistence: reads products
- Catalog services → Commerce entities: uses entities
- Order services → Commerce entities: uses entities
- Admin endpoints → API responses: returns DTOs
mall-server/src/main/java/com/qiujie/controller/admin/UserController.java - Order services → Admin console: fulfills order
- Admin console → Shopper: supports receipt
- Portal endpoints → Product search: searches catalog
- Product search → Search index: queries index
mall-server/src/main/java/com/qiujie/service/impl/ProductSearchServiceImpl.java - Product search → Product persistence: falls back
mall-server/src/main/java/com/qiujie/service/impl/ProductSearchServiceImpl.java - Index sync → Search index: syncs documents
mall-server/src/main/java/com/qiujie/service/EsSyncService.java - Index sync → Product persistence: reads products
mall-server/src/main/java/com/qiujie/service/EsSyncService.java - Admin endpoints → Seckill workflow: manages sessions
- Portal endpoints → Seckill workflow: starts purchase
- Seckill workflow → RabbitMQ queues: publishes messages
- RabbitMQ queues → Seckill consumer: dispatches
- Seckill consumer → Order persistence: creates order
- RabbitMQ queues → Order timeout: dispatches expiry
- Chat client → Chat API: sends chat
- Chat API → Agent supervisor: invokes graph
mall-customer/api/main.py - Chat API → Conversation memory: stores history
mall-customer/api/main.py - Chat API → MCP tools: dispatches tools
mall-customer/api/main.py - Agent supervisor → Support agents: routes requests
- Chat API → Agent tracing: initializes tracing
mall-customer/api/main.py