프로젝트 아키텍처 가이드

이 가이드는 프로젝트의 코드 품질과 일관성을 유지하기 위한 범용 원칙입니다.

코드 구조 원칙

1. 단일 책임 원칙 (SRP)

• 파일/모듈당 하나의 주요 책임만 가집니다
• 함수는 하나의 작업만 수행합니다
• 클래스는 하나의 변경 이유만 가집니다

2. 계층 분리

[Presentation Layer] → [Business Logic] → [Data Access] → [External Services]

• 각 계층은 자신보다 하위 계층만 의존합니다
• 순환 의존성은 금지됩니다