REST API 프로젝트 구조
폴더 구조입문
잘 조직된 API 프로젝트 구조는 Claude Code가 코드베이스를 효율적으로 탐색하고 올바른 위치에 변경 사항을 적용하도록 도와줍니다. 이 패턴은 라우트, 컨트롤러, 서비스, 데이터 접근 계층을 분리하여 Claude가 비즈니스 로직과 HTTP 처리가 어디에 있는지 이해하게 합니다. 이 구조를 따르면 CLAUDE.md 지시사항도 더 정확해집니다 -- '새 서비스를 추가해줘'라고 하면 Claude가 정확히 어디에 파일을 생성해야 하는지 알게 됩니다.
APIRESTNode.jsExpress백엔드폴더 구조
패턴 코드
my-api/
├── src/
│ ├── routes/ # HTTP route definitions
│ │ ├── users.ts # /api/users endpoints
│ │ ├── products.ts # /api/products endpoints
│ │ └── index.ts # Route aggregator
│ ├── controllers/ # Request/response handling
│ │ ├── userController.ts
│ │ └── productController.ts
│ ├── services/ # Business logic (no HTTP awareness)
│ │ ├── userService.ts
│ │ └── productService.ts
│ ├── repositories/ # Database queries (Prisma/Drizzle)
│ │ ├── userRepo.ts
│ │ └── productRepo.ts
│ ├── middleware/ # Auth, validation, error handling
│ │ ├── auth.ts
│ │ ├── validate.ts
│ │ └── errorHandler.ts
│ ├── utils/ # Shared helpers
│ │ ├── logger.ts
│ │ └── constants.ts
│ ├── types/ # TypeScript type definitions
│ │ └── index.ts
│ └── app.ts # Express/Fastify app setup
├── tests/
│ ├── unit/ # Mirror src/ structure
│ │ └── services/
│ └── integration/ # API endpoint tests
│ └── users.test.ts
├── prisma/
│ └── schema.prisma # Database schema
├── CLAUDE.md # Project rules for Claude Code
├── .env.example
├── package.json
└── tsconfig.json
# CLAUDE.md excerpt for this structure:
# - Routes only handle HTTP (req/res). No business logic.
# - Services contain all business logic. No HTTP awareness.
# - Repositories handle all database queries via Prisma.
# - Tests mirror src/ structure. Co-located unit tests OK.
# - New feature = route + controller + service + repo + test.
이 패턴을 프로젝트 설정에 복사하여 적용하세요.
실행 미리보기
REST API 프로젝트 구조
REST API 프로젝트 구조에 대해
Claude Code 패턴은 복잡한 개발 시나리오를 효과적으로 다루기 위한 검증된 아키텍처 설계와 워크플로우 구조입니다. REST API 프로젝트 구조은(는) 입문 수준의 폴더 구조 패턴으로, 프로젝트에 맞게 응용할 수 있는 테스트된 반복 가능한 접근 방식을 제공하여 더 효율적이고 일관된 결과를 만들어 냅니다.