K리그 query key factory 구조화

GET 요청 모음

API명	경로	로그인 유무
회원가입 여부 체크	`/user/check-joinable?walletAddress=`	X
이메일 중복 확인	`/user/check-email?email=`	O
닉네임 중복 확인	`/user/check-nickname?q=`	O
회원탈퇴일 확인	`/user/check-withdrawal-date?walletAddress=`	X
기본 정보 조회	`/user?clubCode=`	O
거래 내역 조회	`/user/transaction?clubCode=&page=`	O
~~지갑 토큰 수량 조회~~	`~~/user/wallet~~`	O
S3 presigned URL 조회	`/user/profile/url`	O
특정 클럽 라운드 드랍 조회	`/round?clubCode=&page=`	X
특정 클럽 홈 라운드 드랍 2개 조회	`/round/home?clubCode=`	X
특정 클럽 현재 진행중인 드랍 1개 조회	`/round/recently?clubCode=`	X
특정 클럽 특정 선수 라운드 드랍 조회	`/round/search?clubCode=?&player=?`	X
특정 클럽 선수 드롭다운 조회	`/round/dropdown?clubCode=`	X
특정 클럽 라운드 드랍 상세 조회	`/round/:cardIdx`	X
특정 클럽 선수 관련 라운드 NFT 조회	`/round/:cardIdx/relevant`	X
선수 별 입찰 내역	`/round/transactions/:cardIdx`	X
입찰 진행건 존재 여부 조회	`/round/order/:cardIdx`	O
특정 클럽 선수 Edition 조회	`/round/edition/:orderIdx`	O
특정 클럽 보유 선수 전체 조회	`/collection?clubCode=`	O
특정 클럽 선수 상세 리스트 조회	`/collection/search?clubCode=?&player=?`	O
특정 클럽 선수 드롭다운 조회	`/collection/dropdown?clubCode=?`	O
특정 클럽 선수 리포트 조회	`/collection/report/:cardIdx`	O
FAQ 타입 조회	`/faq/type`	X
FAQ 리스트 조회	`/faq?type=`	X

필요하다고 생각되는 처리

로그아웃 시 로그인 했었던 지갑 주소와 관련된 캐시 데이터 전부 제거
선수의 Unique ID를 필터로 사용하는 Query Key 구조
지갑 주소를 기준으로 하는 Query Key 구조

Scope, Entity 그리고 Unique ID

Query Key Base

API	Scope	Entity	Unique ID	Filter	Wallet Address
회원가입 여부 체크	`user`	`checkJoinable`			O
이메일 중복 확인	`user`	`checkEmail`			O
닉네임 중복 확인	`user`	`checkNickname`			O
회원탈퇴일 확인	`user`	`checkWithdrawalDate`			O
기본 정보 조회	`user`		`clubCode`		O
거래 내역 조회	`user`	`transaction`	`clubCode`	`page`	O
~~지갑 토큰 수량 조회~~	`~~user~~`	`~~wallet~~`			O
S3 presigned URL 조회	`user`				O
특정 클럽 라운드 드랍 조회	`round`		`clubCode`		X
특정 클럽 홈 라운드 드랍 2개 조회	`round`	`home`	`clubCode`		X
특정 클럽 현재 진행중인 드랍 1개 조회	`round`	`recently`	`clubCode`		X
특정 클럽 특정 선수 라운드 드랍 조회	`round`	`search`	`clubCode`	`player`	X
특정 클럽 선수 드롭다운 조회	`round`	`dropdown`	`clubCode`		X
특정 클럽 라운드 드랍 상세 조회	`round`	`detail`	`clubCode`	`cardIdx`	X
특정 클럽 선수 관련 라운드 NFT 조회	`round`	`relevant`	`clubCode`	`cardIdx`	X
선수 별 입찰 내역	`round`	`transactions`	`clubCode`	`cardIdx` , `page`	X
입찰 진행건 존재 여부 조회	`round`	`order`	`clubCode`	`cardIdx`	O
특정 클럽 선수 Edition 조회	`round`	`edition`	`clubCode`	`cardIdx`	O
특정 클럽 보유 선수 전체 조회	`collection`		`clubCode`		O
특정 클럽 선수 상세 리스트 조회	`collection`	`search`	`clubCode`	`player`	O
특정 클럽 선수 드롭다운 조회	`collection`	`dropdown`	`clubCode`		O
특정 클럽 선수 리포트 조회	`collection`	`report`		`cardIdx`
FAQ 타입 조회	`faq`	`type`			X
FAQ 리스트 조회	`faq`		`type`		X

Query Key Structure

지갑 주소 : address

