feat: 트렌딩 레포지터리 추천, 카테고리별 레포지터리 생성 완료

Author: sokft

src/main/java/Capstone/FOSSistant/global/apiPayload/code/status/ErrorStatus.java

@@ -33,6 +33,7 @@ public enum ErrorStatus implements BaseErrorCode {
     NOT_CONTAIN_TOKEN(HttpStatus.INTERNAL_SERVER_ERROR, "INFRA_500_003", "Redis에 토큰이 없음."),
     AI_API_FAIL(HttpStatus.BAD_GATEWAY, "EXT_502_001", "AI API 호출 실패"),
     GITHUB_API_FAIL(HttpStatus.BAD_GATEWAY, "EXT_502_002", "Github API 호출 실패"),
+    GITHUB_NO_REPOSITORY_FOUND(HttpStatus.BAD_GATEWAY, "EXT_502_002", "DB에 저장된 레포지터리 없음"),
 
     // 가장 일반적인 응답
     _INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "COMMON500", "서버 에러, 관리자에게 문의 바랍니다."),

src/main/java/Capstone/FOSSistant/global/repository/GithubRepositoryRepository.java

@@ -7,5 +7,6 @@
 
 public interface GithubRepositoryRepository extends JpaRepository<GitHubRepository, Long> {
     List<GitHubRepository> findAllByLanguage(String language);
+    List<GitHubRepository> findTop15ByLanguage(String language);
 
 }

src/main/java/Capstone/FOSSistant/global/service/githubRepo/GithubRepositoryService.java

@@ -7,6 +7,7 @@ public interface GithubRepositoryService {
     void fetchAndStoreTrendingRepositories();
 
     GithubRepoDTO.GithubRepoListDTO recommendTopRepositories(Member member);
-}
+    GithubRepoDTO.GithubRepoListDTO recommendByLanguage(String language);
+    }
 
 

src/main/java/Capstone/FOSSistant/global/service/githubRepo/GithubRepositoryServiceImpl.java

@@ -1,5 +1,7 @@
 package Capstone.FOSSistant.global.service.githubRepo;
 
+import Capstone.FOSSistant.global.apiPayload.code.status.ErrorStatus;
+import Capstone.FOSSistant.global.apiPayload.exception.GeneralException;
 import Capstone.FOSSistant.global.domain.entity.GitHubRepository;
 import Capstone.FOSSistant.global.domain.entity.Member;
 import Capstone.FOSSistant.global.domain.entity.MemberTopLanguage;
@@ -11,6 +13,7 @@
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
+import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
 
@@ -65,4 +68,32 @@ private GithubRepoDTO.GithubRepoResponseDTO toDto(GitHubRepository repo) {
                 .stars(repo.getStars())
                 .build();
     }
+
+    @Override
+    public GithubRepoDTO.GithubRepoListDTO recommendByLanguage(String language) {
+        List<GitHubRepository> repoList = gitHubRepositoryRepository.findTop15ByLanguage(language);
+
+        if (repoList.isEmpty()) {
+            throw new GeneralException(ErrorStatus.GITHUB_NO_REPOSITORY_FOUND);
+        }
+
+        Collections.shuffle(repoList);
+        List<GitHubRepository> random3 = repoList.stream().limit(3).toList();
+
+        List<GithubRepoDTO.GithubRepoResponseDTO> result = random3.stream()
+                .map(repo -> GithubRepoDTO.GithubRepoResponseDTO.builder()
+                        .name(repo.getName())
+                        .fullName(repo.getFullName())
+                        .url(repo.getUrl())
+                        .description(repo.getDescription())
+                        .language(repo.getLanguage())
+                        .stars(repo.getStars())
+                        .build())
+                .toList();
+
+        return GithubRepoDTO.GithubRepoListDTO.builder()
+                .results(result)
+                .build();
+    }
+
 }

src/main/java/Capstone/FOSSistant/global/web/controller/GithubRepoController.java

@@ -11,6 +11,7 @@
 import Capstone.FOSSistant.global.web.dto.util.custom.ApiErrorCodeExamples;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -26,14 +27,14 @@ public class GithubRepoController {
 
     private final GithubRepositoryServiceImpl githubRepositoryService;
 
-    @PostMapping("/trending")
-    @Operation(summary = "트렌딩 레포지터리 저장", description = "언어별 트렌딩 레포지터리 15개씩 가져와 DB에 저장")
-    @ApiErrorCodeExamples({ErrorStatus.GITHUB_API_FAIL, ErrorStatus._INTERNAL_SERVER_ERROR})
-    public APiResponse<Void> storeTrendingRepositories() {
-        log.info("트렌딩 레포지터리 저장 요청 수신");
-        githubRepositoryService.fetchAndStoreTrendingRepositories();
-        return APiResponse.onSuccess(SuccessStatus.REPO_CRAWLING_OK, null);
-    }
+//    @PostMapping("/trending")
+//    @Operation(summary = "트렌딩 레포지터리 저장", description = "언어별 트렌딩 레포지터리 15개씩 가져와 DB에 저장")
+//    @ApiErrorCodeExamples({ErrorStatus.GITHUB_API_FAIL, ErrorStatus._INTERNAL_SERVER_ERROR})
+//    public APiResponse<Void> storeTrendingRepositories() {
+//        log.info("트렌딩 레포지터리 저장 요청 수신");
+//        githubRepositoryService.fetchAndStoreTrendingRepositories();
+//        return APiResponse.onSuccess(SuccessStatus.REPO_CRAWLING_OK, null);
+//    }
 
     @GetMapping("/personal")
     @Operation(
@@ -45,6 +46,22 @@ public APiResponse<GithubRepoDTO.GithubRepoListDTO> recommendUserTopLangRepos(@A
                 githubRepositoryService.recommendTopRepositories(member));
     }
 
-
+    @GetMapping("/category/{language}")
+    @Operation(
+            summary = "언어별 레포지터리 추천",
+            description = "지정한 언어(Java, TypeScript, JavaScript, Python, Jupyter Notebook)에 해당하는 무작위 레포지터리 3개를 반환합니다."
+    )
+    public APiResponse<GithubRepoDTO.GithubRepoListDTO> recommendByLanguage(
+            @Parameter(
+                    description = "프론트에서 선택한 언어. 다음 중 하나여야 합니다: Java, TypeScript, JavaScript, Python, Jupyter Notebook",
+                    schema = @Schema(allowableValues = {
+                            "Java", "TypeScript", "JavaScript", "Python", "Jupyter Notebook"
+                    })
+            )
+            @PathVariable String language
+    ) {
+        return APiResponse.onSuccess(SuccessStatus.REPO_RECOMMEND_OK,
+                githubRepositoryService.recommendByLanguage(language));
+    }
 
 }

src/main/java/Capstone/FOSSistant/global/web/dto/GithubRepo/GithubRepoDTO.java

@@ -1,5 +1,6 @@
 package Capstone.FOSSistant.global.web.dto.GithubRepo;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.*;
 
 import java.util.List;
@@ -28,5 +29,4 @@ public static class GithubRepoResponseDTO {
     public static class GithubRepoListDTO {
         private List<GithubRepoResponseDTO> results;
     }
-
 }

src/main/resources/application.yml

@@ -27,7 +27,7 @@ spring:
 
   data:
     redis:
-      host: localhost # ※운영 환경에서는 localhost → redis
+      host: redis # ※운영 환경에서는 localhost → redis
       port: 6379
 
   gemini: