고생하셨습니다.

🎉 PR 머지 완료! 🎉

Author: nonactress

README.md

@@ -1,20 +1,20 @@
-### 컨트롤러 (Controller)
--   `AdminController`: `@Controller`를 사용하여 웹 페이지를 반환합니다. 사용자가 특정 경로로 접속했을 때, 해당하는 HTML 파일을 렌더링하여 보여줍니다.
-    -   `/`: `home.html` (홈 페이지)
-    -   `/reservation`: `reservation.html` (예약 관리 페이지)
--   `ReservationController`: `@RestController`를 사용하여 RESTful API를 제공합니다. HTTP 요청을 받아 `ReservationService`를 호출하고, 그 결과를 JSON 형태로 반환합니다.
-    -   `GET /reservations`: 모든 예약 목록을 조회합니다.
-    -   `POST /reservations`: 새로운 예약을 생성합니다.
-    -   `DELETE /reservations/{id}`: 특정 예약을 삭제합니다.
+## 📂 프로젝트 구조
 
-### 서비스 (Service)
--   `ReservationService`: 핵심 비즈니스 로직을 담당합니다.
-    -   예약 데이터를 `List<Reservation>` 형태로 메모리에 저장하고 관리합니다.
-    -   `AtomicLong`을 사용하여 예약 ID를 순차적으로 생성합니다.
-    -   주요 메서드:
-        -   `getAllReservations()`: 전체 예약 목록을 반환합니다.
-        -   `addReservation()`: 새로운 예약을 리스트에 추가하고, 생성된 예약 객체를 반환합니다.
-        -   `deleteReservation()`: ID를 기준으로 예약을 찾아 리스트에서 삭제합니다. 존재하지 않는 ID일 경우 `IllegalArgumentException`을 발생시킵니다.
+```
+.
+├── build.gradle
+├── src
+│   ├── main
+│   │   ├── java
+│   │   │   └── roomescape
+│   │   │       ├── controller
+│   │   │       │   ├── AdminController.java      # 웹 페이지 라우팅
+│   │   │       │   └── ReservationController.java # 예약 API
+│   │   │       ├── dto                         # 데이터 전송 객체
+│   │   │       ├── model                       # 데이터 모델
+│   │   │       ├── repository                  # 데이터 접근
+│   │   │       └── service                     # 비즈니스 로직
+```
 
 ## 📝 API 엔드포인트
 
@@ -44,8 +44,3 @@
   "time": "14:00"
 }
 ```
-
-## 📄 페이지
-
-- **홈**: `http://localhost:8080/`
-- **예약 관리**: `http://localhost:8080/reservation`

build.gradle

