🚀 Agentic AI Demo - Smart Business Platform

Transform your business operations with AI-powered automation!

Welcome to a cutting-edge demonstration of how AI agents can seamlessly integrate with real business applications. This platform showcases a complete microservices ecosystem where AI assistants (like Claude or GitHub Copilot) can directly manage orders, process payments, and handle incidents through natural conversation.

✨ What Makes This Special?

🤖 Talk to Your Business System: Use natural language to manage orders, payments, and incidents
⚡ Real-Time Operations: AI agents perform actual business operations, not just mock data
🔧 Production-Ready: Built with enterprise-grade technologies and best practices
🎯 Plug & Play: Easy setup with Docker - get running in minutes
🌐 Modern Stack: Vue.js frontends, Spring Boot APIs, and intelligent MCP servers

📋 Quick Overview

| Service | What It Does | Frontend | API | |---------|-------------|----------|-----| | 📦 Orders | Manage customer orders & lifecycle | localhost:5173 | localhost:8081 | | 💳 Payments | Process payments & transactions | localhost:5174 | localhost:8082 | | 🚨 Incidents | Track issues & resolutions | localhost:5175 | localhost:8083 | | 🧠 AI Assistant | Smart automation layer | - | localhost:8085 |

🏗️ System Architecture

    🖥️ Frontend Apps (Vue.js + TypeScript)
    ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
    │   Orders    │  │  Payments   │  │  Incidents  │
    │   :5173     │  │   :5174     │  │   :5175     │
    └─────────────┘  └─────────────┘  └─────────────┘
           │                │               │
    ⚡ REST APIs (Spring Boot + Java)
    ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
    │ Order API   │  │Payment API  │  │Incident API │
    │   :8081     │  │   :8082     │  │   :8083     │
    └─────────────┘  └─────────────┘  └─────────────┘
           │                │               │
           └────────────────┼───────────────┘
                           │
    🤖 AI Integration Layer
           ┌─────────────────────────┐
           │     MCP Servers         │
           │   (AI ↔ Business)       │
           │       :8085             │
           └─────────────────────────┘
                           │
    💾 Data Layer
           ┌─────────────────────────┐
           │      MongoDB            │
           │   (Document Store)      │
           │       :27017            │
           └─────────────────────────┘

🚀 Get Started in 3 Minutes!

Prerequisites ✅

• Docker Desktop installed and running
• Available ports: 5173-5175, 8081-8083, 8085, 27017

1️⃣ Launch Everything

# Navigate to project directory
cd agentic-ai-demo

# 🚀 Start all services (this might take 2-3 minutes first time)
docker-compose up --build -d

# ✅ Check everything is running
docker-compose ps

2️⃣ Verify It's Working

Open these links to confirm services are up:

• 🌐 Order Management UI - Manage customer orders
• 💳 Payment Portal - Handle transactions
• 🎯 Incident Dashboard - Track issues
• 📊 Order API Health - Should show {"status":"UP"}

3️⃣ Explore Sample Data

The platform comes pre-loaded with realistic business data:

• 8 sample orders in various stages (new → processing → shipped → delivered)
• 4 payment records with different statuses
• 5 incident tickets with varying priorities

🎉 You're ready! Your complete business platform is now running!

🛠️ Management Commands

Essential Operations

# 🛑 Stop everything
docker-compose down

# 🔄 Restart a specific servi

... [View full README on GitHub](https://github.com/Ramzus/spring-ai-mcp-server-demo#readme)