Docs: Swagger 어노테이션 추가

Author: jueunk617

src/main/java/com/back/domain/chat/controller/ChatApiController.java

@@ -4,6 +4,8 @@
 import com.back.domain.chat.service.ChatService;
 import com.back.global.common.dto.RsData;
 import com.back.global.security.CustomUserDetails;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.format.annotation.DateTimeFormat;
 import org.springframework.http.HttpStatus;
@@ -16,12 +18,14 @@
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api")
+@Tag(name = "Chat API", description = "채팅 메시지 조회 관련 API")
 public class ChatApiController {
 
     private final ChatService chatService;
 
     // 방 채팅 메시지 조회 (페이징, 특정 시간 이전 메시지)
     @GetMapping("/rooms/{roomId}/messages")
+    @Operation(summary = "채팅방 메시지 목록 조회", description = "특정 채팅방의 이전 메시지 기록을 페이징하여 조회합니다.")
     public ResponseEntity<RsData<ChatPageResponse>> getRoomChatMessages(
             @PathVariable Long roomId,
             @RequestParam(defaultValue = "0") int page,

src/main/java/com/back/domain/chat/controller/ChatWebSocketController.java

@@ -5,6 +5,7 @@
 import com.back.global.security.CustomUserDetails;
 import com.back.global.websocket.dto.WebSocketErrorResponse;
 import com.back.domain.chat.service.ChatService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.messaging.handler.annotation.DestinationVariable;
 import org.springframework.messaging.handler.annotation.MessageMapping;
@@ -17,6 +18,7 @@
 
 @Controller
 @RequiredArgsConstructor
+@Tag(name = "Chat WebSocket", description = "STOMP를 이용한 실시간 채팅 WebSocket 컨트롤러 (Swagger에서 직접 테스트 불가)")
 public class ChatWebSocketController {
 
     private final ChatService chatService;

src/main/java/com/back/global/websocket/controller/WebSocketTestController.java

@@ -1,6 +1,8 @@
 package com.back.global.websocket.controller;
 
 import com.back.global.common.dto.RsData;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
@@ -15,10 +17,12 @@
 @Slf4j
 @RestController
 @RequestMapping("/api/websocket")
+@Tag(name = "WebSocket Test API", description = "WebSocket 서버 상태 확인 및 연결 정보 제공 API")
 public class WebSocketTestController { // WebSocket 기능 테스트용 REST 컨트롤러
 
     // WebSocket 서버 상태 확인
     @GetMapping("/health")
+    @Operation(summary = "WebSocket 서버 헬스체크", description = "WebSocket 서비스의 현재 상태를 확인합니다.")
     public ResponseEntity<RsData<Map<String, Object>>> healthCheck() {
         log.info("WebSocket 헬스체크 요청");
 
@@ -40,6 +44,7 @@ public ResponseEntity<RsData<Map<String, Object>>> healthCheck() {
 
     // WebSocket 연결 정보 제공
     @GetMapping("/info")
+    @Operation(summary = "WebSocket 연결 정보 조회", description = "클라이언트가 WebSocket에 연결하기 위해 필요한 정보를 제공합니다.")
     public ResponseEntity<RsData<Map<String, Object>>> getConnectionInfo() {
         log.info("WebSocket 연결 정보 요청");