Feat(client): acorns 추가 알림 tooltip window focus 될 때 뜨도록 변경

[constantly-dev]

📌 Related Issues

관련된 Issue를 태그해주세요. (e.g. - close #25)

• close [Feat] 도토리 툴팁 open 조건 window 창 focus로 변경 #305

📄 Tasks

• acorns 추가 알림 tooltip window focus 될 때 뜨도록 변경

⭐ PR Point (To Reviewer)

• 아티클 읽는 updateToReadStatus API 함수 설정에 invalidateQueries 제거하여 바로 반영 안되도록 하였습니다.
• useGetAcorns에 refetchOnWindowFocus 옵션을 줘 pinback dashboard window가 focus될 때 refetch하도록 하였습니다.
• usePutArticleReadStatus에 refetchType: 'none', 옵션을 통해 stale 상태로 변경은 하지만 refetch는 안되도록 설정하였습니다.

시나리오

1. 사용자가 Pinback 대시보드에서 아티클 카드를 클릭합니다.
2. 클릭 직후 window.open(article.url, '_blank')로 아티클이 새 탭/새 창에서 열립니다.
3. 동시에 기존 탭에서는 updateToReadStatus가 호출되어 해당 아티클의 read status를 즉시 변경합니다.
4. 이때 acorns 쿼리는 바로 refetch하지 않고, refetchType: 'none'으로 stale 상태만 표시합니다.
5. 따라서 사용자가 아티클을 클릭한 직후에는 기존 Pinback 대시보드 탭의 Sidebar에서 도토리 개수가 즉시 갱신되지 않고, 풍선 토스트도 뜨지 않습니다.
6. 이후 사용자가 다시 Pinback 대시보드 탭으로 돌아오면, useGetAcorns의 refetchOnWindowFocus에 의해 acorns가 다시 조회됩니다.
7. 이 시점에 최신 acornCount가 반영되고, 이전 값보다 증가한 경우에만 Sidebar의 풍선 토스트가 표시됩니다.

Summary by CodeRabbit

릴리스 노트

• Refactor
  • 북마크 데이터 캐시 관리 최적화로 불필요한 새로고침 제거
  • 창 포커스 시 데이터 자동 동기화 개선

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
pinback-client-client	Ready	Preview, Comment	Mar 10, 2026 11:21am
pinback-client-landing	Ready	Preview, Comment	Mar 10, 2026 11:21am

[coderabbitai]

Walkthrough

도토리(acorns) 쿼리의 캐시 및 리페치 동작을 조정했습니다. MyBookmarkContent에서 도토리 캐시 무효화를 제거하고, queries.ts에서 윈도우 포커스 시 자동 리페치를 활성화하며 무효화 시 자동 리페치를 비활성화했습니다.

Changes

Cohort / File(s)	Summary
도토리 캐시 무효화 제거 apps/client/src/pages/myBookmark/components/myBookmarkContent/MyBookmarkContent.tsx	updateToReadStatus 성공 핸들러에서 ['acorns'] 캐시 무효화 로직 제거
도토리 쿼리 리페치 동작 조정 apps/client/src/shared/apis/queries.ts	useGetAcorns 쿼리에 refetchOnWindowFocus: true 추가, usePutArticleReadStatus의 도토리 캐시 무효화에 refetchType: 'none' 추가

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

• Feat(Client): remind aticle list 수정 #284: 동일한 쿼리/훅(useGetAcorns)과 캐시 키(['acorns']) 변경을 포함하고 있어 관련성이 높습니다.
• Api(client): 아티클 읽음 상태 변경 API 연결 #96: 본 PR에서 수정하는 도토리 리페치/무효화 동작이 #96에서 도입된 읽음 상태 변경 뮤테이션 흐름과 연계되어 있습니다.
• Feat(client): 나의 북마크 관련 API v3로 변경 및 연결 #278: 도토리 쿼리의 캐시 무효화/리페치 설정을 함께 수정하고 있습니다.

Suggested reviewers

• jllee000
• jjangminii

Poem

🐰 도토리 쏟아지는 창 열릴 때마다
새로운 보물을 찾아내네요
캐시는 스마트하게, 리페치는 똑똑하게
토끼의 수고로움 조금 덜었다는 게 기쁨이에요! ✨🌰

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목이 변경 사항의 주요 목적(도토리 추가 알림 tooltip을 window focus 시에 표시하도록 변경)을 명확하게 반영하고 있습니다.
Linked Issues check	✅ Passed	코드 변경 사항이 #305의 요구사항(도토리 툴팁을 window focus 조건으로 변경)을 충족하고 있습니다. #25는 연결되어 있으나 본 PR과는 관련이 없습니다.
Out of Scope Changes check	✅ Passed	모든 코드 변경 사항이 #305의 요구사항(window focus 시 도토리 툴팁 표시)과 관련된 범위 내에 있으며, 불필요한 변경은 없습니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	PR 설명이 필수 섹션(Related Issues, Tasks, PR Point)을 모두 포함하고 있으며, 변경사항의 의도와 구현 시나리오가 명확하게 설명되어 있습니다.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/#305-acorns-tooltip-window-focus-open

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

✅ Storybook chromatic 배포 확인:
🐿️ storybook

[jjangminii]

저도 refetchOnWindowFocus: true 이걸로 테스트 해봤을 때 왜 안되나 했었는데 invalidateQueries이걸 까먹고 있었네요,, 👍 👍