# Code Style Guidelines — Java / Spring Boot

- **Formatter:** Google Java Format or IntelliJ default Java formatter
- **Indentation:** 4 spaces (no tabs)
- **Line Length:** Max 120 characters per line
- **Braces:** Always use braces even for single-line if/else/for
- **Blank lines:** 1 blank line between methods; 2 blank lines between top-level declarations
- **Complexity:** Methods should do one thing only. If a method exceeds ~30 lines, consider extracting
- **Comments:** Comment the "why", not the "what". Use Javadoc for public API methods
- **Annotations:** Place each annotation on its own line above the declaration
- **Imports:** No wildcard imports (`import java.util.*`). Organize: Java → javax → third-party → internal