[etc] 프로젝트 협업 준비 및 진행 가이드

---

• 협업을 시작할 때의 단계와 고려할 사항을 살펴보자.
• [참고할만한 노션↗️]

---

1. 기획

1.1 아이디어 회의

① 프로젝트 주제:

② 페이지 구성:

③ 페이지 권한 구분:

• 로그인 필수:
• 로그인 선택:
• 로그인 금지:

1.2 Tool 활용하여 아이디어 구체화

피그마나 노션 활용하여 아이디어 구체화

1.3 역할 분담

팀원들의 기술 수준과 사용 능력을 파악한 후, 각자의 역할을 분배

분류 기준： 프로젝트 경험 , 학습 경험 , 학습 중 , x

팀원	프로젝트 횟수	React	Next.js	TypeScript
팀원1	n회
팀원2	n회
팀원3	n회
팀원4	n회

1.4 컨벤션 수립

코드 컨벤션

• [React Project Convention↗]

깃허브 커밋 컨벤션

깃허브 issue나 milestone 사용여부도 같이 결정하기

• [Github Convention↗]

1.5 yarn vs npm?

프로젝트 생성 이후에는 팀 내에서 npm, yarn 중 하나를 선택해서 사용하기

• npm을 사용할 경우 package-lock.json 파일, yarn을 사용할 경우, yarn.lock 파일이 github에 함께 공유되어야 의존성 라이브러리들의 버전을 일관성있게 관리 할 수 있어 동일한 개발환경을 유지할 수 있다.
• yarn을 추천 → 성능, 안정성, 보안성 면에서 유리 (https://stackoverflow.com/questions/40027819/when-to-use-yarn-over-npm-what-are-the-differences)

1.6 API 문서 작성

사용될 API들을 문서화하고, 각 API의 역할과 사용 방법을 명확히 정의

1.7 회의 시간

회의를 통한 프로젝트 진척도 관리 규정 수립

먼저 팀원들의 불가한 시간 (고정일정)을 파악한 후, 회의 시간을 선정하자.

팀원	불가한 시간 (고정일정)
팀원1
팀원2
팀원3
팀원4

회의 종류	일정	내용
주간 회의	매주 n요일, n시	한 주 동안의 주요 진행 사항 공유 및 문제 해결, 향후 계획 논의
진행 상황 회의	매일 n시	매일 n시 카톡으로 오늘 진행한 작업, 내일 할 작업, 문제점 보내기

2. 기술적 의사 결정

• 기술 스택: 각종 라이브러리는 어떤 것을 사용할 것이며, 그 이유는 무엇인지 정리
• 외부 API 사용: 프로젝트에서 사용할 API를 정리하고, 어떻게 사용할지 정의

3. Ground Rule 정하기

• 지각시 패널티: 10분당 1000원(올림) / 최대 5000원
• 코드 컨벤션(변수명 등) 및 Commit, PR 컨벤션 지키기
• 모르는 것, 헷갈리는 것은 즉시 이야기하기
• 좋은 정보를 발견하면 팀원들과 공유하기

4. 프로젝트 셋업

• git
  • 공동 세팅
  • 기초 틀 다 같이 세팅
  • 브랜치 분기
    
    
• 프로젝트 셋업
  • React
  • Next.js
    
    
• 각종 라이브러리 세팅
  • Client State 관리 : RTK, Zustand, Recoil
  • Server State 관리 : React Query, RTK Query, SWR
  • 디자인(UI) : Next UI, Tailwind CSS
  • 인증인가 : Next Auth