Team ILsangEmong

일상이몽 - 함께 경험한 하나의 일상을 서로 다른 시각으로 회상하는 서비스

THE SOPT Sopkathon - Group 4

🛠 Used Stacks

🧑‍💻 Developers

주효식	김소현
HYOSITIVE	thguss

💼 Roles

기능명	엔드포인트	담당자
팀 생성	[POST] /team	주효식
팀 존재 유무 확인	[GET] /team/:inviteCode	김소현
코멘트 한 줄 작성	[PUT] /comment	김소현
코멘트결과 확인	[GET] /comment/:inviteCode	주효식

📏 Code Convention

변수명

1. Camel Case 사용

• lower Camel Case

2. 함수의 경우 동사+명사 사용

• ex) getInformation()

3. flag로 사용 되는 변수는 조동사 + flag 종류로 구성

• ex) isNum

4. 약어는 되도록 사용하지 않는다.

• 부득이하게 약어가 필요하다고 판단되는 경우 팀원과 상의를 거친다.

주석

1. 한줄 주석은 // 를 사용한다.

  // 한줄 주석일 때
  /**
  * 여러줄
  * 주석일 때
  */

2. 함수에 대한 주석

  /**
   * @route Method /Route
   * @desc Function Description
   * @access Public
 */

3. Bracket 사용 시 내부에 주석을 작성한다.

  if (a == 5) {
    // 주석
  }

Bracket

1. 한줄 if 문은 여러 줄로 작성한다.

// 한줄 if 문 - 여러 줄로 작성
 if(trigger) {
   return;
 }

2. 괄호는 한칸 띄우고 사용한다.

// 괄호 사용 한칸 띄우고 사용한다.
 if (left == true) {
    return;
 }

3. Bracket 양쪽 사이를 띄어서 사용한다.

 const { userId } = request.user;

비동기 함수의 사용

1. async, await 함수 사용을 지향한다.
2. Promise 사용은 지양한다.
3. 다만 로직을 짜는 데 있어 promise를 불가피하게 사용할 경우, 주석으로 표시하고 commit에 그 이유를 작성한다.

🌿 Branch Strategy

Git Workflow

main → develop → name → name_#feature
feature 번호는 issue 번호에 맞게 생성 / name에는 자기 이름

1. issue 생성
2. local - name_#feature에서 각자 기능 작업 (feature 번호는 issue 번호에 맞게 생성)
3. remote - name_#feature 에 Push
4. remote - name 으로 PR
5. remote - develop 으로 PR
6. 코드 리뷰 후 Confirm 받고 remote - develop Merge
7. remote - develop 에 Merge 될 때 마다 모든 팀원 local - develop pull 받아 최신 상태 유지

Branch Name	설명
main	초기 세팅 존재
develop	구현 완료 브랜치
hyosik	효식 개인 브랜치
sohyeon	소현 개인 브랜치
name_#issue	이슈 별 기능 구현 브랜치

📌 Commit Convention

[TAG] 메시지

태그 이름	설명
[CHORE]	코드 수정, 내부 파일 수정
[FEAT]	새로운 기능 구현
[ADD]	FEAT 이외의 부수적인 코드 추가, 라이브러리 추가, 새로운 파일 생성
[HOTFIX]	issue나 QA에서 급한 버그 수정에 사용
[FIX]	버그, 오류 해결
[DEL]	쓸모 없는 코드 삭제
[DOCS]	README나 WIKI 등의 문서 개정
[CORRECT]	주로 문법의 오류나 타입의 변경, 이름 변경에 사용
[MOVE]	프로젝트 내 파일이나 코드의 이동
[RENAME]	파일 이름 변경이 있을 때 사용
[IMPROVE]	향상이 있을 때 사용
[REFACTOR]	전면 수정이 있을 때 사용

📁 Project Foldering

🗃️ 3-Layer Architecture 적용

📁 src _
|_ 📁 config _
|_ 📁 controllers _
|_ 📁 interfaces _
|_ 📁 loaders _
|_ 📁 models _
|_ 📁 modules _
|_ 📁 routess _
|_ 📁 services _

💾 Collection

const TeamSchema = new mongoose.Schema({
    name: {
        type: String,
        required: true,
    },
    inviteCode: {
        type: String,
        required: true,
        unique: true,
    },
    comments: {
        type: [String],
    },
    startTime: {
        type: Date,
        required: true,
    },
    endTime: {
        type: Date,
        required: true,
    },
});

📦 Package.json

{
  "name": "node-typescript-init",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "dev": "nodemon",
    "build": "tsc && node dist"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@types/express": "^4.17.13",
    "@types/mongoose": "^5.11.97",
    "@types/node": "^17.0.25",
    "nodemon": "^2.0.15",
    "ts-node": "^10.7.0",
    "typescript": "^4.6.3"
  },
  "dependencies": {
    "dotenv": "^16.0.0",
    "eslint": "^8.16.0",
    "eslint-config-prettier": "^8.5.0",
    "express": "^4.17.3",
    "express-validator": "^6.14.0",
    "mongoose": "^6.3.1",
    "prettier": "^2.6.2"
  }
}

👷‍♂️ Server Architecture

• 개발 환경 : Typescript, Node
• 데이터베이스 : MongoDB
• 서버 환경 : AWS EC2, PM2