Backend 시작하기

npx @vortex/cli init --backend 로 풀스택 프로젝트를 만들고, npx @vortex/cli add backend/* 로 백엔드 모듈을 추가합니다.

개요

Vortex CLI의 백엔드 기능은 두 가지입니다. 새 프로젝트는 init --backend로 프론트 + 백엔드 풀스택 모노레포를 한 번에 생성하고, 기존 프로젝트에는 add backend/<module>로 백엔드 모듈을 추가합니다. 템플릿·모듈은 모두 원격 레지스트리에서 받아오며, 설치 후 무결성 검증·app.module.ts 자동 등록·.env.example 병합까지 처리됩니다.

방법 1: 풀스택 프로젝트 생성 (init —backend)

대화형 모드 (권장)

npx @vortex/cli init

프론트 선택(프레임워크·제품) 후, 백엔드 단계가 이어집니다:

1. 백엔드 추가 여부: NestJS / 아니오(프론트만)
2. DB 선택: PostgreSQL / MySQL
3. 공통 모듈 선택(다중): 인증(JWT) · CRUD + DB · 에러·로깅 · 파일 업로드

비대화형 모드

npx @vortex/cli init my-app \
  --template vite-cals \
  --backend nest \
  --db postgresql \
  --modules auth,crud-db,error-logging,file-upload

생성 후

cd my-app
pnpm install
cp apps/api/.env.example apps/api/.env       # 환경 변수 채우기
 
# CRUD 모듈을 포함했다면 DB 준비
pnpm --filter ./apps/api exec prisma generate
pnpm --filter ./apps/api exec prisma db push
 
pnpm api:dev                                  # 백엔드 → http://localhost:3000/swagger-ui
pnpm web:dev                                  # 프론트엔드
pnpm contracts:generate                       # 백엔드 떠있는 상태에서 — 연동 코드 자동 생성

방법 2: 기존 프로젝트에 모듈 추가 (add backend/*)

이미 Vortex 백엔드(apps/api 또는 단독)가 있다면 모듈을 추가합니다.

# 모노레포 루트 또는 apps/api 에서 실행 (자동 감지)
npx @vortex/cli add backend/file-upload
npx @vortex/cli add backend/auth

추가 시 자동으로 수행되는 것:

• 모듈 파일 설치 + 설치 후 무결성 검증(부분 설치 차단)
• src/app.module.ts의 마커(<vortex:modules>)에 모듈 자동 등록
• .env.example에 필요한 환경 변수 병합 (.env는 건드리지 않음)
• 필요한 의존성을 package.json에 추가

개발 레지스트리로 테스트

# 최신 develop 레지스트리 사용
npx @vortex/cli init my-app --backend nest --dev

다음 단계