고생하셨습니다.

🎉 PR 머지 완료! 🎉

Author: gjtjrl303

README.MD

@@ -8,3 +8,144 @@
 - /reservation: 예약 관리 페이지 (reservation.html) 응답
 - /reservations: 예약 데이터 JSON 응답
 
+## 3단계 - 예약 등록
+- `POST /reservations`: 새로운 예약 정보를 등록합니다.
+    - 요청 본문에 예약자의 이름, 날짜, 시간이 포함됩니다.
+    - 성공 시 `201 Created` 응답 및 Location 헤더 반환
+
+## 4단계 - 예외 처리
+- 클라이언트 요청의 문제로 예외가 발생할 경우 `400 Bad Request`를 반환합니다.
+- 처리되는 예외 예시:
+  - 예약 입력값 누락 (name, date, time 중 하나라도 누락) 
+  - 존재하지 않는 예약 ID로 삭제 요청
+  - JSON 파싱 오류 (날짜/시간 형식이 올바르지 않음)
+
+# 📌 API 명세서
+
+---
+
+##  GET /reservations
+
+- 설명: 모든 예약 목록 조회
+- 응답: `200 OK`
+- 응답 본문 예시:
+
+```json
+[
+  {
+    "id": 1,
+    "name": "브라운",
+    "date": "2023-08-05",
+    "time": "15:40"
+  },
+  {
+    "id": 2,
+    "name": "죠르디",
+    "date": "2023-08-05",
+    "time": "17:00"
+  }
+  // ... 더 많은 예약
+]
+
+```
+| 필드     | 타입                    | 설명     |
+| ------ | --------------------- | ------ |
+| `id`   | `number`              | 예약 식별자 |
+| `name` | `string`              | 예약자 이름 |
+| `date` | `string (YYYY-MM-DD)` | 예약 날짜  |
+| `time` | `string (HH:mm)`      | 예약 시간  |
+
+---
+## POST /reservations
+- 설명: 예약 추가
+- 응답: `201 Created`
+- 응답 본문 예시:
+``` json
+  {
+    "id": 1,
+    "name": "브라운",
+    "date": "2023-08-05",
+    "time": "15:40"
+  }
+```
+| 필드     | 타입                    | 필수 여부 | 설명     |
+| ------ | --------------------- | ----- | ------ |
+| `name` | `string`              | ✅     | 예약자 이름 |
+| `date` | `string (YYYY-MM-DD)` | ✅     | 예약 날짜  |
+| `time` | `string (HH:mm)`      | ✅     | 예약 시간  |
+---
+## DELETE /reservations/{id}
+- 설명: 예약 삭제
+- 응답: `204 No Content`
+- 응답 본문 예시: 없음
+
+---
+
+## ❗ 예외 응답 명세
+
+### 잘못된 요청 (필드 누락 등)
+
+- 상태 코드: `400 Bad Request`
+- 발생 조건:
+  - 예약 요청에서 name, date, time 중 하나라도 누락되거나
+  - 빈 문자열 또는 null 값이 들어온 경우
+
+응답 예시:
+```json
+{
+  "code": "BAD_REQUEST",
+  "message": "이름은 필수입니다."
+}
+```
+### 존재하지 않는 예약 ID
+- 상태 코드: `400 Bad Request`
+- 발생 조건: 존재하지 않는 ID를 가진 예약을 삭제할 때
+
+응답 예시:
+```json
+{
+"code": "NOT_FOUND_RESERVATION",
+"message": "해당 예약이 존재하지 않습니다."
+}
+```
+
+### JSON 파싱 오류
+- 상태 코드: `400 Bad Request`
+- 발생 조건: 요청 JSON이 잘못된 형식일 경우
+
+응답 예시:
+```json
+{
+  "code": "INVALID_JSON",
+  "message": "형식이 옳바르지 않습니다"
+}
+```
+
+### 존재하는 ID 중복 예약
+- 상태 코드: `409 CONFLICT`
+- 발생 조건: 중복된 ID의 Reservation을 예약할 경우
+
+응답 예시:
+```json
+{
+  "code": "RESERVATION_ALREADY_EXISTS",
+  "message": "이미 ID가 존재하는 예약은 저장할 수 없습니다.
+}
+```
+
+### 예상하지 못한 오류
+- 상태 코드: `500 Internal Server Error`
+- 발생 조건: 서버 내부에서 예상하지 못한 예외가 발생한 경우
+
+응답 예시:
+```json
+{
+  "code": "INTERNAL_SERVER_ERROR",
+  "message": "예상치 못한 오류 발생"
+}
+```
+
+
+
+
+

src/main/java/roomescape/controller/HomeController.java renamed to src/main/java/roomescape/controller/PageController.java

@@ -4,11 +4,16 @@
 import org.springframework.web.bind.annotation.GetMapping;
 
 @Controller
