1️⃣ 폴더 구조

폴더 구조	설명
	api : 서버 통신 assets : 이미지, 아이콘 core : 더미데이터 hooks : 커스텀 훅 pages : 화면 페이지 - 기능에 따라 10가지 화면으로 구성 styles : 포맷, 공통 스타일 types : 데이터 타입 utils : 공통 함수

2️⃣ 코드 설명

1) api 연결

1. axios

• 왜 fetch가 아닌 axios를 사용했는가? 사실 자바스크립트에는 fetch api가 존재하지만, 더 많은 기능을 지원하기에 개발자들은 서버 통신에 보다 편리한 axios를 선호한다고..!

Axios	Fetch
설치 필요 O	설치 필요 X
CSRF 보호 기능이 있다	별도 기능이 없다
자동으로 JSON 데이터 형식으로 변환해준다	json() 메서드를 따로 사용해서 JSON 형태로 바꿔 주어야 한다
요청 취소 및 타임아웃을 걸 수 있다.	-
HTTP 요청을 가로챌 수 있다.	-
상태코드가 에러 코드를 내뱉으면 reject 한다.	에러 응답을 받더라도 resolve 하고 네트워크 장애가 발생한 경우에만 거부한다. (에러 뱉어주지 X)

2. async/await

• 왜 promise가 아닌 async, await를 사용했는가? ⚠️ Promise & then 의 문제점

  • 가독성이 떨어지고, 디버깅이 불편하다 (길어지는 체이닝)
  • 예외처리 (try…catch 와 .then / .catch의 혼용이 헷갈림)

  👉 그래서 등장한 async/await

async function 함수명( ){
  await 비동기함수();
}

3. customAxios

• axios를 사용할 때마다 baseURL을 작성하는 등 반복되는 코드를 작성하지 않기 위해서 커스터마이징한 인스턴스를 모듈화하여 사용

import axios from "axios";

export const customAxios = axios.create({
  baseURL: `${import.meta.env.VITE_APP_BASE_URL}`,
  headers: {
    "Content-Type": "application/json",
    "Access-Control-Allow-Origin": "*",
  },
});

4. 인터셉터

• 로그인을하면 헤더에 토큰을 넣어주는 작업 👉 authorization header
  • access 토큰에 따라 사용자를 식별해야하기 때문에 토큰을 확인하는 절차가 필수였습니다. 따라서 요청을 인터셉트해서 access token의 정보를 헤더에 넣어주도록 했습니다.
  • 토큰은 Cookie에 넣어서 관리했고 access token이 있으면 헤더의 Authorization에 Bearer ${token} 형태로 토큰 값을 넣어서 요청합니다.
  • useLayoutEffect 훅을 이용해서 렌더링 전에 훅 실행

const useSetInterceptors = () => {
  useLayoutEffect(() => {
    api.interceptors.request.use((config) => {
      const accessToken = getToken();
      if (accessToken) {
        config.headers["Authorization"] = `Bearer ${accessToken}`;
      }
      return config;
    });
  });
};

export default useSetInterceptors;

5. react-query와 custom-hook

🔻 GET - useQuery 사용

첫 번째 파라미터로 unique key를 포함한 배열이 들어간다. 이후 동일한 쿼리를 불러올 때 유용하게 사용된다. 첫 번째 파라미터에 들어가는 배열의 첫 요소는 unique key로 사용되고, 두 번째 요소부터는 query 함수 내부의 파라미터로 값들이 전달된다. 두 번째 파라미터로 실제 호출하고자 하는 비동기 함수가 들어간다. 이때 함수는 Promise를 반환하는 형태여야 한다. 최종 반환 값은 API의 성공, 실패 여부, 반환값을 포함한 객체이다.

export function useGetAll() {
  const { data, error, refetch } = useQuery("getAll", getAll, {
    refetchInterval: 3000, // 3초마다 데이터를 refetch
    onError: () => {
      console.log("물품 리스트 조회 에러", error);
    },
  });
  return { data, error, refetch };
}

🔻 POST - useMutation 사용

반환값은 useQuery와 동일하지만, 처음 사용 시에 post 비동기 함수를 넣어준다. 이때 useMutation의 첫 번째 파라미터에 비동기 함수가 들어가고, 두 번째 인자로 상황 별 분기 설정이 들어간다는 점이 차이이다.

