🤖 An AI-powered, open-source e-commerce platform built with microservices architecture

Features • Architecture • Services • Contributing

x • shop • ai — Each part of our name tells our story:

x	✖️	Cross-platform & polyglot — Built with 5 languages (C#, Java, Python, TypeScript, JavaScript), diverse frameworks (Express, FastAPI, Spring Boot, Quarkus, ASP.NET Core), and polyglot persistence (MongoDB, PostgreSQL, SQL Server, MySQL, Redis)
shop	🛒	E-commerce at scale — A full-featured online store inspired by Amazon and Microsoft's eShop reference architecture
ai	🤖	AI-native — Intelligent chatbot, smart recommendations, and natural language interfaces powered by OpenAI

xshopai is an AI-powered, open-source e-commerce platform built with a modern, microservices-based architecture. Featuring an intelligent chatbot (powered by OpenAI), smart product recommendations, and natural language order tracking — it showcases how AI/ML can be seamlessly integrated into a production-grade distributed system.

Designed as a learning resource and architectural blueprint for developers, architects, and students exploring distributed systems, AI integration, full-stack development, and cloud-native design.

🎯 Perfect for: Learning microservices patterns, exploring AI/ML integration in e-commerce, understanding event-driven systems, and building your portfolio with production-grade code.

• 🧱 Microservices Architecture — Each business capability is implemented as a separate microservice using the most suitable technology (Node.js, .NET, Python, Java, Go, etc.).
• 🖥️ Frontend in React — A sleek, responsive UI built with vanilla React, optimized for user experience.
• 📱 Mobile-Ready — Future support for native mobile apps using React Native or Flutter.
• ☁️ Cloud-Native — Deployable locally with Docker Compose or to cloud platforms like Azure AKS using Kubernetes and Helm.
• 🧠 AI-First Design — Designed with AI/ML in mind: recommendation engine, intelligent chatbot, and NLP services are core to the vision.
• ⚙️ DevOps with GitHub Actions — Full CI/CD automation with GitHub Actions and reusable workflows across all microservices.
• 🗃️ Polyglot Persistence — Uses SQL, NoSQL, key-value, and graph databases — chosen based on the nature of each service's data.
• 🔐 Authentication & Authorization — Supports secure login via email/password and OAuth2 (Google, Facebook, Twitter), JWT authentication, and role-based access control.
• 📡 API-First & Event-Driven — RESTful APIs and asynchronous communication using message queues for scalability and loose coupling.

High-level architecture diagram (coming soon)

• 🌐 Polyglot Architecture: Each service uses the technology best suited for its requirements
• 🔄 Event-Driven Communication: Services communicate via message queues and events
• 📊 Comprehensive Audit Logging: Full activity tracking and compliance monitoring
• ⚡ High-Performance Services: Go-based inventory service for speed-critical operations
• 🎯 Saga Pattern: Distributed transaction management in order processing
• 📈 Scalable Data Storage: PostgreSQL, MongoDB, and Redis for different data patterns
• 🛡️ Security-First Design: JWT authentication, service-to-service tokens, and audit trails

Each microservice is hosted in its own GitHub repository for separation of concerns, independent scalability, and streamlined DevOps workflows. The platform demonstrates a polyglot architecture with different technologies chosen for each service's specific requirements:

Note: Service-to-service communication and event-driven messaging is handled by DAPR (Distributed Application Runtime), eliminating the need for a separate message broker service.

We welcome contributions from the community! Whether it's:

• 🐛 Bug fixes - Found an issue? Submit a PR!
• ✨ New features - Have an idea? Let's discuss it!
• 📖 Documentation - Help us improve our docs
• 🧪 Tests - Increase our test coverage

Please read our Contributing Guidelines before submitting a pull request.

• 📘 Architecture Overview
• 🔧 Development Setup
• 🚀 Deployment Guide
• 📡 API Reference

• 💡 GitHub Discussions - Ask questions, share ideas
• 🐛 Issue Tracker - Report bugs

If you find this project helpful, please consider giving it a star! It helps others discover this resource.

MIT License — feel free to use, extend, and modify.

Made with ❤️ by the xshopai