stack-analysis
CHAPTER 60 / 90
읽기 약 2분
FUNCTION
백엔드 스택 종합: 나만의 API 보일러플레이트
핵심 개념
Express + Prisma + Zod + Sentry — 신규 API 30분 셋업.
본문
추천 백엔드 스택 (1인 개발자)
[Core]
- Node.js 20 + TypeScript strict
- Express (또는 Fastify·Hono)
- Prisma (ORM)
- Zod (검증)
- pino (로깅)
[Auth]
- jsonwebtoken
- bcryptjs
- Passport (OAuth2)
[Infra]
- PostgreSQL (Supabase)
- Redis (Upstash)
- BullMQ (작업 큐)
- S3 (파일)
[보안]
- helmet
- cors
- express-rate-limit
- express-mongo-sanitize
[모니터링]
- Sentry
- Logflare
- New Relic (선택)
[배포]
- Docker
- Vercel/Railway/Fly.io
- GitHub Actions폴더 구조 (신규 API)
api/
├── src/
│ ├── index.ts # 엔트리
│ ├── app.ts # Express 셋업
│ ├── env.ts # 환경변수 (Zod)
│ ├── container.ts # DI 컨테이너
│ ├── middleware/
│ │ ├── auth.ts
│ │ ├── error.ts
│ │ ├── rateLimit.ts
│ │ └── validation.ts
│ ├── modules/
│ │ ├── user/
│ │ │ ├── user.controller.ts
│ │ │ ├── user.service.ts
│ │ │ ├── user.repository.ts
│ │ │ ├── user.schema.ts
│ │ │ └── user.routes.ts
│ │ └── post/
│ ├── lib/
│ │ ├── prisma.ts
│ │ ├── redis.ts
│ │ └── logger.ts
│ ├── utils/
│ │ ├── errors.ts
│ │ └── asyncHandler.ts
│ └── types/
├── prisma/
│ ├── schema.prisma
│ └── migrations/
├── tests/
├── Dockerfile
├── docker-compose.yml
├── .env.example
└── package.json신규 모듈 5분 셋업 (예: comments)
# 1. 폴더 생성
mkdir -p src/modules/comment
# 2. 파일 4개 생성
touch src/modules/comment/{comment.controller,comment.service,comment.repository,comment.schema,comment.routes}.ts
# 3. Prisma 모델 추가
# schema.prisma
model Comment {
id String @id @default(cuid())
content String
postId String
authorId String
createdAt DateTime @default(now())
@@index([postId, createdAt])
}
# 4. 마이그레이션
pnpm dlx prisma migrate dev --name add_comment
# 5. 라우터 등록
// app.ts
import commentRouter from './modules/comment/comment.routes';
app.use('/comments', commentRouter);30분 풀스택 셋업
# 1. 프로젝트 생성
pnpm create t3-app@latest my-api --no-tailwind --no-trpc --no-nextAuth
# 2. 의존성 추가
cd my-api
pnpm add express cors helmet express-rate-limit
pnpm add jsonwebtoken bcryptjs
pnpm add ioredis bullmq
pnpm add @sentry/node pino pino-logflare
pnpm add -D @types/express @types/cors @types/jsonwebtoken @types/bcryptjs
# 3. Prisma + DB
pnpm dlx prisma init
# DATABASE_URL 설정 후
pnpm dlx prisma migrate dev
# 4. Docker compose 시작
docker compose up -d postgres redis
# 5. 시드
pnpm dlx prisma db seed
# 6. 개발 시작
pnpm dev프로덕션 체크리스트
[코드 품질]
☐ TypeScript strict
☐ ESLint + Prettier
☐ Husky pre-commit
☐ Vitest 단위 테스트
☐ Supertest 통합 테스트
[보안]
☐ helmet 적용
☐ CORS 화이트리스트
☐ Rate limit (Redis)
☐ 입력 검증 (Zod)
☐ SQL injection 방지 (Prisma)
☐ XSS 방지
☐ CSRF token (쿠키 기반)
☐ Secrets Manager
[성능]
☐ 인덱스 검토
☐ N+1 방지 (DataLoader/include)
☐ Redis 캐시
☐ 비동기 잡 (BullMQ)
☐ Connection pool
[운영]
☐ Sentry 통합
☐ 구조화 로그 (pino)
☐ Health check (/health)
☐ Graceful shutdown
☐ 자동 백업 (DB)
☐ 모니터링 알림
[배포]
☐ Dockerfile multi-stage
☐ CI/CD (GitHub Actions)
☐ Staging 환경
☐ Blue-Green 또는 rolling
☐ 롤백 절차 문서
[문서]
☐ OpenAPI 자동 생성
☐ README (셋업·실행)
☐ Architecture 문서
☐ Runbook (장애 대응)파트 2 정리
✅ Node.js/Express (CH.31~38): 아키텍처·인증·업로드·실시간·큐·보안·버저닝·GraphQL
✅ DB 심화 (CH.39~46): 튜닝·인덱스·마이그레이션·Redis·MongoDB·Supabase·정규화·백업
✅ API 설계 (CH.47~52): RESTful·에러·페이지네이션·보안·문서화·tRPC
✅ 인프라 (CH.53~60): 클라우드 비교·Docker·CI/CD·시크릿·도메인·모니터링·비용·종합
다음 파트 3 (예정):
데이터+인프라 30챕터 — DB·Redis·Kafka·K8s·Terraform
다음 파트 4 (예정):
AI+보안+모니터링 30챕터 — LLM·LangChain·Sentry·Datadog·Vault학습 적용
1. 본인 프로젝트에 보일러플레이트 적용
2. 1개 모듈씩 — auth → posts → comments
3. 프로덕션 체크리스트 점검
4. CI/CD 파이프라인 구축
5. 모니터링 + 알림 셋업
6. 100K MAU까지 단계별 확장AI 프롬프트
🤖 AI에게 잘 물어보는 법 — 모델·전략별 프롬프트
Claude
무료: Sonnet 4.6 / Pro $20/mo: Opus 4.6
내 코드의 백엔드 보일러플레이트 부분을 분석해서 실전 분석 + 개선 우선순위를 알려줘.
ChatGPT
무료: GPT-5.5 / Plus $20/mo: GPT-5.5 Pro
백엔드 보일러플레이트 관련 인기 라이브러리/패턴 5개를 비교 분석해서 패턴 추출를 알려줘.
Gemini
무료: 2.5 Flash / Pro $19.99/mo: 3.1 Pro
내 프로젝트 전체에서 백엔드 보일러플레이트 최적화 가능 위치를 보고해줘.
Grok
무료: Grok 4.1 / SuperGrok $30/mo
2026년 한국 백엔드 시장의 백엔드 보일러플레이트 트렌드를 솔직히 알려줘.
⭐ 이것만 기억하세요
백엔드 스택 종합: 나만의 API 보일러플레이트는 이 3가지만 확실히 잡으세요
1.추천 백엔드 스택 = Express + Prisma + Zod + pino + Sentry (검증된 조합)
2.모듈 구조 (controller/service/repository/schema/routes)로 신규 도메인 5분 추가
3.프로덕션 체크리스트 26개 — 셋업 → 보안 → 성능 → 운영 → 배포 → 문서
공유하기
진행도 60 / 90