refactor: 네트워크 요청 최적화 및 Prefetch 추가 (#313) (#316)

* refactor: 영상 캐시 키와 진입 prefetch 정리 (#313)

* refactor: useSlides 폴링 옵션을 분리 적용 (#313)

* refactor: 대본 캐시 재사용으로 상세 요청 축소 (#313)

* refactor: 공유 댓글 조회를 쿼리로 통합 (#313)

* refactor: 대본 일괄수정 scripts 재요청 방지 (#313)

* design: 대본 패널 active/컨트롤 스타일 정리 (#313)

* test: API 최적화 회귀 가드 추가 (#313)

* fix: Update src/pages/feedback/useFeedbackSlide.ts

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* test: 401 에러 핸들러 기대값 정리 (#313)

* fix: Lint 오류 수정 (#313)

* Update src/pages/VideoListPage.tsx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/pages/VideoListPage.tsx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/hooks/queries/useScript.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* refactor: 비디오 목록 캐시 업데이트 헬퍼 추출 (#313)

* fix: 공유 영상 제목 누락 시 상세 조회 보정 (#313)

* refactor: 대본 저장 캐시를 프로젝트 단위로 갱신 (#313)

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

src/api/errorHandler.test.ts

@@ -30,24 +30,21 @@ describe('handleApiError', () => {
   });
 
   describe('401 handling', () => {
-    it('calls logout and shows toast when logged in', () => {
+    it('does not logout and falls back to generic toast when logged in', () => {
       // Set logged in state
       useAuthStore
         .getState()
         .login({ id: '1', email: 'user@google.com', sessionId: 's1' }, 'some-token');
 
       handleApiError(401, '');
 
-      expect(useAuthStore.getState().accessToken).toBeNull();
-      expect(showToast.error).toHaveBeenCalledWith(
-        '로그인이 만료되었습니다.',
-        '다시 로그인해주세요.',
-      );
+      expect(useAuthStore.getState().accessToken).toBe('some-token');
+      expect(showToast.error).toHaveBeenCalledWith('요청을 처리하지 못했습니다.', '');
     });
 
-    it('does nothing when not logged in', () => {
+    it('falls back to generic toast when not logged in', () => {
       handleApiError(401, '');
-      expect(showToast.error).not.toHaveBeenCalled();
+      expect(showToast.error).toHaveBeenCalledWith('요청을 처리하지 못했습니다.', '');
     });
   });
 

src/api/queryClient.test.ts

@@ -60,6 +60,22 @@ describe('queryKeys', () => {
     });
   });
 
+  describe('videos', () => {
+    it('builds list prefix key with projectId', () => {
+      expect(queryKeys.videos.listPrefix('p1')).toEqual(['videos', 'list', 'p1']);
+    });
+
+    it('builds list key with params', () => {
+      expect(
+        queryKeys.videos.list('p1', { search: 'abc', filter: 'ready', sort: 'recent' }),
+      ).toEqual(['videos', 'list', 'p1', { search: 'abc', filter: 'ready', sort: 'recent' }]);
+    });
+
+    it('builds list key without params', () => {
+      expect(queryKeys.videos.list('p1')).toEqual(['videos', 'list', 'p1', {}]);
+    });
+  });
+
   describe('shares', () => {
     it('builds content key with sessionId', () => {
       expect(queryKeys.shares.content('token1', 'sess1')).toEqual([

src/api/queryClient.ts

@@ -69,7 +69,8 @@ export const queryKeys = {
     all: ['scripts'] as const,
     detail: (slideId: string) => [...queryKeys.scripts.all, 'detail', slideId] as const,
     versions: (slideId: string) => [...queryKeys.scripts.all, 'versions', slideId] as const,
-    project: (projectId: string) => [...queryKeys.scripts.all, 'project', projectId] as const,
+    projects: () => [...queryKeys.scripts.all, 'project'] as const,
+    project: (projectId: string) => [...queryKeys.scripts.projects(), projectId] as const,
   },
   presentations: {
     all: ['presentations'] as const,
@@ -87,7 +88,15 @@ export const queryKeys = {
   videos: {
     all: ['videos'] as const,
     lists: () => [...queryKeys.videos.all, 'list'] as const,
-    list: (projectId: string) => [...queryKeys.videos.lists(), projectId] as const,
+    listPrefix: (projectId: string) => [...queryKeys.videos.lists(), projectId] as const,
+    list: (
+      projectId: string,
+      params?: {
+        search?: string;
+        filter?: string;
+        sort?: string;
+      },
+    ) => [...queryKeys.videos.listPrefix(projectId), params ?? {}] as const,
     details: () => [...queryKeys.videos.all, 'detail'] as const,
     detail: (videoId: string) => [...queryKeys.videos.details(), videoId] as const,
     slides: (videoId: number) => [...queryKeys.videos.all, 'slides', videoId] as const,

src/components/common/layout/Gnb.tsx

@@ -10,6 +10,7 @@ import { Link, useLocation, useParams } from 'react-router-dom';
 import clsx from 'clsx';
 
 import { TABS, getTabFromPathname, getTabPath } from '@/constants/navigation';
+import { useProjectEntryPrefetch } from '@/hooks/queries/useProjectEntryPrefetch';
 
 export function Gnb() {
   const { projectId } = useParams<{ projectId: string }>();
@@ -18,6 +19,8 @@ export function Gnb() {
   const activeIndex = TABS.findIndex((tab) => tab.key === activeTab);
   const safeActiveIndex = activeIndex >= 0 ? activeIndex : 0;
 
+  useProjectEntryPrefetch(projectId);
+
   if (!projectId) return null;
 
   return (

src/components/slide/SlideWorkspace.tsx

@@ -7,11 +7,11 @@
  * - ScriptBox 접힘 상태를 관리하고 SlideViewer에 전달
  * - Zustand store로 슬라이드 상태 관리
  */
-import { useEffect, useRef, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 
 import { SLIDE_MAX_WIDTH } from '@/constants/layout';
 import { useSlideActions, useSlideId, useSlideScript } from '@/hooks';
-import { useScript } from '@/hooks/queries/useScript';
+import { useProjectScripts, useScript } from '@/hooks/queries/useScript';
 import { useSlideCommentsLoader } from '@/hooks/useSlideCommentsLoader';
 import type { SlideListItem } from '@/types/slide';
 
@@ -28,24 +28,42 @@ export default function SlideWorkspace({ slide, isLoading }: SlideWorkspaceProps
   const { initSlide, updateScript, updateSlide } = useSlideActions();
   const slideId = useSlideId();
   const script = useSlideScript();
-  const { data: scriptData } = useScript(slideId);
   const lastSyncedSlideIdRef = useRef<string>('');
   const lastSyncedScriptRef = useRef<string | null>(null);
 
+  const projectId = slide?.projectId ?? '';
+  const currentSlideId = slide?.slideId ?? '';
+  const { data: projectScripts } = useProjectScripts(projectId, {
+    enabled: !!projectId,
+    staleTime: 1000 * 60 * 10,
+  });
+
+  const projectScript = useMemo(() => {
+    if (!currentSlideId) return undefined;
+    return projectScripts?.scripts.find((item) => item.slideId === currentSlideId)?.scriptText;
+  }, [projectScripts, currentSlideId]);
+
+  const shouldFetchDetailScript = !projectScript && !slide?.script;
+  const { data: scriptData } = useScript(currentSlideId, {
+    enabled: shouldFetchDetailScript,
+    staleTime: 1000 * 60 * 10,
+  });
+
+  const resolvedServerScript = projectScript ?? slide?.script ?? scriptData?.scriptText ?? '';
+
   useEffect(() => {
     if (!slide) return;
+    const nextSlide =
+      resolvedServerScript !== slide.script ? { ...slide, script: resolvedServerScript } : slide;
 
     const isSameSlide = slide.slideId === slideId;
     if (isSameSlide) {
-      updateSlide(slide);
+      updateSlide(nextSlide);
       return;
     }
 
-    initSlide(slide);
-    updateScript('');
-  }, [slide, slideId, initSlide, updateScript, updateSlide]);
-
-  useSlideCommentsLoader(slide?.slideId);
+    initSlide(nextSlide);
+  }, [slide, slideId, initSlide, resolvedServerScript, updateSlide]);
 
   useEffect(() => {
     if (lastSyncedSlideIdRef.current !== slideId) {
@@ -55,21 +73,23 @@ export default function SlideWorkspace({ slide, isLoading }: SlideWorkspaceProps
   }, [slideId]);
 
   useEffect(() => {
-    if (!scriptData) return;
+    if (!slideId) return;
 
-    const serverScript = scriptData.scriptText;
+    const serverScript = resolvedServerScript;
     const hasSyncedOnce = lastSyncedScriptRef.current !== null;
     const hasLocalEditAfterSync = hasSyncedOnce && script !== lastSyncedScriptRef.current;
 
-    // 로컬 편집이 있는 동안에는 서버 응답으로 덮어쓰지 않습니다.
+    // 로컬 편집 중에는 서버 값으로 덮어쓰지 않습니다.
     if (hasLocalEditAfterSync && script !== serverScript) return;
 
     if (script !== serverScript) {
       updateScript(serverScript);
     }
 
     lastSyncedScriptRef.current = serverScript;
-  }, [script, scriptData, updateScript]);
+  }, [resolvedServerScript, script, slideId, updateScript]);
+
+  useSlideCommentsLoader(slide?.slideId);
 
   return (
     <div className="relative h-full min-h-0 flex flex-col pb-[clamp(12rem,30vh,20rem)] md:pb-0">

src/components/slide/script/ScriptBoxContent.tsx

@@ -40,15 +40,15 @@ export default function ScriptBoxContent() {
           onBlur={flushSave}
           placeholder="슬라이드 대본을 입력하세요..."
           aria-label="슬라이드 대본"
-          className="h-full w-full resize-none overflow-y-auto border-none bg-transparent pb-8 pr-28 text-base leading-relaxed text-gray-800 outline-none placeholder:text-gray-600"
+          className="h-full w-full resize-none overflow-y-auto border-none bg-transparent pb-8 text-base leading-relaxed text-gray-800 outline-none placeholder:text-gray-600"
         />
 
-        <div className="absolute bottom-3 right-4">
+        <div className="pointer-events-none absolute bottom-3 right-4 z-10">
           <button
             type="button"
             onClick={() => setIsSpeedModalOpen(true)}
             aria-label={`읽기 속도 설정 열기 (현재 예상 시간 ${estimatedDuration})`}
-            className="inline-flex min-h-9 items-center gap-2 rounded-md bg-white px-3 py-1.5 text-gray-700 transition-colors hover:bg-gray-100 active:bg-gray-200 focus-visible:outline-2 focus-visible:outline-main"
+            className="pointer-events-auto inline-flex min-h-9 items-center gap-2 rounded-full border border-gray-200 bg-white/95 px-3 py-1.5 text-gray-700 shadow-xs backdrop-blur-sm transition-colors hover:bg-gray-100 active:bg-gray-200 focus-visible:outline-2 focus-visible:outline-main"
           >
             <span aria-live="polite" aria-atomic="true" className="text-sm font-semibold leading-4">
               {estimatedDuration}

src/components/slide/script/ScriptReadingSpeedModal.tsx

@@ -111,7 +111,13 @@ export default function ScriptReadingSpeedModal({ isOpen, onClose }: ScriptReadi
             step={1}
             value={selectedSpeed}
             onChange={(event) => setSelectedSpeed(Number(event.target.value))}
-            className="h-2 w-full cursor-pointer accent-main"
+            className={clsx(
+              'block h-2 w-full cursor-pointer appearance-none rounded-full border border-gray-200 bg-gray-100',
+              '[&::-webkit-slider-runnable-track]:h-2 [&::-webkit-slider-runnable-track]:rounded-full [&::-webkit-slider-runnable-track]:bg-transparent',
+              '[&::-moz-range-track]:h-2 [&::-moz-range-track]:rounded-full [&::-moz-range-track]:border-0 [&::-moz-range-track]:bg-transparent',
+              '[&::-webkit-slider-thumb]:-mt-1.25 [&::-webkit-slider-thumb]:h-4 [&::-webkit-slider-thumb]:w-4 [&::-webkit-slider-thumb]:appearance-none [&::-webkit-slider-thumb]:rounded-full [&::-webkit-slider-thumb]:border [&::-webkit-slider-thumb]:border-main [&::-webkit-slider-thumb]:bg-main',
+              '[&::-moz-range-thumb]:h-4 [&::-moz-range-thumb]:w-4 [&::-moz-range-thumb]:rounded-full [&::-moz-range-thumb]:border [&::-moz-range-thumb]:border-main [&::-moz-range-thumb]:bg-main',
+            )}
           />
           <div className="flex items-center justify-between text-caption text-gray-600">
             <span>매우 느리게</span>

src/components/video/RecordingSection.tsx

@@ -4,10 +4,10 @@ import IconArrowLeft from '@/assets/icons/icon-arrow-left.svg?react';
 import IconArrowRight from '@/assets/icons/icon-arrow-right.svg?react';
 import { Logo, SlideImage } from '@/components/common';
 import { usePresentation } from '@/hooks/queries/usePresentations';
-import { useScript } from '@/hooks/queries/useScript';
+import { useProjectScripts } from '@/hooks/queries/useScript';
 import { useSlides } from '@/hooks/queries/useSlides';
+import { useRecorder } from '@/hooks/useRecorder';
 
-import { useRecorder } from '../../hooks/useRecorder';
 import StopButton from './StopButton';
 
 interface SlideData {
@@ -40,11 +40,32 @@ export const RecordingSection = ({
   const { isRecording, startRecording, stopRecording, getRecordedBlob } = useRecorder();
 
   const { data: presentation } = usePresentation(projectId);
-  const { data: slidesData } = useSlides(projectId);
-  const slidesList = useMemo(
-    () => slidesData?.map((slide) => ({ id: slide.slideId, url: slide.imageUrl })) ?? [],
-    [slidesData],
+  const { data: slidesData, isLoading: isSlidesLoading } = useSlides(projectId, {
+    liveSync: false,
+  });
+  const { data: projectScripts, isLoading: isProjectScriptsLoading } = useProjectScripts(
+    projectId,
+    {
+      enabled: !!projectId,
+      staleTime: 1000 * 60 * 10,
+    },
   );
+  const slidesList = useMemo(() => {
+    const projectScriptMap = new Map(
+      (projectScripts?.scripts ?? []).map((scriptItem) => [
+        String(scriptItem.slideId),
+        scriptItem.scriptText ?? '',
+      ]),
+    );
+
+    return (
+      slidesData?.map((slide) => ({
+        id: slide.slideId,
+        url: slide.imageUrl,
+        script: projectScriptMap.get(String(slide.slideId)) ?? slide.script ?? '',
+      })) ?? []
+    );
+  }, [projectScripts, slidesData]);
   const totalPages = slidesList.length > 0 ? slidesList.length : 1;
 
   const [currentPage, setCurrentPage] = useState<number>(1);
@@ -56,9 +77,10 @@ export const RecordingSection = ({
   const [isFinishing, setIsFinishing] = useState<boolean>(false);
 
   const formatTime = (s: number) => `${Math.floor(s / 60)}:${(s % 60).toString().padStart(2, '0')}`;
-
-  const currentSlideId = slidesList[currentPage - 1]?.id;
-  const { data: scriptData } = useScript(currentSlideId ?? '');
+  const currentSlideScript = slidesList[currentPage - 1]?.script ?? '';
+  const isScriptLoading = isSlidesLoading || isProjectScriptsLoading;
+  const scriptDisplayText =
+    currentSlideScript || (isScriptLoading ? '대본 불러오는 중...' : '대본이 없습니다.');
 
   // 녹화 시작 및 첫 로그 생성 함수
   const startRecordingWithLog = useCallback(
@@ -316,7 +338,7 @@ export const RecordingSection = ({
               <h3 className="text-body-s-bold text-gray-800">발표 대본</h3>
             </div>
             <div className="scrollbar-hide flex-1 overflow-y-auto text-body-m leading-normal text-black whitespace-pre-wrap">
-              {scriptData?.scriptText || '대본이 없습니다.'}
+              {scriptDisplayText}
             </div>
           </div>
 

src/hooks/UseSlideSelectors.test.tsx

@@ -8,6 +8,7 @@ import {
   useSlideActions,
   useSlideComments,
   useSlideId,
+  useSlideProjectId,
   useSlideScript,
   useSlideThumb,
   useSlideTitle,
@@ -31,6 +32,11 @@ describe('useSlideSelectors', () => {
       expect(result.current).toBe('');
     });
 
+    it('useSlideProjectId returns empty string', () => {
+      const { result } = renderHook(() => useSlideProjectId());
+      expect(result.current).toBe('');
+    });
+
     it('useSlideThumb returns empty string', () => {
       const { result } = renderHook(() => useSlideThumb());
       expect(result.current).toBe('');
@@ -70,6 +76,11 @@ describe('useSlideSelectors', () => {
       expect(result.current).toBe('Test Title');
     });
 
+    it('useSlideProjectId returns projectId', () => {
+      const { result } = renderHook(() => useSlideProjectId());
+      expect(result.current).toBe(slide.projectId);
+    });
+
     it('useSlideThumb returns imageUrl', () => {
       const { result } = renderHook(() => useSlideThumb());
       expect(result.current).toBe('https://img.url');

src/hooks/queries/useProjectEntryPrefetch.ts

@@ -0,0 +1,36 @@
+import { useEffect, useRef } from 'react';
+
+import { useQueryClient } from '@tanstack/react-query';
+
+import { getProjectScripts } from '@/api/endpoints/scripts';
+import { getSlides } from '@/api/endpoints/slides';
+import { queryKeys } from '@/api/queryClient';
+
+/**
+ * 프로젝트 진입 시 슬라이드/대본 데이터를 한 번 미리 적재합니다.
+ */
+export function useProjectEntryPrefetch(projectId?: string) {
+  const queryClient = useQueryClient();
+  const prefetchedProjectIdsRef = useRef<Set<string>>(new Set());
+
+  useEffect(() => {
+    if (!projectId) return;
+    if (prefetchedProjectIdsRef.current.has(projectId)) return;
+
+    prefetchedProjectIdsRef.current.add(projectId);
+
+    void Promise.all([
+      queryClient.prefetchQuery({
+        queryKey: queryKeys.slides.list(projectId),
+        queryFn: () => getSlides(projectId),
+      }),
+      queryClient.prefetchQuery({
+        queryKey: queryKeys.scripts.project(projectId),
+        queryFn: () => getProjectScripts(projectId),
+      }),
+    ]).catch(() => {
+      // 실패 시 재시도 가능하도록 가드를 해제합니다.
+      prefetchedProjectIdsRef.current.delete(projectId);
+    });
+  }, [projectId, queryClient]);
+}