[Board] 1차 제출입니다!

build.gradle

@@ -1,6 +1,6 @@
 plugins {
     id 'java'
-    id 'org.springframework.boot' version '3.4.3'
+    id 'org.springframework.boot' version '3.3.3'
     id 'io.spring.dependency-management' version '1.1.7'
     id 'org.asciidoctor.jvm.convert' version '3.3.2'
 }
@@ -39,6 +39,15 @@ dependencies {
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'org.springframework.restdocs:spring-restdocs-mockmvc'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+
+    // jwt
+    implementation 'com.auth0:java-jwt:4.2.1'
+
+    // swagger
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0'
+
+    // password encoder
+    implementation 'org.springframework.security:spring-security-crypto'
 }
 
 tasks.named('test') {

docs/code_review.md

@@ -0,0 +1,93 @@
+# /api 는 클래스 레벨보다는 yml로 따로 빼는 건 어떨까요?
+
+---
+## 문제점
+
+* 개발할 때는 /api 경로로 접근하지만 배포 환경에서는 /prod 경로로 접근한다고 가정한다. -> @RequestMapping("/api")를 전부 /prod로 바꿔야 한다.
+* 또한 URI.create(~~) 부분도 모두 수정해야 한다.
+
+## 해결
+
+* application.yml 파일에 경로를 미리 설정한다.
+* URI 부분은 ServletUriComponentsBuilder의 fromCurrentRequestUri() 메서드를 사용하여 해결한다. -> 해당 메서드는 현재 요청을 보내는 경로를 받아오는 기능을 제공한다. 
+
+# 에러 코드 재사용성
+
+---
+## 문제점(현재 에러 코드 구조)
+
+~~~
+public class GlobalExceptionHandler {
+    @ExceptionHandler(GlobalException.class)
+    public ResponseEntity<GlobalErrorResponse> handleException(GlobalException e) {
+    }
+}
+
+@Getter
+public enum GlobalErrorCode {
+
+}
+
+@Getter
+public class GlobalException extends RuntimeException {
+
+    private final GlobalErrorCode errorCode;
+
+    public GlobalException(GlobalErrorCode errorCode) {
+    }
+}
+~~~
+
+* 현재 이 3단계 구조로, 특정 관심사 패키지마다 exception 을 관리하고 있음
+* 이렇게 할 경우, 패키지마다 계속해서 exception 을 생성 및 관리해야함 -> 코드 재활용이 안됌.
+
+## 해결책
+
+* common 패키지에, 공통적으로 사용되는 errorCode 를 interface화 시킴.
+* 이후 interface(errorCode) 를 사용한 BaseException 클래스를 생성 -> 다른 패키지 exception 에서 BaseException 상속받아 사용할 수 있음
+* 그렇기에 exception handler 도 하나로만 관리 가능
+
+## 결론
+
+* ErrorCode 인터페이스 하나 파서 관리
+* BaseException 생성, 그리고 이 클래스를 이용한  BaseExceptionHandler 생성 -> 핸들러 하나만 사용 가능
+* MemberException, ArticleException 등등 BaseException 을 상속받아 BaseExceptionHandler 에서 에러 처리 가능
+* ErrorCode 추가될때마다 exception 을 추가할 필요가 없어짐.
+
+---
+
+# Offset Paging
+
+--- 
+## 장점
+* 구현이 쉽다 -> JPA에서 바로 Pageable 객체로 페이징 가능
+* 페이지 번호가 있는 프론트 구현 시, 잘 맞는다.
+
+## 단점
+* OFFSET 100000 같이 뒤 페이지로 갈수록 느려짐 → 인덱스가 있어도 느림
+* 페이징 도중 데이터가 추가/삭제되면 순서가 뒤틀릴 수 있음 (같은 댓글이 여러 번 보이거나 사라짐)
+
+
+# ```@ManyToOne``` vs 간접참조
+
+---
+
+## @ManyToOne
+
+* 객체를 통째로 다루기 떄문에 저장이 간편하다.
+* 그렇기에 객체에 직접적으로 바로 접근이 가능하다.
+* 하지만 연관관계 이슈 때문에 객체 조회 시 N+1 문제가 발생할 수 있다.
+* 따라서 관계에 따라 접근 전략을 모색해야 한다.
+
+## 간접참조
+
+* id 값만 저장하면 된다.(단순하고 가볍게 관리 가능)
+* 따라서, id 값을 통해 조회를 또 다시 해야한다.
+* 하지만 이는 객체지향과는 조금 거리가 멀다.(객체가 아닌, 단순 id 값만 가지고 있기 때문이다.)
+
+# ORM의 탄생 배경
+
+---
+
+* ORM 은 DB를 테이블처럼 다루지 말고 객체 처럼 다루자는 목표로 등장.
+* 

docs/spring_annotation.md

@@ -0,0 +1,87 @@
+## **Java Bean Validation: `@NotNull`, `@NotEmpty`, `@NotBlank` 차이점**  
+
+---
+
+### 1. @NotNull
+
+* null 값만 허용하지 않음
+* 빈 값("")과 공백(" ")은 허용됨
+
+### 2. @NotEmpty 
+
+* null 값과 빈 값("") 모두 허용되지 않음
+* 공백(" ")은 허용됨
+
+### 3. @NotBlank 
+
+* null 값, 빈 값(""), 공백(" ") 모두 허용되지 않음
+
+**회원 가입 시, @NotBlank 어노테이션 활용하는 것이 좋을 것 같음**
+
+
+## **Lombok의 생성자 어노테이션 비교 (`@AllArgsConstructor`, `@RequiredArgsConstructor`, `@NoArgsConstructor`)**
+
+---
+
+### 1. @AllArgsConstructor 
+
+* 클래스의 모든 필드를 초기화하는 생성자를 자동 생성
+* @NonNull 필드가 null이면 NullPointerException 발생
+
+### 2. @RequiredArgsConstructor 
+
+* final 필드 및 @NonNull 필드만 포함하는 생성자를 생성
+* 초기화된 final 필드는 생성자에서 제외됨
+
+### 3. @NoArgsConstructor 
+
+* 매개변수가 없는 기본 생성자를 생성
+* final 필드가 있을 경우 force = true 옵션 필요
+
+### JPA 에서 기본 생성자가 필요한 이유(protected 쓰는 이유까지)
+
+1. JPA는 데이터베이스에서 조회한 결과를 기반으로 엔티티 객체를 생성해야 합니다.
+2. Reflection을 이용하여 객체를 만들기 때문에, 기본 생성자가 반드시 필요합니다.
+3. 외부에서 기본 생성자를 직접 호출하는 것을 막기 위해 protected 사용합니다.
+3. 만약 기본 생성자가 없으면 InstantiationException 오류 발생!
+
+
+## @RequestParam vs @PathVariable 차이점
+
+---
+
+### 1. @RequestParam
+
+*  `@RequestParam`은 **쿼리 문자열**에서 값을 추출합니다. - (쿼리 파라미터)
+* 예시
+~~~
+@GetMapping("/foos")
+@ResponseBody
+public String getFooByIdUsingQueryParam(@RequestParam String id) {
+    return "ID: " + id;
+}
+~~~
+
+해당 요청을 처리하는 URL는 다음과 같습니다. - > `http://localhost:8080/spring-mvc-basics/foos?id=abc`
+
+* @RequestParam은 URL 디코딩되어 값을 추출합니다. 
+`http://localhost:8080/foos?id=ab+c` -> `ab c` 를 추출합니다. (+ 가 공백으로 디코딩 됌)
+* @RequestParam은 필터링이나 검색 조건을 전달할 때 유용합니다.
+
+### 2. @PathVariable
+
+* `@PathVariable`은 **URI 경로**에서 값을 추출합니다. - (URI 경로)
+* 예시
+~~~
+@GetMapping({"/myfoos/optional", "/myfoos/optional/{id}"})
+@ResponseBody
+public String getFooByOptionalId(@PathVariable(required = false) String id){
+    return "ID: " + id;
+}
+~~~
+
+해당 요청을 처리하는 URL 은 다음과 같습니다. -> `http://localhost:8080/spring-mvc-basics/myfoos/optional/abc`
+
+* @PathVariable은 URI 경로에서 값을 추출하기 때문에 값이 인코딩되지 않습니다.
+`http://localhost:8080/foos/id=ab+c` -> `ab+b` 값을 정확하게 추출합니다.
+* @PathVariable은 주로 리소스를 식별할 때 유용합니다.

docs/spring_cs.md

@@ -0,0 +1,23 @@
+## @Transactional(readOnly = true) 를 사용한 경우 vs 사용하지 않은 경우
+
+---
+
+### 1. @Transactional(readOnly = true)를 사용하지 않은 경우
+
+1. 트랜잭션이 시작됩니다.
+2. SELECT 쿼리를 실행하여 데이터 조회합니다.
+3. 트랜잭션이 쓰기 모드이므로 변경 감지(Dirty Checking)가 활성화됩니다.
+4. 조회한 엔티티를 영속성 컨텍스트(Persistence Context)에 저장합니다.
+5. JPA가 Book 엔티티를 관리하기 시작합니다.
+6. 트랜잭션이 종료되면, 변경된 엔티티가 있으면 UPDATE 쿼리를 실행합니다.
+7. 변경이 없어도 flush()가 호출되면서 DB와 동기화 수행합니다. → 불필요한 성능 저하 가능
+
+
+### 2. @Transactional(readOnly = true) 사용한 경우
+
+1. 트랜잭션이 시작됩니다. (READ ONLY)
+2. SELECT 쿼리를 실행하여 데이터 조회합니다.
+3. 쓰기 관련 기능(변경 감지, flush, dirty checking)이 비활성화 됩니다.
+4. JPA가 엔티티를 관리하지 않습니다. (영속성 컨텍스트 제외)
+5. 트랜잭션이 종료됩니다.
+

docs/test.md

@@ -0,0 +1,134 @@
+# Spring Test
+
+---
+
+## @DataJpaTest와 JUnit을 사용한 Repository 테스트
+
+---
+
+### 개요
+
+* Spring Boot 애플리케이션에서 Spring Data JPA를 사용하여 데이터베이스를 다룰 때, JPA Repository가 제대로 동작하는지 테스트하는 것이 중요합니다.
+
+----
+
+### @DataJpaTest
+
+* @DataJpaTest 란? -> JPA Repository 테스트를 위한 애너테이션입니다.
+* 최소한의 Spring 컨텍스트만 로드하여 테스트 속도를 높이고, EntityManager와 TestEntityManager를 자동 제공합니다.
+~~~
+EntityManager란? 
+
+-> JPA(Java Persistence API)에서 제공하는 기본적인 데이터베이스 관리 도구입니다.
+   Spring Boot에서 JPA를 사용할 때, 일반적으로 EntityManager를 사용하여 데이터베이스 작업을 수행합니다.
+
+EntityManager의 주요 기능
+
+1. 엔티티 저장: persist(entity)
+2. 엔티티 수정: merge(entity)
+3. 엔티티 삭제: remove(entity)
+4. 엔티티 조회: find(Class<T>, primaryKey), createQuery()
+
+-----------------------------------------------------------------------------------------
+EntityTestManager란?
+
+-> 테스트용으로 제공되는 EntityManager입니다.
+   Spring Boot의 @DataJpaTest에서 사용할 수 있으며, 일반 EntityManager보다 테스트에 최적화되어 있습니다.
+
+TestEntityManager의 특징
+
+1. 테스트 중 사용할 수 있도록 간편한 메서드 제공
+2. 트랜잭션이 자동 롤백되어 데이터가 남지 않음
+3. flush()를 명시적으로 호출하여 즉시 쿼리를 실행 가능
+
+~~~
+* 애플리케이션 전체를 로드하지 않고, JPA 관련 Bean들만 로드하여 테스트 성능을 최적화합니다.
+
+---
+
+### @DataJpaTest의 선택적 파라미터
+
+**properties 속성**
+* 테스트 환경에서 특정 Spring Boot 설정 값을 변경할 수 있습니다.
+~~~
+@DataJpaTest(properties = {
+    "spring.datasource.url=jdbc:h2:mem:testdb",
+    "spring.jpa.hibernate.ddl-auto=create-drop"
+})
+public class UserRepositoryTest {
+    // 테스트 메서드 작성
+}
+~~~
+
+**showSql 속성**
+* SQL 쿼리 로그를 출력할지 설정하는 옵션입니다.
+~~~
+@DataJpaTest(showSql = false)
+public class UserRepositoryTest {
+    // 테스트 메서드 작성
+}
+~~~
+
+**includeFilters와 excludeFilters**
+* 테스트할 컴포넌트(클래스)를 선택적으로 포함하거나 제외할 수 있습니다.
+
+---
+
+### 주요 기능
+
+* 테스트 환경 구성
+  * @DataJpaTest는 테스트를 위한 DB 환경을 자동으로 구성해줍니다. 
+  * 일반적으로 H2 인메모리 데이터베이스를 사용하여, 테스트 후 자동으로 데이터가 삭제됩니다.
+
+* 의존성 주입
+  * @DataJpaTest를 사용하면 Repository 빈이 자동으로 주입되어 테스트할 수 있습니다.
+
+* 기본적으로 트랜잭션 롤백
+  * 각 테스트 메서드는 트랜잭션 내부에서 실행되며, 테스트가 끝나면 데이터가 자동으로 롤백됩니다.
+  * 테스트 간 데이터가 격리(독립적) 되므로, 테스트 실행 순서에 영향을 받지 않습니다.
+
+---
+
+### Repository 테스트 구현
+
+* 테스트 라이프사이클 관리
+~~~
+private User testUser;
+
+@BeforeEach
+public void setUp() {
+    testUser = new User();
+    testUser.setUsername("testuser");
+    testUser.setPassword("password");
+    userRepository.save(testUser);
+}
+
+@AfterEach
+public void tearDown() {
+    userRepository.delete(testUser);
+}
+~~~
+1. @BeforeEach : 각 테스트 시작 전 실행 → 테스트 데이터를 초기화
+2. @AfterEach : 각 테스트 종료 후 실행 → 테스트 데이터 정리(삭제)
+
+
+출처: baeldung
+
+
+
+## Service layer Test
+
+---
+
+### 1. UnitTest
+
+* Service layer 만 테스트를 진행한다.
+* 외부 의존성은 모두 mocking 해서 처리한다.
+* 테스트 속도가 빠르고 로직을 집중적으로 테스트 할 수 있다.
+
+### 2. IntegrationTest(Spring Context 전체를 올림)
+
+* ``@SpringBootTest`` 와 ``@Transactional`` 어노테이션을 사용하여 테스트 진행한다.
+* 실제 Bean 들을 다 올리기 때문에 실제 동작을 더 잘 검증할 수 있다.
+* 하지만 속도 느리고 무겁다.
+