README.md

spring-axon-rabbitmq-starter

This project is a Spring Boot application using Axon Framework, RabbitMQ, and PostgreSQL, following * DDD* (Domain-Driven Design) and CQRS (Command Query Responsibility Segregation) principles.

📥 Clone the Project

git clone https://github.com/coundia/spring-axon-rabbitmq-starter.git
cd spring-axon-rabbitmq-starter

📌 Prerequisites

Before running the application, make sure you have installed:

• Docker
• Docker Compose
• Maven

🚀 Installation and Execution

1️⃣ Start PostgreSQL and RabbitMQ

Run the following command to start the Docker containers:

docker compose -f docker/main.yml up -d

2️⃣ Run Tests

mvn spring-boot:test-run

3️⃣ Start the Spring Boot Application

mvn spring-boot:run

📡 API Documentation

Once the application is running, you can access the Swagger UI documentation here:

🔗 http://127.0.0.1:8093/swagger-ui/index.html#/

USAGE

curl -X 'POST'

'http://127.0.0.1:8095/api/auth/register'

-H 'accept: /'

-H 'Content-Type: application/json'

-d '{

"username": "admin",

"password": "admin"

#}' POST http://127.0.0.1:8095/api/auth/register accept: / Content-Type: application/json

{ "username": "admin", "password": "admin" }

curl -X 'POST'

'http://127.0.0.1:8095/api/auth/login'

-H 'accept: /'

-H 'Content-Type: application/json'

-d '{

"username": "admin",

"password": "admin"

#}' POST http://127.0.0.1:8095/api/auth/login accept: / Content-Type: application/json

{ "username": "admin", "password": "admin" }

POST http://127.0.0.1:8095/api/auth/register accept: / Content-Type: application/json

{ "username": "string", "password": "string" }

POST http://127.0.0.1:8095/api/v1/commands/transaction accept: / Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJhZG1pbiIsImlhdCI6MTc0NTAwMDY5NywiZXhwIjoxNzQ1MDM2Njk3fQ.mIc3-ALDasLCBiFaDx2pKzEWCOWAENSuMnUYgzmK2Y0

{ "reference": "string", "amount": 0 }

Api documentation swagger

RabbitMQ Management

http://localhost:15672/#/queues

📁 Project Structure

- `domain/`: logique métier, agrégats, events, value objects
- `application/`: services, DTOs, command/query handlers
- `infrastructure/`: persistance (JPA), messaging (RabbitMQ)
- `presentation/`: API REST (commandes & queries)
- `templates/`: fichiers mustache pour la génération de code
- `shared/`: utilitaires

Vor [tree.md](docs/tree.md)

Test

Projet généré par : https://github.com/coundia/axon-web-cqrs-generator

🔹 Notes

• The application follows the CQRS pattern, separating command and query models.
• RabbitMQ is used as a message broker for event-driven communication.
• PostgreSQL is the primary database.

📜 License

CC-BY-NC-SA-4.0