# achyuthmohan/spring-boot-kafka architecture

> Architecture diagram of the GitHub repository achyuthmohan/spring-boot-kafka, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/achyuthmohan/spring-boot-kafka
- Repository: https://github.com/achyuthmohan/spring-boot-kafka

## Overview

##### Project type and purpose
- This is a backend Spring Boot micro-service that demonstrates producing to and consuming from Apache Kafka topics.
- It exposes REST endpoints (via controllers) to accept messages, publishes them to Kafka, and consumes messages from Kafka (JSON and plain text).

##### File structure
- src/main/java/com/kafka/guide/springboot_kafka
- Application.java – Spring Boot entry point
- config/KafkaTopicConfig.java – Topic and binder configuration
- common/KafkaTopicName.java – Topic name constants
- controllers/MessageController.java & JsonMessageController.java – REST APIs for sending plain and JSON messages
- kafka/KafkaProducer.java & JsonKafkaProducer.java – Producer implementations
- kafka/KafkaConsumer.java & JsonKafkaConsumer.java – Consumer implementations
- models/SendMessageRequestModel.java & UserModel.java – Request and payload models
- exceptions/KafkaException.java – Custom Kafka exception
- application.properties – Kafka broker address and serialization settings
- pom.xml – Spring Boot, Spring Kafka dependencies

##### README
- Minimal, only project title. We infer architecture from code.

##### Detailed component breakdown (to include
- Controller layer:
- JsonMessageController
- MessageController
- Producer layer:
- JsonKafkaProducer
- KafkaProducer
- Kafka infrastructure:
- Topic: “json_topic”
- Topic: “text_topic”
- Broker cluster
- Consumer layer:
- JsonKafkaConsumer
- KafkaConsumer

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client"]:::client

    subgraph "Spring Boot Service"
        App["Application"]:::config
        subgraph "Configuration Module"
            Config["KafkaTopicConfig"]:::config
            Constants["KafkaTopicName"]:::config
        end
        subgraph "Controller Layer"
            MC["MessageController"]:::controller
            JMC["JsonMessageController"]:::controller
        end
        subgraph "Producer Layer"
            KP["KafkaProducer"]:::producer
            JKP["JsonKafkaProducer"]:::producer
        end
        subgraph "Consumer Layer"
            KC["KafkaConsumer"]:::consumer
            JKC["JsonKafkaConsumer"]:::consumer
        end
    end

    subgraph "Kafka Cluster"
        Broker["Broker Cluster"]:::kafka
        TT["text_topic"]:::kafka
        JT["json_topic"]:::kafka
    end

    Client -->|HTTP/text| MC
    Client -->|HTTP/JSON| JMC
    MC -->|"calls KafkaProducer"| KP
    JMC -->|"calls JsonKafkaProducer"| JKP
    KP -.->|Kafka/text| TT
    JKP -.->|Kafka/JSON| JT
    TT -->|"subscribes"| KC
    JT -->|"subscribes"| JKC

    click App "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/Application.java"
    click Config "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/config/KafkaTopicConfig.java"
    click Constants "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/common/KafkaTopicName.java"
    click MC "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/controllers/MessageController.java"
    click JMC "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/controllers/JsonMessageController.java"
    click KP "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/kafka/KafkaProducer.java"
    click JKP "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/kafka/JsonKafkaProducer.java"
    click KC "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/kafka/KafkaConsumer.java"
    click JKC "https://github.com/achyuthmohan/spring-boot-kafka/blob/main/src/main/java/com/kafka/guide/springboot_kafka/kafka/JsonKafkaConsumer.java"

    classDef controller fill:#AED6F1,stroke:#3498DB,stroke-width:1px
    classDef producer fill:#D5F5E3,stroke:#27AE60,stroke-width:1px
    classDef consumer fill:#FDEBD0,stroke:#D35400,stroke-width:1px
    classDef kafka fill:#ABEBC6,stroke:#229954,stroke-width:1px
    classDef client fill:#F2F3F4,stroke:#ABB2B9,stroke-width:1px
    classDef config fill:#E8DAEF,stroke:#8E44AD,stroke-width:1px
```
