|
| 1 | +package com.semosan.api.domain.admin.controller.docs; |
| 2 | + |
| 3 | +import com.semosan.api.common.response.ApiResponse; |
| 4 | +import com.semosan.api.domain.admin.dto.request.AdminUserSuspendRequest; |
| 5 | +import com.semosan.api.domain.admin.dto.response.AdminReportedPostResponse; |
| 6 | +import io.swagger.v3.oas.annotations.Operation; |
| 7 | +import io.swagger.v3.oas.annotations.responses.ApiResponses; |
| 8 | +import io.swagger.v3.oas.annotations.tags.Tag; |
| 9 | +import jakarta.validation.Valid; |
| 10 | +import org.springframework.data.domain.Page; |
| 11 | +import org.springframework.data.domain.Pageable; |
| 12 | +import org.springframework.http.ResponseEntity; |
| 13 | +import org.springframework.web.bind.annotation.PathVariable; |
| 14 | +import org.springframework.web.bind.annotation.RequestBody; |
| 15 | + |
| 16 | +@Tag(name = "Admin Community", description = "관리자 커뮤니티 관리 API") |
| 17 | +public interface AdminCommunityControllerDocs { |
| 18 | + |
| 19 | + @Operation(summary = "신고된 게시글 목록 조회", description = "신고 횟수가 많은 순으로 게시글 목록을 조회합니다.") |
| 20 | + @ApiResponses({ |
| 21 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "조회 성공") |
| 22 | + }) |
| 23 | + ResponseEntity<ApiResponse<Page<AdminReportedPostResponse>>> getReportedPosts(Pageable pageable); |
| 24 | + |
| 25 | + @Operation(summary = "게시글 강제 삭제", description = "게시글을 강제로 삭제(숨김) 처리합니다.") |
| 26 | + @ApiResponses({ |
| 27 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "삭제 성공"), |
| 28 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "게시글을 찾을 수 없음") |
| 29 | + }) |
| 30 | + ResponseEntity<ApiResponse<Void>> deletePost(@PathVariable Long postId); |
| 31 | + |
| 32 | + @Operation(summary = "댓글 강제 삭제", description = "댓글을 강제로 삭제 처리합니다.") |
| 33 | + @ApiResponses({ |
| 34 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "삭제 성공"), |
| 35 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "댓글을 찾을 수 없음") |
| 36 | + }) |
| 37 | + ResponseEntity<ApiResponse<Void>> deleteComment(@PathVariable Long commentId); |
| 38 | + |
| 39 | + @Operation(summary = "사용자 정지", description = "사용자를 지정된 기간까지 정지합니다.") |
| 40 | + @ApiResponses({ |
| 41 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "정지 성공"), |
| 42 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "사용자를 찾을 수 없음") |
| 43 | + }) |
| 44 | + ResponseEntity<ApiResponse<Void>> suspendUser( |
| 45 | + @PathVariable Long userId, |
| 46 | + @Valid @RequestBody AdminUserSuspendRequest request |
| 47 | + ); |
| 48 | + |
| 49 | + @Operation(summary = "사용자 정지 해제", description = "사용자의 정지를 해제합니다.") |
| 50 | + @ApiResponses({ |
| 51 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "정지 해제 성공"), |
| 52 | + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "사용자를 찾을 수 없음") |
| 53 | + }) |
| 54 | + ResponseEntity<ApiResponse<Void>> unsuspendUser(@PathVariable Long userId); |
| 55 | +} |
0 commit comments