λ³Έ λ¬Έμλ 'SAN(μ§μ λ¦¬μ½ μμ΄μ νΈ)' νλ‘μ νΈμ μ½μ΄ APIλ₯Ό λ΄λΉνλ Spring Boot μλ²μ μ½λ μμ± λ° μ€κ³ κ·μΉμ μ μν©λλ€. 6μ£ΌλΌλ μ νλ κΈ°κ° λ΄μ λΉ λ₯΄κ³ μμ μ μΌλ‘ κ°λ°νλ κ²μ μ΅μ°μ λͺ©νλ‘ ν©λλ€.
Ctrl + Alt + L (Mac: Cmd + Option + L)μ μνννμ¬ λΆνμν Git Conflictλ₯Ό λ°©μ§ν©λλ€.μλ²½ν μ£Όμλ³΄λ€ 'μ€μ€λ‘ μ€λͺ νλ μ½λ(Self-documenting)' λ€μ΄λ°μ μ§ν₯νλ©°, μμ°μ±μ μν΄ μ£Όμμ μ νμ μΌλ‘ μ¬μ©ν©λλ€.
Controllerμ λͺ¨λ End-point λ©μλ (API μ€ν μ€λͺ
)Service ν΄λμ€μ ν΅μ¬ λΉμ¦λμ€ λ‘μ§ λ©μλClient μΈν°νμ΄μ€Repository)Getter/Setter, μμ±μ, DTO ν΄λμ€//): λ‘μ§μ΄ 볡μ‘νκ±°λ, νΉμ μμΈ μ²λ¦¬λ₯Ό ν 'μ΄μ (Why)'λ₯Ό μ€λͺ
ν λλ§ μ¬μ©ν©λλ€.// Controller λ©μλ Javadoc μμ
/**
* μ¬μ©μμ μ€ν¬λ© λ°μ΄ν°λ₯Ό κΈ°λ°μΌλ‘ AI μμ§μ μμ½μ μμ²ν©λλ€.
*
* @param request μ€ν¬λ© μλ³Έ ν
μ€νΈ λ° λ©νλ°μ΄ν°
* @return AI μμ§μ΄ μμ±ν λ§ν¬λ€μ΄ μμ½λ³Έ λ° νκ·Έ 리μ€νΈ
*/
@PostMapping("/scrap")
public ResponseEntity<ScrapResponse> processScrap(@RequestBody ScrapRequest request) { ... }
request / response κΈ°μ€μΌλ‘ λΆλ¦¬νλ©°,XXXRequest, XXXResponse ν¬λ§·μ μ¬μ©ν©λλ€.BaseResponseλ‘ κ°μΈμ λ°νν©λλ€.@RestControllerAdvice κΈ°λ°μ GlobalExceptionHandlerλ₯Ό μ¬μ©νμ¬ μμΈλ₯Ό μ€μ μ§μ€μμΌλ‘ μ²λ¦¬ν©λλ€.BaseExceptionμ μμλ°μΌλ©°, μμΈ μλ¬ μ½λλ ErrorCode (Enum)μΌλ‘ μΌκ΄ κ΄λ¦¬ν©λλ€.AiEngineTimeoutExceptionμ λ°μμν΅λλ€.