[3 - 4단계 방탈출 예약 대기] 몰리(김지민) 미션 제출합니다.

docs/APISpecification.md

@@ -79,65 +79,167 @@ Content-Type: application/json
 ```
 
 </details>
+<br>
 
-## 예약
+<details>
+<summary> 내 예약 대기 조회 API </summary>
+
+### 내 예약 대기 조회 API
+
+#### Request
+
+```http request
+GET /members/waitings HTTP/1.1
+```
+
+#### Response
+
+```
+HTTP/1.1 200
+[
+    {
+        "id": 1,
+        "name": "브라운",
+        "date": "2023-01-01",
+        "timeId": 1,
+        "themeId": 1
+    }
+]
+```
+</details>
+
+## 관리자 
 
 <details>
-<summary> 예약 페이지 조회 API </summary>
+<summary> 예약 목록 조회 API - 관리자 </summary>
 
-### 예약 페이지 조회
+### 예약 목록 조회 - 관리자
 
 #### Request
 
 ```http request
-GET /admin/reservation HTTP/1.1
+GET /admin/reservations HTTP/1.1
 ```
 
 #### Response
 
 ```
 HTTP/1.1 200 
+Content-Type: application/json
+
+[
+    {
+        "id": 1,
+        "name": "브라운",
+        "date": "2023-01-01",
+        "startAt": "10:00"
+        "theme": "레벨2 탈출"
+    }
+]
 ```
 </details>
 
 <br>
 
 <details>
-<summary> 예약 목록 조회 API </summary>
+<summary> 예약 추가 - 관리자 API </summary>
 
-### 예약 목록 조회
+### 예약 추가 - 관리자
 
 #### Request
 
 ```http request
-GET /reservations HTTP/1.1
+POST /admin/reservations HTTP/1.1
+content-type: application/json
+cookie: token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwibmFtZSI6ImFkbWluIiwicm9sZSI6IkFETUlOIn0.cwnHsltFeEtOzMHs2Q5-ItawgvBZ140OyWecppNlLoI
+host: localhost:8080
+
+{
+    "date": "2024-03-01",
+    "themeId": 1,
+    "timeId": 1,
+    "memberId": 1
+}
 ```
 
 #### Response
 
 ```
