Backend

기획 문서만 있으면 디자인 → 프론트엔드 → 백엔드까지 Vortex 하나로 개발합니다.

개요

Vortex Backend는 프론트엔드에서 제공하던 것(템플릿 + 컴포넌트 add + 표준)을 백엔드로 확장한 백엔드 개발 시작 키트입니다. npx @vortex/cli init --backend 한 줄로 바로 실행되는 서버 뼈대를 받고, 필요한 공통 모듈(인증·CRUD·로깅·파일 업로드)을 골라 조립하며, 백엔드의 OpenAPI(스웨거) 명세에서 프론트엔드 연동 코드(타입·TanStack Query 훅·MSW mock)를 자동 생성합니다.

백엔드 템플릿·모듈의 본체(소스·설계·CI)는 별도 저장소 **vortex-backend**에 있고, CLI는 이를 원격 레지스트리(S3)에서 받아 설치합니다.

”3 + 1” 모델

Vortex Backend가 제공하는 것은 정확히 템플릿 3종 + 계약 파이프라인 1종입니다.

규모와 성격(공공/엔터프라이즈 여부 포함)에 따라 사용하는 사람이 템플릿을 고르고, Vortex는 어떤 선택을 해도 프론트엔드와 유기적으로 맞물리도록 미리 갖춰진 템플릿을 제공합니다.

빠르게 시작

# 프론트 + 백엔드 풀스택 프로젝트를 한 번에 생성
npx @vortex/cli init my-app --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   # 환경 변수 채우기
pnpm api:dev                              # http://localhost:3000/swagger-ui

생성되는 풀스택 모노레포 구조:

my-app/
├─ apps/
│   ├─ web/              # 프론트엔드 (Vortex 프론트 템플릿)
│   └─ api/              # 백엔드 (NestJS + 선택한 모듈)
├─ packages/
│   └─ contracts/        # 계약 파이프라인 (openapi → 타입·훅·MSW)
└─ pnpm-workspace.yaml

더 알아보기