refactor(recruit): 모집 상태 API 및 스키마 코드 위치 변경 (#17)

스키마와 api 파일 모두 recruitment-status에서 recruitment로 이동

Author: DandelionQZ

apps/recruit/src/app/(home)/_components/RecruitmentActive.tsx

@@ -18,7 +18,7 @@ export const RecruitmentActive = () => {
 
   const [isModalOpen, setIsModalOpen] = useState(false);
   const {data: recruitmentStatus} = useRecruitmentStatusQuery();
-  const generation = recruitmentStatus?.data?.generationId ?? '';
+  const generation = recruitmentStatus?.generationId ?? '';
 
   const {isAuthenticated} = useAuthStore();
 

apps/recruit/src/app/apply/_hooks/useApplyFormController.ts

@@ -28,7 +28,7 @@ import {
 } from '@/hooks/mutations/useApply.mutation';
 import {useQueryClient} from '@tanstack/react-query';
 import {QUERY_KEYS} from '@/constants/query-keys';
-import {getRecruitmentStatus} from '@/services/api/recruitment/recruitment-status.api';
+import {getRecruitmentStatus} from '@/services/api/recruitment/recruitment.api';
 import {ROUTES} from '@/constants/routes';
 
 interface UseApplyFormControllerReturn {
@@ -133,7 +133,7 @@ export const useApplyFormController = (): UseApplyFormControllerReturn => {
         staleTime: 0, // 항상 서버에서 최신 데이터 가져오기
       });
 
-      if (!latest.data.isActive) {
+      if (!latest.isActive) {
         alert('모집 기간이 종료되었습니다.');
         router.push(ROUTES.HOME);
         return false;

apps/recruit/src/hooks/queries/useRecruitmentStatus.query.ts

@@ -2,7 +2,7 @@ import {useQuery} from '@tanstack/react-query';
 import {useRecruitmentStore} from '@/store/useRecruitmentStore';
 import {useEffect} from 'react';
 import {QUERY_KEYS} from '@/constants/query-keys';
-import {getRecruitmentStatus} from '@/services/api/recruitment/recruitment-status.api';
+import {getRecruitmentStatus} from '@/services/api/recruitment/recruitment.api';
 
 export const useRecruitmentStatusQuery = (options?: {
   refetchInterval?: number;
@@ -19,9 +19,9 @@ export const useRecruitmentStatusQuery = (options?: {
 
   // 서버 데이터로 store 동기화
   useEffect(() => {
-    if (query.data?.data) {
+    if (query.data) {
       const {isActive, generationId, isAdditionalRecruitmentActive} =
-        query.data.data;
+        query.data;
 
       setIsRecruiting(isActive);
       setIsAdditional(isAdditionalRecruitmentActive);

apps/recruit/src/schemas/recruitment/recruitment.schema.ts

@@ -1,7 +1,16 @@
 import z from 'zod';
 
+export const RecruitmentStatusResponseSchema = z.object({
+  isActive: z.boolean(),
+  generationId: z.number().nullable(),
+  isAdditionalRecruitmentActive: z.boolean(),
+});
+
 export const RecruitmentNotifyRequestSchema = z.object({email: z.email()});
 
+export type RecruitmentStatusResponse = z.infer<
+  typeof RecruitmentStatusResponseSchema
+>;
 export type RecruitmentNotifyRequest = z.infer<
   typeof RecruitmentNotifyRequestSchema
 >;

apps/recruit/src/schemas/status/recruitment-status.schema.ts

@@ -1,7 +1,42 @@
-import {RecruitmentNotifyRequest} from '@/schemas/recruitment/recruitment.schema';
+import {createSuccessResponseSchema} from '@/schemas/common/common-schema';
+import {
+  RecruitmentNotifyRequest,
+  RecruitmentStatusResponse,
+  RecruitmentStatusResponseSchema,
+} from '@/schemas/recruitment/recruitment.schema';
 import {publicAxios} from '@/services/config/axios';
 import {ENDPOINT} from '@/services/constant/endpoint';
 import {handleApiError} from '@/services/utils/apiHelper';
+import {AxiosResponse} from 'axios';
+
+/**
+ * 모집 상태 조회
+ * - 모집 종료/시작 여부는 최종 제출 시점에 반드시 재확인 필요
+ */
+export const getRecruitmentStatus =
+  async (): Promise<RecruitmentStatusResponse> => {
+    try {
+      const response: AxiosResponse = await publicAxios.get(
+        ENDPOINT.RECRUITMENT.STATUS,
+        {
+          params: {_ts: Date.now()},
+          headers: {
+            'Cache-Control': 'no-cache',
+            Pragma: 'no-cache',
+          },
+        }
+      );
+
+      const responseSchema = createSuccessResponseSchema(
+        RecruitmentStatusResponseSchema
+      );
+      const validatedResponse = responseSchema.parse(response.data);
+
+      return validatedResponse.data;
+    } catch (error) {
+      return handleApiError(error);
+    }
+  };
 
 /** 모집 알림 구독 신청 */
 export const postRecruitmentNotify = async (