generate-backend-projects

Generate Projects

프레임워크를 선택하여 NestJS + Prisma 또는 FastAPI + SQLAlchemy 프로젝트를 자동으로 생성합니다.

---

사용법

/generate-backend-projects --framework=nestjs  # NestJS + Prisma 프로젝트 생성
/generate-backend-projects --framework=fastapi # FastAPI + SQLAlchemy 프로젝트 생성

--framework 파라미터가 없으면 NestJS가 기본값입니다.

---

프레임워크 선택

파라미터	스택	ORM	스키마/모델
--framework=nestjs	TypeScript + Node.js	Prisma	Prisma Schema
--framework=fastapi	Python + FastAPI	SQLAlchemy	Pydantic + Alembic

---

프로젝트 구조 (공통)

생성되는 프로젝트 구조는 선택한 프레임워크에 따라 달라집니다:

NestJS (--framework=nestjs):

• src/ - TypeScript 소스 (NestJS 모듈 구조)
• prisma/ - Prisma 스키마 및 마이그레이션
• package.json, tsconfig.json

FastAPI (--framework=fastapi):

• src/ - Python 소스 (routers, models, schemas, services)
• alembic/ - Alembic 마이그레이션
• requirements.txt, pyproject.toml

자세한 구조는 각 프레임워크 참조를 확인하세요:

• NestJS 상세: references/nestjs.md
• FastAPI 상세: references/fastapi.md

---

설치 및 실행

NestJS

npm install
npx prisma migrate dev --name init
npm run start:dev

FastAPI

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
alembic revision --autogenerate -m "init"
alembic upgrade head
uvicorn src.main:app --reload --port 8000

---

지원 인증 방식

NestJS - Auth 스캐폴딩

auth 폴더 구조만 생성됩니다. 실제 구현은 /generate-auth-apis 스킬을 사용하여 채웁니다.

FastAPI - Auth 스캐폴딩

auth 폴더 구조만 생성됩니다. 실제 구현은 /generate-auth-apis 스킬을 사용하여 채웁니다.

---

.env 설정 (NestJS)

# Database
DATABASE_URL="file:./dev.db"

# Mode
MODE=dev

# JWT
JWT_ACCESS_SECRET=your-access-secret-key-change-in-production
JWT_REFRESH_SECRET=your-refresh-secret-key-change-in-production
JWT_ACCESS_EXPIRES=1h
JWT_REFRESH_EXPIRES=7d

# Frontend URL
FRONTEND_URL=http://localhost:3000

# OAuth
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/sns/google/callback

KAKAO_CLIENT_ID=
KAKAO_CLIENT_SECRET=
KAKAO_REDIRECT_URI=http://localhost:8000/auth/sns/kakao/callback

NAVER_CLIENT_ID=
NAVER_CLIENT_SECRET=
NAVER_REDIRECT_URI=http://localhost:8000/auth/sns/naver/callback

# NCP SMS
NCP_ACCESS_KEY=your-ncp-access-key
NCP_SECRET_KEY=your-ncp-secret-key
NCP_SMS_SERVICE_ID=your-ncp-sms-service-id
NCP_SMS_SENDER=01012345678

# Server
PORT=8000

.env 설정 (FastAPI)

# Database
DATABASE_URL=postgresql://postgres:postgres@localhost:5433/mydb

# JWT
JWT_ACCESS_SECRET=your-access-secret-key-change-in-production
JWT_REFRESH_SECRET=your-refresh-secret-key-change-in-production
JWT_ACCESS_EXPIRES=3600
JWT_REFRESH_EXPIRES=604800

# Frontend URL
FRONTEND_URL=http://localhost:3000

# OAuth
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/sns/google/callback

KAKAO_CLIENT_ID=
KAKAO_CLIENT_SECRET=
KAKAO_REDIRECT_URI=http://localhost:8000/auth/sns/kakao/callback

NAVER_CLIENT_ID=
NAVER_CLIENT_SECRET=
NAVER_REDIRECT_URI=http://localhost:8000/auth/sns/naver/callback

# NCP SMS
NCP_ACCESS_KEY=
NCP_SECRET_KEY=
NCP_SMS_SERVICE_ID=
NCP_SMS_SENDER=01012345678

# Server
PORT=8000

---

프레임워크별 상세 참조

각 프레임워크의 상세한 프로젝트 구조, 스키마, API 스펙은 다음을 참조하세요:

• NestJS + Prisma: references/nestjs.md
• FastAPI + Pydantic + SQLAlchemy: references/fastapi.md

---

PostgreSQL vs SQLite 선택 가이드

상황	추천
로컬 개발/테스트	SQLite
프로덕션	PostgreSQL
단일 DB per repo	SQLite
다중 환경	PostgreSQL
풀텍스트 검색 필요	PostgreSQL