Merge pull request #612 from solid-connection/feat/application-status-access-funnel

✨ 지원자 현황 접근 상태별 퍼널 개선

Author: manNomi

apps/web/src/apis/Scores/getGpaList.ts

@@ -1,17 +1,24 @@
-import { useQuery } from "@tanstack/react-query";
+import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
+import type { AxiosResponse } from "axios";
 
-import { ScoresQueryKeys, scoresApi } from "./api";
+import { ScoresQueryKeys, scoresApi, type UseMyGpaScoreResponse } from "./api";
+
+type UseGetMyGpaScoreOptions = Omit<
+  UseQueryOptions<AxiosResponse<UseMyGpaScoreResponse>, unknown, UseMyGpaScoreResponse>,
+  "queryKey" | "queryFn"
+>;
 
 /**
  * @description 내 학점 점수 조회 훅
  */
-const useGetMyGpaScore = ({ enabled = true }: { enabled?: boolean } = {}) => {
+const useGetMyGpaScore = (props?: UseGetMyGpaScoreOptions) => {
   return useQuery({
     queryKey: [ScoresQueryKeys.myGpaScore],
     queryFn: scoresApi.getMyGpaScore,
-    enabled,
+    enabled: true,
     staleTime: Infinity,
     select: (data) => data.data,
+    ...props,
   });
 };
 

apps/web/src/apis/Scores/getLanguageTestList.ts

@@ -1,16 +1,25 @@
-import { useQuery } from "@tanstack/react-query";
+import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
+import type { AxiosResponse } from "axios";
 
-import { ScoresQueryKeys, scoresApi } from "./api";
+import type { LanguageTestScore } from "@/types/score";
+import { ScoresQueryKeys, scoresApi, type UseGetMyLanguageTestScoreResponse } from "./api";
+
+type UseGetMyLanguageTestScoreOptions = Omit<
+  UseQueryOptions<AxiosResponse<UseGetMyLanguageTestScoreResponse>, unknown, LanguageTestScore[]>,
+  "queryKey" | "queryFn"
+>;
 
 /**
  * @description 내 어학 점수 조회 훅
  */
-const useGetMyLanguageTestScore = () => {
+const useGetMyLanguageTestScore = (props?: UseGetMyLanguageTestScoreOptions) => {
   return useQuery({
     queryKey: [ScoresQueryKeys.myLanguageTestScore],
     queryFn: scoresApi.getMyLanguageTestScore,
+    enabled: true,
     staleTime: Infinity,
     select: (data) => data.data.languageTestScoreStatusResponseList,
+    ...props,
   });
 };
 

apps/web/src/apis/applications/api.ts

@@ -1,15 +1,20 @@
 import type { AxiosResponse } from "axios";
-import type { ApplicationListResponse } from "@/types/application";
+import type { ApplicationListResponse, ApplicationPreviewResponse } from "@/types/application";
 import { axiosInstance } from "@/utils/axiosInstance";
 
 // ====== Query Keys ======
 export const ApplicationsQueryKeys = {
   competitorsApplicationList: "competitorsApplicationList",
+  applicationPreview: "applicationPreview",
 } as const;
 
 // ====== Types ======
 export interface UseSubmitApplicationResponse {
-  isSuccess: boolean;
+  totalApplyCount: number;
+  applyCount: number;
+  appliedUniversities: {
+    choices: string[];
+  };
 }
 
 export interface UseSubmitApplicationRequest {
@@ -37,6 +42,13 @@ export const applicationsApi = {
     return axiosInstance.get("/applications");
   },
 
+  /**
+   * 지원자가 있는 대학의 제한 공개 정보 조회
+   */
+  getApplicationPreview: async (): Promise<AxiosResponse<ApplicationPreviewResponse>> => {
+    return axiosInstance.get("/applications/preview");
+  },
+
   /**
    * 지원 제출
    */

apps/web/src/apis/applications/getApplicationPreview.ts

@@ -0,0 +1,17 @@
+import { useQuery } from "@tanstack/react-query";
+import type { AxiosError } from "axios";
+import type { ApplicationPreviewResponse } from "@/types/application";
+import { ApplicationsQueryKeys, applicationsApi } from "./api";
+
+const useGetApplicationPreview = () => {
+  return useQuery<ApplicationPreviewResponse, AxiosError<{ message: string }>>({
+    queryKey: [ApplicationsQueryKeys.applicationPreview],
+    queryFn: async () => {
+      const response = await applicationsApi.getApplicationPreview();
+      return response.data;
+    },
+    staleTime: 1000 * 60 * 5,
+  });
+};
+
+export default useGetApplicationPreview;

apps/web/src/apis/applications/index.ts

@@ -1,5 +1,6 @@
 export type { UseSubmitApplicationRequest, UseSubmitApplicationResponse } from "./api";
 export { ApplicationsQueryKeys, applicationsApi } from "./api";
 export { default as useGetApplicationsList } from "./getApplicants";
+export { default as useGetApplicationPreview } from "./getApplicationPreview";
 export { default as useGetCompetitors } from "./getCompetitors";
 export { default as usePostSubmitApplication } from "./postSubmitApplication";

apps/web/src/app/my/school-email/_lib/returnTo.ts

@@ -1,5 +1,6 @@
 export const SCHOOL_EMAIL_RETURN_PATHS = {
   applicationApply: "/university/application/apply",
+  applicationStatus: "/university/application",
   score: "/university/score",
   gpaSubmit: "/university/score/submit/gpa",
 } as const;