백엔드스터디Spring BootJava서버AI 코드 읽기

백엔드 스터디 Day 1: 스프링 프로젝트를 읽기 위한 최소 지도

2026년 5월 31일31분 읽기

예상 읽기 시간: 20~30분

오늘의 목표

이번 백엔드 스터디는 "내가 백엔드 코드를 전부 손으로 작성할 수 있게 되기"가 목표가 아닙니다. 목표를 그렇게 잡으면 시작점이 너무 높아집니다. Java 문법, Spring 문법, JPA, DB, 인증, 배포, 테스트까지 한 번에 외워야 할 것처럼 느껴지고, 결국 AI에게 코드를 맡긴 뒤에도 무엇을 확인해야 하는지 감이 잘 안 옵니다.

이 시리즈의 목표는 조금 다르게 잡겠습니다.

AI가 Spring Boot 백엔드 코드를 만들어 줬을 때, 그 코드가 프로젝트 안에서 어떤 위치에 있고, 어떤 요청을 처리하며, 어디까지가 위험한 변경인지 읽을 수 있는 수준.

그러니까 당장 문법을 외우지 않아도 됩니다. 오늘은 외우기보다 지도를 만드는 날입니다. 지도를 먼저 만들면, 나중에 AI가 만든 코드가 길어져도 "이건 Controller구나", "이건 DB에 닿는 Repository구나", "이 DTO가 요청 바디 모양이구나", "여기서 예외 처리를 안 하면 프론트가 이상한 응답을 받겠구나" 정도를 구분할 수 있습니다.

오늘 글을 읽고 나면 아래 질문에 답할 수 있어야 합니다.

백엔드는 프론트엔드와 무엇을 주고받는가?
HTTP 요청은 Spring Boot 프로젝트 안에서 어떤 파일을 거쳐 가는가?
controller, service, repository, entity, dto 폴더는 왜 나뉘어 있는가?
AI가 만든 백엔드 코드를 볼 때 가장 먼저 어디를 봐야 하는가?
Java/Spring 문법을 완벽히 몰라도 흐름을 읽는 방법은 무엇인가?

1. 백엔드를 "화면 뒤의 코드"라고만 보면 부족하다

처음에는 백엔드를 이렇게 이해하기 쉽습니다.

프론트엔드: 사용자가 보는 화면
백엔드: 화면 뒤에서 데이터를 주는 서버

틀린 말은 아닙니다. 하지만 이 설명만으로는 실제 코드를 읽기가 어렵습니다. 백엔드는 단순히 데이터를 주는 곳이 아니라, 사용자의 요청을 받아서 "규칙에 맞게 판단하고, 필요한 데이터를 읽거나 바꾸고, 결과를 약속된 형태로 돌려주는 프로그램"입니다.

예를 들어 블로그에 댓글을 작성하는 상황을 생각해 봅시다.

사용자는 화면에서 댓글 내용을 입력하고 등록 버튼을 누릅니다. 프론트엔드는 서버에 이런 요청을 보냅니다.

text

POST /api/posts/123/comments

{
  "content": "좋은 글입니다!"
}

백엔드는 이 요청을 받고 곧바로 DB에 저장하지 않습니다. 중간에 여러 판단이 들어갑니다.

로그인한 사용자인가?
글 번호 123이 실제로 존재하는가?
댓글 내용이 비어 있지는 않은가?
너무 긴 댓글은 아닌가?
차단된 사용자는 아닌가?
DB에 저장할 때 댓글과 사용자와 게시글의 관계를 어떻게 묶을 것인가?
성공하면 프론트에 어떤 모양의 응답을 줄 것인가?

text

backend-project/
  build.gradle 또는 pom.xml
  src/
    main/
      java/
        com/example/project/
          ProjectApplication.java
          controller/
          service/
          repository/
          entity/
          dto/
          config/
          exception/
      resources/
        application.yml 또는 application.properties
    test/
      java/

위치	먼저 이해할 역할
`ProjectApplication.java`	서버 시작점
`controller`	HTTP 요청을 받는 입구
`service`	비즈니스 규칙을 처리하는 중심
`repository`	DB에 접근하는 통로
`entity`	DB 테이블과 가까운 객체

java

@RestController
@RequestMapping("/api/posts")
@RequiredArgsConstructor
public class PostController {

    private final PostService postService;

    @GetMapping("/{postId}")
    public PostResponse getPost(@PathVariable Long postId) {
        return postService.getPost(postId);
    }

    @PostMapping
    public PostResponse createPost(@RequestBody CreatePostRequest request) {
        return postService.createPost(request);
    }

java

@Service
@RequiredArgsConstructor
public class PostService {

    private final PostRepository postRepository;

    public PostResponse getPost(Long postId) {
        Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

        return PostResponse.from(post);
    }
}

java

@Entity
public class Post {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;

    private String content;

    private Long authorId;
}

java

public record PostResponse(
    Long id,
    String title,
    String content,
    String authorName
) {
    public static PostResponse from(Post post) {
        return new PostResponse(
            post.getId(),
            post.getTitle(),
            post.getContent(),
            "작성자 이름"
        );
    }
}

text

프론트엔드
  ↓ HTTP 요청
PostController
  ↓ postService.getPost(123)
PostService
  ↓ postRepository.findById(123)
PostRepository
  ↓ DB 조회
Database
  ↑ Post Entity
PostService
  ↓ PostResponse DTO로 변환
PostController
  ↓ JSON 응답
프론트엔드

java

@RestController
@RequestMapping("/api/posts")
@RequiredArgsConstructor
public class PostController {
    private final PostService postService;

    @GetMapping("/{postId}")
    public PostResponse getPost(@PathVariable Long postId) {
        return postService.getPost(postId);
    }
}

java

@Service
@RequiredArgsConstructor
public class PostService {
    private final PostRepository postRepository;

    public PostResponse getPost(Long postId) {
        Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

        return PostResponse.from(post);
    }
}

java

public record PostResponse(
    Long id,
    String title,
    String content
) {
    public static PostResponse from(Post post) {
        return new PostResponse(post.getId(), post.getTitle(), post.getContent());
    }
}

어노테이션	처음 읽을 때 의미
`@RestController`	HTTP API 입구
`@RequestMapping`	기본 주소
`@GetMapping`	GET 요청 처리
`@PostMapping`	POST 요청 처리
`@RequestBody`	JSON body를 객체로 받음

text

Spring Boot로 게시글 상세 조회 API를 추가해 줘.

요구사항:
- GET /api/posts/{postId}
- Controller, Service, Repository, Response DTO를 분리해 줘.
- 게시글이 없으면 404를 반환하게 해 줘.
- Entity를 그대로 반환하지 말고 PostResponse로 변환해 줘.
- 프론트에서 필요한 필드는 id, title, content, authorName, createdAt이야.
- 변경 후 테스트 또는 최소한 빌드와 lint를 실행해 줘.

java

@RestController
@RequestMapping("/api/todos")
@RequiredArgsConstructor
public class TodoController {

    private final TodoService todoService;

    @PostMapping
    public TodoResponse create(@RequestBody CreateTodoRequest request) {
        return todoService.create(request);
    }
}

java

@Service
@RequiredArgsConstructor
public class TodoService {

    private final TodoRepository todoRepository;

    @Transactional
    public TodoResponse create(CreateTodoRequest request) {
        Todo todo = new Todo(request.title(), false);
        Todo saved = todoRepository.save(todo);
        return TodoResponse.from(saved);
    }
}

text

CreateTodoRequest에서 title을 꺼내 Todo Entity를 만든다.
완료 여부는 false로 시작한다.
Repository를 통해 DB에 저장한다.
저장된 Entity를 TodoResponse로 변환해서 반환한다.
DB 변경 작업이라 @Transactional이 붙어 있다.

java

public record TodoResponse(Long id, String title, boolean completed) {
    public static TodoResponse from(Todo todo) {
        return new TodoResponse(todo.getId(), todo.getTitle(), todo.isCompleted());
    }
}

오늘의 목표

1. 백엔드를 "화면 뒤의 코드"라고만 보면 부족하다

포스트 목록

2. 백엔드는 결국 "요청과 응답"을 다룬다

2.1 Method: 어떤 행동인가

2.2 Path: 어떤 자원을 대상으로 하는가

2.3 Headers: 요청의 부가 정보

2.4 Body: 실제로 보내는 데이터

3. Spring Boot 프로젝트를 처음 열었을 때 보는 것들

4. 서버 시작점: Application 파일

5. Controller: HTTP 요청이 처음 도착하는 곳

5.1 @RestController

5.2 @RequestMapping("/api/posts")

5.3 @GetMapping, @PostMapping

5.4 @PathVariable

5.5 @RequestBody

5.6 Controller에서 보면 안 좋은 신호

6. Service: 실제 규칙이 모이는 곳

6.1 Repository를 통해 DB에서 찾는다

6.2 없을 때 예외를 던진다

6.3 Entity를 Response DTO로 바꾼다

6.4 Service에서 봐야 하는 질문

7. Repository: DB에 접근하는 통로

7.1 Repository에서 조심할 점

8. Entity: DB 테이블과 가까운 객체

8.1 Entity를 API 응답으로 그대로 내보내면 왜 위험한가

9. DTO: 프론트와 주고받는 데이터 모양

9.1 Request DTO와 Response DTO를 구분하자

9.2 AI 코드에서 DTO를 확인하는 방법

10. 요청 하나를 끝까지 따라가 보기

11. 문법을 외우지 않고 읽는 요령

12. AI에게 백엔드 작업을 맡길 때 더 좋은 지시 방식

13. 오늘 기준으로 외우지 않아도 되는 것들

14. AI가 만든 코드에서 Day 1 수준으로 체크할 것

14.1 API 주소와 Method

14.2 Controller

14.3 Service

14.4 Repository

14.5 Entity와 DTO

15. 짧은 실전 읽기 예시

16. 오늘의 핵심 문장

Day 1 복습 질문

다음에 이어서 볼 것

5.1 `@RestController`

5.2 `@RequestMapping("/api/posts")`

5.3 `@GetMapping`, `@PostMapping`

5.4 `@PathVariable`

5.5 `@RequestBody`