실제 사용 시에는 mutation.mutate 메서드를 사용하고, 첫 번째 인자로 API 호출 시에 전달해주어야하는 데이터를 넣어주면 된다 const { mutate: postVoteMutate } = usePostVote();

export function usePostImage() {
  return useMutation(postImage, {
    onSuccess: (data) => {
      console.log("이미지 업로드 성공", data);
    },
    onError: (error) => {
      console.log("이미지 업로드 실패", error);
    },
  });
}

👉 왜 React Query를 사용했는가?

1. React Query는 React Application에서 서버 상태를 불러오고, 캐싱하며, 지속적으로 동기화하고 업데이트하는 작업을 도와주는 라이브러리입니다.
2. 복잡하고 장황한 코드가 필요한 다른 데이터 불러오기 방식과 달리 React Component 내부에서 간단하고 직관적으로 API를 사용할 수 있습니다.
3. 더 나아가 React Query에서 제공하는 캐싱, Window Focus Refetching 등 다양한 기능을 활용하여 API 요청과 관련된 번잡한 작업 없이 “핵심 로직”에 집중할 수 있습니다.
4. React-Query는 캐싱을 통해 동일한 데이터에 대한 반복적인 비동기 데이터 호출을 방지하고, 이는 불필요한 API 콜을 줄여 서버에 대한 부하를 줄이는 좋은 결과를 가져옵니다.
5. 컴포넌트 내부에서 Server 데이터를 가져오고 있는데, 이때 onSuccess와 onError 함수를 통해 fetch 성공과 실패에 대한 분기를 아주 간단하게 구현할 수 있어서 이는 Server 데이터를 불러오는 과정에서 구현해야할 추가적인 설정들을 진행할 필요가 없습니다.
6. 📍 즉, Client 데이터는 상태 관리 라이브러리가 관리하고, Server 데이터는 React-Query가 관리하는 구조라고 생각하면 되고 이를 통해 우리는 Client 데이터와 Server 데이터를 온전하게 분리할 수 있습니다.

장점
재사용성	API 호출과 처리를 분리하여 여러 컴포넌트에서 재사용 가능
에러 핸들링	useMutation의 onError 콜백을 사용하여 에러를 처리
성공 처리	onSuccess 콜백을 사용해 성공 시 필요한 후속 작업(예: 페이지 이동)을 쉽게 관리할 수 있음
상태 관리	React Query를 사용하여 서버 상태를 관리하면, 상태를 직접 관리할 필요 없이 자동으로 업데이트

6. 리액트쿼리를 적용한 방법

• api 폴더에 있는 함수는 API 호출을 수행합니다.
• customAxios를 사용해 API 요청을 보내고, 서버로부터의 응답을 반환합니다.

• hooks 폴더에 있는 함수는 요청을 처리하는 역할
• 예를 들어, 로그인에 성공하면 쿠키에 토큰을 저장하고, 실패 시 에러 메시지를 표시하는 등 커스텀 할 수 있습니다.
• 컴포넌트에서 hooks들을 호출하여 다양하게 사용할 수 있습니다

3️⃣ How to install, test

1) 프로젝트를 본인의 저장소로 fork

2) fork한 저장소로 이동 후 저장소 주소 복사

3) fork한 저장소를 자신의 컴퓨터로 clone하고, 해당 폴더로 이동

git clone 저장소_주소.git
cd 폴더_이름

4) 의존성 모듈 설치 yarn

5) React 앱 실행 yarn dev

4️⃣ Opensource

역할	종류
Library
Programming Language
Styling
Data Fetching
Formatting
Package Manager
Version Control
Deploy

---

📄 브랜치 전략

[Issue 먼저 생성하고 해당 이슈 번호 브랜치 생성]

▶️ 브랜치명

• main: 최종 Merge를 하는 곳 (배포 브랜치)
• develop : 개발할때 Merge하는 곳
• 페이지명 : 기능을 개발하면서 각자 페이지별로 사용할 브랜치

▶️ 브랜치 전략

• 이슈번호/페이지/기능설명

signup
ㄴ 46/signup/resize-padding