Installs into .claude/skills of the current project.
Are you the author of Node Express?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/ggombee-node-express)
---
name: node-express
description: Express/Fastify 기반 Node.js 백엔드 컨벤션
---
# Node.js Express/Fastify 컨벤션
## 프로젝트 구조
```
src/
├── app.ts # 앱 초기화, 미들웨어 등록
├── server.ts # 서버 진입점 (app.ts와 분리)
├── routes/ # 라우터 모음
├── controllers/ # 요청/응답 처리
├── services/ # 비즈니스 로직
├── middleware/ # 커스텀 미들웨어
├── models/ # DB 모델 (Prisma schema 또는 ORM)
└── types/ # 공유 TypeScript 타입
```
## 네이밍 규칙
- 파일: `camelCase.ts` 또는 `kebab-case.ts` (프로젝트 일관성 유지)
- 클래스: `PascalCase`
- 함수/변수: `camelCase`
- 환경변수: `UPPER_SNAKE_CASE`
- 라우트 경로: `kebab-case` (예: `/user-profiles`)
## 에러 처리
- 중앙 집중식 에러 핸들러 미들웨어 (`middleware/errorHandler.ts`)
- `AppError` 커스텀 클래스로 상태 코드 + 메시지 캡슐화
- async 라우터는 `express-async-errors` 또는 `try-catch` wrapper 사용
## 테스트
- `Jest` + `supertest` 조합
- 서비스 레이어 단위 테스트 + 라우터 통합 테스트
- DB mock: `jest.mock` 또는 테스트 전용 DB 인스턴스
