[Spring Boot / 백엔드] 스프링 부트 프로젝트 세팅하기 - 아키텍처 구조와 Swagger 정리

백엔드 개발을 공부하다 보면 기능 구현 자체도 중요하지만, 그 전에 프로젝트를 어떤 구조로 시작할지 고민하게 됩니다. 처음에는 저도 스프링 프로젝트를 생성하고, 필요한 클래스만 빠르게 추가하면 된다고 생각했습니다. 그런데 직접 프로젝트를 진행해보니 어떤 구조로 파일을 나누는지, 설정 파일을 어떻게 관리하는지, 그리고 API 문서를 어떤 방식으로 공유하는지에 따라 협업 난이도와 유지보수성이 꽤 크게 달라진다는 걸 느꼈습니다. 특히 프로젝트 규모가 커질수록 “기능이 돌아가기만 하는 코드”보다 “다른 사람이 봐도 이해하기 쉬운 구조”가 훨씬 중요하다는 점을 실감했습니다. 그래서 이번 글에서는 워크북 내용을 바탕으로 아키텍처 구조가 왜 필요한지, 도메인형 아키텍처는 어떤 특징이 있는지, 그리고 스프링 부트 프로..

• format_list_bulleted 백엔드
• · 2026. 4. 15.

[Spring Boot / 백엔드] API 설계하기 - API 명세서, RESTful API

백엔드 개발을 공부하다 보면 기능을 구현하는 것만큼이나 API를 어떻게 설계할지 고민하게 됩니다.처음에는 저도 API를 단순히 “프론트와 서버가 통신하기 위한 주소” 정도로만 생각했습니다.그런데 직접 기능을 만들다 보니, 같은 기능이어도어떤 URL로 설계할지,어떤 HTTP 메서드를 써야 할지,어떤 데이터를 어디에 담아 보내야 할지에 따라협업 난이도와 유지보수성이 꽤 달라진다는 걸 느꼈습니다. 그래서 이번 글에서는 워크북 내용을 바탕으로API 명세서가 무엇인지,RESTful API는 어떻게 설계하는지,그리고 실제로 어떤 기준으로 API를 나누고 문서화해야 하는지를 정리해보려고 합니다.이번 글에서 다룰 내용은 다음과 같습니다.API란 무엇인가REST API와 RESTful한 설계HTTP 메서드와 멱등성API..

• format_list_bulleted 백엔드
• · 2026. 4. 3.