Merge pull request #99 from Bamdoliro/feat/#79

[새기능] 어드민 분석 기능

src/docs/asciidoc/analysis.adoc

@@ -0,0 +1,92 @@
+== 분석 Analysis
+
+=== 전형별 지원자 수 조회
+전형별 지원자들의 수를 조회할 수 있습니다.
+
+=== 요청 형식
+
+==== Request Header
+include::{snippets}/analysis-controller-test/전형별_지원자수를_조회한다/request-headers.adoc[]
+
+==== 요청
+include::{snippets}/analysis-controller-test/전형별_지원자수를_조회한다/http-request.adoc[]
+
+==== 응답
+include::{snippets}/analysis-controller-test/전형별_지원자수를_조회한다/http-response.adoc[]
+
+=== 전형별 성적 분포 조회
+1차 합격자, 2차 전형자, 최종 합격자들의 전형별 성적 분포를 조회할 수 있습니다.
+
+=== 요청 형식
+
+==== Request Header
+include::{snippets}/analysis-controller-test/_1차_합격자들의_성적_분포를_조회한다/request-headers.adoc[]
+
+==== Query Parameter
+include::{snippets}/analysis-controller-test/_1차_합격자들의_성적_분포를_조회한다/query-parameters.adoc[]
+
+==== 요청
+
+===== 1차 합격자
+include::{snippets}/analysis-controller-test/_1차_합격자들의_성적_분포를_조회한다/http-request.adoc[]
+
+===== 2차 전형자
+include::{snippets}/analysis-controller-test/_2차_전형자들의_성적_분포를_조회한다/http-request.adoc[]
+
+===== 최종 합격자
+include::{snippets}/analysis-controller-test/최종_합격자들의_성적_분포를_조회한다/http-request.adoc[]
+
+==== 응답
+
+===== 정상 응답
+include::{snippets}/analysis-controller-test/최종_합격자들의_성적_분포를_조회한다/http-response.adoc[]
+
+=== 전형별 성비 조회
+1차 합격자, 2차 전형자, 최종 합격자들의 전형별, 지역별 성비를 조회할 수 있습니다.
+
+=== 요청 형식
+
+==== Request Header
+include::{snippets}/analysis-controller-test/전형별_성비를_조회한다/request-headers.adoc[]
+
+==== Query Parameter
+include::{snippets}/analysis-controller-test/전형별_성비를_조회한다/query-parameters.adoc[]
+
+==== 요청
+include::{snippets}/analysis-controller-test/전형별_성비를_조회한다/http-request.adoc[]
+
+==== 응답
+
+===== 정상 응답
+include::{snippets}/analysis-controller-test/전형별_성비를_조회한다/http-response.adoc[]
+
+=== 전형별 출신학교 조회
+1차 합격자, 2차 전형자, 최종 합격자들의 출신학교를 조회할 수 있습니다.
+
+=== 요청 형식
+
+==== Request Header
+include::{snippets}/analysis-controller-test/부산_특정구_출신_지원자들의_출신학교_통계를_조회한다/request-headers.adoc[]
+
+==== Query Parameter
+include::{snippets}/analysis-controller-test/부산_특정구_출신_지원자들의_출신학교_통계를_조회한다/query-parameters.adoc[]
+
+==== 요청
+===== 부산 특정구 출신
+include::{snippets}/analysis-controller-test/부산_특정구_출신_지원자들의_출신학교_통계를_조회한다/http-request.adoc[]
+
+==== 부산 출신
+include::{snippets}/analysis-controller-test/부산_출신_지원자들의_출신학교_통계를_조회한다/http-request.adoc[]
+
+==== 타지역 출신
+include::{snippets}/analysis-controller-test/타지역_출신_지원자들의_출신학교_통계를_조회한다/http-request.adoc[]
+
+==== 응답
+==== 부산 특정구 출신 정상 응답
+include::{snippets}/analysis-controller-test/부산_특정구_출신_지원자들의_출신학교_통계를_조회한다/http-response.adoc[]
+
+==== 부산 출신 정상 응답
+include::{snippets}/analysis-controller-test/부산_출신_지원자들의_출신학교_통계를_조회한다/http-response.adoc[]
+
+==== 타지역 출신 정상 응답
+include::{snippets}/analysis-controller-test/타지역_출신_지원자들의_출신학교_통계를_조회한다/http-response.adoc[]

