[feature] 관리자 캘린더 연동 탭에 Notion DB 선택/캘린더 표시 기능 추가

frontend/src/apis/calendarOAuth.ts

@@ -0,0 +1,267 @@
+import API_BASE_URL from '@/constants/api';
+import { secureFetch } from './auth/secureFetch';
+import { handleResponse } from './utils/apiHelpers';
+
+export interface GoogleCalendarItem {
+  id: string;
+  summary: string;
+  primary?: boolean;
+}
+
+export interface GoogleEventItem {
+  id: string;
+  summary?: string;
+  htmlLink?: string;
+  start?: {
+    dateTime?: string;
+    date?: string;
+  };
+  end?: {
+    dateTime?: string;
+    date?: string;
+  };
+}
+
+export interface NotionSearchItem {
+  id: string;
+  object: string;
+  url?: string;
+  last_edited_time?: string;
+  properties?: Record<string, unknown>;
+}
+
+export interface NotionDatabaseOption {
+  id: string;
+  title: string;
+}
+
+export const fetchGoogleCalendarList = async (accessToken: string) => {
+  const response = await fetch(
+    'https://www.googleapis.com/calendar/v3/users/me/calendarList',
+    {
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+    },
+  );
+
+  if (!response.ok) {
+    throw new Error('Google 캘린더 목록 조회에 실패했습니다.');
+  }
+
+  const data = await response.json();
+  return (data.items ?? []) as GoogleCalendarItem[];
+};
+
+export const fetchGooglePrimaryEvents = async (accessToken: string) => {
+  const query = new URLSearchParams({
+    maxResults: '10',
+    singleEvents: 'true',
+    orderBy: 'startTime',
+    timeMin: new Date().toISOString(),
+  });
+
+  const response = await fetch(
+    `https://www.googleapis.com/calendar/v3/calendars/primary/events?${query.toString()}`,
+    {
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+    },
+  );
+
+  if (!response.ok) {
+    throw new Error('Google 캘린더 이벤트 조회에 실패했습니다.');
+  }
+
+  const data = await response.json();
+  return (data.items ?? []) as GoogleEventItem[];
+};
+
+interface NotionTokenRequest {
+  code: string;
+}
+
+interface NotionTokenResponse {
+  accessToken?: string;
+  workspaceName?: string;
+  workspaceId?: string;
+}
+
+interface NotionAuthorizeResponse {
+  authorizeUrl: string;
+}
+
+interface NotionPagesPayload {
+  items?: NotionSearchItem[];
+  results?: NotionSearchItem[];
+  total_results?: number;
+  totalResults?: number;
+  database_id?: string;
+  databaseId?: string;
+}
+
+interface NotionDatabasePayload {
+  id: string;
+  object?: string;
+  title?: Array<{ plain_text?: string }>;
+}
+
+export interface NotionPagesResponse {
+  items: NotionSearchItem[];
+  totalResults: number;
+  databaseId?: string;
+}
+
+export const fetchNotionAuthorizeUrl = async (state?: string) => {
+  const params = new URLSearchParams();
+  if (state) {
+    params.set('state', state);
+  }
+
+  const url = `${API_BASE_URL}/api/integration/notion/oauth/authorize${params.toString() ? `?${params.toString()}` : ''}`;
+  const response = await secureFetch(url, {
+    method: 'GET',
+    headers: {
+      Accept: 'application/json',
+    },
+  });
+
+  const data = await handleResponse<NotionAuthorizeResponse>(
+    response,
+    'Notion 인가 URL 생성에 실패했습니다.',
+  );
+
+  if (!data?.authorizeUrl) {
+    throw new Error('Notion 인가 URL이 비어있습니다.');
+  }
+  return data.authorizeUrl;
+};
+
+export const exchangeNotionCode = async ({ code }: NotionTokenRequest) => {
+  const response = await secureFetch(
+    `${API_BASE_URL}/api/integration/notion/oauth/token`,
+    {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        code,
+      }),
+    },
+  );
+
+  const data = await handleResponse<NotionTokenResponse>(
+    response,
+    'Notion 토큰 교환에 실패했습니다.',
+  );
+  return data;
+};
+
+export const fetchNotionPages = async () => {
+  const response = await secureFetch(
+    `${API_BASE_URL}/api/integration/notion/pages`,
+    {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json',
+      },
+    },
+  );
+
+  const data = await handleResponse<NotionPagesPayload | NotionSearchItem[]>(
+    response,
+    'Notion 데이터 조회에 실패했습니다.',
+  );
+  if (Array.isArray(data)) {
+    return {
+      items: data,
+      totalResults: data.length,
+    } satisfies NotionPagesResponse;
+  }
+
+  const items = (data?.items ?? data?.results ?? []) as NotionSearchItem[];
+  const totalResults =
+    data?.total_results ?? data?.totalResults ?? items.length;
+  const databaseId = data?.database_id ?? data?.databaseId;
+  return {
+    items,
+    totalResults,
+    databaseId,
+  } satisfies NotionPagesResponse;
+};
+
+export const fetchNotionDatabasePages = async ({
+  databaseId,
+  dateProperty,
+}: {
+  databaseId: string;
+  dateProperty?: string;
+}) => {
+  const params = new URLSearchParams();
+  if (dateProperty) {
+    params.set('dateProperty', dateProperty);
+  }
+
+  const query = params.toString();
+  const response = await secureFetch(
+    `${API_BASE_URL}/api/integration/notion/databases/${databaseId}/pages${query ? `?${query}` : ''}`,
+    {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json',
+      },
+    },
+  );
+
+  const data = await handleResponse<NotionPagesPayload | NotionSearchItem[]>(
+    response,
+    'Notion 데이터베이스 페이지 조회에 실패했습니다.',
+  );
+
+  if (Array.isArray(data)) {
+    return {
+      items: data,
+      totalResults: data.length,
+      databaseId,
+    } satisfies NotionPagesResponse;
+  }
+
+  const items = (data?.items ?? data?.results ?? []) as NotionSearchItem[];
+  const totalResults =
+    data?.total_results ?? data?.totalResults ?? items.length;
+  const resolvedDatabaseId =
+    data?.database_id ?? data?.databaseId ?? databaseId;
+  return {
+    items,
+    totalResults,
+    databaseId: resolvedDatabaseId,
+  } satisfies NotionPagesResponse;
+};
+
+export const fetchNotionDatabases = async () => {
+  const response = await secureFetch(
+    `${API_BASE_URL}/api/integration/notion/databases`,
+    {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json',
+      },
+    },
+  );
+
+  const data = await handleResponse<
+    { results?: NotionDatabasePayload[] } | NotionDatabasePayload[]
+  >(response, 'Notion 데이터베이스 목록 조회에 실패했습니다.');
+
+  const databases = Array.isArray(data) ? data : (data?.results ?? []);
+  return databases.map((database) => ({
+    id: database.id,
+    title:
+      database.title
+        ?.map((segment) => segment.plain_text ?? '')
+        .join('')
+        .trim() || '(이름 없는 데이터베이스)',
+  })) as NotionDatabaseOption[];
+};

frontend/src/pages/AdminPage/AdminRoutes.tsx

@@ -5,6 +5,7 @@ import ApplicantDetailPage from '@/pages/AdminPage/tabs/ApplicantsTab/ApplicantD
 import ApplicantsListTab from '@/pages/AdminPage/tabs/ApplicantsTab/ApplicantsListTab/ApplicantsListTab';
 import ApplicationEditTab from '@/pages/AdminPage/tabs/ApplicationEditTab/ApplicationEditTab';
 import ApplicationListTab from '@/pages/AdminPage/tabs/ApplicationListTab/ApplicationListTab';
+import CalendarSyncTab from '@/pages/AdminPage/tabs/CalendarSyncTab/CalendarSyncTab';
 import ClubInfoEditTab from '@/pages/AdminPage/tabs/ClubInfoEditTab/ClubInfoEditTab';
 import PhotoEditTab from '@/pages/AdminPage/tabs/PhotoEditTab/PhotoEditTab';
 import RecruitEditTab from '@/pages/AdminPage/tabs/RecruitEditTab/RecruitEditTab';
@@ -18,6 +19,7 @@ export default function AdminRoutes() {
         <Route index element={<Navigate to='club-info' replace />} />
         <Route path='club-info' element={<ClubInfoEditTab />} />
         <Route path='recruit-edit' element={<RecruitEditTab />} />
+        <Route path='calendar-sync' element={<CalendarSyncTab />} />
         <Route path='photo-edit' element={<PhotoEditTab />} />
         <Route path='account-edit' element={<AccountEditTab />} />
         <Route path='application-list' element={<ApplicationListTab />} />

frontend/src/pages/AdminPage/components/SideBar/SideBar.tsx

@@ -23,6 +23,7 @@ const tabs: TabCategory[] = [
       { label: '기본 정보 수정', path: '/admin/club-info' },
       { label: '소개 정보 수정', path: '/admin/club-intro' },
       { label: '활동 사진 수정', path: '/admin/photo-edit' },
+      { label: '동아리 일정 관리', path: '/admin/calendar-sync' },
     ],
   },
   {