fix: 일정 변경사항 Task를 줄입니다.

packages/client/src/entities/schedule/api/schedule.ts

@@ -0,0 +1,26 @@
+import { useQuery } from '@tanstack/react-query';
+import { fetchBasketOpenDate, fetchCurrentPeriod, fetchPreSeatOpenDate } from '../lib/manageSchedule';
+
+export function useCurrentPeriod() {
+  return useQuery({
+    queryKey: ['currentPeriod'],
+    queryFn: fetchCurrentPeriod,
+    staleTime: Infinity,
+  });
+}
+
+export function usePreSeatOpenDate() {
+  return useQuery({
+    queryKey: ['preSeatOpenDate'],
+    queryFn: fetchPreSeatOpenDate,
+    staleTime: Infinity,
+  });
+}
+
+export function useBasketOpenDate() {
+  return useQuery({
+    queryKey: ['basketOpenDate'],
+    queryFn: fetchBasketOpenDate,
+    staleTime: Infinity,
+  });
+}

packages/client/src/entities/schedule/lib/getMainPageActionsMode.ts

@@ -0,0 +1,37 @@
+import { ServiceMode, ServicePeriod } from './manageSchedule';
+
+interface MainAction {
+  label: string;
+  link: string;
+}
+
+/**
+ * 메인 페이지에서 보여지는 액션 버튼의 모드를 반환하는 함수입니다.
+ * 각 수강 신청 기간에 따라 다른 액션 버튼이 메인 페이지에 표시됩니다.
+ * @param mode
+ * @returns
+ */
+export const getMainPageActionsMode = (mode: ServicePeriod['mode']): MainAction[] => {
+  switch (mode) {
+    case ServiceMode.WISHLIST:
+      return [
+        { label: '관심과목 담기', link: '/wishlist' },
+        { label: '수강 신청 연습하기', link: '/simulation' },
+      ];
+
+    case ServiceMode.REGISTRATION_SENIOR:
+    case ServiceMode.REGISTRATION_ALL:
+    case ServiceMode.REGISTRATION_FRESHMAN:
+    case ServiceMode.CORRECTION:
+      return [
+        { label: '실시간 여석 확인하기', link: '/live' },
+        { label: '수강 신청 연습하기', link: '/simulation' },
+      ];
+
+    default:
+      return [
+        { label: '전체 학년 여석 확인하기', link: '/live' },
+        { label: '수강 신청 연습하기', link: '/simulation' },
+      ];
+  }
+};

packages/client/src/entities/schedule/lib/manageSchedule.ts

@@ -0,0 +1,89 @@
+export enum ServiceMode {
+  WISHLIST = 'wishlist',
+  REGISTRATION_SENIOR = 'registration-senior',
+  REGISTRATION_ALL = 'registration-all',
+  REGISTRATION_FRESHMAN = 'registration-freshman',
+  CORRECTION = 'correction',
+}
+
+export interface ServicePeriod {
+  start: string;
+  end: string;
+  mode: ServiceMode;
+  description: string;
+}
+
+/**
+ * periods: 수강 신청과 관련된 각 기간의 시작과 끝, 그리고 해당 기간의 모드와 설명
+ * displayPeriod: 메인 배너의 수강 신청 기간
+ * CURRENT_PERIOD의 start, end 필드는 매 학기  일정이 나오면 업데이트 되어야합니다.
+ */
+export interface AcademicSchedule {
+  periods: ServicePeriod[];
+
+  displayPeriod: {
+    displayPeriodName?: string; // '수강 신청 기간' or '수강 정정 기간''
+    start: string; // '02월 10일(화)'
+    end: string; // '02월 13일(금)'
+  };
+}
+
+export const CURRENT_PERIOD: AcademicSchedule = {
+  periods: [
+    {
+      start: '2026-01-27T10:00:00',
+      end: '2026-02-09T16:59:59',
+      mode: ServiceMode.WISHLIST,
+      description: '관심과목 담기 기간',
+    },
+    {
+      start: '2026-02-10T10:00:00',
+      end: '2026-02-12T16:59:59',
+      mode: ServiceMode.REGISTRATION_SENIOR,
+      description: '4~1학년 수강신청 기간',
+    },
+    {
+      start: '2026-02-13T10:00:00',
+      end: '2026-02-26T16:59:59',
+      mode: ServiceMode.REGISTRATION_ALL,
+      description: '전체학년 수강신청 기간',
+    },
+    {
+      start: '2026-02-27T10:00:00',
+      end: '2026-02-27T16:59:59',
+      mode: ServiceMode.REGISTRATION_FRESHMAN,
+      description: '신입생 수강신청 기간',
+    },
+    {
+      start: '2026-03-04T10:00:00',
+      end: '2026-03-09T16:59:59',
+      mode: ServiceMode.CORRECTION,
+      description: '수강정정 기간',
+    },
+  ],
+
+  displayPeriod: {
+    displayPeriodName: '수강정정 기간',
+    start: '03월 04일(수)',
+    end: '03월 09일(월)',
+  },
+};
+
+//preSeat 데이터 업데이트 시 preSeatOpenDate를 변경해주어야합니다.
+export const PRESEAT_OPEN_DATE = new Date('2026-03-09T00:00:00');
+
+// basket 데이터 업데이트 시 basketOpenDate를 변경해주어야합니다.
+export const BASKET_OPEN_DATE = new Date('2026-01-31T00:00:00');
+
+// API 연결 확장성을 위해 fetchCurrentPeriod, fetchPreSeatOpenDate, fetchBasketOpenDate 함수를 만들어두었습니다.
+export const fetchCurrentPeriod = async (): Promise<AcademicSchedule> => {
+  return CURRENT_PERIOD;
+};
+
+export const fetchPreSeatOpenDate = async (): Promise<Date> => {
+  return PRESEAT_OPEN_DATE;
+};
+
+export const fetchBasketOpenDate = async (): Promise<Date> => {
+  return BASKET_OPEN_DATE;
+};

packages/client/src/entities/schedule/model/useManagePeriod.ts

@@ -0,0 +1,31 @@
+import { useBasketOpenDate } from '../api/schedule';
+import { getMainPageActionsMode } from '../lib/getMainPageActionsMode';
+import { usePreSeatInfo } from './usePreSeatInfo';
+import { useServiceMode } from './useServiceMode';
+
+/**
+ *
+ * @returns
+ * period: 메인 배너 수강 신청 기간
+ * mainPageRouter: 메인 페이지 라우터 정보
+ * preSeat: 전체 여석 오픈, 클로즈 여부 및 시간
+ * basket: 관심 과목 오픈 날짜
+ */
+export function useManagePeriod() {
+  const { serviceMode, registrationDisplayPeriod } = useServiceMode();
+  const preSeat = usePreSeatInfo();
+  const { data: basketOpenDate } = useBasketOpenDate();
+
+  return {
+    period: {
+      registrationDisplayPeriod,
+    },
+    mainPageRouter: {
+      mainPageActionsMode: getMainPageActionsMode(serviceMode),
+    },
+    preSeat,
+    basket: {
+      basketOpenDate,
+    },
+  };
+}

packages/client/src/entities/schedule/model/usePreSeatInfo.ts

@@ -0,0 +1,44 @@
+import { useCurrentPeriod, usePreSeatOpenDate } from '../api/schedule';
+import { ServiceMode, ServicePeriod } from '../lib/manageSchedule';
+
+export function usePreSeatInfo() {
+  const now = new Date();
+  const { data: currentPeriodData } = useCurrentPeriod();
+  const { data: preSeatOpenDate } = usePreSeatOpenDate();
+
+  const periods = currentPeriodData?.periods ?? [];
+
+  const transitionPairs: [ServiceMode, ServiceMode][] = [
+    [ServiceMode.REGISTRATION_SENIOR, ServiceMode.REGISTRATION_ALL],
+    [ServiceMode.REGISTRATION_ALL, ServiceMode.REGISTRATION_FRESHMAN],
+    [ServiceMode.REGISTRATION_FRESHMAN, ServiceMode.CORRECTION],
+  ];
+
+  let shouldPreparePreSeat = false;
+  let livePeriodStart: string | null = null;
+
+  for (const [beforeMode, afterMode] of transitionPairs) {
+    const beforePeriod = periods.find((p: ServicePeriod) => p.mode === beforeMode);
+    const afterPeriod = periods.find((p: ServicePeriod) => p.mode === afterMode);
+
+    if (!beforePeriod || !afterPeriod) continue;
+
+    if (
+      now > new Date(beforePeriod.end) &&
+      now < new Date(afterPeriod.start) &&
+      preSeatOpenDate &&
+      preSeatOpenDate <= now
+    ) {
+      shouldPreparePreSeat = true;
+      livePeriodStart = afterPeriod.start;
+      break;
+    }
+  }
+
+  return {
+    shouldPreparePreSeat,
+    preSeatCloseDate: livePeriodStart?.split('T')[0] ?? '',
+    preSeatCloseTime: livePeriodStart?.split('T')[1]?.slice(0, 5) ?? '',
+    preSeatOpenDate,
+  };
+}

packages/client/src/entities/schedule/model/useServiceMode.ts

@@ -0,0 +1,26 @@
+import { useCurrentPeriod } from '../api/schedule';
+import { ServiceMode, ServicePeriod } from '../lib/manageSchedule';
+
+/**
+ * 전체 학년 수강 신청 기간, 신입생 수강 신청 기간, 수강 정정 기간 등 각 기간에 따른 모드를 반환하는 커스텀 훅입니다.
+ * @returns
+ */
+export const useServiceMode = () => {
+  const now = new Date();
+  const { data: currentPeriodData } = useCurrentPeriod();
+
+  const currentPeriod =
+    currentPeriodData?.periods.find((period: ServicePeriod) => {
+      const start = new Date(period.start);
+      const end = new Date(period.end);
+      return now >= start && now <= end;
+    }) || null;
+
+  const currentMode = currentPeriod?.mode || ServiceMode.WISHLIST;
+
+  return {
+    activePeriod: currentPeriod,
+    serviceMode: currentMode,
+    registrationDisplayPeriod: currentPeriodData?.displayPeriod,
+  };
+};

packages/client/src/entities/seat/api/usePreRealSeats.ts

@@ -1,5 +1,6 @@
 import { useQuery } from '@tanstack/react-query';
 import { fetchJsonOnPublic } from '@/shared/api/api.ts';
+import { useManagePeriod } from '@/entities/schedule/model/useManagePeriod';
 
 const SEC = 1000;
 const MIN = 60 * SEC;
@@ -19,16 +20,19 @@ export const InitPreRealSeat: IPreRealSeat = {
 };
 
 function usePreRealSeats() {
+  const { preSeat } = useManagePeriod();
+
   return useQuery({
     queryKey: ['preRealSeats'],
-    queryFn: fetchPreRealSeats,
+    queryFn: () => fetchPreRealSeats(preSeat.preSeatOpenDate),
     staleTime: 10 * MIN,
     select: data => data?.preSeats ?? null,
   });
 }
 
-async function fetchPreRealSeats(): Promise<IPreRealSeatsResponse> {
-  return await fetchJsonOnPublic<IPreRealSeatsResponse>('/pre-seats.json?date=20260215');
+async function fetchPreRealSeats(preSeatOpenDate: Date): Promise<IPreRealSeatsResponse> {
+  //preSeat 데이터 업데이트 시 preSeatOpenDate를 변경해주어야합니다.
+  return await fetchJsonOnPublic<IPreRealSeatsResponse>(`/pre-seats.json?date=${preSeatOpenDate}`);
 }
 
 export default usePreRealSeats;

packages/client/src/entities/subjects/ui/SubjectDetail.tsx

@@ -1,7 +1,7 @@
 import React from 'react';
 import { InitWishes } from '@/entities/wishes/model/useWishes.ts';
 import { WishesWithSeat } from '@/entities/subjectAggregate/model/useWishesPreSeats.ts';
-import usePreSeatGate from '@/widgets/live/preSeat/model/usePreSeatGate';
+import { useManagePeriod } from '@/entities/schedule/model/useManagePeriod';
 import { getSeatColor } from '@/shared/config/colors.ts';
 import { Flex } from '@allcll/allcll-ui';
 
@@ -13,7 +13,8 @@ interface ISubjectDetailProps {
 function SubjectDetail({ wishes }: ISubjectDetailProps) {
   const data = wishes ?? InitWishes;
   const hasPreSeats = wishes && 'seat' in wishes;
-  const { isPreSeatAvailable } = usePreSeatGate({ hasSeats: hasPreSeats });
+  const { preSeat } = useManagePeriod();
+  const isPreSeatAvailable = preSeat.shouldPreparePreSeat && Boolean(hasPreSeats);
 
   const seats = hasPreSeats ? wishes.seat : -1;
 

packages/client/src/entities/wishes/api/wishes.ts

@@ -6,11 +6,9 @@ export interface WishesApiResponse {
   baskets: { subjectId: number; totalCount: number }[];
 }
 
-// baskets.json 파일 업데이트 시 반드시 `CACHE_VERSION` 값을 함께 변경해주세요.
-const CACHE_VERSION = 'SPRING_26_20260131';
-
-export const fetchWishesDataBySemester = async (semester: string) => {
-  return await fetchJsonOnPublic<WishesApiResponse>(`/${semester}/baskets.json?v=${CACHE_VERSION}`);
+// baskets.json 파일 업데이트 시 반드시 `BASKET_OPEN_DATE` 값을 함께 변경해주세요.
+export const fetchWishesDataBySemester = async (semester: string, basketOpenDate: Date) => {
+  return await fetchJsonOnPublic<WishesApiResponse>(`/${semester}/baskets.json?v=${basketOpenDate}`);
 };
 
 interface DetailRegistersResponse {

packages/client/src/entities/wishes/model/useWishes.ts

@@ -4,6 +4,7 @@ import useSubject, { InitSubject } from '@/entities/subjects/model/useSubject.ts
 import { joinData } from '@/entities/subjectAggregate/lib/joinSubjects.ts';
 import { fetchWishesDataBySemester, WishesApiResponse } from '@/entities/wishes/api/wishes.ts';
 import { RECENT_SEMESTERS } from '@/entities/semester/api/semester';
+import { useManagePeriod } from '@/entities/schedule/model/useManagePeriod';
 
 export const InitWishes = {
   ...InitSubject,
@@ -15,10 +16,11 @@ export const InitWishes = {
 function useWishes(semester?: string) {
   semester = semester ?? RECENT_SEMESTERS.semesterCode;
   const { data: subjects, isPending, isLoading } = useSubject(semester);
+  const { basket } = useManagePeriod();
 
   const query = useQuery({
     queryKey: ['wishlist', semester],
-    queryFn: () => fetchWishesDataBySemester(semester),
+    queryFn: () => fetchWishesDataBySemester(semester, basket.basketOpenDate),
     staleTime: Infinity,
     select: data => joinSubjects(data, subjects),
   });

packages/client/src/features/wish/lib/useHeaderSelector.ts

@@ -1,14 +1,15 @@
 import { Wishes } from '@/shared/model/types.ts';
 import { useWishesTableStore } from '../model/useWishTableColumnStore';
 import { IPreRealSeat } from '@/entities/seat/api/usePreRealSeats';
-import usePreSeatGate from '@/widgets/live/preSeat/model/usePreSeatGate';
+import { useManagePeriod } from '@/entities/schedule/model/useManagePeriod';
 
 /** 사용하는 헤더를 반환해줍니다. 기간에 따라, wishes, pre-seats 변경 가능 */
 function useHeaderSelector(data: Wishes[] | (Wishes & IPreRealSeat)[] | null | undefined) {
   const tableTitles = useWishesTableStore(state => state.tableTitles);
   const hasPreSeats = !!(data && data[0] && 'seat' in data[0]);
   const isWishesAvailable = data && data[0] && 'totalCount' in data[0];
-  const { isPreSeatAvailable } = usePreSeatGate({ hasSeats: hasPreSeats });
+  const { preSeat } = useManagePeriod();
+  const isPreSeatAvailable = preSeat.shouldPreparePreSeat && hasPreSeats;
 
   let visibleCols = [{ title: '', visible: true, key: '' }, ...tableTitles.filter(col => col.visible)];
   if (!isWishesAvailable) {

packages/client/src/pages/live/Live.tsx

@@ -7,13 +7,13 @@ import { Helmet } from 'react-helmet';
 import PinSearchBottomSheet from '@/widgets/live/pin/ui/PinSearchBottomSheet';
 import RealtimeTable from '@/widgets/live/board/ui/RealtimeTable';
 import useAlarmModalStore from '@/features/live/pin/model/useAlarmModalStore';
-import usePreSeatGate from '@/widgets/live/preSeat/model/usePreSeatGate';
+import { useManagePeriod } from '@/entities/schedule/model/useManagePeriod';
 
 function Live() {
   const isSearchOpen = useAlarmModalStore(state => state.isSearchOpen);
   const setIsSearchOpen = useAlarmModalStore(state => state.setIsSearchOpen);
   const isMobile = useMobile();
-  const { isPreSeatAvailable } = usePreSeatGate();
+  const { preSeat } = useManagePeriod();
 
   return (
     <>
@@ -41,7 +41,7 @@ function Live() {
           <LivePinnedCourses />
 
           <Grid columns={{ base: 1 }} gap="gap-4">
-            <LiveMainContent isPreSeatAvailable={isPreSeatAvailable} />
+            <LiveMainContent isPreSeatAvailable={preSeat.shouldPreparePreSeat} />
           </Grid>
         </Flex>