[Admin/FE] 큐레이션 스펙 version 기반 브라우저 캐시

[bottlenote-app]

배경

Admin 큐레이션 작성 화면은 목록 API와 선택 스펙 상세 schema를 사용한다. 현재는 작성 화면 진입 시 목록 query가 별도 key로 다시 실행될 수 있고, 브라우저를 재시작하면 상세 schema를 다시 요청한다.

목표

• 브라우저 localStorage에 큐레이션 스펙 manifest와 상세 schema를 adminId scope로 저장한다.
• 목록 API의 id/code/version/isActive를 manifest로 비교해 version 변경·신규·비활성 스펙만 갱신한다.
• 목록/상세 version이 같은 경우 저장된 상세 schema를 재사용한다.
• canonical 목록 query를 재사용해 작성 화면의 중복 목록 요청을 제거한다.

범위

• 재검증 간격: 1시간 및 탭 재포커스
• detail query key: specId + version
• malformed/만료 browser storage 안전 복구
• localStorage에는 스펙 manifest/detail만 저장하며 토큰·사용자 데이터·큐레이션 본문은 저장하지 않는다.

제외

• 서버 ETag/Cache-Control 변경
• SSE/WebSocket 실시간 invalidation
• QueryClient 전체 persistence

[bottlenote-app]

구현 PR을 생성했습니다: bottle-note/admin-dashboard#92

• version manifest + localStorage 상세 schema cache
• 동일 version cache hit 시 상세 API 요청 생략
• version 변경/inactive 감지 시 해당 상세 cache만 갱신
• 전체 unit test 43 files / 316 tests 통과, dev build 통과

[Whale0928]

시음회·프로그램 스펙 내용이 바뀌면서 version을 2 → 3으로 올렸습니다 (#344).

버전을 올리지 않으면 이미 캐시한 어드민에게 변경이 반영되지 않는 상황이 실제로 발생했습니다. 이번엔 조치했지만, 스펙 내용 변경 시 version 승격을 강제하는 규칙이 필요합니다. #322에 남겨뒀습니다.

참고로 CurationSpecResourceReader가 major 자리만 사용하므로 2.1.0이 아니라 3.0.0처럼 major를 올려야 합니다.