chore: Improve Docker Compose setup for local development (#182)

* chore: Improve Docker Compose setup for local development

- Separate infrastructure containers from module containers for clearer management.
- Enable easy scaling of module containers to simulate a production-like setup.

Implements: MRSPECS-103

Author: viacheslavkol

NEWS.md

@@ -18,6 +18,7 @@
 * Add integration test to cover sync endpoint ([MRSPECS-105](https://folio-org.atlassian.net/browse/MRSPECS-105))
 * Add integration test to verify field restoration after sync ([MRSPECS-106](https://folio-org.atlassian.net/browse/MRSPECS-106))
 * Refactor code to comply with Checkstyle method length limit (max 25 lines) ([MRSPECS-195](https://folio-org.atlassian.net/browse/MRSPECS-195))
+* Improve Docker Compose setup for local development ([MRSPECS-103](https://folio-org.atlassian.net/browse/MRSPECS-103))
 
 ### Dependencies
 * Bump `LIB_NAME` from `OLD_VERSION` to `NEW_VERSION`

README.md

@@ -61,33 +61,58 @@ Change these variables as per your requirements.
 
 ### Running The Module
 
-#### Locally
+#### Using Docker Compose (Recommended)
 
-Run the module locally on the default listening port (8081) with the prescribed command:
+The recommended way to run the module locally is using Docker Compose. This provides a complete development environment with all dependencies.
 
 ```shell
-DB_HOST=localhost DB_PORT=5432 DB_DATABASE=okapi_modules DB_USERNAME=folio_admin DB_PASSWORD=folio_admin \
-java -Dserver.port=8081 -jar mod-record-specifications-server/target/mod-record-specifications-fat.jar
+# Build the module JAR
+mvn clean package -DskipTests
+
+# Start all services (infrastructure + module)
+docker compose -f docker/app-docker-compose.yml up -d
+
+# View logs
+docker compose -f docker/app-docker-compose.yml logs -f mod-record-specifications
 ```
 
-#### Using Docker
+For detailed Docker Compose documentation, see [docker/README.md](docker/README.md).
 
-To run the module in a Docker container, first build the Docker image:
+#### Local Development with IntelliJ IDEA
 
-```shell
-docker build -t dev.folio/mod-record-specifications .
-```
+For local development, you can run the application directly from IntelliJ IDEA with the `dev` profile. Spring Boot will automatically start the required infrastructure services (PostgreSQL, Kafka) using Docker Compose.
+
+1. Open the project in IntelliJ IDEA
+2. Run the main application class with the `dev` profile active
+3. Spring Boot will automatically start infrastructure containers from `docker/infra-docker-compose.yml`
+
+#### Manually Running the Module
+
+Run the module locally on the default listening port (8081) with infrastructure services:
 
-Prepare infrastructure needed for the module: PostgreSQL database.
-Alternatively, you can use Docker Compose to manage the application's infrastructure.
 ```shell
-docker compose up
+# Start infrastructure services
+docker compose -f docker/infra-docker-compose.yml up -d
+
+# Run the module
+DB_HOST=localhost DB_PORT=5432 DB_DATABASE=okapi_modules DB_USERNAME=folio_admin DB_PASSWORD=folio_admin \
+KAFKA_HOST=localhost KAFKA_PORT=29092 \
+java -Dserver.port=8081 -jar mod-record-specifications-server/target/mod-record-specifications-fat.jar
 ```
 
-Then run the container:
+#### Using Docker (Legacy)
+
+To run the module in a Docker container:
 
 ```shell
-docker run -t -i -p 8081:8081 dev.folio/mod-record-specifications
+# Build the module JAR
+mvn clean package -DskipTests
+
+# Build the Docker image
+docker build -t dev.folio/mod-record-specifications .
+
+# Run with Docker Compose
+docker compose -f docker/app-docker-compose.yml up -d
 ```
 
 ### Module Descriptor

compose.yml

@@ -0,0 +1,27 @@
+# Docker Compose configuration for mod-record-specifications
+
+# Project name
+COMPOSE_PROJECT_NAME=folio-mod-record-specifications
+
+# Module Configuration
+ENV=folio
+MODULE_REPLICAS=2
+
+# Database Configuration
+DB_HOST=postgres
+DB_PORT=5432
+DB_DATABASE=okapi_modules
+DB_USERNAME=folio_admin
+DB_PASSWORD=folio_admin
+
+# pgAdmin Configuration
+PGADMIN_DEFAULT_EMAIL=user@domain.com
+PGADMIN_DEFAULT_PASSWORD=admin
+PGADMIN_PORT=5050
+
+# Kafka Configuration
+KAFKA_HOST=kafka
+KAFKA_PORT=9093
+KAFKA_TOPIC_PARTITIONS=2
+KAFKA_UI_PORT=8090
+