Skip to content

feat: 분실물 API Controller 분리 및 분실물 조회 API 필터 추가 #2130

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DHkimgit merged 7 commits into from
Jan 16, 2026
Merged

feat: 분실물 API Controller 분리 및 분실물 조회 API 필터 추가 #2130

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
b200d94
refactor: lostitemarticle controller 분리
DHkimgit Jan 13, 2026
86d86be
feat: 분실물 게시글 목록 조회 API 필터 추가
DHkimgit Jan 13, 2026
eb9a57f
feat: 찾는중 상태인 분실물 게시글 개수 반환 GET API 추가
DHkimgit Jan 13, 2026
b163bca
feat: 통계 API 통합
DHkimgit Jan 14, 2026
e6ed716
chore: 미사용 dto 제거
DHkimgit Jan 14, 2026
4b94cf3
feat: title 검색 조건 추가
DHkimgit Jan 14, 2026
16816e8
fix: 리뷰 반영
DHkimgit Jan 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
129 changes: 0 additions & 129 deletions src/main/java/in/koreatech/koin/domain/community/article/controller/ArticleApi.java
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,32 +1,20 @@
package in.koreatech.koin.domain.community.article.controller;

import static in.koreatech.koin.domain.user.model.UserType.*;
import static in.koreatech.koin.global.code.ApiResponseCode.*;
import static io.swagger.v3.oas.annotations.enums.ParameterIn.PATH;

import java.util.List;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

import in.koreatech.koin.domain.community.article.dto.ArticleHotKeywordResponse;
import in.koreatech.koin.domain.community.article.dto.ArticleResponse;
import in.koreatech.koin.domain.community.article.dto.ArticlesResponse;
import in.koreatech.koin.domain.community.article.dto.FoundLostItemArticleCountResponse;
import in.koreatech.koin.domain.community.article.dto.HotArticleItemResponse;
import in.koreatech.koin.domain.community.article.dto.LostItemArticleResponse;
import in.koreatech.koin.domain.community.article.dto.LostItemArticlesRequest;
import in.koreatech.koin.domain.community.article.dto.LostItemArticlesResponse;
import in.koreatech.koin.domain.community.article.model.LostItemFoundStatus;
import in.koreatech.koin.global.auth.Auth;
import in.koreatech.koin.global.auth.UserId;
import in.koreatech.koin.global.code.ApiResponseCodes;
import in.koreatech.koin.global.ipaddress.IpAddress;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
Expand All @@ -35,7 +23,6 @@
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.responses.ApiResponses;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;

@Tag(name = "(Normal) Articles: 게시글", description = "게시글 정보를 관리한다")
@RequestMapping("/articles")
Expand Down Expand Up @@ -97,21 +84,6 @@ ResponseEntity<ArticlesResponse> searchArticles(
@UserId Integer userId
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "200"),
}
)
@Operation(summary = "분실물 게시글 검색")
@GetMapping("/lost-item/search")
ResponseEntity<LostItemArticlesResponse> searchArticles(
@RequestParam String query,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@IpAddress String ipAddress,
@UserId Integer userId
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "200")
Expand All @@ -122,105 +94,4 @@ ResponseEntity<LostItemArticlesResponse> searchArticles(
ResponseEntity<ArticleHotKeywordResponse> getArticlesHotKeyword(
@RequestParam Integer count
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "200"),
@ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
}
)
@Operation(summary = "분실물 게시글 목록 조회")
@GetMapping("/lost-item")
ResponseEntity<LostItemArticlesResponse> getLostItemArticles(
@RequestParam(required = false) String type,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@UserId Integer userId
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "200"),
@ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
}
)
@Operation(summary = "분실물 게시글 목록 조회 V2", description = """
### 분실물 게시글 목록 조회 V2 변경점
- Request Param 추가: foundStatus (ALL, FOUND, NOT_FOUND)
- ALL : 모든 분실물 게시글 조회 (Default)
- FOUND : '주인 찾음' 상태인 게시글 조회
- NOT_FOUND : '찾는 중' 상태인 게시글 조회
""")
@GetMapping("/lost-item/v2")
ResponseEntity<LostItemArticlesResponse> getLostItemArticlesV2(
@RequestParam(required = false) String type,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@RequestParam(required = false, defaultValue = "ALL") LostItemFoundStatus foundStatus,
@UserId Integer userId
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "200"),
@ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
}
)
@Operation(summary = "분실물 게시글 단건 조회")
@GetMapping("/lost-item/{id}")
ResponseEntity<LostItemArticleResponse> getLostItemArticle(
@Parameter(in = PATH) @PathVariable("id") Integer articleId,
@UserId Integer userId
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "201"),
@ApiResponse(responseCode = "401", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "403", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "422", content = @Content(schema = @Schema(hidden = true))),
}
)
@Operation(summary = "분실물 게시글 등록")
@PostMapping("/lost-item")
ResponseEntity<LostItemArticleResponse> createLostItemArticle(
@Auth(permit = {STUDENT, COUNCIL}) Integer userId,
@RequestBody @Valid LostItemArticlesRequest lostItemArticlesRequest
);