-public class HomeController {
+public class PageController {
 
     @GetMapping("/")
     public String home() {
         return "home";
     }
+
+    @GetMapping("/reservation")
+    public String reservation() {
+        return "reservation";
+    }
 }
 

src/main/java/roomescape/controller/ReservationApiController.java

@@ -0,0 +1,45 @@
+package roomescape.controller;
+
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import roomescape.controller.dto.ReservationRequest;
+import roomescape.controller.dto.ReservationResponse;
+import roomescape.service.ReservationService;
+import roomescape.service.dto.ReservationResult;
+
+import java.net.URI;
+import java.util.List;
+
+@RestController
+public class ReservationApiController {
+
+    private final ReservationService reservationService;
+
+    public ReservationApiController(ReservationService reservationService) {
+        this.reservationService = reservationService;
+    }
+
+    @GetMapping("/reservations")
+    public ResponseEntity<List<ReservationResponse>> findAll() {
+        List<ReservationResult> all = reservationService.findAll();
+        List<ReservationResponse> reservationResponses = all.stream()
+                .map(ReservationResponse::from)
+                .toList();
+        return ResponseEntity.ok(reservationResponses);
+    }
+
+    @PostMapping("/reservations")
+    public ResponseEntity<ReservationResponse> save(@RequestBody ReservationRequest reservationRequest) {
+        ReservationResult result = reservationService.save(reservationRequest.toCommand());
+        return ResponseEntity.created(URI.create("/reservations/" + result.id()))
+                .contentType(MediaType.APPLICATION_JSON)
+                .body(ReservationResponse.from(result));
+    }
+
+    @DeleteMapping("/reservations/{id}")
+    public ResponseEntity<Void> delete(@PathVariable Long id) {
+        reservationService.delete(id);
+        return ResponseEntity.noContent().build();
+    }
+}

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

@@ -0,0 +1,48 @@
+package roomescape.controller.dto;
+
+import roomescape.service.dto.SaveReservationCommand;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+public class ReservationRequest {
+    private final String name;
+    private final LocalDate date;
+    private final LocalTime time;
+
+    public ReservationRequest(String name, LocalDate date, LocalTime time) {
+        validate(name, date, time);
+        this.name = name;
+        this.date = date;
+        this.time = time;
+    }
+
+    public SaveReservationCommand toCommand() {
+        return new SaveReservationCommand(name, date, time);
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public LocalDate getDate() {
+        return date;
+    }
+
+    public LocalTime getTime() {
+        return time;
+    }
+
+    private static void validate(String name, LocalDate date, LocalTime time) {
+        if (name == null || name.isBlank()) {
+            throw new IllegalArgumentException("이름은 필수입니다.");
+        }
+        if (date == null) {
+            throw new IllegalArgumentException("날짜는 필수입니다.");
+        }
+        if (time == null) {
+            throw new IllegalArgumentException("시간은 필수입니다.");
+        }
+    }
+}
+

src/main/java/roomescape/controller/dto/ReservationRequest.java

@@ -0,0 +1,22 @@
+package roomescape.controller.dto;
+
+import roomescape.service.dto.ReservationResult;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+public record ReservationResponse(
+        Long id,
+        String name,
+        LocalDate date,
+        LocalTime time
+) {
+
+    public static ReservationResponse from(ReservationResult result) {
+        return new ReservationResponse(
+                result.id(),
+                result.name(),
+                result.date(),
+                result.time()
+        );
+    }}

src/main/java/roomescape/controller/dto/ReservationResponse.java

@@ -11,17 +11,17 @@ public class Reservation {
     private LocalTime time;
 
     public Reservation(Long id, String name, LocalDate date, LocalTime time) {
+        validateName(name);
+        validateDate(date);
+        validateTime(time);
         this.id = id;
         this.name = name;
         this.date = date;
         this.time = time;
     }
 
     public Reservation(String name, LocalDate date, LocalTime time) {
-        this.id = null;
-        this.name = name;
-        this.date = date;
-        this.time = time;
+        this(null, name, date, time);
     }
 
     public Reservation withId(Long id) {
@@ -31,7 +31,6 @@ public Reservation withId(Long id) {
     public Long getId() {
         return id;
     }
-
     public String getName() {
         return name;
     }
@@ -43,4 +42,25 @@ public LocalDate getDate() {
     public LocalTime getTime() {
         return time;
     }
+
+    private void validateName(String name) {
+        if (name == null || name.isBlank()) {
+            throw new IllegalArgumentException("이름은 필수입니다.");
+        }
+    }
+
+    private void validateDate(LocalDate date) {
+        if (date == null) {
+            throw new IllegalArgumentException("날짜는 필수입니다.");
+        }
+        if (date.isBefore(LocalDate.now())) {
+            throw new IllegalArgumentException("예약 날짜는 오늘 이후여야 합니다.");
+        }
+    }
+
+    private void validateTime(LocalTime time) {
+        if (time == null) {
+            throw new IllegalArgumentException("시간은 필수입니다.");
+        }
+    }
 }

src/main/java/roomescape/domain/Reservation.java

@@ -0,0 +1,6 @@
+package roomescape.exception;
+
+public record ErrorResult(
+        String code,
+        String message
+) {}