TekaPicker 프로젝트 초기 세팅 요약 (음슴체 버전, 프론트/백엔드 분리 모노레포 기준)

---

✅ 목표

• 프론트엔드와 백엔드를 서로 다른 모노레포로 구성할 예정
  • 프론트: React + Vite + TypeScript
  • 백엔드: NestJS + 서비스 단위 MSA 구성
• 각 모노레포는 내부적으로 워크스페이스 구성 (ex. apps, libs 폴더)
• Docker + docker-compose 환경으로 컨테이너 개발 환경 구성할 계획임

---

✅ Step 1: Docker 설치 (Pop!_OS 기준)

# 기존 Docker 깔려있을 수 있으니 제거
sudo apt remove docker docker-engine docker.io containerd runc

# 패키지 리스트 최신으로 갱신
sudo apt update

# Docker 설치에 필요한 기본 패키지 설치
sudo apt install ca-certificates curl gnupg

# Docker 공식 GPG 키 추가
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Docker 저장소 등록
echo \
  "deb [arch=$(dpkg --print-architecture) \
  signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 패키지 리스트 다시 갱신
sudo apt update

# Docker 설치
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 설치 테스트
sudo docker run hello-world

🔹 sudo 없이 docker 명령 쓰고 싶으면

sudo usermod -aG docker $USER
newgrp docker

---

✅ Step 2: Node.js & NestJS CLI 설치

# Node.js 18.x 설치
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# NestJS CLI 설치
npm install -g @nestjs/cli

# 버전 확인
node -v
npm -v
nest -v

---

⚠️ npm 업데이트 중 생긴 에러

npm install -g npm@11.2.0

위 명령어 실행 시 다음과 같은 에러 발생함

npm ERR! notsup Required: {"node":"^20.17.0 || >=22.9.0"}
npm ERR! notsup Actual:   {"npm":"10.8.2","node":"v18.20.8"}

이건 npm 11.2.0이 Node.js 20 이상 요구하는 거라서 생긴 문제임
현재 Node.js v18 사용 중이면 무시해도 됨

---

✅ 정리

• 프론트와 백엔드는 서로 다른 레포로 각각 모노레포 구성함
• 각 서비스는 추후 gRPC + MSA 구조로 NestJS 기반 설계할 예정
• 지금은 준비 단계 완료, 다음부터 user-service부터 개발 들어갈 예정임