itroi/AGENTS.md

AGENTS.md

Build/Test Commands

• Build: ./gradlew build
• Test all: ./gradlew test
• Run single test: ./gradlew test --tests "FreightIntegrationTest.getByIdReturnsEntity"
• Run app: ./gradlew bootRun

Code Style Guidelines

• Package structure: ua.com.dxrkness.{controller,service,repository,model}
• Use Spring Boot annotations (@RestController, @Service, etc.)
• Records for models with Jackson @JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
• Constructor injection for dependencies
• JSpecify annotations (@NullMarked, @Nullable) for null safety
• Integration tests with @SpringBootTest and parameterized tests
• REST controllers support both JSON and XML media types
• Use ResponseEntity for HTTP responses with proper status codes
• OpenAPI documentation with Swagger annotations on controllers