📝 docs: add auto-generated Swagger UI

Author: MateuszNaKodach

pom.xml

@@ -29,6 +29,7 @@
 	<properties>
 		<axon.version>4.11.1</axon.version>
 		<java.version>23</java.version>
+		<spring-doc.version>2.8.5</spring-doc.version>
 		<spring-modulith.version>1.3.2</spring-modulith.version>
 	</properties>
 	<dependencies>
@@ -65,6 +66,12 @@
 			<artifactId>axon-spring-boot-starter</artifactId>
 		</dependency>
 
+		<dependency>
+			<groupId>org.springdoc</groupId>
+			<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+			<version>${spring-doc.version}</version>
+		</dependency>
+
 		<!-- Runtime dependencies -->
 		<dependency>
 			<groupId>org.springframework.boot</groupId>

src/main/java/com/dddheroes/heroesofddd/OpenApiConfiguration.java

@@ -0,0 +1,20 @@
+package com.dddheroes.heroesofddd;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class OpenApiConfiguration {
+
+    @Bean
+    public OpenAPI heroesOfDddOpenAPI() {
+        return new OpenAPI()
+                .info(new Info()
+                              .title("Heroes of Domain-Driven Design API")
+                              .description("REST API for Heroes of Domain-Driven Design game")
+                              .version("v1.0.0")
+                );
+    }
+}