스프링 부트 개발자 온보딩 가이드: 스프링 부트로 시작하는 첫 실무 프로젝트(온보딩 가이드 2)

실무 감각을 키우는 가장 현실적인 백엔드 온보딩 학습서!
대부분의 개발 입문서는 기능 설명에 치중되어 있어 실제 프로젝트를 어떻게 시작하고 운영하는지는 배우기 어렵습니다. 이 책은 그런 고민을 해결하기 위해 기획된 스프링 부트 실무 온보딩 가이드입니다.
저자는 글로벌 SaaS 기업에서 CTO로 활동하면서 작성해 온 실제 온보딩 문서 경험을 바탕으로 초보자가 막히는 지점을 정확히 짚어 주고, 실무에서 바로 쓰는 기술 스택을 단계별로 전달합니다. 또한 모든 기능은 단순한 예시가 아니라 하나의 프로젝트로 이어지는 흐름에서 배우도록 설계되어 있어, 학습자는 책을 끝까지 따라가기만 해도 서비스 하나를 기획하고 개발하고 배포하는 전 과정을 경험하게 됩니다.
스프링 부트 개발을 처음 시작하는 학습자뿐 아니라, 실무 온보딩 문서가 절실한 팀, 새 프로젝트를 준비하는 개발자에게도 강력 추천합니다.

이 책을 꼭 읽어야 하는 독자
● 스프링 부트를 시작하려고 하지만, 무엇부터 어떻게 공부해야 할지 막막한 입문자
● 입사 후 바로 실무 API/서버 개발을 맡게 된 신입 백엔드 개발자
● 실무 환경(WSL2, Docker, MySQL, JPA, Swagger 등)을 그대로 경험해 보고 싶은 학습자
● REST API와 더불어 GraphQL API까지 다뤄보고 싶은 개발자
● 이론 중심 책보다 따라 만들며 배우는 실무 흐름을 선호하는 주니어 개발자

이 책의 구성과 강점
1. 개발 환경 준비
개발 현장에서 실제로 사용하는 WSL2·Docker·IntelliJ 기반 환경을 그대로 경험하며, 회사에서 바로 적용 가능한 개발 환경 구축 능력을 갖출 수 있습니다.
2. 스프링 부트 기본기 이해
IoC/DI/빈/AOP, 자동 구성, 스타터 등 실제 개발자가 매일 다루는 핵심 원리를 이론은 최소, 실습은 최대로 빠르게 익힐 수 있습니다.
3. 인메모리 REST API 구축
가장 작은 기능부터 실제 API 형태로 만들며, 스프링 부트 애플리케이션의 전체 구조와 흐름을 단숨에 이해할 수 있습니다.
4. JPA + MySQL 개발
Docker + JPA + Testcontainers를 연동해 실무에서 요구하는 데이터 접근 구조와 테스트 방법을 그대로 재현합니다.
5. 고급 JPA 마이크로블로그 구현
복잡한 도메인 모델링과 전역 예외 처리 방식까지 다루며, 주니어 개발자가 어려워하는 실무형 API 설계에 한 단계 다가갑니다.
6. JWT 기반 인증 적용
JWT 발급·검증과 Spring Security 설정을 직접 구현해, 실제 서비스 수준의 인증·인가 흐름을 이해하고 적용할 수 있습니다.
7. GraphQL API 서버 개발
REST만 다루는 책과 달리 GraphQL까지 직접 구현해, 현업에서 차별화된 API 개발 역량을 갖출 수 있습니다.
8. Docker & AWS 배포
Docker 이미지 빌드부터 ECR/ECS 배포까지 완주하며, 개발 → 테스트 → 배포의 전 과정을 스스로 완료하며 경험을 쌓습니다.

Part 1. 스프링 부트 온보딩 가이드북 안내
Chapter 01 온보딩 가이드의 목적과 활용법
● 1-1 가이드의 목적
○ 온보딩 가이드의 대상과 범위
○ 알고 있으면 좋은 지식
○ 필요한 개발 환경
● 1.2 개발 환경 온보딩
○ WSL2를 사용하는 이유
○ WSL2 설치하기
○ 도커 데스크탑 설치하기
○ IntelliJ IDEA 설치하기
○ JDK 21 설치하기
○ Gradle 설치하기
Chapter 02 스프링 부트란 무엇인가요?
● 2.1 스프링 부트 소개
○ 스프링 부트의 쓰임새
○ 스프링 부트의 내부 구조
○ 스프링 부트 소개
○ 스프링 부트 이해에 필요한 주요 개념
[고민상담소] 자바 개발자가 배워야 할 프레임워크

________________________________________
Part 2. 스프링 부트 기능 실습
Chapter 03 인메모리 기반의 To-Do 리스트 REST API 서버 만들기
● 3.1 프로젝트 초기화
○ WSL2 터미널 실행
○ 프로젝트 스캐폴드 생성 및 다운로드
○ IntelliJ IDEA 프로젝트 초기화
○ 애플리케이션 패키지 및 소스 코드 파일 생성하기
○ build.gradle 수정
● 3.2 인메모리 To-Do 리스트 API 서버 구현
○ To-Do 리스트 구성 요소
○ 빌드
○ 유닛 테스트
○ TestControllerTests: TodoController 유닛 테스트
○ 실행 및 Swagger-UI를 이용한 API 테스트
[고민상담소] 테스트 코드의 필요성

