arch-blueprint-kotlin

A Kotlin project as template and pedagogical support for the teaching of Clean Architecture crafting practice.

Features

CRUD operations on client entities exposed by a REST API, and examples of problem-solving exposed by a Kotlin API.

• Web request validation with Swagger request validator
• Web security based on Basic Authentication
• Exception handling with Zalando problem handling
• Application management with Spring Actuator
• Acceptance testing with Cucumber
• Contract testing with Pact
• Architecture testing with ArchUnit
• Reactive programming supported by Spring Webflux and Reactor

Getting started

• Build the project with ./gradlew clean build.
• Start the containerized database with docker-compose up.
• Launch the application locally with gradlew bootRun --args='--spring.profiles.active=local,r2dbc'
• Play use cases with Postman using this default collection or with Swagger UI.

Documentation

Find full detailed documentation here powered by MkDocs