Add Spring profiles and Swagger documentation

- Configure development and production profiles with appropriate settings
- Add Swagger/OpenAPI documentation for EventController endpoints
- Update CLAUDE.md with profile information and commands
- Add spring-boot-devtools for development

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: dpconde

CLAUDE.md

@@ -19,9 +19,12 @@ Sofia Tracker is a Spring Boot application written in Kotlin. It's a server appl
 # Build the project
 ./gradlew build
 
-# Run the application
+# Run the application (development profile by default)
 ./gradlew bootRun
 
+# Run with specific profile
+./gradlew bootRun --args='--spring.profiles.active=production'
+
 # Clean build
 ./gradlew clean build
 ```
@@ -103,6 +106,10 @@ src/
 - **Testing**: JUnit 5 platform with Spring Boot Test and MockK
 - **Build**: Gradle with Kotlin DSL
 - **Code Quality**: KtLint, Detekt, Jacoco coverage, OWASP dependency check
+- **API Documentation**: Swagger/OpenAPI (development profile only)
+- **Profiles**:
+  - **Development**: Full logging, H2 console, Swagger UI enabled
+  - **Production**: Minimal logging, security hardened, Swagger disabled
 
 ## CI/CD Pipeline
 

build.gradle

@@ -6,7 +6,7 @@ plugins {
 	id 'org.springframework.boot' version '3.5.6'
 	id 'io.spring.dependency-management' version '1.1.7'
 	id 'org.jlleitschuh.gradle.ktlint' version '12.1.0'
-	id 'io.gitlab.arturbosch.detekt' version '1.23.4'
+	id 'io.gitlab.arturbosch.detekt' version '1.23.1'
 	id 'jacoco'
 	id 'org.owasp.dependencycheck' version '9.0.7'
 }
@@ -32,6 +32,12 @@ dependencies {
 	implementation 'org.flywaydb:flyway-core'
 	implementation 'org.jetbrains.kotlin:kotlin-reflect'
 
+	// Swagger/OpenAPI for development (compatible with Spring Boot 3.x)
+	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.13'
+
+	// Development tools
+	developmentOnly 'org.springframework.boot:spring-boot-devtools'
+
 	runtimeOnly 'com.h2database:h2'
 
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'

src/main/kotlin/com/dpconde/sofia_tracker/infrastructure/config/SwaggerConfig.kt

@@ -0,0 +1,43 @@
+package com.dpconde.sofia_tracker.infrastructure.config
+
+import io.swagger.v3.oas.models.OpenAPI
+import io.swagger.v3.oas.models.info.Contact
+import io.swagger.v3.oas.models.info.Info
+import io.swagger.v3.oas.models.info.License
+import io.swagger.v3.oas.models.servers.Server
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.Profile
+
+@Configuration
+@Profile("development")
+class SwaggerConfig {
+
+    @Bean
+    fun customOpenAPI(): OpenAPI {
+        return OpenAPI()
+            .info(
+                Info()
+                    .title("Sofia Tracker API")
+                    .description("REST API for tracking baby events like feeding, sleeping, and diaper changes")
+                    .version("0.0.1-SNAPSHOT")
+                    .contact(
+                        Contact()
+                            .name("Sofia Tracker Team")
+                            .email("contact@sofiatracker.com")
+                    )
+                    .license(
+                        License()
+                            .name("MIT License")
+                            .url("https://opensource.org/licenses/MIT")
+                    )
+            )
+            .servers(
+                listOf(
+                    Server()
+                        .url("http://localhost:8080")
+                        .description("Development server")
+                )
+            )
+    }
+}

src/main/kotlin/com/dpconde/sofia_tracker/presentation/controllers/EventController.kt

@@ -7,6 +7,11 @@ import com.dpconde.sofia_tracker.presentation.dto.RemoteEventDto
 import com.dpconde.sofia_tracker.presentation.dto.UpdateEventRequestDto
 import com.dpconde.sofia_tracker.presentation.exception.EventNotFoundException
 import com.dpconde.sofia_tracker.presentation.mappers.EventDtoMapper
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.Parameter
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.responses.ApiResponses
+import io.swagger.v3.oas.annotations.tags.Tag
 import jakarta.validation.Valid
 import org.springframework.format.annotation.DateTimeFormat
 import org.springframework.http.HttpStatus
@@ -18,6 +23,7 @@ import java.time.ZoneOffset
 
 @RestController
 @RequestMapping("/api/events")
+@Tag(name = "Events", description = "API for managing baby events (feeding, sleeping, diaper changes)")
 class EventController(
     private val createEventUseCase: CreateEventUseCase,
     private val getEventUseCase: GetEventUseCase,
@@ -28,6 +34,17 @@ class EventController(
 ) {
 
     @PostMapping
+    @Operation(
+        summary = "Create a new event",
+        description = "Creates a new baby event (feeding, sleeping, or diaper change)"
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(responseCode = "201", description = "Event created successfully"),
+            ApiResponse(responseCode = "400", description = "Invalid request data"),
+            ApiResponse(responseCode = "409", description = "Event with this ID already exists")
+        ]
+    )
     fun createEvent(@Valid @RequestBody request: CreateEventRequestDto): ResponseEntity<RemoteEventDto> {
         val command = eventDtoMapper.toCreateEventCommand(request)
         val createdEvent = createEventUseCase.execute(command)
@@ -36,7 +53,20 @@ class EventController(
     }
 
     @GetMapping("/{id}")
-    fun getEvent(@PathVariable id: String): ResponseEntity<RemoteEventDto> {
+    @Operation(
+        summary = "Get event by ID",
+        description = "Retrieves a specific event by its unique identifier"
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(responseCode = "200", description = "Event found"),
+            ApiResponse(responseCode = "404", description = "Event not found")
+        ]
+    )
+    fun getEvent(
+        @Parameter(description = "Event ID", required = true)
+        @PathVariable id: String
+    ): ResponseEntity<RemoteEventDto> {
         val event = getEventUseCase.execute(id)
             ?: throw EventNotFoundException("Event with ID $id not found")
 
@@ -77,9 +107,22 @@ class EventController(
     }
 
     @GetMapping
+    @Operation(
+        summary = "List events",
+        description = "Retrieves all events with optional filtering by type or date range"
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(responseCode = "200", description = "Events retrieved successfully"),
+            ApiResponse(responseCode = "400", description = "Invalid query parameters")
+        ]
+    )
     fun listEvents(
+        @Parameter(description = "Filter by event type (EAT, SLEEP, POOP)")
         @RequestParam(required = false) type: String?,
+        @Parameter(description = "Start date for date range filter (ISO format)")
         @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) start: LocalDateTime?,
+        @Parameter(description = "End date for date range filter (ISO format)")
         @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) end: LocalDateTime?
     ): ResponseEntity<List<RemoteEventDto>> {
         val events = when {
@@ -107,6 +150,11 @@ class EventController(
     }
 
     @GetMapping("/health")
+    @Operation(
+        summary = "Health check",
+        description = "Returns the health status of the Events API"
+    )
+    @ApiResponse(responseCode = "200", description = "Service is healthy")
     fun health(): ResponseEntity<Map<String, String>> {
         return ResponseEntity.ok(mapOf("status" to "UP"))
     }

src/main/resources/application-development.properties

@@ -0,0 +1,45 @@
+# Development Profile Configuration
+spring.application.name=sofia-tracker
+
+# H2 Database Configuration
+spring.datasource.url=jdbc:h2:mem:sofia_tracker_dev_db;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DEFAULT_NULL_ORDERING=HIGH
+spring.datasource.driver-class-name=org.h2.Driver
+spring.datasource.username=sa
+spring.datasource.password=
+
+# H2 Console Configuration (enabled for development)
+spring.h2.console.enabled=true
+spring.h2.console.path=/h2-console
+
+# JPA Configuration for Development
+spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
+spring.jpa.hibernate.ddl-auto=validate
+spring.jpa.show-sql=true
+spring.jpa.properties.hibernate.format_sql=true
+
+# Flyway Configuration
+spring.flyway.enabled=true
+spring.flyway.locations=classpath:db/migration
+spring.flyway.baseline-on-migrate=true
+spring.flyway.baseline-version=0
+
+# Logging Configuration for Development
+logging.level.org.flywaydb=INFO
+logging.level.org.hibernate.SQL=DEBUG
+logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
+logging.level.com.dpconde.sofia_tracker=DEBUG
+logging.level.org.springframework.web=DEBUG
+
+# Server Configuration
+server.port=8080
+
+# Swagger/OpenAPI Configuration (enabled for development)
+springdoc.api-docs.enabled=true
+springdoc.swagger-ui.enabled=true
+springdoc.swagger-ui.tryItOutEnabled=true
+springdoc.swagger-ui.operationsSorter=method
+springdoc.swagger-ui.tagsSorter=alpha
+
+# Development-specific settings
+spring.devtools.restart.enabled=true
+spring.devtools.livereload.enabled=true

src/main/resources/application-production.properties

@@ -0,0 +1,55 @@
+# Production Profile Configuration
+spring.application.name=sofia-tracker
+
+# Database Configuration (will be overridden by Railway environment variables)
+spring.datasource.url=${DATABASE_URL:jdbc:h2:mem:sofia_tracker_prod_db}
+spring.datasource.driver-class-name=${DATABASE_DRIVER:org.h2.Driver}
+spring.datasource.username=${DATABASE_USERNAME:sa}
+spring.datasource.password=${DATABASE_PASSWORD:}
+
+# H2 Console Configuration (disabled for production)
+spring.h2.console.enabled=false
+
+# JPA Configuration for Production
+spring.jpa.database-platform=${DATABASE_PLATFORM:org.hibernate.dialect.H2Dialect}
+spring.jpa.hibernate.ddl-auto=validate
+spring.jpa.show-sql=false
+spring.jpa.properties.hibernate.format_sql=false
+
+# Flyway Configuration
+spring.flyway.enabled=true
+spring.flyway.locations=classpath:db/migration
+spring.flyway.baseline-on-migrate=true
+spring.flyway.baseline-version=0
+
+# Logging Configuration for Production
+logging.level.org.flywaydb=WARN
+logging.level.org.hibernate.SQL=WARN
+logging.level.org.hibernate.type.descriptor.sql.BasicBinder=WARN
+logging.level.com.dpconde.sofia_tracker=INFO
+logging.level.org.springframework.web=WARN
+logging.level.org.springframework.security=WARN
+
+# Server Configuration
+server.port=${PORT:8080}
+
+# Swagger/OpenAPI Configuration (disabled for production)
+springdoc.api-docs.enabled=false
+springdoc.swagger-ui.enabled=false
+
+# Production-specific settings
+spring.devtools.restart.enabled=false
+spring.devtools.livereload.enabled=false
+
+# Security settings for production
+server.error.include-message=never
+server.error.include-binding-errors=never
+server.error.include-stacktrace=never
+server.error.include-exception=false
+
+# Connection pool settings for production
+spring.datasource.hikari.maximum-pool-size=${DATABASE_MAX_POOL_SIZE:10}
+spring.datasource.hikari.minimum-idle=${DATABASE_MIN_IDLE:5}
+spring.datasource.hikari.connection-timeout=${DATABASE_CONNECTION_TIMEOUT:30000}
+spring.datasource.hikari.idle-timeout=${DATABASE_IDLE_TIMEOUT:600000}
+spring.datasource.hikari.max-lifetime=${DATABASE_MAX_LIFETIME:1800000}

src/main/resources/application.properties

@@ -1,31 +1,8 @@
+# Default Profile Configuration
 spring.application.name=sofia-tracker
 
-# H2 Database Configuration
-spring.datasource.url=jdbc:h2:mem:sofia_tracker_db;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DEFAULT_NULL_ORDERING=HIGH
-spring.datasource.driver-class-name=org.h2.Driver
-spring.datasource.username=sa
-spring.datasource.password=
+# Set default profile to development (use production profile in Railway)
+spring.profiles.active=${SPRING_PROFILES_ACTIVE:development}
 
-# H2 Console Configuration (for development)
-spring.h2.console.enabled=true
-spring.h2.console.path=/h2-console
-
-# JPA Configuration
-spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
-spring.jpa.hibernate.ddl-auto=validate
-spring.jpa.show-sql=false
-spring.jpa.properties.hibernate.format_sql=true
-
-# Flyway Configuration
-spring.flyway.enabled=true
-spring.flyway.locations=classpath:db/migration
-spring.flyway.baseline-on-migrate=true
-spring.flyway.baseline-version=0
-
-# Logging Configuration
-logging.level.org.flywaydb=INFO
-logging.level.org.hibernate.SQL=DEBUG
-logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
-
-# Server Configuration
-server.port=8080
+# Common configuration that applies to all profiles
+server.port=${PORT:8080}