________________________________________
Chapter 04 JPA 기반의 To-Do 리스트 REST API 서버 개발
● 4.1 JPA 이해하기
○ JPA의 개념과 역할
○ JPA와 Hibernate의 관계
○ JPA의 주요 애노테이션
○ 스프링 데이터 JPA
○ DTO 패턴 이해하기
● 4.2 프로젝트 초기화
○ 프로젝트 복사
○ 도커를 이용한 MySQL 설치 및 설정
○ 테이블 스키마
○ settings.gradle의 프로젝트 명 변경
○ build.gradle에 JPA 및 MySQL JDBC 드라이버 의존성 추가
○ application.properties 수정
● 4.3 JPA 기반의 To-Do 리스트 API 서버 구현
○ 메인 클래스 수정하기
○ 엔티티, DTO, 매퍼 작성
○ 리포지토리 수정
○ 서비스 레이어 수정
○ REST 컨트롤러 수정
○ API 문서화를 위한 Swagger 설정
○ TodoControllerTests 수정
○ TodoServiceTests 수정
○ Test 실행
○ 실행 및 Swagger-UI를 이용한 API 테스트
[고민상담소] 스프링 부트의 데이터베이스 연동
________________________________________
Chapter 05 고급 JPA 기반의 마이크로블로그 REST API 서버 개발
● 5.1 프로젝트 초기화
○ 프로젝트 스캐폴드 생성 및 다운로드
○ IntelliJ IDEA 프로젝트 초기화
○ 패키지 및 소스 코드 파일 생성
○ 도커를 이용한 MySQL 설치 및 설정
○ build.gradle 수정
○ application.properties 수정
● 5.2 Minilog API 서버 구현
○ 스프링 전역 에러 처리기 작성하기
○ 엔티티, DTO, 매퍼 구현
○ entity, dto, util 패키지 생성하기
○ DTO 클래스 작성하기
○ 리포지토리 레이어 구현하기
○ 서비스 레이어 구현하기
○ 컨트롤러 레이어 구현하기
○ API 문서화를 위한 Swagger 설정
[고민상담소] JPA 코드 구조
________________________________________
Chapter 06 Minilog에 인증 기능 추가하기
● 6.1 JWT 인증 이해하기
○ 주요 인증 기법
○ 왜 JWT인가?
○ JWT의 구조와 메커니즘
○ JWT 인증 순서
○ 스프링 시큐리티를 이용한 JWT 인증 기능 통합
● 6.2 프로젝트 초기화
○ 프로젝트 복사
○ build.gradle에 스프링 시큐리티 의존성 추가
○ application.properties 수정
● 6.3 Minilog에 인증 기능 더하기
○ JWT 생성 및 검증 구현하기
○ GrantedAuthority를 상속하는 MinilogGrantedAuthority 정의하기
○ UserDetails 및 UserDetailsService를 각각 상속하여 MinilogUserDetails와 MinilogUserDetailsService 정의하기
○ JWT 인증 처리 구현하기
○ 엔티티, DTO 수정하기
○ 서비스 레이어 수정하기
○ 컨트롤러 레이어 수정하기
○ 빌드
● 6.4 실행 및 Swagger-UI를 이용한 API 테스트
○ minlog-jpa-with-auth 실행
○ 신규 사용자 추가
○ Minilog 로그인 및 Swagger UI 인증
○ 기타 기능 테스트
[고민상담소] 스프링 시큐리티의 소셜 로그인
________________________________________
Chapter 07 GraphQL 기반 마이크로블로그 API 서버 개발
● 7.1 GraphQL 이해하기
○ GraphQL이란?
○ GraphQL의 핵심 개념
○ GraphQL의 주요 구성 요소
○ GraphQL 동작 구조
○ GraphQL 스키마
○ 에러 처리
● 7.2 프로젝트 초기화
○ 프로젝트 복사
○ build.gradle에 graphql 의존성 추가
○ application.properties 수정
● 7.3 Minilog에 GraphQL 지원 추가하기
○ Minilog GraphQL 스키마 정의하기
○ 전역 GraphQL 예외 처리
○ SecurityConfig 수정
○ 응답 타입
○ 입력 타입
○ GraphQL 컨트롤러 추가하기
○ 빌드
● 7.4 실행 및 GraphiQL/Swaggger-UI를 이용한 API 테스트
○ minlog-graphql 실행
○ 신규 사용자 추가
○ Minilog 로그인 및 Swagger UI 인증
○ GraphQL 테스트
○ 추가 테스트
[고민상담소] GrapQL 도입 시점
________________________________________
Chapter 08 도커를 이용한 애플리케이션 패키징 및 배포
● 8.1 Docker의 기본 개념과 설치
○ Docker란 무엇인가?
○ Docker의 주요 구성 요소
● 8.2 Dockerfile 작성 및 이미지 실행 테스트
○ application.properties의 분리
○ Dockerfile 작성
○ 개발(로컬) 환경에서 컨테이너 실행 및 테스트
● 8.3 AWS에 Minilog-GraphQL 배포하기
○ AWS 액세스 키 및 비밀 액세스 키 생성 방법
○ WSL2에 AWS CLI 설치하기
○ Amazon RDS, ECR, ECS 이해하기
○ Amazon RDS MySQL 인스턴스 설정
○ 기본 보안 그룹 인바운드 속성 편집
○ application-prod.properties 수정
○ Amazon ECR에 Docker 이미지 등록
○ Amazon ECS 클러스터에 Minilog-GraphQL 앱 배포하기
● 8.4 Swaggger-UI/GraphiQL를 이용한 API 테스트
○ Swagger-UI를 이용한 API 테스트
○ GraphiQL를 이용한 GraphQL테스트
[고민상담소] AWS, Azure, GCP

박상현 글로벌 SaaS, 무기 시스템 SW, 캐리어급 통신장비 SW를 개발해 온 소프트웨어 엔지니어이며, 현재는 B2B SaaS 기업의 CTO로 재직 중입니다. 대표 저서로는 『이것이 자료구조+알고리즘이다 with C』, 『이것이 C#이다(3판)』 등이 있습니다.