API	Query Key
회원가입 여부 체크	`[{ scope: 'user', entity: 'checkJoinable', address: '-' }]`
이메일 중복 확인	`[{ scope: 'user', entity: 'checkEmail', address: '-' }]`
닉네임 중복 확인	`[{ scope: 'user', entity: 'checkNickname', address: '-' }]`
회원탈퇴일 확인	`[{ scope: 'user', entity: 'checkWithdrawalDate', address: '-' }]`
기본 정보 조회	`[{ scope: 'user', clubCode: '-' , address: '-' }]`
거래 내역 조회	`[{ scope: 'user', entity: 'transaction', clubCode: '-', address: '-' }]`
~~지갑 토큰 수량 조회~~	`~~[{ scope: 'user', entity: 'wallet', address: '-' }]~~`
S3 presigned URL 조회	`[{ scope: 'user', contentType: '-', address: '-' }]`
특정 클럽 라운드 드랍 조회	`[{ scope: 'round’, clubCode: '-' }]`
특정 클럽 홈 라운드 드랍 2개 조회	`[{ scope: 'round’, entity: 'home', clubCode: '-' }]`
특정 클럽 현재 진행중인 드랍 1개 조회	`[{ scope: 'round’, entity: 'recently', clubCode: '-' }]`
특정 클럽 특정 선수 라운드 드랍 조회	`[{ scope: 'round’, entity: 'search', clubCode: '-', player: '-' }]`
특정 클럽 선수 드롭다운 조회	`[{ scope: 'round’, entity: 'dropdown', clubCode: '-' }]`
특정 클럽 보유 선수 전체 조회	`[{ scope: 'collection', clubCode: '-', address: '-' }]`
특정 클럽 선수 상세 리스트 조회	`[{ scope: 'collection', entity: 'search', filter: 'player', clubCode: '-', address: '-' }]`
특정 클럽 선수 드롭다운 조회	`[{ scope: 'collection', entity: 'dropdown', clubCode: '-', address: '-' }]`
특정 클럽 라운드 드랍 상세 조회	`[{ scope: 'round’, entity: 'detail', id: '-', clubCode: '-' }]`
특정 클럽 선수 관련 라운드 NFT 조회	`[{ scope: 'round’, entity: 'relevant', id: '-', clubCode: '-' }]`
선수 별 입찰 내역	`[{ scope: 'round’, entity: 'transactions', id: '-', clubCode: '-' }]`
입찰 진행건 존재 여부 조회	`[{ scope: 'round’, entity: 'order', id: '-', clubCode: '-', address: '-' }]`
특정 클럽 선수 Edition 조회	`[{ scope: 'round’, entity: 'edition', id: '-', clubCode: '-', address: '-' }]`
특정 클럽 보유 선수 전체 조회	`[{ scope: 'collection’, clubCode: '-', address: '-' }]`
특정 클럽 선수 상세 리스트 조회	`[{ scope: 'collection’, entity: 'search', player: '-', clubCode: '-', address: '-' }]`
특정 클럽 선수 드롭다운 조회	`[{ scope: 'collection’, entity: 'dropdown', clubCode: '-', address: '-' }]`
특정 클럽 선수 리포트 조회	`[{ scope: 'collection’, entity: 'report', id: '-', address: '-' }]`
FAQ 타입 조회	`[{ scope: 'faq', entity: 'type' }]`
FAQ 리스트 조회	`[{ scope: 'faq', type: '-' }]`

Query Key Factory

user

const userKeys = {
  base: [{ scope: 'user' }] as const,
  joinable: (address: string) => [{ ...userKeys.base[0], entity: 'checkJoinable', address }] as const,
  email: (address: string) => [{ ...userKeys.base[0], entity: 'checkEmail', address }] as const,
  nickname: (address: string) => [{ ...userKeys.base[0], entity: 'checkNickname', address }] as const,
  withdraw: (address: string) => [{ ...userKeys.base[0], entity: 'checkWithdrawalDate', address }] as const,
  profile: (clubCode: string, address: string) => [{ ...userKeys.base[0], clubCode, address }] as const,
  transaction: (clubCode: string, address: string) =>
    [{ ...userKeys.base[0], entity: 'transaction', clubCode, address }] as const,
  ~~wallet: (address: string) => [{ ...userKeys.base[0], entity: 'wallet', address }] as const,~~
  presigned: (contentType: string, address: string) => [{ ...userKeys.base[0], contentType, address }] as const,
};

round

const roundKeys = {
  base: [{ scope: 'round' }] as const,
  all: (clubCode: string) => [{ ...roundKeys.base[0], clubCode }] as const,
  home: (clubCode: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'home' }] as const,
  recently: (clubCode: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'recently' }] as const,
  dropdown: (clubCode: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'dropdown' }] as const,
  search: (clubCode: string, player: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'search', player }] as const,
  detail: (clubCode: string, id: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'detail', id }] as const,
  relevant: (clubCode: string, id: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'relevant', id }] as const,
  bidable: (clubCode: string, id: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'checkBidable', id }] as const,
  bid: (clubCode: string, id: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'bid', id }] as const,
  transaction: (clubCode: string, id: string) => [{ ...roundKeys.all(clubCode)[0], entity: 'transaction', id }] as const,
};