An AI-powered, open-source e-commerce platform built with microservices architecture
xshopai is a production-grade, polyglot e-commerce platform built across 16 independent microservices. Each service is implemented in the language and framework best suited for its domain — C#, Java, Python, TypeScript, and JavaScript — backed by polyglot persistence (MongoDB, PostgreSQL, SQL Server, MySQL, Redis) and orchestrated via Dapr.
The platform is designed as both a functional e-commerce system and an architectural reference for distributed systems, event-driven design, and AI integration.
| Service | Stack | Purpose | CI |
|---|---|---|---|
| admin-service | Node.js · Express | User and role administration |  |
| audit-service | Node.js · TypeScript · PostgreSQL | Immutable audit trail for all platform events |  |
| auth-service | Node.js · Express | Authentication, JWT issuance, session management |  |
| cart-service | Node.js · TypeScript · Redis | Shopping cart with guest and authenticated cart support |  |
| chat-service | Node.js · TypeScript · Azure OpenAI | AI-powered conversational shopping assistant |  |
| inventory-service | Python · Flask · MySQL | Stock management, reservations, reorder alerts |  |
| notification-service | Node.js · TypeScript | Event-driven email and notification delivery |  |
| order-processor-service | Java · Spring Boot · PostgreSQL | Choreography-based saga for order fulfillment |  |
| order-service | C# · ASP.NET Core · SQL Server | Order lifecycle management |  |
| payment-service | C# · ASP.NET Core · SQL Server | Multi-provider payment processing |  |
| product-service | Python · FastAPI · MongoDB | Product catalog, search, and categories |  |
| review-service | Node.js · Express · MongoDB | Product reviews and ratings |  |
| user-service | Node.js · Express · MongoDB | User profiles, addresses, preferences |  |
| web-bff | Node.js · TypeScript | Backend for Frontend — API gateway for web UIs |  |
| Application | Stack | Purpose | CI |
|---|---|---|---|
| customer-ui | React 18 | Customer-facing storefront |  |
| admin-ui | React 18 · TypeScript | Admin portal for operations and analytics |  |
| Resource | Location |
|---|---|
| Architecture Overview | Wiki |
| Service Catalog | Wiki |
| API Reference | Wiki |
| Event Catalog | Wiki |
| Installation Guide | Wiki |
| Deployment Guide | Wiki |
Contributions are welcome. Please review the Contributing Guidelines before opening a pull request. For questions and discussions, use GitHub Discussions.
