예시 | Notion

<aside> 💡 수료 후, 이력서에 우리가 만들어낸 내용들을 꼼꼼하게 채워넣어야겠죠? 우리 프로젝트의 강점을 잘 녹여내기 위해 회고록 양식을 공유 드립니다. 프로젝트와 작성하시는 회고록을 기반으로 다음 주 멘토님들께서 순회할 예정이니, 새롭게 추가/개선할 기능이나 수정 방향성에 대해서 깊은 고민을 할 수 있는 기회가 되길 바랍니다 😊

</aside>

3주차까지의 후기 및 소감

<aside> 📢 중간 발표 이전 기재

</aside>

1. MVP 중간발표 자료(기입)

프로젝트 정보
- 서비스명: Give Me The Ticket
- 서비스 기획 의도:
  - 일반적인 중고 거래 티켓은 암표 형태로 진행됨
  - 그래서 가격의 상한선이 존재하지 않고 사기 당할 위험도 사용자가 부담해야 함
  - 하지만 이 서비스를 통해 티켓을 예매한 곳에서 중고 거래 함으로써 안전하고 알맞은 가격에 거래가 가능하게 지원할 수 있음
- 프로젝트 한 줄 설명: 공연 예매와 예매한 티켓의 중고 거래를 한 곳에서 지원하는 서비스
- 최종 MVP 스펙:
  - Front-End : HTML, CSS, JavaScript, EJS
  - Back-End : TypeScript, Node.js, Nest.js
  - DataBase : MySQL, TypeORM, AWS RDS
  - Deploy : Gibhub Actions, AWS EC2, ALB, ACM
- 서비스 배포 URL : https://mymycode.shop/views
- 팀 노션 URL : https://teamsparta.notion.site/No-Pain-No-Code-2ce80522fefd4216bae9986af368b6b3
  
  No Pain No Code

2. 기술적 의사결정 & 트러블슈팅 기록

기술적 의사결정

요구 사항	기술	선택한 이유
언어	**선택한 기술

TypeScript**

선택지

TypeScript
JavaScript | - 타입 안전성을 제공해서 런타임 상에서 오류를 감소 시킬 수 있음
기존 JavaScript 코드와 호환되기 때문에 쉽게 마이그레이션할 수 있음
모듈화를 통해 코드 구조화와 유지 보수성을 향상 시킬 수 있음 | | 프레임워크 | **선택한 기술
Nest.js**

선택지

Nest.js
Express.js | - TypeScript를 지원하여 타입 안전성을 향상 시킴
Nest.js에서 제공하는 의존성 주입 기능을 통해서 코드의 재사용성과 유지 보수성을 향상 시킬 수 있음
데코레이터, 메서드, 클래스 등 다양한 기능을 내장하여 여러 요구 사항에 유연하게 대응할 수 있음
기본적인 문법이나 구조는 잘 정리된 공식 문서를 통해서 학습이 가능함 | | 데이터베이스 | **선택한 기술
MySQL**

선택지

MySQL
NoSQL
MongoDB | - 관계형 데이터베이스를 사용해서 공연, 사용자, 예매 등 복잡한 관계를 관리할 수 있음
ACID 트랜잭션을 지원하기 때문에 예매 과정에서 발생할 수 있는 오류나 충돌을 방지할 수 있음
다양한 도구와 라이브러리가 지원되기 때문에 개발 및 운영 시 편의성을 제공 받을 수 있음
대량의 데이터를 처리할 때 인덱싱, 로우 쿼리 사용 등을 통해서 데이터베이스의 성능을 극대화할 수 있는 방법이 많음 | | ORM | **선택한 기술
TypeORM**

선택지

TypeORM
Prisma
Mongoose | - TypeORM은 TypeScript로 작성되기 때문에 타입 안전성을 제공함
MySQL과 같은 관계형 데이터베이스와 호환성이 좋음
쿼리 빌더를 제공하기 때문에 복잡한 데이터베이스 쿼리를 로우 쿼리와 유사항 형태로 쉽게 작성할 수 있게 도와줌
잘 정리된 공식 문서를 가지고 있고, 검색 시 다양한 자료에 접근이 가능함 | | CI/CD | **선택한 기술
Github Actions**

선택지