src/docs/asciidoc/index.adoc

@@ -27,4 +27,6 @@ include::fair.adoc[]
 
 include::message.adoc[]
 
+include::analysis.adoc[]
+
 include::enum.adoc[]

src/main/java/com/bamdoliro/maru/application/analysis/QueryGenderRatioUseCase.java

@@ -0,0 +1,76 @@
+package com.bamdoliro.maru.application.analysis;
+
+import com.bamdoliro.maru.domain.form.domain.Form;
+import com.bamdoliro.maru.domain.form.domain.type.FormType;
+import com.bamdoliro.maru.domain.form.domain.type.Gender;
+import com.bamdoliro.maru.infrastructure.persistence.form.FormRepository;
+import com.bamdoliro.maru.presentation.analysis.dto.request.GenderRatioRequest;
+import com.bamdoliro.maru.presentation.analysis.dto.response.GenderRatioResponse;
+import com.bamdoliro.maru.shared.annotation.UseCase;
+import lombok.RequiredArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+@RequiredArgsConstructor
+@UseCase
+public class QueryGenderRatioUseCase {
+    private final FormRepository formRepository;
+
+    public List<GenderRatioResponse> execute(GenderRatioRequest request) {
+        FormType.Category mainCategory = request.getMainCategory();
+        List<GenderRatioResponse> result = new ArrayList<>();
+        List<FormType.Category> subCategories = new ArrayList<>();
+
+        if (mainCategory.equals(FormType.Category.REGULAR))
+            subCategories.add(FormType.Category.REGULAR);
+        else if (mainCategory.equals(FormType.Category.SPECIAL))
+            subCategories.addAll(List.of(
+                    FormType.Category.MEISTER_TALENT,
+                    FormType.Category.SOCIAL_INTEGRATION));
+        else if (mainCategory.equals(FormType.Category.SUPERNUMERARY))
+            subCategories.addAll(List.of(
+                    FormType.Category.NATIONAL_VETERANS_EDUCATION,
+                    FormType.Category.SPECIAL_ADMISSION));
+
+        Map<FormType.Category, List<Form>> formLists = subCategories.stream()
+                .collect(Collectors.toMap(
+                        category -> category,
+                        category -> formRepository.findByCategory(category).stream()
+                                .filter(form -> request.getStatusList().contains(form.getStatus()))
+                                .collect(Collectors.toList())
+                ));
+
+        for(Map.Entry<FormType.Category, List<Form>> entry : formLists.entrySet()) {
+            FormType.Category category = entry.getKey();
+            List<Form> formList = entry.getValue();
+
+            long busanMale = formList.stream().filter(this::isBusan).filter(this::isMale).count();
+            long busanFemale = formList.stream().filter(this::isBusan).filter(this::isFemale).count();
+            long otherLocationMale = formList.stream().filter(this::isNotBusan).filter(this::isMale).count();
+            long otherLocationFemale = formList.stream().filter(this::isNotBusan).filter(this::isFemale).count();
+
+            result.add(new GenderRatioResponse(category, busanMale, busanFemale, otherLocationMale, otherLocationFemale));
+        }
+
+        return result;
+    }
+
+    private boolean isBusan(Form form) {
+        return form.getEducation().getSchool().isBusan();
+    }
+
+    private boolean isNotBusan(Form form) {
+        return !isBusan(form);
+    }
+
+    private boolean isMale(Form form) {
+        return form.getApplicant().getGender().equals(Gender.MALE);
+    }
+
+    private boolean isFemale(Form form) {
+        return !isMale(form);
+    }
+}

src/main/java/com/bamdoliro/maru/application/analysis/QueryGradeDistributionUseCase.java

@@ -0,0 +1,37 @@
+package com.bamdoliro.maru.application.analysis;
+
+import com.bamdoliro.maru.domain.form.domain.type.FormType;
+import com.bamdoliro.maru.infrastructure.persistence.form.FormRepository;
+import com.bamdoliro.maru.presentation.analysis.dto.request.GradeDistributionRequest;
+import com.bamdoliro.maru.presentation.analysis.dto.response.GradeDistributionResponse;
+import com.bamdoliro.maru.shared.annotation.UseCase;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@RequiredArgsConstructor
+@UseCase
+public class QueryGradeDistributionUseCase {
+
+    private final FormRepository formRepository;
+
+    public List<GradeDistributionResponse> execute(GradeDistributionRequest request) {
+        List<GradeDistributionResponse> result = new java.util.ArrayList<>(formRepository.findGradeGroupByTypeAndStatus(request.getStatusList())
+                .stream()
+                .map(GradeDistributionResponse::new)
+                .toList());
+
+        List<FormType> existingTypes = result
+                .stream()
+                .map(GradeDistributionResponse::getType)
+                .toList();
+
+        for (FormType formType : FormType.values()) {
+            if (!existingTypes.contains(formType)) {
+                result.add(new GradeDistributionResponse(formType, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
+            }
+        }
+
+        return result;
+    }
+}

src/main/java/com/bamdoliro/maru/application/analysis/QueryNumberOfApplicantsUseCase.java

@@ -0,0 +1,37 @@
+package com.bamdoliro.maru.application.analysis;
+
+import com.bamdoliro.maru.domain.form.domain.type.FormType;
+import com.bamdoliro.maru.infrastructure.persistence.form.FormRepository;
+import com.bamdoliro.maru.presentation.analysis.dto.response.NumberOfApplicantsResponse;
+import com.bamdoliro.maru.shared.annotation.UseCase;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+@RequiredArgsConstructor
+@UseCase
+public class QueryNumberOfApplicantsUseCase {
+
+    private final FormRepository formRepository;
+
+    public List<NumberOfApplicantsResponse> execute() {
+        List<NumberOfApplicantsResponse> result = formRepository.findTypeAndCountGroupByType()
+                .stream()
+                .map(NumberOfApplicantsResponse::new)
+                .collect(Collectors.toList());
+
+        List<FormType> existingTypes = result
+                .stream()
+                .map(NumberOfApplicantsResponse::getType)
+                .toList();
+
+        for (FormType formType: FormType.values()) {
+            if (!existingTypes.contains(formType)) {
+                result.add(new NumberOfApplicantsResponse(formType, 0L));
+            }
+        }
+
+        return result;
+    }
+}

src/main/java/com/bamdoliro/maru/application/analysis/QuerySchoolStatusUseCase.java

@@ -0,0 +1,33 @@
+package com.bamdoliro.maru.application.analysis;
+
+import com.bamdoliro.maru.infrastructure.persistence.form.FormRepository;
+import com.bamdoliro.maru.presentation.analysis.dto.request.SchoolStatusRequest;
+import com.bamdoliro.maru.presentation.analysis.dto.response.SchoolStatusResponse;
+import com.bamdoliro.maru.shared.annotation.UseCase;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@RequiredArgsConstructor
+@UseCase
+public class QuerySchoolStatusUseCase {
+
+    private final FormRepository formRepository;
+
+    public List<SchoolStatusResponse> execute(SchoolStatusRequest request) {
+        if (request.getIsBusan()) {
+            String keyword = "부산광역시";
+            keyword += request.getGu() == null ? "" : (" " + request.getGu());
+
+            return formRepository.findSchoolByAddress(request.getStatusList(), keyword)
+                    .stream()
+                    .map(SchoolStatusResponse::new)
+                    .toList();
+        }
+
+        return formRepository.findNotBusanSchool(request.getStatusList())
+                .stream()
+                .map(SchoolStatusResponse::new)
+                .toList();
+    }
+}

src/main/java/com/bamdoliro/maru/domain/form/domain/type/FormType.java

@@ -25,8 +25,8 @@ public enum FormType implements EnumProperty {
     MULTI_CHILDREN("다자녀가정자녀", Category.SPECIAL, Category.SOCIAL_INTEGRATION, Category.SOCIETY_DIVERSITY),
     FARMING_AND_FISHING("농어촌지역출신자", Category.SPECIAL, Category.SOCIAL_INTEGRATION, Category.SOCIETY_DIVERSITY),
 
-    NATIONAL_VETERANS_EDUCATION("국가보훈대상자 중 교육지원대상자녀", Category.SUPERNUMERARY, null, null),
-    SPECIAL_ADMISSION("특례입학대상자", Category.SUPERNUMERARY, null, null),
+    NATIONAL_VETERANS_EDUCATION("국가보훈대상자 중 교육지원대상자녀", Category.SUPERNUMERARY, Category.NATIONAL_VETERANS_EDUCATION, null),
+    SPECIAL_ADMISSION("특례입학대상자", Category.SUPERNUMERARY, Category.SPECIAL_ADMISSION, null),
     ;
 
 
@@ -46,6 +46,8 @@ public enum Category implements EnumProperty {
         // Middle Category
         SOCIAL_INTEGRATION("사회통합전형"),
         MEISTER_TALENT("마이스터인재전형"),
+        NATIONAL_VETERANS_EDUCATION("국가보훈대상자 중 교육지원대상자녀"),
+        SPECIAL_ADMISSION("특례입학대상자"),
 
         // Sub Category
         EQUAL_OPPORTUNITY("기회균등전형"),

src/main/java/com/bamdoliro/maru/domain/form/domain/value/School.java

@@ -19,10 +19,13 @@ public class School {
     @Column(name = "school_location", nullable = false, length = 20)
     private String location;
 
+    @Column(name = "school_address", nullable = false, length = 40)
+    private String address;
+
     @Column(name = "school_code", nullable = false, length = 10)
     private String code;
 
     public boolean isBusan() {
         return location.equals("부산광역시");
     }
-}
+}

src/main/java/com/bamdoliro/maru/infrastructure/neis/SearchSchoolService.java

@@ -27,6 +27,7 @@ public List<SchoolResponse> execute(String q) throws JsonProcessingException {
                 .map(s -> SchoolResponse.builder()
                         .name(s.getSchoolName())
                         .location(s.getLocation())
+                        .address((s.getAddress()))
                         .code(s.getStandardSchoolCode())
                         .build())
                 .toList();

src/main/java/com/bamdoliro/maru/infrastructure/persistence/form/FormRepositoryCustom.java

@@ -2,13 +2,19 @@
 
 import com.bamdoliro.maru.domain.form.domain.Form;
 import com.bamdoliro.maru.domain.form.domain.type.FormStatus;
+import com.bamdoliro.maru.domain.form.domain.type.FormType;
+import com.bamdoliro.maru.infrastructure.persistence.form.vo.NumberOfApplicantsVo;
 import com.bamdoliro.maru.infrastructure.persistence.form.vo.FormUrlVo;
+import com.bamdoliro.maru.infrastructure.persistence.form.vo.GradeVo;
+import com.bamdoliro.maru.infrastructure.persistence.form.vo.SchoolStatusVo;
 
 import java.util.List;
 
 public interface FormRepositoryCustom {
 
     List<Form> findByStatus(FormStatus status);
+    List<Form> findByType(FormType type);
+    List<Form> findByCategory(FormType.Category category);
     List<Form> findReceivedSpecialForm();
     List<Form> findReceivedRegularOrSupernumeraryForm();
     List<Form> findFirstRoundForm();
@@ -18,4 +24,8 @@ public interface FormRepositoryCustom {
     List<Form> findSecondRoundForm();
     List<Form> findByFormIdList(List<Long> idList);
     List<FormUrlVo> findFormUrlByFormIdList(List<Long> idList);
-}
+    List<NumberOfApplicantsVo> findTypeAndCountGroupByType();
+    List<GradeVo> findGradeGroupByTypeAndStatus(List<FormStatus> round);
+    List<SchoolStatusVo> findSchoolByAddress(List<FormStatus> round, String keyword);
+    List<SchoolStatusVo> findNotBusanSchool(List<FormStatus> round);
+}