api-convention

Create one function per endpoint in a domain file under src/api/, type the response as Promise<IApiResponse<T>>, and return response.data to unwrap the Axios wrapper. Name functions after the HTTP verb, such as getOrderBySlug or createOrder, and never add try/catch since React Query handles errors.

Use useMutation with a mutationFn calling the API service, then call queryClient.invalidateQueries with the relevant QUERYKEY in onSuccess. Global error toasts are handled by MutationCache in App.tsx, so only add onError for specific extra handling.

Always use a React Query hook from src/hooks/ rather than calling API functions directly in components. Hooks provide caching, loading states, automatic refetching, and integration with the global error handling configured in QueryCache and MutationCache.

Pass doNotShowLoading: true in the Axios request config, using @ts-expect-error since it is not part of the standard AxiosRequestConfig type. This is the standard pattern for polling endpoints like kitchen orders that refetch on an interval.

Centralized QUERYKEY constants in src/constants/query.ts prevent typos and make cache invalidation reliable across mutations and queries. Inline string arrays risk mismatched keys, which silently break invalidation and leave stale data on screen.