Github Actions
GitHub Actions + Docker
Jenkins | - Github 저장소와 연결되어 있기 때문에, 코드 Push, Merge, PR 등 다양한 이벤트에 대해 CI/CD 파이프라인을 설정할 수 있음
YAML 기반의 구성 파일을 이용해서 CI/CD 진행 과정을 쉽게 설정할 수 있음
코드 형태로 관리되기 때문에 버전 관리가 가능하고 협업에도 용이함
Github에서 GUI 형태로 CI/CD workflow에서 발생하는 오류나 경고를 실시간으로 확인 가능하기 때문에 개발자가 신속하게 문제를 발견하고 해결할 수 있게 도와줌
무엇보다 간편함과 통합된 환경 때문에 선택함
Docker를 결합한 방식은 시간 부족으로 사용하지 못 함 | | 프론트엔드 | **선택한 기술
EJS**

선택지

EJS
React
Bubble.io
handlebars
pug | - EJS는 기존에 알고 있는 html를 사용할 수 있고, 자바스크립트를 자유롭게 사용할 수 있음.
React는 유연성 및 커스터마이징이 가능하고 우수한 성능을 보이나, 학습의 어려움이 있음.
Bubble.io는 사용이 쉽지만, 백엔드에서 반환 된 값을 가져와서 저장하는 등의 데이터 활용이 생각보다 어렵고 공동 작업을 위해서는 과금이 필요함.
pug는 지금까지 알고 있었던 다른 형태의 html 템플릿임. | | 프론트엔드 API 호출 방식 | **선택한 기술
Axios**

선택지

Axios
Fetch | - Axios는 직관적인 API를 제공하기 때문에 HTTP 요청을 훨씬 간단하게 수행할 수 있음
서버에서 받은 응답을 자동으로 JSON 형태로 변환해 줌
IE와 같은 구형 브라우저에서도 잘 동작함
HTTP 오류 코드가 반환될 경우 자동으로 오류를 발생시켜서 try ~ catch 문으로 예외 처리가 가능함 | | 동시성 처리 | **선택한 기술
BullMQ + Redis**

선택지

BullMQ + Redis
rabbit queue
active queue
분산 Locks(RedLock) | - 티켓 예매는 여러 사용자가 동시에 요청하는 경우가 많고 이 경우에는 요청을 한 순서가 굉장히 중요하기 때문에 Queue를 사용함
BullMQ의 우선순위 기능을 통해서 공정한 예매 환경을 조성할 수 있음
Nest.js 공식 문서에서 기본적인 구조와 사용법을 제공하고 있기 때문에 학습이 용이함
TypeScript로 작성되어 있어, 타입 안전성을 제공할 수 있음
rabbit Queue는 복잡한 애플리케이션에 필요하고, 학습에 어려움이 있음.
activemq는 사용이 용이하지만, 보안에 취약한 서비스 버전이 있어서 보안 관련 이슈가 있음. | | 동시성 테스트도구 | **선택한 기술
Apache JMeter**

선택지

Apache JMeter
Locust | - jmeter는 다양한 기능과 프로토콜을 지원함.(https 배포를 지원함.)
locust는 테스트를 쉽게 확장하나 https 지원이 되지 않는 단점이 있음. | | 공연 검색 | 선택한 기술
ElasticSearch

선택지

ElasticSearch
TypeORM %Like% | - DB-Engines Ranking 에서 3위를 차지하고 있는 높은 인기도를 보임
- 많은 사람이 사용하는 기술이기 때문에 문제 발생 시 해결 방법도 많이 나와있고, 참고자료가 다양함
Lucene를 기반으로 한 오픈소스 검색 엔진 -전문 검색 가능
역색인 구조를 통해 단어가 포함된 특정 문서의 위치를 알아내서 빠르게 결과를 찾을 수 있음 | | 공연 목록 조회 | 선택한 기술
Pagination | - 전체 데이터를 가져오는 것 보다 페이지 당 데이터를 정해서 가져오니까 검색 속도가 빠름
사용자 의도에 맞게 페이지를 넘기기 가능 (사용자가 원하는 페이지 클릭)
원하는 항목의 위치를 확인 가능 (어떤 공연이 몇 페이지에 있었다는 것을 알 수 있음) |
프로젝트를 진행하면서 직면한 문제를 어떤 과정으로 해결 하셨는지, 스택별로 기록 해 주세요
기술적 의사결정을 기본으로, 트러블슈팅도 있다면 기록해둡시다.
트러블 슈팅
- CI/CD
- Portone 결제 기능
- Elasticsearch
CD workfolw 멈춤 현상 - 1차 문제
CD workflow 멈춤 현상 - 2차 문제
Portone 결제 기능
Elasticsearch

<aside> 📢 중간 발표 이후 기재

</aside>