🚀 Distributed-Hateable: AI-Powered Distributed Code Generation Platform

📖 Overview

Distributed-Hateable is a cloud-native AI code generation platform built using a microservices architecture. The platform leverages Large Language Models (LLMs), Apache Kafka, Spring Boot, Redis, and Docker to generate code asynchronously while ensuring scalability, resilience, and fault tolerance.

The application follows an event-driven architecture where independent services communicate through Kafka, enabling high throughput and loose coupling between components.

✨ Features

AI-powered code generation using LLMs
Microservices architecture with Spring Boot
API Gateway for routing
Service Discovery
Centralized Configuration Server
JWT & OAuth2 Authentication
Event-driven communication using Apache Kafka
Redis caching and rate limiting
PostgreSQL/MySQL persistence
Docker containerization
Kubernetes-ready deployment
High scalability and fault tolerance

🏗 System Architecture

                    DISTRIBUTED-LOVABLE AI CODE GENERATION PLATFORM

┌────────────────────────────────────────────────────────────────────────────┐
│                                USER                                        │
└────────────────────────────────────────────────────────────────────────────┘
                                     │
                                     ▼

                          React.js Frontend (Lovable UI)

      Authentication • Workspace • AI Prompt Editor • File Explorer
      Project Dashboard • Code Preview • Download Generated Code

                                     │
                             HTTPS / REST APIs
                                     │
                                     ▼

──────────────────────────── API GATEWAY ────────────────────────────────────

               Spring Cloud Gateway
      Routing • Authentication • Rate Limiting • Load Balancing

                                     │
        ┌────────────────────────────┼────────────────────────────┐
        │                            │                            │
        ▼                            ▼                            ▼

 Account Service             Workspace Service          Intelligence Service
 User Authentication         Workspace Management       AI Code Generation
 OAuth2 / JWT                Projects & Files           Prompt Engineering
 User Profiles               Collaboration             Spring AI / LLM
 Role Management             Metadata                  Context Retrieval

        │                            │                            │
        └───────────────┬────────────┴────────────┬───────────────┘
                        │                         │
                        ▼                         ▼

                Apache Kafka Event Bus

         code-generation-topic
         workspace-events
         notification-events

                        │
         ┌──────────────┴───────────────┐
         ▼                              ▼

 Code Generation Worker         File Processing Worker

 Consume Events                 Generate Project Files
 Invoke LLM                     Apply Templates
 Build Code                     Format Source Code
 Publish Result                 Store Generated Files

         └──────────────┬───────────────┘
                        │
                        ▼

──────────────────────── Supporting Services ────────────────────────────────

 Discovery Service                Config Service
 Eureka Server                    Spring Cloud Config
 Service Discovery                Centralized Configuration

 Common Library
 Shared DTOs
 Shared Exceptions
 Utilities
 Event Models

────────────────────────────── Data Layer ───────────────────────────────────

                     PostgreSQL

Tables

• Users
• Workspaces
• Projects
• AI Requests
• Generated Files
• Event Logs

                     Redis

• Response Cache
• Rate Limiting
• Session Storage

──────────────────────── External Integrations ──────────────────────────────

Spring AI
OpenAI / LLM Provider

──────────────────────────── Infrastructure ─────────────────────────────────

Docker
Containerized Microservices

Kubernetes

🔄 System Workflow

User sends a code generation request.
API Gateway authenticates the request.
Account Service validates the user.
Workspace Service manages project data.
Intelligence Service prepares prompts for the AI model.
Kafka publishes generation events.
Code Generation Service processes requests asynchronously.
Generated files are stored and managed.
Notification Service informs users once processing is complete.
Redis improves response time with caching and rate limiting.

🛠 Tech Stack

Backend

Java
Spring Boot
Spring Cloud
Spring AI
Spring Security
Spring Data JPA
Hibernate

Infrastructure

Apache Kafka
Redis
Docker
Kubernetes
Config Server
Eureka Discovery Server

Database

PostgreSQL
MySQL

Authentication

OAuth2
JWT

Build Tool

Maven

📂 Project Structure

                              
 ┌────────────────────┐
 │ 👤 User (Web App)  │
 └─────────┬──────────┘
           │
           │ 1. Enter Prompt
           ▼
 ┌────────────────────┐
 │ React Frontend     │
 │ Authentication     │
 │ Workspace UI       │
 └─────────┬──────────┘
           │ HTTPS
           ▼
 ┌────────────────────┐
 │ API Gateway        │
 │ Spring Cloud       │
 │ Routing            │
 │ Rate Limiting      │
 │ Request Validation │
 └─────────┬──────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ Account Service               │
 │ • JWT Validation              │
 │ • OAuth2 Authentication       │
 │ • User Profile                │
 └─────────┬─────────────────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ Workspace Service             │
 │ • Create Project              │
 │ • Store Prompt                │
 │ • Manage Files                │
 └─────────┬─────────────────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ Intelligence Service          │
 │ • Prompt Engineering          │
 │ • Context Retrieval           │
 │ • AI Model Selection          │
 │ • Build Generation Request    │
 └─────────┬─────────────────────┘
           │
           │ Publish Event
           ▼
 ╔══════════════════════════════╗
 ║       Apache Kafka           ║
 ║  code-generation-topic       ║
 ╚══════════════════════════════╝
           │
           ▼
 ┌───────────────────────────────┐
 │ AI Worker / Consumer          │
 │ • Consume Event               │
 │ • Invoke LLM                  │
 │ • Generate Source Code        │
 │ • Apply Templates             │
 └─────────┬─────────────────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ File Processing               │
 │ • Build Project               │
 │ • Format Code                 │
 │ • Create ZIP                  │
 └─────────┬─────────────────────┘
           │
           ├───────────────┐
           ▼               ▼
 ┌───────────────┐   ┌────────────────┐
 │ PostgreSQL    │   │ Redis Cache    │
 │ Project Data  │   │ Session/Cache  │
 └───────────────┘   └────────────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ Notification Service          │
 │ • Kafka Event                 │
 │ • Email / WebSocket           │
 │ • Generation Completed        │
 └─────────┬─────────────────────┘
           │
           ▼
 ┌───────────────────────────────┐
 │ React Frontend                │
 │ Download Generated Project    │
 │ Preview Code                  │
 └─────────┬─────────────────────┘
           │
           ▼
        ✅ RESULT
   Generated AI Project

⚡ Key Highlights

Event-driven microservices
AI-assisted code generation
Asynchronous processing using Kafka
Secure authentication and authorization
Independent service deployment
High availability and scalability
Cloud-native architecture

🚀 Future Enhancements

Multi-LLM support
Real-time collaborative coding
AI agent orchestration
GitHub integration
Deployment to AWS/GCP/Azure
Monitoring with Prometheus and Grafana

📌 Conclusion

Distributed-Hateable demonstrates how modern distributed systems, AI, and event-driven microservices can be combined to build scalable, secure, and production-ready developer platforms. It showcases best practices in cloud-native architecture, asynchronous processing, and AI integration for real-world software engineering.