💜RecorDream-Server

레코드림은 베를린이야. 꿈쟁이들 마음에 치명적인 독일수도. 🇩🇪

About

서비스 핵심 기능 소개

Collection 설계

팀원 소개 및 역할 분담

황서경	추서연	김시연
@Seokyeong237	@ChooSeoyeon	@ksiyeon27
DB 설계	DB 설계	DB 설계
API 명세서 작성 및 구현	API 명세서 작성 및 구현	API 명세서 작성 및 구현
프로젝트 세팅		리드미 작성

Branch 전략, Commit Convention

❗️ Git Workflow

main → develop → feature/이슈번호-기능, fix/이슈번호-기능, refactor/이슈번호-기능

1. local - feature/이슈번호-기능 에서 각자 작업
2. 작업 완료 후 remote - develop 에 PR
3. 코드 리뷰 후 Confirm 받고 Merge
4. remote - develop 에 Merge 될 때 마다 모든 팀원 remote - develop pull 받아 최신 상태 유지

❗️ Commit Convention

태그 이름	설명
[Feat]	새로운 기능 구현
[Fix]	버그, 오류 수정
[Hotfix]	issue나 QA에서 급한 버그 수정
[Docs]	문서 수정
[Test]	테스트 코드 추가 및 업데이트
[Chore]	코드 수정, 내부 파일 수정
[Del]	불필요한 코드 삭제
[Refactor]	전면 수정
[Merge]	다른 브랜치를 merge 할 때 사용
[Add]	Feat 이외의 부수적인 코드 추가, 라이브러리 추가, 새로운 파일 생성 시
[Rename]	파일 이름 변경 시 사용
[Move]	프로젝트 내 파일이나 코드의 이동

Code Convention

변수

1. 변수나 함수명은 camelCase를 사용한다.
2. 함수의 경우 동사+명사 사용한다.

• ex) getRecords()

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

• ex) isDeleted

4. Class / Interface / Type / Namespace / Enum 명은 PascalCase를 사용한다.
5. 약어는 되도록 사용하지 않는다.

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

주석

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

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

2. 컨트롤러에 대한 주석

/**
 * @route POST /record
 * @desc Create Record
 * @access Public
 */

Bracket

• Prettier
• Eslint

프로젝트 폴더 구조

---📁src
------📄index.ts
------📄app.ts
------📁tests
------📁config
---------📄agenda.ts
---------📄index.ts
---------📄multer.ts
---------📄s3Config.ts
---------📄firebase-admin.json
------📁controllers
---------📄index.ts
---------📄AuthController.ts
---------📄RecordController.ts
---------📄UserController.ts
---------📄VoiceController.ts
------📁interfaces
---------📁common
---------📁auth
---------📁record
---------📁user
---------📁voice
------📁loaders
---------📄db.ts
------📁models
---------📄Record.ts
---------📄User.ts
---------📄Voice.ts
---------📄VoiceMocking.ts
------📁modules
---------📄exceptionMessage.ts
---------📄jwtHandler.ts
---------📄pushMessage.ts
---------📄responseMessage.ts
---------📄returnToSlackMessage.ts
---------📄slackApI.ts
---------📄statusCode.ts
---------📄util.ts
------📁routes
---------📄index.ts
---------📄AuthRouter.ts
---------📄RecordRouter.ts
---------📄UserRouter.ts
---------📄VoiceRouter.ts
------📁services
---------📄index.ts
---------📄AuthService.ts
---------📄RecordService.ts
---------📄UserService.ts
---------📄VoiceService.ts

Dependency Module

{
  "name": "recordream-server",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "dev": "nodemon",
    "build": "tsc",
    "test": "jest --detectOpenHandles --setupFiles dotenv/config --forceExit",
    "prepare": "husky install"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@types/express": "^4.17.13",
    "@types/jest": "^28.1.6",
    "@types/mongoose": "^5.11.97",
    "@types/multer": "^1.4.7",
    "@types/multer-s3": "^2.7.12",
    "@types/node": "^17.0.25",
    "@types/node-schedule": "^2.1.0",
    "@types/supertest": "^2.0.12",
    "@typescript-eslint/eslint-plugin": "^5.30.5",
    "@typescript-eslint/parser": "^5.30.5",
    "eslint": "^8.19.0",
    "eslint-config-prettier": "^8.5.0",
    "eslint-plugin-prettier": "^4.2.1",
    "husky": "^8.0.0",
    "jest": "^28.1.3",
    "nodemon": "^2.0.15",
    "prettier": "^2.7.1",
    "supertest": "^6.2.4",
    "ts-jest": "^28.0.7",
    "ts-node": "^10.7.0",
    "typescript": "^4.6.3"
  },
  "dependencies": {
    "@types/agenda": "^4.1.0",
    "aws-sdk": "^2.1171.0",
    "axios": "^0.27.2",
    "bcryptjs": "^2.4.3",
    "dayjs": "^1.11.3",
    "dotenv": "^16.0.1",
    "ejs": "^3.1.8",
    "express": "^4.18.1",
    "express-validator": "^6.14.2",
    "firebase-admin": "^11.0.0",
    "jsonwebtoken": "^8.5.1",
    "mongoose": "^6.4.3",
    "multer": "^1.4.5-lts.1",
    "multer-s3": "^2.10.0",
    "node-schedule": "^2.1.0",
    "slack-node": "^0.1.8"
  }
}

전체 API 로직 구현 진척도 및 담당자

기능	담당자	구현 여부
[PUT] 유저 닉네임 수정	황서경	✅
[GET] 회원정보 조회	황서경	✅
[PUT] 푸시알림 여부(토글) 변경	황서경	✅
[POST] 음성녹음 업로드	김시연	✅
[GET] 음성녹음 재생	김시연	✅
[POST] 꿈 기록 작성	추서연	✅
[GET] 꿈 기록 리스트 조회 (홈 뷰)	추서연	✅
[GET] 꿈 기록 리스트 조회 (보관함 뷰)	추서연	✅
[GET] 꿈 기록 조회 (상세보기 뷰)	김시연	✅
[PATCH] 꿈 기록 일부 수정	김시연	✅
[DELETE] 꿈 기록 삭제	김시연	✅
[GET] 꿈 검색	추서연	✅
[POST] 푸시알림 시간 설정	황서경	✅
[PUT] 푸시알림 시간 수정	황서경	✅
[PUT] 푸시알림 토큰 refresh	황서경	✅

Architecture