@@ -18,6 +18,12 @@ repositories {
 
 // 이 'dependencies' 블록 안에 모든 의존성을 관리하세요.
 dependencies {
+    // [필수 1] JdbcTemplate을 포함한 스프링 JDBC 스타터
+    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
+
+    // [필수 2] H2 데이터베이스 드라이버
+    runtimeOnly 'com.h2database:h2'
+
     // [필수 1] 웹 서버 엔진
     implementation 'org.springframework.boot:spring-boot-starter-web'
 
@@ -33,6 +39,10 @@ dependencies {
     // 테스트에 필요한 의존성
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'io.rest-assured:rest-assured:5.3.1'
+
+
+    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
+    runtimeOnly 'com.h2database:h2'
 }
 
 test {

src/main/java/roomescape/advice/ErrorCode.java

@@ -0,0 +1,34 @@
+package roomescape.advice;
+
+import org.springframework.http.HttpStatus;
+
+public enum ErrorCode {
+    // 1. 공통 에러
+    INVALID_INPUT_VALUE(HttpStatus.BAD_REQUEST, "COMMON-001", "잘못된 입력값입니다."),
+
+    // 2. 비즈니스 에러
+    DUPLICATE_DATA(HttpStatus.CONFLICT, "BIZ-001", "이미 처리된 요청이거나 중복된 데이터입니다."),
+    IDEMPOTENCY_KEY_MISMATCH(HttpStatus.BAD_REQUEST, "BIZ-002", "멱등성 키 불일치: 요청 내용이 다릅니다.");
+
+    private final HttpStatus httpStatus;
+    private final String code;
+    private final String message;
+
+    public HttpStatus getHttpStatus() {
+        return httpStatus;
+    }
+
+    public String getCode() {
+        return code;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+
+    ErrorCode(HttpStatus httpStatus, String code, String message) {
+        this.httpStatus = httpStatus;
+        this.code = code;
+        this.message = message;
+    }
+}

…e/controller/GlobalExceptionHandler.java …scape/advice/GlobalExceptionHandler.javasrc/main/java/roomescape/controller/GlobalExceptionHandler.java renamed to src/main/java/roomescape/advice/GlobalExceptionHandler.java src/main/java/roomescape/controller/GlobalExceptionHandler.java renamed to src/main/java/roomescape/advice/GlobalExceptionHandler.java

@@ -1,4 +1,4 @@
-package roomescape.controller;
+package roomescape.controller; // (또는 roomescape.exception)
 
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.MethodArgumentNotValidException;

src/main/java/roomescape/advice/IdempotencyKeyMismatchException.java

@@ -0,0 +1,16 @@
+package roomescape.advice;
+
+public class IdempotencyKeyMismatchException extends RuntimeException {
+
+    private final ErrorCode errorCode;
+
+    public IdempotencyKeyMismatchException() {
+        super(ErrorCode.IDEMPOTENCY_KEY_MISMATCH.getMessage());
+        this.errorCode = ErrorCode.IDEMPOTENCY_KEY_MISMATCH;
+    }
+
+    public ErrorCode getErrorCode() {
+        return errorCode;
+    }
+}
+

src/main/java/roomescape/controller/ReservationController.java

@@ -25,7 +25,7 @@ public ReservationController(ReservationService service) {
 
     @GetMapping
     public List<ReservationResponse> getAllReservations() {
-        return service.getAllReservations().stream()
+        return  service.getAllReservations().stream()
                 .map(ReservationResponse::from) // (::from은 ReservationResponse::from과 동일)
                 .toList();
     }
@@ -39,12 +39,21 @@ public ResponseEntity<Void> deleteReservation(@PathVariable Long id) {
     @PostMapping
     public ResponseEntity<ReservationResponse> createReservation(
             @Valid @RequestBody ReservationCreateRequest requestDto
+            //@RequestHeader(value = "Idempotency-Key", required = true) String idempotencyKey
     ) {
+        /*if(service.exitsKey(idempotencyKey)) {
+            Reservation existingReservation = service.get(requestDto);
+            ReservationResponse responseDto = ReservationResponse.from(existingReservation);
 
-        Reservation reservationToCreate = requestDto.toEntity();
+        Reservation reservationToCreate = new Reservation(
+                requestDto.name(),
+                requestDto.date(),
+                requestDto.time()
+        );*/
 
-        Reservation savedReservation = service.addReservation(reservationToCreate);
+        //Reservation savedReservation = service.addReservation(reservationToCreate);
 
+        Reservation savedReservation = service.addReservation(requestDto.toEntity());
         ReservationResponse responseDto = ReservationResponse.from(savedReservation);
         URI location = URI.create("/reservations/" + savedReservation.getId());
 

src/main/java/roomescape/dto/ErrorResponse.java

@@ -0,0 +1,21 @@
+package roomescape.dto;
+
+import org.springframework.http.ResponseEntity;
+import roomescape.advice.ErrorCode;
+
+public class ErrorResponse {
+    private final String code;
+    private final String message;
+
+    // 핵심: ErrorCode Enum만 던져주면 알아서 ResponseEntity를 만들어줌!
+    public static ResponseEntity<ErrorResponse> toResponseEntity(ErrorCode errorCode) {
+        return ResponseEntity
+                .status(errorCode.getHttpStatus())
+                .body(new ErrorResponse(errorCode.getCode(),errorCode.getMessage()));
+    }
+
+    public ErrorResponse(String code, String message) {
+        this.code = code;
+        this.message = message;
+    }
+}

src/main/java/roomescape/dto/ReservationCreateRequest.java

@@ -23,8 +23,6 @@ public record ReservationCreateRequest(
         LocalTime time
 ) {
     public Reservation toEntity() {
-        return new Reservation(name, date, time);
+        return Reservation.create(name, date, time);
     }
 }
-
-

src/main/java/roomescape/model/Reservation.java

@@ -4,24 +4,45 @@
 import java.time.LocalTime;
 
 public class Reservation {
-    private Long id;
-    private String name;
+    Long id;
+    String name;
     private LocalDate date;
     private LocalTime time;
 
-    public Reservation(Long id, String name, LocalDate date, LocalTime time) {
+    private Reservation(Long id, String name, LocalDate date, LocalTime time) {
         this.id = id;
         this.name = name;
         this.date = date;
         this.time = time;
     }
 
-    public Reservation(String name, LocalDate date, LocalTime time) {
-        this(null, name, date, time);
+    public static Reservation create(String name, LocalDate date, LocalTime time) {
+        return new Reservation(null, name, date, time);
+    }
+
+    public static Reservation of(Long id, String name, LocalDate date, LocalTime time) {
+        return new Reservation(id, name, date, time);
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public LocalDate getDate() {
+        return date;
+    }
+
+    public LocalTime getTime() {
+        return time;
     }
 
-    public Long getId() { return id; }
-    public String getName() { return name; }
-    public LocalDate getDate() { return date; }
-    public LocalTime getTime() { return time; }
+    public Reservation(String name, LocalDate date, LocalTime time) {
+        this.name = name;
+        this.date = date;
+        this.time = time;
+    }
 }

src/main/java/roomescape/repository/IdempotencyRepository.java

@@ -0,0 +1,42 @@
+package roomescape.repository;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.dao.EmptyResultDataAccessException;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public class IdempotencyRepository {
+    private final JdbcTemplate jdbcTemplate;
+
+    @Autowired
+    public IdempotencyRepository(JdbcTemplate jdbcTemplate) {
+        this.jdbcTemplate = jdbcTemplate;
+    }
+
+    public boolean exists(String key) {
+        String sql = "SELECT count(*) FROM idempotency_keys WHERE id = ?";
+        Integer count = jdbcTemplate.queryForObject(sql, Integer.class, key);
+        return count != null && count > 0;
+    }
+
+    public void save(String key) {
+        String sql = "INSERT INTO idempotency_keys (id) VALUES (?)";
+        jdbcTemplate.update(sql, key);
+    }
+
+    public Long getReservationId(String key) {
+        try {
+            String sql = "SELECT reservation_id FROM idempotency_keys WHERE id = ?";
+            return jdbcTemplate.queryForObject(sql, Long.class, key);
+        } catch (EmptyResultDataAccessException e) {
+            return null;
+        }
+    }
+
+    public void save(String key, Long reservationId) {
+        String sql = "INSERT INTO idempotency_keys (id, reservation_id) VALUES (?, ?)";
+        jdbcTemplate.update(sql, key, reservationId);
+    }
+
+}