@ApiResponses(
value = {
@ApiResponse(responseCode = "204"),
@ApiResponse(responseCode = "401", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "403", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
@ApiResponse(responseCode = "422", content = @Content(schema = @Schema(hidden = true))),
}
)
@Operation(summary = "분실물 게시글 삭제")
@DeleteMapping("/lost-item/{id}")
ResponseEntity<Void> deleteLostItemArticle(
@PathVariable("id") Integer articleId,
@Auth(permit = {STUDENT, COUNCIL}) Integer councilId
);

@ApiResponseCodes({
NO_CONTENT,
FORBIDDEN_AUTHOR,
DUPLICATE_FOUND_STATUS
})
@Operation(summary = "분실물 게시글 찾음 처리")
@PostMapping("/lost-item/{id}/found")
ResponseEntity<Void> markLostItemArticleAsFound(
@PathVariable("id") Integer articleId,
@Auth(permit = {GENERAL, STUDENT, COUNCIL}) Integer userId
);

@ApiResponseCodes({
OK
})
@Operation(summary = "주인 찾음 상태인 분실물 게시글 총 개수 조회")
@GetMapping("/lost-item/found/count")
ResponseEntity<FoundLostItemArticleCountResponse> getFoundLostItemArticlesCount();
}
92 changes: 0 additions & 92 deletions src/main/java/in/koreatech/koin/domain/community/article/controller/ArticleController.java
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,35 +1,21 @@
package in.koreatech.koin.domain.community.article.controller;

import static in.koreatech.koin.domain.user.model.UserType.*;

import java.util.List;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import in.koreatech.koin.domain.community.article.dto.ArticleHotKeywordResponse;
import in.koreatech.koin.domain.community.article.dto.ArticleResponse;
import in.koreatech.koin.domain.community.article.dto.ArticlesResponse;
import in.koreatech.koin.domain.community.article.dto.FoundLostItemArticleCountResponse;
import in.koreatech.koin.domain.community.article.dto.HotArticleItemResponse;
import in.koreatech.koin.domain.community.article.dto.LostItemArticleResponse;
import in.koreatech.koin.domain.community.article.dto.LostItemArticlesRequest;
import in.koreatech.koin.domain.community.article.dto.LostItemArticlesResponse;
import in.koreatech.koin.domain.community.article.model.LostItemFoundStatus;
import in.koreatech.koin.domain.community.article.service.ArticleService;
import in.koreatech.koin.domain.community.article.service.LostItemFoundService;
import in.koreatech.koin.global.auth.Auth;
import in.koreatech.koin.global.auth.UserId;
import in.koreatech.koin.global.ipaddress.IpAddress;
import jakarta.validation.Valid;
import lombok.RequiredArgsConstructor;

