Skip to content

fix: onboarding query key 네이밍을 도메인명과 정렬 #67

Description

@haewonwon

배경

도메인 문서 기준명을 onboarding-settingsonboarding으로 정리했습니다 (AGENTS.md, docs/conventions/domains.md, docs/architecture/folder-structure.md, docs/overview.md).

다만 코드에는 React Query key 네임스페이스가 아직 이전 이름을 사용하고 있습니다.

현재 상태

// src/domains/onboarding/api/query-keys.ts
export const onboardingSettingsQueryKeys = {
  all: ['onboarding-settings'] as const,
  // ...
};

사용처:

  • src/domains/onboarding/api/queries.ts
  • src/domains/onboarding/api/mutations.ts

제안

다른 도메인(measurement, daily-memo)과 동일하게 도메인 폴더명을 query key root로 사용합니다.

항목 현재 제안
query key root 'onboarding-settings' 'onboarding'
export명 onboardingSettingsQueryKeys onboardingQueryKeys
하위 키 recovery-methods, sleep-condition 유지

이유

  • query key root는 API 엔드포인트명(setting-onboarding)이 아니라 도메인 네임스페이스로 두는 것이 프로젝트 컨벤션과 일치
  • 문서상 onboarding 도메인 = 최초 저장(/onboarding) + 이후 선호값 수정(setting-onboarding API)을 담당
  • 하위 키가 이미 데이터 슬라이스를 구분하므로 root에 -settings 접미사 불필요

영향

  • query key 문자열 변경으로 기존 in-memory 캐시가 한 번 무효화됨 (개발/앱 재시작 수준, 실질 리스크 낮음)
  • 코드 변경 범위: query-keys.ts, queries.ts, mutations.ts import/참조

작업 체크리스트

  • onboardingSettingsQueryKeysonboardingQueryKeys rename
  • ['onboarding-settings']['onboarding'] 변경
  • queries.ts, mutations.ts 참조 업데이트
  • repo 전체 grep으로 onboarding-settings / onboardingSettingsQueryKeys 잔재 확인

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions