배경
도메인 문서 기준명을 onboarding-settings → onboarding으로 정리했습니다 (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/참조
작업 체크리스트
배경
도메인 문서 기준명을
onboarding-settings→onboarding으로 정리했습니다 (AGENTS.md,docs/conventions/domains.md,docs/architecture/folder-structure.md,docs/overview.md).다만 코드에는 React Query key 네임스페이스가 아직 이전 이름을 사용하고 있습니다.
현재 상태
사용처:
src/domains/onboarding/api/queries.tssrc/domains/onboarding/api/mutations.ts제안
다른 도메인(
measurement,daily-memo)과 동일하게 도메인 폴더명을 query key root로 사용합니다.'onboarding-settings''onboarding'onboardingSettingsQueryKeysonboardingQueryKeysrecovery-methods,sleep-condition등이유
setting-onboarding)이 아니라 도메인 네임스페이스로 두는 것이 프로젝트 컨벤션과 일치onboarding도메인 = 최초 저장(/onboarding) + 이후 선호값 수정(setting-onboardingAPI)을 담당-settings접미사 불필요영향
query-keys.ts,queries.ts,mutations.tsimport/참조작업 체크리스트
onboardingSettingsQueryKeys→onboardingQueryKeysrename['onboarding-settings']→['onboarding']변경queries.ts,mutations.ts참조 업데이트onboarding-settings/onboardingSettingsQueryKeys잔재 확인