refactor(graduate): QA 오류 수정 및 파일 구조 개편

apps/graduate/package.json

@@ -25,11 +25,12 @@
     "antd": "^5.24.8",
     "axios": "^1.13.2",
     "crypto-js": "^4.2.0",
-    "dayjs": "^1.11.18",
+    "dayjs": "^1.11.19",
     "lucide-react": "^0.503.0",
     "motion": "^12.23.24",
     "pdfjs-dist": "3.11.174",
     "react": "^19.0.0",
+    "react-big-calendar": "^1.19.4",
     "react-dom": "^19.0.0",
     "react-hook-form": "^7.56.1",
     "react-quill-new": "^3.6.0",
@@ -44,6 +45,7 @@
     "@types/crypto-js": "^4.2.2",
     "@types/node": "^22.10.2",
     "@types/react": "^19.0.8",
+    "@types/react-big-calendar": "^1.16.3",
     "@types/react-dom": "^19.0.3",
     "@vanilla-extract/vite-plugin": "^5.0.1",
     "@vitejs/plugin-react": "^5.0.4",

apps/graduate/src/admin/entities/admin-schedule/api/fetchScheduleDetail.ts

@@ -0,0 +1,15 @@
+import { AxiosResponse } from 'axios';
+
+import { get } from '~/shared/api';
+import { END_POINT } from '~/shared/constants';
+
+import { ScheduleItem } from '~/admin/pages/schedule/model';
+type ScheduleDetailResponse = ScheduleItem;
+
+export async function fetchScheduleDetail(
+  scheduleId: number,
+): Promise<AxiosResponse<ScheduleDetailResponse>> {
+  return get<ScheduleDetailResponse>({
+    request: END_POINT.USER.SCHEDULE(scheduleId),
+  });
+}

apps/graduate/src/admin/entities/admin-schedule/api/fetchScheduleList.ts

@@ -0,0 +1,18 @@
+import { AxiosResponse } from 'axios';
+
+import { get } from '~/shared/api';
+import { END_POINT } from '~/shared/constants';
+
+import { ScheduleItem } from '~/admin/pages/schedule/model';
+
+export interface ScheduleListResponse {
+  contents: ScheduleItem[];
+}
+
+export async function fetchScheduleList(): Promise<
+  AxiosResponse<ScheduleListResponse>
+> {
+  return get<ScheduleListResponse>({
+    request: END_POINT.USER.SCHEDULE_LIST,
+  });
+}

apps/graduate/src/admin/entities/admin-schedule/api/index.ts

@@ -0,0 +1,2 @@
+export * from './fetchScheduleDetail';
+export * from './fetchScheduleList';

apps/graduate/src/shared/hooks/schedule/index.ts → apps/graduate/src/admin/entities/admin-schedule/model/index.ts

@@ -1,3 +1,2 @@
 export { useScheduleList } from './useScheduleList';
 export { useScheduleDetail } from './useScheduleDetail';
-export { useScheduleContent } from './useScheduleContent';

apps/graduate/src/shared/hooks/schedule/useScheduleDetail.ts → apps/graduate/src/admin/entities/admin-schedule/model/useScheduleDetail.ts

@@ -1,13 +1,14 @@
 import { useQuery } from '@tanstack/react-query';
 
-import { getScheduleDetail } from '~/shared/api';
-import { KEYS } from '~/shared/constants';
+import { scheduleKeys } from '~/shared/queries/schedule';
+
+import { fetchScheduleDetail } from '../api';
 
 export function useScheduleDetail(scheduleId: number) {
   return useQuery({
-    queryKey: [...KEYS.SCHEDULE, scheduleId],
+    queryKey: scheduleKeys.detail(scheduleId),
     queryFn: async () => {
-      const response = await getScheduleDetail(scheduleId);
+      const response = await fetchScheduleDetail(scheduleId);
       return response.data;
     },
     enabled: !!scheduleId,

apps/graduate/src/admin/entities/admin-schedule/model/useScheduleList.ts

@@ -0,0 +1,15 @@
+import { useQuery } from '@tanstack/react-query';
+
+import { scheduleKeys } from '~/shared/queries/schedule';
+
+import { fetchScheduleList } from '../api/fetchScheduleList';
+
+export function useScheduleList() {
+  return useQuery({
+    queryKey: scheduleKeys.list(),
+    queryFn: async () => {
+      const response = await fetchScheduleList();
+      return response.data.contents ?? [];
+    },
+  });
+}

apps/graduate/src/admin/entities/graduation-approval/api/index.ts

@@ -0,0 +1 @@
+export * from './updateGraduationBatchApproval';

apps/graduate/src/shared/api/student/updateGraduationUsersBatchApprove.ts → apps/graduate/src/admin/entities/graduation-approval/api/updateGraduationBatchApproval.ts

@@ -1,18 +1,18 @@
 import { patch } from '~/shared/api';
 import { END_POINT } from '~/shared/constants';
 
-type UpdateGraduationUsersBatchApproveRequest = {
+type UpdateGraduationBatchApprovalRequest = {
   ids: number[];
 };
 
-type UpdateGraduationUsersBatchApproveResponse = {
+type UpdateGraduationBatchApprovalResponse = {
   approvedIds: number[];
 };
 
-export const updateGraduationUsersBatchApprove = async (ids: number[]) => {
+export const updateGraduationBatchApproval = async (ids: number[]) => {
   const response = await patch<
-    UpdateGraduationUsersBatchApproveResponse,
-    UpdateGraduationUsersBatchApproveRequest
+    UpdateGraduationBatchApprovalResponse,
+    UpdateGraduationBatchApprovalRequest
   >({
     request: END_POINT.ADMIN.GRADUATION_USERS_BATCH_APPROVE,
     data: { ids },

apps/graduate/src/admin/entities/graduation-approval/model/index.ts

@@ -0,0 +1,2 @@
+export * from './useGraduationApproval';
+export * from './useGraduationBatchApproval';

apps/graduate/src/shared/hooks/student/useApproveGraduationUsers.ts → apps/graduate/src/admin/entities/graduation-approval/model/useGraduationApproval.ts

@@ -1,5 +1,9 @@
 import { createElement } from 'react';
 
+import { useToast } from '~/shared/hooks';
+
+import { useGraduationBatchApproval } from './useGraduationBatchApproval';
+
 import {
   APPROVE_ALERT,
   APPROVE_CONFIRM_TITLE,
@@ -16,10 +20,7 @@ import {
   APPROVE_RESULT_NOT_APPROVED,
   APPROVE_RESULT_TITLE,
   APPROVE_SUCCESS,
-} from '~/shared/components/Toolbar/toolbarTexts';
-
-import { useToast } from '../useToast';
-import { useUpdateGraduationUsersBatchApprove } from './useUpdateGraduationUsersBatchApprove';
+} from '~/admin/shared/ui/Toolbar/toolbarTexts';
 
 type UseApproveGraduationUsersProps<T> = {
   items: T[];
@@ -39,7 +40,7 @@ type NotApprovedDetail = {
   reason: string;
 };
 
-export function useApproveGraduationUsers<T>({
+export function useGraduationApproval<T>({
   items,
   selectedIds,
   getId,
@@ -48,7 +49,7 @@ export function useApproveGraduationUsers<T>({
   onSuccess,
 }: UseApproveGraduationUsersProps<T>) {
   const { toast, confirm, info } = useToast();
-  const { approveGraduationUsers } = useUpdateGraduationUsersBatchApprove({
+  const { approveGraduationUsers } = useGraduationBatchApproval({
     onSuccess,
   });
 

apps/graduate/src/shared/hooks/student/useUpdateGraduationUsersBatchApprove.ts → apps/graduate/src/admin/entities/graduation-approval/model/useGraduationBatchApproval.ts

@@ -1,22 +1,21 @@
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 
-import { updateGraduationUsersBatchApprove } from '~/shared/api';
-import { KEYS } from '~/shared/constants';
+import { graduationUsersKeys } from '~/shared/queries';
+
+import { updateGraduationBatchApproval } from '../api';
 
 type Options = {
   onSuccess?: () => void | Promise<void>;
 };
 
-export function useUpdateGraduationUsersBatchApprove({
-  onSuccess,
-}: Options = {}) {
+export function useGraduationBatchApproval({ onSuccess }: Options = {}) {
   const queryClient = useQueryClient();
 
   const mutation = useMutation({
-    mutationFn: updateGraduationUsersBatchApprove,
+    mutationFn: updateGraduationBatchApproval,
     onSuccess: async () => {
       await queryClient.invalidateQueries({
-        queryKey: [...KEYS.GRADUATION_USERS],
+        queryKey: graduationUsersKeys.all,
       });
       await onSuccess?.();
     },

apps/graduate/src/shared/api/student/fetchGraduationUsers.ts → apps/graduate/src/admin/entities/graduation-users/api/fetchGraduationUsers.ts

@@ -1,6 +1,6 @@
 import { get } from '~/shared/api';
 import { END_POINT, GraduationType } from '~/shared/constants';
-import type { StudentStatus } from '~/shared/types';
+import type { SubmissionStatus } from '~/shared/types/graduation';
 
 export type GraduationLabelType = '미정' | '논문' | '자격증';
 
@@ -10,7 +10,7 @@ export type GraduationUserSummary = {
   name: string;
   graduationDate: string;
   graduationType: GraduationLabelType;
-  status?: StudentStatus;
+  status?: SubmissionStatus;
 };
 
 export type PageableResponse = {

apps/graduate/src/shared/api/student/index.ts → apps/graduate/src/admin/entities/graduation-users/api/index.ts

@@ -1,6 +1,4 @@
-export * from './fetchAdminUsers';
 export * from './fetchGraduationUsers';
 export * from './fetchGraduationUsersExcel';
 export * from './removeGraduationUser';
 export * from './removeGraduationUsersBatch';
-export * from './updateGraduationUsersBatchApprove';

apps/graduate/src/admin/entities/graduation-users/model/index.ts

@@ -0,0 +1,2 @@
+export * from './useFetchGraduationUsers';
+export * from './useRemoveGraduationUsers';

apps/graduate/src/shared/hooks/student/useFetchGraduationUsers.ts → apps/graduate/src/admin/entities/graduation-users/model/useFetchGraduationUsers.ts

@@ -1,15 +1,16 @@
 import { useQuery } from '@tanstack/react-query';
 
+import { graduationUsersKeys } from '~/shared/queries';
+
 import {
-  fetchGraduationUsers,
   type FetchGraduationUsersParams,
   type GraduationUserSummaryPageResponse,
-} from '~/shared/api';
-import { KEYS } from '~/shared/constants';
+} from '~/admin/entities/graduation-users/api';
+import { fetchGraduationUsers } from '~/admin/entities/graduation-users/api';
 
 export function useFetchGraduationUsers(params: FetchGraduationUsersParams) {
   return useQuery<GraduationUserSummaryPageResponse>({
-    queryKey: [...KEYS.GRADUATION_USERS, params],
+    queryKey: graduationUsersKeys.list(params),
     queryFn: () => fetchGraduationUsers(params),
   });
 }

apps/graduate/src/shared/hooks/student/useRemoveGraduationUsers.ts → apps/graduate/src/admin/entities/graduation-users/model/useRemoveGraduationUsers.ts

@@ -1,7 +1,11 @@
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 
-import { removeGraduationUser, removeGraduationUsersBatch } from '~/shared/api';
-import { KEYS } from '~/shared/constants';
+import { graduationUsersKeys } from '~/shared/queries';
+
+import {
+  removeGraduationUser,
+  removeGraduationUsersBatch,
+} from '~/admin/entities/graduation-users/api';
 
 type Options = {
   onSuccess?: () => void | Promise<void>;
@@ -20,7 +24,7 @@ export function useRemoveGraduationUsers({ onSuccess }: Options = {}) {
     },
     onSuccess: async () => {
       await queryClient.invalidateQueries({
-        queryKey: [...KEYS.GRADUATION_USERS],
+        queryKey: graduationUsersKeys.all,
       });
       await onSuccess?.();
     },

apps/graduate/src/feature/studentDetail/hooks/useStudentDetail.ts → apps/graduate/src/admin/features/studentDetail/hooks/useStudentDetail.ts

@@ -1,12 +1,12 @@
 import { useQuery } from '@tanstack/react-query';
 
-import { KEYS } from '~/shared/constants';
+import { studentKeys } from '~/shared/queries/student';
 
 import { getStudentDetail } from '../api';
 
 export function useStudentDetail(studentId: number) {
   return useQuery({
-    queryKey: [...KEYS.STUDENT_DETAIL, studentId],
+    queryKey: studentKeys.detail(studentId),
     queryFn: async () => {
       const response = await getStudentDetail(studentId);
       return response.data;

apps/graduate/src/feature/studentDetail/types/studentDetail.ts → apps/graduate/src/admin/features/studentDetail/types/studentDetail.ts

@@ -1,4 +1,4 @@
-import type { StudentStatus } from '~/shared/types';
+import type { SubmissionStatus } from '~/shared/types/graduation';
 
 export interface StudentDetailApiResponse {
   graduationUserId: number;
@@ -8,5 +8,5 @@ export interface StudentDetailApiResponse {
   advisor: string;
   major: string;
   capstoneCompletion: boolean;
-  status: StudentStatus;
+  status: SubmissionStatus;
 }

apps/graduate/src/pages/admin/all/constants/allManagementColumns.tsx → apps/graduate/src/admin/pages/all/constants/allManagementColumns.tsx

@@ -1,5 +1,3 @@
-import type { Column } from '~/shared/components/DataTable/DataTable';
-
 import {
   HEADER_NAME,
   HEADER_NO,
@@ -9,6 +7,7 @@ import {
 } from './allManagementTexts';
 import type { AllManagementRow } from '../types/allManagement';
 
+import type { Column } from '~/admin/shared/ui/DataTable/DataTable';
 import { vars } from '~/vars.css';
 
 export const allManagementColumns = (

apps/graduate/src/pages/admin/all/constants/allManagementTexts.ts → apps/graduate/src/admin/pages/all/constants/allManagementTexts.ts

@@ -1,7 +1,7 @@
-import { GraduationLabelType } from '~/shared/api';
-
 import type { AllManagementRow } from '../types/allManagement';
 
+import { type GraduationLabelType } from '~/admin/entities/graduation-users/api';
+
 export const STATUS_UNKNOWN = '미정';
 
 export const STATUS_CERTIFICATE_NOT_SUBMITTED = '자격증-미제출';