How zcj117/live-hub works
Live-hub is a microservice local-commerce and customer-support platform. A client enters through the gateway; authentication and Agent rate limiting precede service routing. The Agent creates or resumes a session, streams chat, and uses planning/ReAct tools to answer, search knowledge, or open a ticket and transfer context. Separate branches cover commerce, orders, social features, and RAG document ingestion and question answering. The README documents service-level capabilities not represented by sampled implementation excerpts; those relationships are cited to it, while source-level edges use the excerpts or index. Storage and infrastructure links are shown only where documented.
Main entry points: ChatOrchestratorService.java Agent chat · gateway API gateway · QaPipeline.java RAG question answering · ReActEngine.java ReAct engine
Components 23
Entry and identity
- API gateway
gateway-service/src/main/java/com/hmdp/gateway - User service
user-service/src/main/java/com/hmdp/user
Commerce and community
- Shop service
shop-service/src/main/java/com/hmdp/shop - Voucher service
voucher-service/src/main/java/com/hmdp/voucher - Order service
order-service/src/main/java/com/hmdp/order - Social service
social-service/src/main/java/com/hmdp/social
Knowledge and support
- Agent chat
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Session lifecycle
agent-service/src/main/java/com/hmdp/agent/service/AgentSessionService.java - Chat memory
agent-service/src/main/java/com/hmdp/agent/memory/ChatMemoryService.java - Intent planning
agent-service/src/main/java/com/hmdp/agent/planner - ReAct engine
agent-service/src/main/java/com/hmdp/agent/react/ReActEngine.java - Business tools
agent-service/src/main/java/com/hmdp/agent/tool - Input/output safety
agent-service/src/main/java/com/hmdp/agent/security - Ticket workflow
agent-service/src/main/java/com/hmdp/agent/ticket/TicketService.java - Human handoff
agent-service/src/main/java/com/hmdp/agent/transfer/TransferService.java - SSE sessions
agent-service/src/main/java/com/hmdp/agent/sse/SseSessionManager.java - Knowledge documents
rag-service/src/main/java/com/hmdp/rag/pipeline/DocumentPipeline.java - RAG question answering
rag-service/src/main/java/com/hmdp/rag/pipeline/QaPipeline.java
Persistence and messaging
- Redis
- Service databases
- RocketMQ
Other components
- Web client
- GLM APIs
Connections 32
- Web client → API gateway: sends requests
- API gateway → User service: routes requests
- API gateway → Agent chat: routes and limits
- API gateway → Shop service: routes requests
- API gateway → Voucher service: routes requests
- API gateway → Order service: routes requests
- API gateway → Social service: routes requests
- API gateway → RAG question answering: routes requests
- Agent chat → Session lifecycle: manages sessions
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Agent chat → Chat memory: loads conversation
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Agent chat → Intent planning: plans intent
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Agent chat → ReAct engine: runs decisions
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - ReAct engine → Business tools: executes tools
agent-service/src/main/java/com/hmdp/agent/react/ReActEngine.java - Agent chat → Input/output safety: checks messages
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Agent chat → Ticket workflow: starts complaint flow
- Agent chat → Human handoff: triggers handoff
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - Human handoff → Ticket workflow: creates handoff ticket
agent-service/src/main/java/com/hmdp/agent/transfer/TransferService.java - Agent chat → SSE sessions: streams events
agent-service/src/main/java/com/hmdp/agent/service/ChatOrchestratorService.java - ReAct engine → GLM APIs: requests completions
agent-service/src/main/java/com/hmdp/agent/react/ReActEngine.java - Business tools → RAG question answering: searches knowledge
- Knowledge documents → RocketMQ: queues processing
- RAG question answering → GLM APIs: generates answers
- Knowledge documents → Service databases: stores chunks
- RAG question answering → Service databases: retrieves chunks
- Session lifecycle → Service databases: stores sessions
- Ticket workflow → Service databases: stores tickets
- Chat memory → Redis: stores history
agent-service/src/main/java/com/hmdp/agent/memory/ChatMemoryService.java - Shop service → Service databases: reads and writes shops
- Voucher service → Service databases: manages vouchers
- Order service → RocketMQ: processes orders asynchronously
- Social service → Redis: maintains feeds
- User service → Redis: stores login sessions