-HTTP/1.1 200 
-Content-Type: application/json
+HTTP/1.1 201
+Location: /reservation/{id}
+```
+</details>
+
+<br>
+
+<details>
+<summary> 예약 대기 목록 조회 API - 관리자 </summary>
+
+### 예약 대기 목록 조회 API
+
+#### Request
+
+```http request
+GET /admin/waitings HTTP/1.1
+```
+
+#### Response
 
+```
+HTTP/1.1 200
 [
     {
         "id": 1,
         "name": "브라운",
         "date": "2023-01-01",
-        "time": {
-            "id": 1,
-            "startAt": "10:00"
-        },
-        "theme": {
-            "id": 1,
-            "name": "레벨2 탈출",
-            "description": "우테코 레벨2를 탈출하는 내용입니다.",
-            "thumbnail": "https://i.pinimg.com/236x/6e/bc/46/6ebc461a94a49f9ea3b8bbe2204145d4.jpg"
-        }
+        "timeId": 1,
+        "themeId": 1
     }
 ]
 ```
 </details>
+<br>
+
+
+<details>
+<summary> 예약 대기 거절 API </summary>
+
+### 예약 대기 거절 API
+
+#### Request
+
+```http request
+DELETE /admin/waitings/reject/{waitingId HTTP/1.1
+```
+
+#### Response
+
+```
+HTTP/1.1 204
+```
+</details>
+<br>
+
+
+## 예약
+
+<details>
+<summary> 예약 페이지 조회 API </summary>
+
+### 예약 페이지 조회
+
+#### Request
+
+```http request
+GET /admin/reservation HTTP/1.1
+```
+
+#### Response
+
+```
+HTTP/1.1 200 
+```
+</details>
 
 <br>
 
@@ -248,55 +350,80 @@ Location: /reservation/{id}
 <br>
 
 <details>
-<summary> 예약 추가 - 관리자 API </summary>
+<summary> 예약 취소 API </summary>
 
-### 예약 추가 - 관리자
+### 예약 취소
 
 #### Request
 
 ```http request
-POST /admin/reservations HTTP/1.1
+DELETE /reservations/{id} HTTP/1.1
+```
+
+#### Response
+
+```
+HTTP/1.1 204
+```
+
+---
+</details>
+
+## 예약 대기
+
+<details>
+<summary> 예약 대기 생성 API </summary>
+
+### 예약 대기 생성 API
+
+#### Request
+
+```http request
+POST /waitings HTTP/1.1
 content-type: application/json
 cookie: token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwibmFtZSI6ImFkbWluIiwicm9sZSI6IkFETUlOIn0.cwnHsltFeEtOzMHs2Q5-ItawgvBZ140OyWecppNlLoI
-host: localhost:8080
 
 {
-    "date": "2024-03-01",
-    "themeId": 1,
+    "date": "2023-08-05",
     "timeId": 1,
-    "memberId": 1
+    "themeId": 1
 }
 ```
 
 #### Response
 
 ```
 HTTP/1.1 201
-Location: /reservation/{id}
+Location: /waitings/1 
+
+{
+    "waitingId": 1,
+    "date": "2023-08-05",
+    "timeId": 1,
+    "themeId": 1
+}
 ```
 </details>
-
 <br>
 
 <details>
-<summary> 예약 취소 API </summary>
+<summary> 예약 대기 취소 API </summary>
 
-### 예약 취소
+### 예약 대기 취소 API
 
 #### Request
 
 ```http request
-DELETE /reservations/{id} HTTP/1.1
+DELETe /waitings/{waitingId} HTTP/1.1
 ```
 
 #### Response
 
 ```
 HTTP/1.1 204
 ```
-
----
 </details>
+<br>
 
 ## 시간
 
@@ -642,6 +769,28 @@ Set-Cookie: token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwibmFtZSI6ImFkbWluIiwicm9sZ
 
 <br>
 
+<details>
+<summary> 로그아웃 API </summary>
+
+### 로그아웃
+
+#### Request
+
+```http request
+POST /logout HTTP/1.1
+cookie: token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwibmFtZSI6ImFkbWluIiwicm9sZSI6IkFETUlOIn0.cwnHsltFeEtOzMHs2Q5-ItawgvBZ140OyWecppNlLoI; Path=/; HttpOnly
+host: localhost:8080
+```
+
+#### Response
+
+```http request
+HTTP/1.1 204 OK
+```
+</details>
+
+<br>
+
 <details>
 <summary> 인증 정보 조회 API </summary>
 

docs/README.md

@@ -1,5 +1,34 @@
 # 요구사항 분석
 
+## 예약 대기 정책
+
+- 동일한 날짜, 시간, 테마의 예약이 존재할 경우, 사용자는 해당 예약에 대기를 요청할 수 있다.
+- 사용자는 내 예약 조회 시 대기 중인 예약인 경우, 해당 대기의 순번을 확인할 수 있다.
+- 사용자는 동일한 날짜, 시간, 테마의 예약이 불가능하다.
+  - 동일한 날짜, 시간의 다른 테마인 경우, 예약이 가능하다.
+  - 다른 날짜, 시간의 동일한 테마인 경우, 예약이 가능하다.
+- 사용자는 대기가 예약으로 확정되기 전이라면, 예약 대기를 취소할 수 있다.
+
+## 예약 취소
+- 예약 취소 시, 해당 예약에 대해 우선순위가 높은 대기가 자동으로 예약된다.
+- 관리자는 예약 대기를 거절할 수 있다.
+
+## 3단계
+- 예약 대기 요청 API 구현
+  - [x] 예약 대기 스키마 설계
+  - [x] 예약 대기 엔티티 구현
+  - [x] 예약 대기 요청 로직 구현
+- [x] 예약 대기 취소 API 구현 
+- [x] 예약 조회 API 변경
+  - 예약 조회 시, 대기 목록을 포함한다.
+
+## 4단계
+- [x] 에약 대기 승인 기능 구현
+  - 예약 취소 API에서 대기 번호 1번인 대기가 예약이 되도록 변경
+- [x] 예약 대기 거절 API 구현
+- [x] 어드민 예약 대기 목록 조회 API 구현
+
+---
 ## 1단계
 - [x] gradle 의존성 추가
 - [x] 엔티티 매핑

src/main/java/roomescape/RoomescapeApplication.java

@@ -3,9 +3,11 @@
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
 @ConfigurationPropertiesScan
 @SpringBootApplication
+@EnableJpaAuditing
 public class RoomescapeApplication {
     public static void main(String[] args) {
         SpringApplication.run(RoomescapeApplication.class, args);

src/main/java/roomescape/auth/controller/AuthController.java

@@ -38,4 +38,10 @@ public ResponseEntity<GetAuthInfoResponse> getMemberAuthInfo(@AuthenticationPrin
         GetAuthInfoResponse getAuthInfoResponse = authService.getMemberAuthInfo(authInfo);
         return ResponseEntity.ok(getAuthInfoResponse);
     }
+
+    @PostMapping("/logout")
+    public ResponseEntity<Void> logout(HttpServletResponse httpServletResponse) {
+        authorizationManager.removeAuthorization(httpServletResponse);
+        return ResponseEntity.noContent().build();
+    }
 }

src/main/java/roomescape/auth/core/AuthorizationInterceptor.java

@@ -5,6 +5,8 @@
 import org.springframework.web.servlet.HandlerInterceptor;
 import roomescape.auth.core.token.TokenProvider;
 import roomescape.auth.domain.AuthInfo;
+import roomescape.common.exception.ForbiddenException;
+import roomescape.common.exception.UnAuthorizationException;
 
 public class AuthorizationInterceptor implements HandlerInterceptor {
 
@@ -26,14 +28,14 @@ public boolean preHandle(final HttpServletRequest request, final HttpServletResp
 
     private void validatedTokeIsBlank(final String token) {
         if (token == null || token.isBlank()) {
-            throw new SecurityException("회원의 인증 토큰 정보를 찾을 수 없습니다. 다시 로그인해주세요.");
+            throw new UnAuthorizationException("회원의 인증 토큰 정보를 찾을 수 없습니다. 다시 로그인해주세요.");
         }
     }
 
     private void checkAdminAuthorization(final String token) {
         AuthInfo authInfo = tokenProvider.extractAuthInfo(token);
         if (authInfo.isNotAdmin()) {
-            throw new SecurityException("관리자 회원이 아닙니다. 관리자 권한이 필요한 기능입니다.");
+            throw new ForbiddenException("관리자 회원이 아닙니다. 관리자 권한이 필요한 기능입니다.");
         }
     }
 }