11.7 월 회의록

컨벤션

Git 브랜치 전략 - Git flow + PR

이유

• 브랜치의 구분을 명확히 하기 위해서

종류

• main
  • 개발이 완료된 dev 브랜치를 merge 하여 배포 가능한 상태만을 관리하는 브랜치
• dev
  • 개발이 진행되는 브랜치, 이 브랜치를 기반으로 feat, refactor 등으로 파생됩니다.
  • feat/[기능명][이슈번호(optional)]
    • 새로운 기능을 추가하고자 할 때, 사용하는 브랜치입니다.
  • refactor/[기능명][이슈번호(optional)]
    • 리팩토링이 이루어지는 브랜치입니다.
  • fix/[기능명][이슈번호(optional)]
    • 버그를 수정하기 위한 브랜치입니다.
  • design/[기능명][이슈번호(optional)]
    • 디자인 관련 작업을 하는 브랜치입니다.

코딩 컨벤션

대소문자 컨벤션

• camelCase
  • 일반적인 함수(hook 포함)
  • 일반적인 변수
• PascalCase
  • 컴포넌트 관련한 파일, 폴더, 명
  • class 명
• snake_case
  • DB
  • 상수(영문 대문자 사용)
• kebab-case
  • html 요소

변수 네이밍

• 배열의 이름은 복수형으로 만듭니다.

// 예시

• 반환 값이 boolean 형인 함수나 변수는 is 또는 has 로 시작합니다.
• 매직넘버 사용 금지(변수나 상수로 분리)

순서 컨벤션

• const 는 let 보다 상단에 작성합니다.
• 변수는 사용 시점에 선언 및 할당합니다.
• 선언과 할당을 동시에 하는 변수를 선언만 하는 변수보다 먼저 선언합니다.
• import 순서
  • 외부모듈 -> 내부모듈 -> style -> assets 순서로 작성합니다.

  // 예시
  

  • 선언 그룹 사이에 공백을 둡니다.

.prettierrc & eslint

• 지윤이 가져다 쓰기

파일 분리 방식

• 지윤님이 작성

커밋 컨벤션

• 제목은 확실히 적어줍니다.
• 본문은 optional.

# <타입>: <제목> (#1)

##### 제목은 최대 50 글자까지만 입력 ############## -> |


# 본문은 위에 작성
######## 본문은 한 줄에 최대 72 글자까지만 입력 ########################### -> |
# --- COMMIT END ---
# <타입> 리스트
#   feat    : 기능 (새로운 기능)
#   fix     : 버그 (버그 수정)
#   refactor: 리팩토링
#   style   : 스타일 (코드 형식, 세미콜론 추가: 비즈니스 로직에 변경 없음)
#   docs    : 문서 (문서 추가, 수정, 삭제)
#   test    : 테스트 (테스트 코드 추가, 수정, 삭제: 비즈니스 로직에 변경 없음)
#   chore   : 기타 변경사항 (빌드 스크립트 수정 등)
# ------------------
#     타입은 영어로 작성하고 제목과 본문은 한글로 작성한다.
#     제목 끝에 마침표(.) 금지
#     제목과 본문을 한 줄 띄워 분리하기
#     본문은 "어떻게" 보다 "무엇을", "왜"를 설명한다.
#     본문에 여러줄의 메시지를 작성할 땐 "-"로 구분
#     관련된 이슈번호는 제목 맨 뒤에 추가한다. ex. (#1)
# ------------------

폴더 구조

- client
|- 
- server
|- app.ts
|- 도메인 별로 폴더
|- user // 예시
   |- userController
   |- userService
   |- userRepository
|- utils
   |- ...