🛠️ Blank μ-service with Hex Arch, DDD, SAGA, Outbox&Kafka

👋 Management the blank service for the blanksystem.

From Lg Pentagon or lg5! Get Lg5-Spring to develop μ-services faster.

For more information, check this pages https://lufgarciaqu.medium.com.

⚠️ Replace _blank_ with the Domain Name ⚠️

For full documentation visit the Wiki.

Using Lg5 Spring 1.0.0-alpha, JDK 21

More details and Repository.

🚀 Build project

Install 1/1: Setup JDK 21.

sdk use java 21.0.2-amzn 

Install 1/2: Install the dependencies in your project.

mvn clean install 

🚀 Deploy with K8s

Use the infra repository blank-infra to deploy with K8s

📚Contents

• blank-acceptance-test
• blank-api
• blank-container
• blank-data-access
• blank-domain
  • blank-domain-core
  • blank-application-service
• blank-external
• blank-message
  • blank-message-core
  • blank-message-model

🚀 Run locally

You can ...

Using makefile

Start with infrastructure

😀 To start the Kafka Cluster and Postgres.

make docker-up

⛔️ To the Kafka Cluster and Postgres stop or destroy:

make docker-down

Run APP

😀 To start the blank Service.

make run-app

blank API 1.0.0-alpha

👋 blank API, Port:8181

Username: None
Password: None

Database UI

👋 PgAdmin, Port:5013

Username: [email protected]
Password: blanksystem-db

Kafka UI

👋 Kafka UI, Port:9080

Username: None
Password: None

Contracts

1. Open API
2. Async API

AVRO MODELS from Avro Model definition

If you add a new Avro model, REMEMBER execute avro model again.

make run-avro-model

Logger & ELK

This project is prepared to send log files and process visualization with filebeat. You can specify the directory for stored the *.log files. Now, genera two file logs.

Simple log

• [log.path]/[application_name]-simple.log

Complex log

• [log.path]/[application_name]-complex.log

• Specify the directory with log.path property.

Simple: Simple details about application logs. Complex: More details about application logs.

⚖️ License

The MIT License (MIT). Please see License for more information.