프로젝트 내 다양한 API 데이터 특성에 맞추어 staleTime과 gcTime을 세분화하여 관리하고 있습니다. src/lib/react-query/config.ts 의 상수를 기반으로 각 페이지 화면(훅)별 적용 사례와 그 이유를 정리했습니다.

1. 거의 변하지 않는 정적 데이터 (STATIC / Infinity)

• 적용 대상: 상품 상세 정보(useProduct), 서비스 약관 내용(useTerms)
• 설정값: staleTime: 30분 ~ Infinity / gcTime: 1시간
• 적용 이유:
  • 상품 정보나 약관 내용은 사용자가 앱을 이용하는 동안 실시간으로 바뀔 확률이 거의 없는 정적인 데이터입니다.
  • Infinity나 30분 등 긴 staleTime을 부여하여 탭 전환이나 뒤로 가기 시 발생하는 불필요한 네트워크 요청(Refetch)을 완벽히 차단합니다. 또한 긴 gcTime을 두어 가비지 콜렉터가 메모리에서 캐시를 너무 일찍 비우는 것을 방지, 히트율을 높입니다.

2. 준정적 데이터 (SEMI_STATIC)

• 적용 대상: 배송지 목록(useDeliveryAddress), 약관 동의 여부(useTermsAgreement)
• 설정값: staleTime: 5분 / gcTime: 5분 (기본값)
• 적용 이유:
  • 사용자가 주소지를 추가하거나 약관에 새롭게 동의하는 등 오직 사용자 직접 액션에 의해서만 변경되는 데이터입니다.
  • 외부 요인(타인 개입)으로 바뀔 일이 적으므로 5분 정도의 여유로운 staleTime을 부여하여, 단기간 내 화면 간 이동에서 중복 호출을 막습니다.

3. 결정론적 데이터 (DETERMINISTIC)

• 적용 대상: 배송비 로직(useDeliveryFee)
• 설정값: staleTime: 10분 / gcTime: 30분
• 적용 이유:
  • 입력값(우편번호, 총 상품 금액)이 들어가면 API 응답 결과(배송비)도 항상 동일한(Deterministic) 순수 함수 형태의 성격을 가집니다.
  • 사용자가 결제창 상단에서 금액이나 주소를 잠깐 바꿨다가 원래대로 되돌렸을 때도 똑같은 API를 또 찌르지 않도록, 긴 10분의 넉넉한 staleTime을 설계하여 최적화했습니다.

4. 실시간성을 요하는 동적 데이터 (DYNAMIC)

• 적용 대상: 주문 목록(useOrders), 일반 주문 상세(useOrder)
• 설정값: staleTime: 1분 (서버 컴포넌트 프리패치 기본값과 동일 세팅)
• 적용 이유:
  • 주문의 상태(배송 준비 중, 결제 취소 등)는 사용자 본인뿐만 아니라 관리자(Admin)나 택배사 등 외부 요인에 의해 시시각각 변할 수 있는 동적 데이터입니다.
  • 너무 긴 시간의 staleTime을 주면 브라우저를 다시 띄웠을 때 과거 상태를 관측하는 버그가 생길 수 있습니다. 따라서 1분의 짧은 제한을 주어, 항상 어느 정도의 최신 동기화 상태를 유지합니다.

5. 즉각적인 변화 감지를 위한 실시간 폴링 (REALTIME)

• 적용 대상: PG/카드 결제 직후 진입하는 주문 상세 폴링 상태 (useOrder의 pollUntilPaid 옵션)