📌 프로젝트 소개

• SSAFY Sandbox는 SSAFY 12기 서울 15반에서 백엔드 개발자를 희망하는 친구들이 협업 경험을 보다 쉽게, 그리고 효과적으로 쌓을 수 있도록 하기 위해 시작되었습니다.
• 저희 BE팀은 FE팀이 배포 하기 전, 테스트를 위한 서버를 구축하고 있습니다.

💻 Team-SandBox Server Developers

🐹 오수영	🐯 윤수빈	🐻 이석환	🐰 조예슬
wimmings	king0104	im2sh	yeseul106

🙋🏻‍♀️ 역할 분담

기능명	담당자	완료 여부
프로젝트 세팅	예슬🐰	완료
CI/CD 구축	예슬🐰	완료
Oauth 로그인 구현	예슬🐰	완료
FCM 구현	석환🐻	완료
이메일 인증	석환🐻	완료
이미지 업로드		미정
pagenation 구현		미정

📂 Project Foldering

com
 ㄴ ssafy
     ㄴ side
         ㄴ api
         |   ㄴ member
         |   |   ㄴ controller
         |   |   ㄴ service
         |   |   ㄴ domain
         |   |   ㄴ dto
         |   ㄴ auth
         |   |   ㄴ controller
         |   |   ㄴ service
         |   |   ㄴ domain
         |   |   ㄴ dto
         |   ...
         ㄴ common
         |   ㄴ advice
         |   ㄴ config
         |   |    ㄴ jwt
         |   ㄴ entity
         |   ㄴ exception
         |   ㄴ util
         ㄴ external
         |   ㄴ ...
         ㄴ SandboxServerApplication

📌 Coding Convention

함수에 대한 주석

---

• backend에서 공통적으로 사용하는 함수의 경우, 모듈화를 통해 하나의 파일로 관리합니다.

• 하나의 파일의 시작 부분에 주석으로 상세 내용을 작성합니다. 정리해야 하는 부분은 다음과 같습니다.

• 보통 controller에 작성하기로 합니다

• 함수의 전체 기능에 대한 설명

• 예시 코드

  /**
   * @route GET /mission/all
   * @desc 지난 미션 모두 가져오기
   * */
   */
  const getCompletedMission = async (req: Request, res: Response) => {
    //어쩌구 저쩌구
  };

변수명

---

 ### 읽기 쉽고 알기 쉬운 **변수명**으로 만들기

```tsx
// great - "name" implies strings
const subjectName = ['math', 'english', 'korea'];
const subject = [{name: 'math', difficulty: 'easy’}]
```

- boolean 같은 경우 “is”, “has”, “can”과 같은 접두어와 같이 사용한다.

```tsx
// good
const isOpen = true; const canWrite = true; const hasFruit = true;
```

- 숫자일 경우 max, min, total과같은 단어로 설명한다.

```tsx
// good
let totalNum = 54;
```

- 함수일 경우 동사와 명사를 사용하여 **actionResource**의 형식을 따르는 것이 좋다

```tsx
// good
const getUser = (firstName, LastName) => firstName + LastName
```
<br>

변수(함수) 명에 대한 이름

- 변수, 함수 , 인스턴스 - Camel Case
- 함수명 작성 시 동사 + 명사
- Class, Constructor - Pascal Case

```tsx
// good
var userId
function addUserInfo () {}
class UserInfo {}
```

파일명은 카멜케이스

  - 파일명 - Camel Case

  ### 상수는 무조건 대문자

  - 만약 여러 단어면 상수일 때만 _ (언더바 사용)

  ```tsx
  //bad
  const maxNum = 20;

  //good
  const MAX_NUM = 20;
  ```

Bracket

---

 ### 중괄호로 묶이지 않은 블록문을 금지

  블록문을 반드시 중괄호로 묶을 것을 강제합니다

  ```tsx
  // good
  if (flag) {
    count++;
  }

  // bad
  if (flag) count++;
  ```

들여쓰기로 스페이스 2번을 하지 않을 경우 에러

```tsx
// good
if (a) {
    b=c;
    function foo(d) {
        e=f;
    }
}

// bad
if (a) {
  b=c;
  function foo(d) {
    e=f;
  }
}
```

📌Git Convention

🔹Commit Convention

• ✅ [CHORE] : 동작에 영향 없는 코드 or 변경 없는 변경사항(주석 추가 등)
• ✨ [FEAT] : 새로운 기능 구현
• ➕ [ADD] : Feat 이외의 부수적인 코드 추가, 라이브러리 추가, 새로운 파일 생성
• 🔨 [FIX] : 버그, 오류 해결
• ⚰️ [DEL] : 쓸모없는 코드 삭제
• 📝 [DOCS] : README나 WIKI 등의 문서 수정
• ✏️ [CORRECT] : 주로 문법의 오류나 타입의 변경, 이름 변경시
• ⏪️ [RENAME] : 파일 이름 변경시
• ♻️ [REFACTOR] : 전면 수정
• 🔀 [MERGE]: 다른 브랜치와 병합

커밋 예시

ex ) git commit -m "#{이슈번호} [FEAT] 회원가입 기능 완료"

🔹Branch Convention

• [develop] : 최종 배포
• [feat] : 기능 추가
• [fix] : 에러 수정, 버그 수정
• [docs] : README, 문서
• [refactor] : 코드 리펙토링 (기능 변경 없이 코드만 수정할 때)
• [modify] : 코드 수정 (기능의 변화가 있을 때)
• [chore] : gradle 세팅, 위의 것 이외에 거의 모든 것

브랜치 명 예시

ex) feat/#{이슈번호}

🔹Branch Strategy

Git Flow

기본적으로 Git Flow 전략을 이용한다. Fork한 후 나의 repository에서 작업하고 구현 후 원본 repository에 pr을 날린다. 작업 시작 시 선행되어야 할 작업은 다음과 같다.

1. Issue를 생성한다.
2. feature Branch를 생성한다.
3. Add - Commit - Push - Pull Request 의 과정을 거친다.
4. Pull Request가 작성되면 작성자 이외의 다른 팀원이 Code Review를 한다.
5. Code Review가 완료되면 Pull Request 작성자가 develop Branch로 merge 한다.
6. merge된 작업이 있을 경우, 다른 브랜치에서 작업을 진행 중이던 개발자는 본인의 브랜치로 merge된 작업을 Pull 받아온다.
7. 종료된 Issue와 Pull Request의 Label과 Project를 관리한다.

• 기본적으로 git flow 전략을 사용합니다.
• main, develop, feature 3가지 branch 를 기본으로 합니다.
• main → develop → feature. feature 브랜치는 feat/기능명으로 사용합니다.
• 이슈를 사용하는 경우 브랜치명을 feature/[issue num]-[feature name]로 합니다.

🔹Issue Convention

• [FEAT] : 기능 추가
• [FIX] : 에러 수정, 버그 수정
• [DOCS] : README, 문서
• [REFACTOR] : 코드 리펙토링 (기능 변경 없이 코드만 수정할 때)
• [MODIFY] : 코드 수정 (기능의 변화가 있을 때)
• [CHORE] : gradle 세팅, 위의 것 이외에 거의 모든 것

ex) [feat] user api 구현