@RestController
Expand All @@ -38,7 +24,6 @@
public class ArticleController implements ArticleApi {

private final ArticleService articleService;
private final LostItemFoundService lostItemFoundService;

@GetMapping("/{id}")
public ResponseEntity<ArticleResponse> getArticle(
Expand Down Expand Up @@ -80,88 +65,11 @@ public ResponseEntity<ArticlesResponse> searchArticles(
return ResponseEntity.ok().body(foundArticles);
}

@GetMapping("/lost-item/search")
public ResponseEntity<LostItemArticlesResponse> searchArticles(
@RequestParam String query,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@IpAddress String ipAddress,
@UserId Integer userId
) {
LostItemArticlesResponse foundArticles = articleService.searchLostItemArticles(query, page, limit, ipAddress,
userId);
return ResponseEntity.ok().body(foundArticles);
}

@GetMapping("/hot/keyword")
public ResponseEntity<ArticleHotKeywordResponse> getArticlesHotKeyword(
@RequestParam Integer count
) {
ArticleHotKeywordResponse response = articleService.getArticlesHotKeyword(count);
return ResponseEntity.ok().body(response);
}

@GetMapping("/lost-item")
public ResponseEntity<LostItemArticlesResponse> getLostItemArticles(
@RequestParam(required = false) String type,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@UserId Integer userId
) {
LostItemArticlesResponse response = articleService.getLostItemArticles(type, page, limit, userId);
return ResponseEntity.ok().body(response);
}

@GetMapping("/lost-item/v2")
public ResponseEntity<LostItemArticlesResponse> getLostItemArticlesV2(
@RequestParam(required = false) String type,
@RequestParam(required = false) Integer page,
@RequestParam(required = false) Integer limit,
@RequestParam(required = false, defaultValue = "ALL") LostItemFoundStatus foundStatus,
@UserId Integer userId
) {
LostItemArticlesResponse response = articleService.getLostItemArticlesV2(type, page, limit, userId, foundStatus);
return ResponseEntity.ok().body(response);
}

@GetMapping("/lost-item/{id}")
public ResponseEntity<LostItemArticleResponse> getLostItemArticle(
@PathVariable("id") Integer articleId,
@UserId Integer userId
) {
return ResponseEntity.ok().body(articleService.getLostItemArticle(articleId, userId));
}

@PostMapping("/lost-item")
public ResponseEntity<LostItemArticleResponse> createLostItemArticle(
@Auth(permit = {GENERAL, STUDENT, COUNCIL}) Integer studentId,
@RequestBody @Valid LostItemArticlesRequest lostItemArticlesRequest
) {
LostItemArticleResponse response = articleService.createLostItemArticle(studentId, lostItemArticlesRequest);
return ResponseEntity.status(HttpStatus.CREATED).body(response);
}

@DeleteMapping("/lost-item/{id}")
public ResponseEntity<Void> deleteLostItemArticle(
@PathVariable("id") Integer articleId,
@Auth(permit = {GENERAL, STUDENT, COUNCIL}) Integer userId
) {
articleService.deleteLostItemArticle(articleId, userId);
return ResponseEntity.noContent().build();
}

@PostMapping("/lost-item/{id}/found")
public ResponseEntity<Void> markLostItemArticleAsFound(
@PathVariable("id") Integer articleId,
@Auth(permit = {GENERAL, STUDENT, COUNCIL}) Integer userId
) {
lostItemFoundService.markAsFound(userId, articleId);
return ResponseEntity.noContent().build();
}

@GetMapping("/lost-item/found/count")
public ResponseEntity<FoundLostItemArticleCountResponse> getFoundLostItemArticlesCount() {
FoundLostItemArticleCountResponse response = lostItemFoundService.countFoundArticles();
return ResponseEntity.ok().body(response);
}
}
Loading
Loading