Merge pull request #21 from igorcampos-dev/patch/kafka-and-readme

Patch/kafka and readme

Author: igorcampos-dev

README.md

@@ -14,9 +14,9 @@ Each subdirectory in this repository represents a specific integration or featur
 
 Below you will find a summary table of each subproject. For more details, please refer to the individual README.md files.
 
-| Name                                               | Description                                                                   |
-|----------------------------------------------------|-------------------------------------------------------------------------------|
-| [Spring Boot + Kafka](./spring-kafka-example)      | Demonstrates a basic integration between Spring Boot and Apache Kafka. |
+| Name                                          | Description                                                            |
+|-----------------------------------------------|------------------------------------------------------------------------|
+| [Spring Boot + Kafka](./spring-kafka-example) | Demonstrates a basic integration between Spring Boot and Apache Kafka. |
 
 ---
 

spring-kafka-example/README.md

@@ -0,0 +1,25 @@
+# spring-kafka-example
+
+---
+
+## Overview
+
+Basic Java Spring (Java 21) project showing simple integration with Apache Kafka.  
+Includes a Kafka producer and consumer with minimal setup for local development.
+
+---
+
+## Tech stack
+
+- Spring Boot
+- Java 21
+- Kafka (Docker)
+
+---
+
+## Related Resources
+
+| Description                                      | Link                                                                                                       |
+|--------------------------------------------------|------------------------------------------------------------------------------------------------------------|
+| Spring Kafka Official Docs                       | [spring.io/projects/spring-kafka](https://spring.io/projects/spring-kafka)                                 |
+| Various Kafka setups and approaches using Docker | [github.com/conduktor/kafka-stack-docker-compose](https://github.com/conduktor/kafka-stack-docker-compose) |

spring-kafka-example/compose.yaml

@@ -1,4 +1,5 @@
 services:
+
   server:
     build:
       context: .
@@ -8,3 +9,25 @@ services:
       SERVER_PORT: "80"
       SPRING_PROFILES_ACTIVE: "default"
 
+  zookeeper:
+    image: confluentinc/cp-zookeeper:7.4.0
+    environment:
+      ZOOKEEPER_CLIENT_PORT: 2181
+      ZOOKEEPER_TICK_TIME: 2000
+    ports:
+      - '2181:2181'
+
+  kafka:
+    image: confluentinc/cp-kafka:7.4.0
+    depends_on:
+      - zookeeper
+    ports:
+      - '9092:9092'
+      - '29092:29092'
+    environment:
+      KAFKA_BROKER_ID: 1
+      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
+      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092,PLAINTEXT_HOST://localhost:29092
+      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT
+      KAFKA_INTER_BROKER_LISTENER_NAME: PLAINTEXT
+      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1