백엔드 아키텍처 가이드

1. 계층별 책임

계층	책임	금지 사항
Controller	HTTP 요청/응답, Validation Pipe 연결	비즈니스 로직 작성
Service	비즈니스 로직, 외부 API/DB 접근	Request/Response 객체 접근
Entity	DB 스키마 표현	비즈니스 로직 (최소화)
DTO	외부와 주고받는 데이터 정의	-
Module	의존성 조합	-
Guard / Interceptor	횡단 관심사 (인증, 로깅 등)	-

1.1 계층 간 의존 방향

Controller → Service → Repository → Entity
     ↓           ↓
    DTO         DTO

규칙:

상위 계층이 하위 계층에 의존
역방향 의존 금지
DTO는 Controller ↔ Service 간 데이터 전달에 사용

2. 도메인 모듈 규칙

2.1 디렉토리 구조

src/[domain]/
├── domain.module.ts
├── domain.controller.ts
├── domain.service.ts
├── domain.repository.ts
├── dto/
│   ├── create-domain.dto.ts
│   ├── update-domain.dto.ts
│   └── get-domain-response.dto.ts
├── entities/
│   └── domain.entity.ts
└── types/
    └── external-api.type.ts

2.2 네이밍 규칙

도메인명은 복수형 명사 사용
파일명은 [도메인].[역할].ts 형식

# Good
users/
  users.controller.ts
  users.service.ts

# Bad
user/
  user.controller.ts

2.3 도메인 간 통신

// Good: Service 레벨에서 다른 Service 주입
@Injectable()
export class OrdersService {
  constructor(private readonly usersService: UsersService) {}

  async createOrder(userId: string) {
    const user = await this.usersService.findOne(userId);
    // ...
  }
}

// Bad: Controller에서 다른 도메인 Service 직접 사용
@Controller('orders')
export class OrdersController {
  constructor(
    private readonly ordersService: OrdersService,
    private readonly usersService: UsersService, // ❌
  ) {}
}

규칙: