⚡ Microservices & AI Open Source

Agentic Inventory

Polyglot Microservices & AI Engine

Production-Grade Polyglot Microservices Platform for Real-Time Stock, Dynamic Catalogs, Statistical Demand Forecasting & Agentic AI.

Java 21Spring Boot 3.4FastAPIApache KafkaMongoDBPostgreSQLScikit-Learn MLPodman & Helm

View Source Code ↗License Information

🖼️ Visual Showcase & Highlights

A production-grade, polyglot microservices platform engineered for real-time stock management, dynamic product catalogs, statistical demand forecasting, multi-database dialect persistence, and agentic AI-driven inventory intelligence. Built with Java 21, Spring Boot 3.4, FastAPI (Python 3.11), MongoDB, HikariCP, Hibernate JPA, Spring Security RBAC, Apache Kafka, Podman, Docker, and Helm.

Microservices Architecture & Enterprise Features

☕ Transactional Inventory & Kafka Bus

Java 21 • Spring Boot 3.4.1 • Port 8081
Core transactional engine managing stock items, batch adjustments, non-blocking 2-phase reservation units (reserve/claim/release), immutable audit logs, Spring Security RBAC, and real-time Kafka event publishing.

🍃 MongoDB Dynamic Product Catalog

Java 21 • Spring Boot 3.4.1 • Port 8082
Flexible document-based product management powered by MongoDB (catalog-service). Dynamic key-value technical specifications, categories, brands, tags, and pricing with auto-bootstrap seeders.

🔌 Pluggable Multi-DB Dialects

Zero vendor lock-in via custom runtime query dialect abstraction (QueryDialect) supporting PostgreSQL, Microsoft SQL Server, MySQL, Oracle, and IBM DB2 with programmatic transaction boundaries.

🤖 Agentic AI & Demand Forecasting

Python 3.11 • FastAPI • Port 8083
Scikit-Learn trained ML intent classifier (1,700+ queries across 15 intents), NER entity extraction, dual-mode Gemini/OpenAI router with offline local ML fallback, and statistical demand forecasting (ROP & safety stock).

💻 AI Workspace & Document Exporter

Interactive web chat workspace at http://localhost:8081/chat.html with real-time markdown streaming and automated document export suite: Excel (.xlsx), Word (.docx), and PDF (.pdf).

☸️ Cloud-Native Podman, Docker & Helm

One-command lifecycle management (./scripts/setup.sh fresh [db]), Podman daemonless/rootless pods (podman play kube), Docker Compose, and production Helm Chart (infra/helm/smart-inventory).

🛠️ One-Command Environment Lifecycle Management

1. Fresh Environment Bootstrap

Tears down existing volumes, sets up target database engine, compiles services, launches containers, and seeds sample data:

./scripts/setup.sh fresh postgres

2. Hot-Reload Microservices

Rebuilds and reloads microservice containers on code changes without interrupting database volumes or Kafka brokers:

./scripts/setup.sh reload forecasting-service

3. Pluggable Enterprise RDBMS

Launch instantly against Oracle, MSSQL, MySQL, or DB2:

./scripts/setup.sh fresh oracle
./scripts/setup.sh fresh mssql

⚡ Developer Quickstart & Source Access

This enterprise system tool is fully configured for cloud-native containerized execution (Podman, Docker, Helm) and local development workflows.

View Repository on GitHub ↗